mirror of
https://github.com/scrapy/scrapy.git
synced 2025-02-24 07:43:48 +00:00
0ef570f6f0
Added the missing dot. (+1 squashed commit) Squashed commits: [2198972] Update exceptions.rst There are namely no constructors in classes in Python but an ``__init__`` method instead.
72 lines
1.5 KiB
ReStructuredText
72 lines
1.5 KiB
ReStructuredText
.. _topics-exceptions:
|
|
|
|
==========
|
|
Exceptions
|
|
==========
|
|
|
|
.. module:: scrapy.exceptions
|
|
:synopsis: Scrapy exceptions
|
|
|
|
.. _topics-exceptions-ref:
|
|
|
|
Built-in Exceptions reference
|
|
=============================
|
|
|
|
Here's a list of all exceptions included in Scrapy and their usage.
|
|
|
|
DropItem
|
|
--------
|
|
|
|
.. exception:: DropItem
|
|
|
|
The exception that must be raised by item pipeline stages to stop processing an
|
|
Item. For more information see :ref:`topics-item-pipeline`.
|
|
|
|
CloseSpider
|
|
-----------
|
|
|
|
.. exception:: CloseSpider(reason='cancelled')
|
|
|
|
This exception can be raised from a spider callback to request the spider to be
|
|
closed/stopped. Supported arguments:
|
|
|
|
:param reason: the reason for closing
|
|
:type reason: str
|
|
|
|
For example::
|
|
|
|
def parse_page(self, response):
|
|
if 'Bandwidth exceeded' in response.body:
|
|
raise CloseSpider('bandwidth_exceeded')
|
|
|
|
IgnoreRequest
|
|
-------------
|
|
|
|
.. exception:: IgnoreRequest
|
|
|
|
This exception can be raised by the Scheduler or any downloader middleware to
|
|
indicate that the request should be ignored.
|
|
|
|
NotConfigured
|
|
-------------
|
|
|
|
.. exception:: NotConfigured
|
|
|
|
This exception can be raised by some components to indicate that they will
|
|
remain disabled. Those components include:
|
|
|
|
* Extensions
|
|
* Item pipelines
|
|
* Downloader middlewares
|
|
* Spider middlewares
|
|
|
|
The exception must be raised in the component's ``__init__`` method.
|
|
|
|
NotSupported
|
|
------------
|
|
|
|
.. exception:: NotSupported
|
|
|
|
This exception is raised to indicate an unsupported feature.
|
|
|