Luminoso-api

This is the first released version for the v4 Luminoso API.

* Client changes

- Various improvements to the lumi-upload command-line interface, which
now is more robust for CSV uploads and has some Python 3 support.
- Errors are more informative when login fails or when API's response
does not contain JSON.
- The wait_for method raises an error if the job fails.
- Client uses the URL for the deployed v4 API.

* Server changes

- Various endpoint URL changes, including:
/<account>/projects/ is now /projects/<account>/
/.auth/login/ is now /user/login/
/.accounts/ is now /accounts/
- Users can have a default account, which the client can check for instead
of arbitrarily picking one.
- When documents are uploaded to an empty project (to be immediately
recalculated), they should go to the /preload/ endpoint. There is no
longer /calculate/, only /recalculate/.

This is the first, preliminary version of a client that works with the Luminoso
API v4. Please note that the v4 API is *still in testing* and not yet available
for general use! This client points to a strictly internal URL.

* Client changes

- Several changes to the tests and documentation to take into account the
server changes between v3 and v4.

* Server changes

- Project creation now assigns an arbitrary five-character ID to the
project instead of using the specified name. (This allows more freedom in
naming projects, which are no longer subject to length limits, character
restrictions, or other code-internal issues.) The ID is returned upon
project creation as "project_id" in the resulting dictionary, and that
should be used after "projects" in URLs. See v4 documentation for more
details.

* Client changes

- Easier way to create projects. If you don't specify a URL for the client,
or specify the URL '/auto', it will point to the endpoint
'/account_id/projects' for some reasonable value of 'account_id'.
Now you just need to enter your username (and answer the password
prompt).

* Server changes

- The GET /.accounts endpoint now returns a response following the standard
format, which will give you a list of all accounts you may access.

* Client changes

- As a principled way of dealing with multiple incompatible versions of
requests, we now depend on the 'requests-transition' distribution that
we have put on GitHub.

This lets us explicitly install and import version 0.x without
conflicting with other code.

* Client changes

- The 'requests' library has made incompatible changes in version 1.0.
As our API code is a fairly thin wrapper around requests, changing it to
support requests 1.0 would be a major change. We'll do that in
version 0.4.

- The upload script now gets installed as a command called 'lumi-upload',
which uploads properly-formatted CSV or JSON data to a project.
Type 'lumi-upload --help' for usage information.

* Client changes

- Initial version of upload.py, a script that runs JSON or CSV data
through the entire upload process.