Merge branch 'main' into custom-attrs

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.22.0
+current_version = 0.22.1
 commit = True
 tag = True
 tag_name = {new_version}

CHANGES.rst

@@ -1,6 +1,14 @@
 Changes
 =======
 
+0.22.1 (2024-08-30)
+-------------------
+
+* 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.
+
 0.22.0 (2024-07-26)
 -------------------
 

docs/conf.py

@@ -4,7 +4,7 @@
 project = "scrapy-zyte-api"
 copyright = "2023, Zyte Group Ltd"
 author = "Zyte Group Ltd"
-release = "0.22.0"
+release = "0.22.1"
 
 sys.path.insert(0, str(Path(__file__).parent.absolute()))  # _ext
 extensions = [

docs/usage/session.rst

@@ -338,6 +338,15 @@ To define a different session config for a given URL pattern, install
 
 .. autofunction:: scrapy_zyte_api.session_config
 
+If you only need to override the :meth:`SessionConfig.check
+<scrapy_zyte_api.SessionConfig.check>` or :meth:`SessionConfig.params
+<scrapy_zyte_api.SessionConfig.params>` methods for scenarios involving a
+location, you may subclass :class:`~scrapy_zyte_api.LocationSessionConfig`
+instead:
+
+.. autoclass:: scrapy_zyte_api.LocationSessionConfig
+    :members: location_check, location_params
+
 If in a session config implementation or in any other Scrapy component you need
 to tell whether a request is a :ref:`session initialization request
 <session-init>` or not, use :func:`~scrapy_zyte_api.is_session_init_request`:

scrapy_zyte_api/__init__.py

@@ -17,6 +17,7 @@
 )
 from ._session import SESSION_DEFAULT_RETRY_POLICY as _SESSION_DEFAULT_RETRY_POLICY
 from ._session import (
+    LocationSessionConfig,
     ScrapyZyteAPISessionDownloaderMiddleware,
     SessionConfig,
     is_session_init_request,

scrapy_zyte_api/__version__.py

@@ -1 +1 @@
-__version__ = "0.22.0"
+__version__ = "0.22.1"