Support Scrapy 2.14

.github/workflows/test.yml

@@ -17,23 +17,23 @@ jobs:
       fail-fast: false
       matrix:
         include:
-        - python-version: '3.9'
+        - python-version: '3.10'
           toxenv: min-scrapy-2x0
-        - python-version: '3.9'
+        - python-version: '3.10'
           toxenv: min-scrapy-2x1
-        - python-version: '3.9'
+        - python-version: '3.10'
           toxenv: min-scrapy-2x3
-        - python-version: '3.9'
+        - python-version: '3.10'
           toxenv: min-scrapy-2x4
-        - python-version: '3.9'
+        - python-version: '3.10'
           toxenv: min-scrapy-2x5
-        - python-version: '3.9'
+        - python-version: '3.10'
           toxenv: min-scrapy-2x6
-        - python-version: '3.9'
+        - python-version: '3.10'
           toxenv: min-scrapy-2x7
-        - python-version: '3.9'
+        - python-version: '3.10'
           toxenv: min-extra
-        - python-version: '3.9'
+        - python-version: '3.10'
           toxenv: min-provider
         - python-version: '3.10'
           toxenv: min-x402

docs/setup.rst

@@ -18,14 +18,12 @@ You need at least:
 -   A :ref:`Zyte API <zyte-api>` subscription (there’s a :ref:`free trial
     <zapi-trial>`).
 
--   Python 3.9+
+-   Python 3.10+
 
 -   Scrapy 2.0.1+
 
 :doc:`scrapy-poet <scrapy-poet:index>` integration requires Scrapy 2.6+.
 
-:ref:`x402 support <x402>` requires Python 3.10+.
-
 
 .. _install:
 
@@ -38,14 +36,13 @@ For a basic installation:
 
     pip install scrapy-zyte-api
 
-For :ref:`scrapy-poet integration <scrapy-poet>`:
+For :ref:`scrapy-poet integration <scrapy-poet>`,  install the ``provider`` extra:
 
 .. code-block:: shell
 
     pip install scrapy-zyte-api[provider]
 
-For :ref:`x402 support <x402>`, make sure you have Python 3.10+ and install
-the ``x402`` extra:
+For :ref:`x402 support <x402>`,  install the ``x402`` extra:
 
 .. code-block:: shell
 

docs/usage/automap.rst

@@ -19,7 +19,7 @@ For example:
     class SampleQuotesSpider(scrapy.Spider):
         name = "sample_quotes"
 
-        def start_requests(self):
+        async def start(self):
             yield scrapy.Request(
                 url="https://quotes.toscrape.com/",
                 meta={

docs/usage/manual.rst

@@ -22,7 +22,7 @@ For example:
     class SampleQuotesSpider(scrapy.Spider):
         name = "sample_quotes"
 
-        def start_requests(self):
+        async def start(self):
             yield scrapy.Request(
                 url="https://quotes.toscrape.com/",
                 meta={
@@ -48,7 +48,7 @@ remember to also request :http:`request:httpResponseHeaders`:
     class SampleQuotesSpider(scrapy.Spider):
         name = "sample_quotes"
 
-        def start_requests(self):
+        async def start(self):
             yield scrapy.Request(
                 url="https://quotes.toscrape.com/",
                 meta={

pyproject.toml

@@ -16,13 +16,12 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
 ]
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 # Sync with [pinned] @ tox.ini
 dependencies = [
     "packaging>=20.0",
@@ -120,5 +119,13 @@ testpaths = [
 ]
 minversion = "6.0"
 filterwarnings = [
-    "ignore::DeprecationWarning:twisted.web.http",
+    "ignore::DeprecationWarning:twisted\\.web\\.http",
+    "ignore::DeprecationWarning:scrapy\\.core\\.downloader\\.contextfactory",  # https://github.com/scrapy/scrapy/issues/3288
+
+    # scrapy-poet warnings for Scrapy 2.14:
+    "ignore:CollectorPipeline\\.:scrapy.exceptions.ScrapyDeprecationWarning",
+    "ignore:DownloaderStatsMiddleware\\.:scrapy.exceptions.ScrapyDeprecationWarning",
+    "ignore:.*?InjectionMiddleware\\.:scrapy.exceptions.ScrapyDeprecationWarning",
+    "ignore:RetryMiddleware\\.process_spider_exception\\(\\):scrapy.exceptions.ScrapyDeprecationWarning",
+    "ignore::scrapy.exceptions.ScrapyDeprecationWarning:scrapy_poet",
 ]

scrapy_zyte_api/_middlewares.py

@@ -1,12 +1,19 @@
 from logging import getLogger
-from typing import cast
+from warnings import warn
 
-from scrapy import Request
-from scrapy.exceptions import IgnoreRequest
+from scrapy import Request, Spider
+from scrapy.exceptions import IgnoreRequest, ScrapyDeprecationWarning
+from scrapy.utils.python import global_object_name
 from zyte_api import RequestError
 
 from ._params import _ParamParser
-from .utils import _AUTOTHROTTLE_DONT_ADJUST_DELAY_SUPPORT
+from .utils import (
+    _AUTOTHROTTLE_DONT_ADJUST_DELAY_SUPPORT,
+    _GET_SLOT_NEEDS_SPIDER,
+    _LOG_DEFERRED_IS_DEPRECATED,
+    _close_spider,
+    _schedule_coro,
+)
 
 logger = getLogger(__name__)
 _start_requests_processed = object()
@@ -27,7 +34,19 @@ def __init__(self, crawler):
             not crawler.settings.getbool("AUTOTHROTTLE_ENABLED"),
         )
 
-    def slot_request(self, request, spider, force=False):
+    def slot_request(
+        self, request: Request, spider: Spider | None = None, force: bool = False
+    ):
+        if spider is not None:
+            warn(
+                f"Passing a 'spider' argument to "
+                f"{global_object_name(self.__class__)}.slot_request() is "
+                f"deprecated and the argument will be removed in a future "
+                f"scrapy-zyte-api version.",
+                category=ScrapyDeprecationWarning,
+                stacklevel=2,
+            )
+
         if not force and self._param_parser.parse(request) is None:
             return
 
@@ -38,12 +57,13 @@ def slot_request(self, request, spider, force=False):
         try:
             slot_id = downloader.get_slot_key(request)
         except AttributeError:  # Scrapy < 2.12
-            slot_id = downloader._get_slot_key(request, spider)
+            slot_id = downloader._get_slot_key(request, self._crawler.spider)
         if not isinstance(slot_id, str) or not slot_id.startswith(self._slot_prefix):
             slot_id = f"{self._slot_prefix}{slot_id}"
             request.meta["download_slot"] = slot_id
         if not self._preserve_delay:
-            _, slot = downloader._get_slot(request, spider)
+            args = (self._crawler.spider,) if _GET_SLOT_NEEDS_SPIDER else ()
+            _, slot = downloader._get_slot(request, *args)
             slot.delay = 0
 
 
@@ -65,6 +85,7 @@ def __init__(self, crawler) -> None:
         crawler.signals.connect(
             self._start_requests_processed, signal=_start_requests_processed
         )
+        self._crawler = crawler
 
     def _get_spm_mw(self):
         spm_mw_classes = []
@@ -89,15 +110,15 @@ def _get_spm_mw(self):
                 return middleware
         return None
 
-    def _check_spm_conflict(self, spider):
+    def _check_spm_conflict(self):
         checked = getattr(self, "_checked_spm_conflict", False)
         if checked:
             return
         self._checked_spm_conflict = True
         settings = self._crawler.settings
         in_transparent_mode = settings.getbool("ZYTE_API_TRANSPARENT_MODE", False)
         spm_mw = self._get_spm_mw()
-        spm_is_enabled = spm_mw and spm_mw.is_enabled(spider)
+        spm_is_enabled = spm_mw and spm_mw.is_enabled(self._crawler.spider)
         if not in_transparent_mode or not spm_is_enabled:
             return
         logger.error(
@@ -114,35 +135,31 @@ def _check_spm_conflict(self, spider):
             "request.meta to set dont_proxy to True and zyte_api_automap "
             "either to True or to a dictionary of extra request fields."
         )
-        from twisted.internet import reactor
-        from twisted.internet.interfaces import IReactorCore
-
-        reactor = cast(IReactorCore, reactor)
-        reactor.callLater(
-            0, self._crawler.engine.close_spider, spider, "plugin_conflict"
-        )
+        _close_spider(self._crawler, "plugin_conflict")
 
     def _start_requests_processed(self, count):
         self._total_start_request_count = count
         self._maybe_close()
 
-    def process_request(self, request, spider):
-        self._check_spm_conflict(spider)
+    def process_request(self, request: Request, spider: Spider | None = None):
+        self._check_spm_conflict()
 
         if self._param_parser.parse(request) is None:
             return
 
         self._request_count += 1
         if self._max_requests and self._request_count > self._max_requests:
-            self._crawler.engine.close_spider(spider, "closespider_max_zapi_requests")
+            _close_spider(self._crawler, "closespider_max_zapi_requests")
             raise IgnoreRequest(
                 f"The request {request} is skipped as {self._max_requests} max "
                 f"Zyte API requests have been reached."
             )
 
-        self.slot_request(request, spider, force=True)
+        self.slot_request(request, force=True)
 
-    def process_exception(self, request, exception, spider):
+    def process_exception(
+        self, request: Request, exception: Exception, spider: Spider | None = None
+    ):
         if (
             not request.meta.get("is_start_request")
             or not isinstance(exception, RequestError)
@@ -162,60 +179,66 @@ def _maybe_close(self):
             "Stopping the spider, all start requests failed because they "
             "were pointing to a domain forbidden by Zyte API."
         )
-        self._crawler.engine.close_spider(
-            self._crawler.spider, "failed_forbidden_domain"
-        )
+        _close_spider(self._crawler, "failed_forbidden_domain")
 
 
 class ScrapyZyteAPISpiderMiddleware(_BaseMiddleware):
     def __init__(self, crawler):
         super().__init__(crawler)
-        self._send_signal = crawler.signals.send_catch_log
+        if _LOG_DEFERRED_IS_DEPRECATED:
+            self._send_signal = crawler.signals.send_catch_log_async
+        else:
+            self._send_signal = crawler.signals.send_catch_log_deferred
 
     @staticmethod
     def _get_header_set(request):
         return {header.strip().lower() for header in request.headers}
 
-    async def process_start(self, start):
+    async def process_start(self, start, spider: Spider | None = None):
         # Mark start requests and reports to the downloader middleware the
         # number of them once all have been processed.
         count = 0
         async for item_or_request in start:
             if isinstance(item_or_request, Request):
                 count += 1
                 item_or_request.meta["is_start_request"] = True
-                self._process_output_request(item_or_request, None)
+                self._process_output_request(item_or_request)
             yield item_or_request
-        self._send_signal(_start_requests_processed, count=count)
+        await self._send_signal(_start_requests_processed, count=count)
 
-    def process_start_requests(self, start_requests, spider):
+    def process_start_requests(self, start_requests, spider: Spider):
         count = 0
         for item_or_request in start_requests:
             if isinstance(item_or_request, Request):
                 count += 1
                 item_or_request.meta["is_start_request"] = True
-                self._process_output_request(item_or_request, spider)
+                self._process_output_request(item_or_request)
             yield item_or_request
-        self._send_signal(_start_requests_processed, count=count)
+        if _LOG_DEFERRED_IS_DEPRECATED:
+            _schedule_coro(self._send_signal(_start_requests_processed, count=count))
+        else:
+            self._send_signal(_start_requests_processed, count=count)
 
-    def _process_output_request(self, request, spider):
+    def _process_output_request(self, request: Request):
         if "_pre_mw_headers" not in request.meta:
             request.meta["_pre_mw_headers"] = self._get_header_set(request)
-        self.slot_request(request, spider)
+        self.slot_request(request)
 
-    def _process_output_item_or_request(self, item_or_request, spider):
+    def _process_output_item_or_request(self, item_or_request):
         if not isinstance(item_or_request, Request):
             return
-        self._process_output_request(item_or_request, spider)
+        self._process_output_request(item_or_request)
 
-    def process_spider_output(self, response, result, spider):
+    def process_spider_output(self, response, result, spider: Spider | None = None):
         for item_or_request in result:
-            self._process_output_item_or_request(item_or_request, spider)
+            self._process_output_item_or_request(item_or_request)
             yield item_or_request
 
-    async def process_spider_output_async(self, response, result, spider):
+    async def process_spider_output_async(
+        self, response, result, spider: Spider | None = None
+    ):
         async for item_or_request in result:
-            self._process_output_item_or_request(item_or_request, spider)
+            self._process_output_item_or_request(item_or_request)
             yield item_or_request
 
 
@@ -230,22 +253,24 @@ def __init__(self, crawler):
         )
         self._param_parser = _ParamParser(crawler, cookies_enabled=False)
 
-    def process_spider_output(self, response, result, spider):
+    def process_spider_output(self, response, result, spider: Spider | None = None):
         for item_or_request in result:
-            self._process_output_item_or_request(item_or_request, spider)
+            self._process_output_item_or_request(item_or_request)
             yield item_or_request
 
-    async def process_spider_output_async(self, response, result, spider):
+    async def process_spider_output_async(
+        self, response, result, spider: Spider | None = None
+    ):
         async for item_or_request in result:
-            self._process_output_item_or_request(item_or_request, spider)
+            self._process_output_item_or_request(item_or_request)
             yield item_or_request
 
-    def _process_output_item_or_request(self, item_or_request, spider):
+    def _process_output_item_or_request(self, item_or_request):
         if not isinstance(item_or_request, Request):
             return
-        self._process_output_request(item_or_request, spider)
+        self._process_output_request(item_or_request)
 
-    def _process_output_request(self, request, spider):
+    def _process_output_request(self, request: Request):
         if self._is_zyte_api_request(request):
             request.meta.setdefault("referrer_policy", self._default_policy)