docs: mention H2DownloadHandler in settings.rst

This commit is contained in:
Aditya 2020-07-30 18:06:21 +05:30
parent a3fecaf07f
commit d707f8b5d9
1 changed files with 15 additions and 0 deletions

View File

@ -620,6 +620,13 @@ handler (without replacement), place this in your ``settings.py``::
'ftp': None,
}
The default https handler uses HTTP/1.x, to use HTTP/2.0 update :setting:`DOWNLOAD_HANDLERS`
as::
DOWNLOAD_HANDLERS = {
'https': 'scrapy.core.downloader.handlers.http2.H2DownloadHandler',
}
.. setting:: DOWNLOAD_TIMEOUT
DOWNLOAD_TIMEOUT
@ -697,6 +704,14 @@ Optionally, this can be set per-request basis by using the
If :setting:`RETRY_ENABLED` is ``True`` and this setting is set to ``True``,
the ``ResponseFailed([_DataLoss])`` failure will be retried as usual.
.. warning::
This is ignored when :class:`~scrapy.core.downloader.handlers.http2.H2DownloadHandler`
is set as ``https`` download handler in :setting:`DOWNLOAD_HANDLERS`. In
case of data loss error the connection may be corrupted affecting other streams,
hence all streams return with the ``ResponseFailed([InvalidBodyLengthError])``
failure.
.. setting:: DUPEFILTER_CLASS
DUPEFILTER_CLASS