Scrapy-zyte-api

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

* Added official Python 3.13 support, removed official Python 3.8 support.

* Fixed a race condition that could allow more Zyte API requests than those
configured in the :setting:`ZYTE_API_MAX_REQUESTS` setting.

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

* Added support for ``zyte_common_items.JobPostingNavigation`` to the
scrapy-poet provider.

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

* Added support for :ref:`custom attribute extraction <custom-attrs>`.

* Added the :class:`~scrapy_zyte_api.LocationSessionConfig` class.

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

* Fixed an issue in the handling of excessive session initialization failures
during session refreshing, which would manifest as an asyncio messages about
unretrieved ``TooManyBadSessionInits`` task exceptions instead of stopping
the spider as intended.

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

* ``scrapy-zyte-api[provider]`` now requires :doc:`zyte-common-items
<zyte-common-items:index>` 0.20.0+.

* Added the :setting:`ZYTE_API_AUTO_FIELD_STATS` setting.

* Added the :func:`~scrapy_zyte_api.is_session_init_request` function.

* Added the :data:`~scrapy_zyte_api.session_config_registry` variable.

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

* **Backward-incompatible change:** The precedence of session param settings,
request metadata keys and session config override methods has changed.

Before, priority from higher to lower was:

. :meth:`~scrapy_zyte_api.SessionConfig.params`

. :meth:`~scrapy_zyte_api.SessionConfig.location`

. :reqmeta:`zyte_api_session_location`

. :setting:`ZYTE_API_SESSION_LOCATION`

. :reqmeta:`zyte_api_session_params`

. :setting:`ZYTE_API_SESSION_PARAMS`

Now, it is:

. :reqmeta:`zyte_api_session_params`

. :reqmeta:`zyte_api_session_location`

. :setting:`ZYTE_API_SESSION_PARAMS`

. :setting:`ZYTE_API_SESSION_LOCATION`

. :meth:`~scrapy_zyte_api.SessionConfig.location`

. :meth:`~scrapy_zyte_api.SessionConfig.params`

* When using the :reqmeta:`zyte_api_session_params` or
:reqmeta:`zyte_api_session_location` request metadata keys, a different pool
ID is now generated by default based on their value. See
:meth:`~scrapy_zyte_api.SessionConfig.pool` for details.

* The new :reqmeta:`zyte_api_session_pool` request metadata key allows
overriding the pool ID of a request.

* Added :ref:`pool management documentation <session-pools>`.

* Fixed some documentation examples where the parameters of the ``check``
method of :setting:`ZYTE_API_SESSION_CHECKER` were in reverse order.