added an optional return_upserts argument to bulk_upsert

@wesokes FYI I added an optional return_upserts argument to bulk_upsert in order to facilitate processing using manager utils.

I updated the README and included tests. It's pretty minor. The biggest changes are that I restructured the project to go by our new open source project structure guidelines