Gapipy

-------------------

* Fix `2.26.3 (2020-04-28) (Yanked)`_: Add missing ``CONTRIBUTING.rst`` to the
manifest.

.. note:: Discovered when attempting to install ``gapipy`` via ``pip``.

----------------------------

* Fix py2 & py3 compatibility for ``urlparse``

-------------------

* Fix for `2.26.1 (2020-04-20)`_ and `Issue 113`_.

* See `PR 125`_.
* Remove the ``_set_resource_collection_field`` method in ``TourDossier``
* Introducing the ``_Parent`` namedtuple in `PR 123`_.
broke being able to Query-chain from Tour-Dossiers to departures
* Buggy behaviour fixed from `2.26.1 (2020-04-20)`_

.. code-block:: python

>>> from gapipy import Client
>>> api = Client(application_key='MY_SECRET_KEY')

>>> api.tour_dossiers(24309).departures.count()
AttributeError: 'tuple' object has no attribute 'uri'

.. _`PR 125`: https://github.com/gadventures/gapipy/pull/125

-------------------

* Fix for `2.26.0 (2020-04-14)`_ and `Issue 113`_.

* Calls to ``APIRequestor.list_raw`` will use initialised its parameters,
unless the URI provides its own.
* See `PR 123`_.

* Add the ability to define the ``max_retries`` values on the requestor.

* New ``env`` value ``GAPI_CLIENT_MAX_RETRIES``.
* The default value will be ``0``, and if provided will override the ``retry``
value on the ``requests.Session``.
* This change will also always initialize a ``requests.Session`` value on
initialisation of the ``gapipy.Client``.
* See `PR 124`_.

* Add ``variation_id`` field to the ``Image`` resource.

* See `Commit edc8d9b`_.

* Update the ``ActivityDossier`` and ``AccommodationDossier`` resources.

* Remove the ``is_prepaid`` field.
* Adds the ``has_costs`` field.
* See `Commit bd35531`_.

.. _`Issue 113`: https://github.com/gadventures/gapipy/issues/113
.. _`PR 123`: https://github.com/gadventures/gapipy/pull/123
.. _`PR 124`: https://github.com/gadventures/gapipy/pull/124
.. _`Commit edc8d9b`: https://github.com/gadventures/gapipy/commit/edc8d9b
.. _`Commit bd35531`: https://github.com/gadventures/gapipy/commit/bd35531

-------------------

.. warning:: BREAKING!

* The ``Query.filter`` method will return a clone/copy of itself. This will
preserve the state of ``filters`` on the original Query object.
* The ``Query.all`` method will **not** clear the filters after returning.
* The ``Query.all`` method will return a ``TypeError`` if a type other than
an ``int`` is passed to the ``limit`` argument.
* The ``Query.count`` method will **not** clear the filters after returning.
* See `PR 121`_ for more details.

New behaviour with the ``Query.filter`` method:

.. code-block:: python

>>> from gapipy import Client
>>> api = Client(application_key='MY_SECRET_KEY')

create a filter on the departures
>>> query = api.departures.filter(**{"tour_dossier.id": "24309"})
>>> query.count()
494

we preserve the filter status of the current query
>>> query.filter(**{"availability.status": "AVAILABLE"}).count()
80

>>> query.count()
494

* The ``AgencyChain.agencies`` attribute returns a list of ``Agency`` objects.
See `Commit f34afd52`_.

.. _`PR 121`: https://github.com/gadventures/gapipy/pull/121
.. _`Commit f34afd52`: https://github.com/gadventures/gapipy/commit/f34afd52

-------------------

* Improve contribution instructions to check long_description rST file in dist
* Dev Requirement updates:

* Add ``readme_renderer==24.0``
* Add ``twine==1.15.0`` for ``twine check`` command