GitLab

In the past, there was one `Translator`, which was a global
singleton, and would be permanently modified any time a new
object class with an `_item_type` was created.

Recently, in v2.0.0a1, we tried out a change where the global
translator would be modified any time a new object class with an
`_item_type` OR with a baseclass with an `_item_type` was created.
This means that every subclass operation mutated global state.
We thought this would make it easier for developers to add their
own classes to the SDK. In retrospect, it makes it much harder
to write tests (because any temporary subclasses created,
including by a mock library, will modify global state for the
rest of the test run), and makes it impossible to intentionally
create a subclass that shouldn't be registered in the
translator. So we are reverting this behavior for v2.0.0a2.

Furthermore, this adds the ability to create non-global
translators (which are, by default, used on `BoxSession`
objects), and the ability to add non-global registrations to
these non-global translators. This is now the publicly
recommended way for developers to register types, outside of the
SDK itself.

For now, the old mechanism of implicitly registering the
official SDK classes with `_item_type` is retained. But we can
experiment with the new system, and see if we prefer to switch
to the explicit registration, and delete the implicit
registration system, in v2.0.0a3.

Also fix a bug that I discovered in `ExtendableEnumMeta`.

Prepare for alpha release of 2.0.0

Bump version to 2.0.0a1.

Add @kelseymorris95 to AUTHORS.

Fix up docstrings for Sphinx, and update docs sources.

Clean up release notes.

Bump version to 2.0.0a1.

Add @kelseymorris95 to AUTHORS.

Fix up docstrings for Sphinx, and update docs sources.

Clean up release notes.

Update HISTORY and README for new release.

Add `NetworkResponse` to `BoxAPIException`.

New `@api_call` decorator can be used to allow methods that make an API call to accept an extra
parameter `extra_network_parameters`, to be used for sending low level request parameters to
Requests or whatever network layer is being used.

When `extra_network_parameters` is provided, the underlying `BoxSession` is cloned, and the
`extra_network_parameters` are attached to the new one.

Decorate all existing API call methods with `@api_call`.

For consistency with other objects, can use `client.collaboration('box_id').do_something(...)` the
same way we do with `Folder`, `File`, etc.

Register subclasses

Enable `Translator` registered subclasses of smart objects to be returned
from smart object methods.

Remove all hard coded smart object return types in favor of a lookup in
`Translator` or returning an instance of `self.__class__`.

Added an `Event` class, edited `Events.get_event()` to return a list of them.

This creates a new branch in the object class hierarchy, with a distinction between REST objects (instances of `BaseObject` and its subclasses) and non-REST (objects that are not addressable / queryable in the API) objects (instances of `APIJSONObject` and its subclasses). `BaseObject` and `APIJSONObject` inherit from a common baseclass, `BaseAPIJSONObject`, which is now the base for translation.

To maintain backwards-compatibility with methods that used to return `dict`, `APIJSONObject` implements the `Mapping` interface.

Fixes #15.

Fixes to JWTAuth

Open the PEM private key file in 'rb' mode so that `.read()`
returns `bytes` in Python 3. Otherwise, the default openssl
backend of cryptography fails to use the key.

Set the `_user_id` attribute to `None` when authenticating an
enterprise instance.

Fixes #136.

Always update `OAuth2` object with new tokens

If the protected method `_get_tokens()` returns new tokens,
refresh is skipped, and those tokens are used.

Previously, we would return the new tokens without updating the
object state. Subsequent uses of the `OAuth2` object would use
the old tokens.

Now we will correctly update the object state.

Fixes #128.

Also make some minor test fixes and upgrade the version of mock
that we use.

Prepare for bump to version 1.5.2.

Add revoke() method to OAuth2 class.

Fixes #124

The Box API includes a /revoke endpoint to de-auth tokens.
This commit makes it easy to use this endpoint with the SDK.

Docs

Box objects will now be repr'd including the object type and
either the object's name or its Box id.

Also, add support for dir() and vars() being called on Box
objects. Those builtin functions will now include API response fields
as attributes of the object.

Add note in CONTRIBUTING.rst about updating HISTORY and AUTHORS.

* Use custom user agent for requests to Box.
* Add LoggingClient and DevelopmentClient classes.

Additional changes for 1.4.2 release

Update references to new API doc site.

Create wheel with correct conditional dependencies and license file.

Change the ``license`` meta-data from the full license text, to
just a short string, as specified in [1][2].

Include entire test/ directory in source distribution.
test/__init__.py was previously missing.

Update documentation. Fixes #112.

Use utf-8 encoding to open README in setup.py.

Run pep8 and pylint on setup.py.

Update pylint directives.

[1] <https://docs.python.org/3.5/distutils/setupscript.html#additional-meta-data>
[2] <https://www.python.org/dev/peps/pep-0459/#license>

Bump to version 1.4.2.

Update README with info about ``make_request``.