Pdpyras

* **New features:**
* Add the ability to specify a timestamp when submitting a change event by supplying keyword argument ``timestamp`` to ``ChangeEventsAPISession.submit``
* Explicitly include the upstream exception as cause when raising due to a non-transient network error
* **Breaking Changes:**
* Removal of deprecated functions:
* ``pdpyras.tokenize_url_path``
* ``pdpyras.resource_envelope``
* ``pdpyras.object_type``
* ``pdpyras.resource_name``
* ``pdpyras.raise_on_error``
* Removal of deprecated keyword arguments:
* ``__init__`` for all session classes no longer accepts ``name``
* ``pdpyras.APISession.iter_all`` no longer accepts ``paginate``
* ``pdpyras.APISession.iter_cursor`` no longer accepts ``attribute``
* Removal of deprecated object methods/properties:
* ``pdpyras.APISession.profiler_key``
* ``pdpyras.APISession.raise_if_http_error``

* Fix bug: ``/users/me`` is also ambiguously matched by canonical path ``/users/{id}``; the solution by asmith-pd short-circuits if there is an exact match for the URL to a canonical path

* Incorporate bugfix from `103 <https://github.com/PagerDuty/pdpyras/issues/103>`_ by av1m
* Fix the generic issue behind `102 <https://github.com/PagerDuty/pdpyras/issues/102>`_ (unsafe mix of string formatting styles)
* In HTTP retry exhaustion messages, print only the limit that got reached and not necessarily the per-status HTTP retry

Note: version 5.0.0 has been yanked; patch release v5.0.1 addresses an issue in ``setup.py``.

* **New Features:**
* Methods that assume entity wrapping like ``rget`` and ``iter_all`` now support all API endpoints
* Property ``PDSession.print_debug`` enables printing verbose log messages to ``sys.stderr``
* **Breaking Changes:**
* Removal of the deprecated method ``PDSession.set_api_key``
* End support for `Python v3.5 <https://www.python.org/downloads/release/python-350/>`_, which has reached end-of-life.
* **Deprecations:** the following will be removed in the next minor release, and use of them in v5.0.0 will trigger warnings:
* Keyword argument ``name`` of the session constructor: this previously set the name of the logger; now it has no effect.
* Keyword argument ``paginate`` of ``APISession.iter_all``: this previously could be set to ``False`` to make ``iter_all`` stop iteration after the first page of results; now it has no effect.
* Keyword argument ``attribute`` of ``APISession.iter_cursor``: this previously could be used to specify the entity wrapper name of results. The wrapper is now determined automatically and this argument has no effect.
* Function ``tokenize_url_path``
* Function (decorator) ``resource_envelope``
* Function ``object_type``
* Function ``raise_on_error``
* Function ``resource_name``
* Property ``APISession.raise_if_http_error``: this previously allowed partial results to be returned from ``iter_all`` in the case of HTTP errors; now it has no effect.
* Function ``APISession.profiler_key``

* The default value for request timeouts is now 60s.
* Method ``api_key_access`` is now implemented as a property in the class ``APISession``. Formerly it was implemented in the parent class ``PDSession`` and inherited in classes that did not need it and could not use it.
* Bug in version 4.5.1 (removed) in package distribution/build fixed

* Add a new API generator ``iter_cursor`` to :class:`APISession` that yields results from API endpoints that support cursor-based pagination, requesting the next page of results whenever needed.