Skip to content

Scrapy, a fast high-level web crawling & scraping framework for Python.

docs: correct point,comma and plural replacements

Ammar Najjard21e1034f046
diff --git a/docs/topics/exporters.rst b/docs/topics/exporters.rst
index 1b8a69ca3..b8d898022 100644
--- a/docs/topics/exporters.rst
+++ b/docs/topics/exporters.rst
@@ -247,7 +247,7 @@ XmlItemExporter
:type item_element: str
The additional keyword arguments of this ``__init__`` method are passed to the
- :class:`BaseItemExporter` ``__init__`` method
+ :class:`BaseItemExporter` ``__init__`` method.
A typical output of this exporter would be::
@@ -352,7 +352,7 @@ PprintItemExporter
accept ``bytes`` (a disk file opened in binary mode, a ``io.BytesIO`` object, etc)
The additional keyword arguments of this ``__init__`` method are passed to the
- :class:`BaseItemExporter` ``__init__`` method
+ :class:`BaseItemExporter` ``__init__`` method.
A typical output of this exporter would be::
@@ -399,7 +399,7 @@ JsonLinesItemExporter
Exports Items in JSON format to the specified file-like object, writing one
JSON-encoded item per line. The additional ``__init__`` method arguments are passed
- to the :class:`BaseItemExporter` ``__init__`` method and the leftover arguments to
+ to the :class:`BaseItemExporter` ``__init__`` method, and the leftover arguments to
the `JSONEncoder`_ ``__init__`` method, so you can use any `JSONEncoder`_
``__init__`` method argument to customize this exporter.
diff --git a/docs/topics/items.rst b/docs/topics/items.rst
index 370409026..cdf60208e 100644
--- a/docs/topics/items.rst
+++ b/docs/topics/items.rst
@@ -237,7 +237,7 @@ Item objects
Return a new Item optionally initialized from the given argument.
- Items replicate the standard `dict API`_, including its ``__init__`` method and
+ Items replicate the standard `dict API`_, including its ``__init__`` method, and
also provide the following additional API members:
.. automethod:: copy
diff --git a/docs/topics/loaders.rst b/docs/topics/loaders.rst
index 72610f645..a4465f88d 100644
--- a/docs/topics/loaders.rst
+++ b/docs/topics/loaders.rst
@@ -265,7 +265,7 @@ There are several ways to modify Item Loader context values:
loader.context['unit'] = 'cm'
2. On Item Loader instantiation (the keyword arguments of Item Loader
- ``__init__`` methodare stored in the Item Loader context)::
+ ``__init__`` method are stored in the Item Loader context)::
loader = ItemLoader(product, unit='cm')
@@ -494,7 +494,7 @@ ItemLoader objects
.. attribute:: default_item_class
An Item class (or factory), used to instantiate items when not given in
- the ``__init__`` method
+ the ``__init__`` method.
.. attribute:: default_input_processor
@@ -509,15 +509,15 @@ ItemLoader objects
.. attribute:: default_selector_class
The class used to construct the :attr:`selector` of this
- :class:`ItemLoader`, if only a response is given in the ``__init__`` method
+ :class:`ItemLoader`, if only a response is given in the ``__init__`` method.
If a selector is given in the ``__init__`` method this attribute is ignored.
This attribute is sometimes overridden in subclasses.
.. attribute:: selector
The :class:`~scrapy.selector.Selector` object to extract data from.
- It's either the selector given in the ``__init__`` methodor one created from
- the response given in the ``__init__`` methodusing the
+ It's either the selector given in the ``__init__`` method or one created from
+ the response given in the ``__init__`` method using the
:attr:`default_selector_class`. This attribute is meant to be
read-only.
@@ -656,7 +656,7 @@ Here is a list of all built-in processors:
Returns the first non-null/non-empty value from the values received,
so it's typically used as an output processor to single-valued fields.
- It doesn't receive any ``__init__`` methodarguments, nor does it accept Loader contexts.
+ It doesn't receive any ``__init__`` method arguments, nor does it accept Loader contexts.
Example::
@@ -667,7 +667,7 @@ Here is a list of all built-in processors:
.. class:: Join(separator=u' ')
- Returns the values joined with the separator given in the ``__init__`` method which
+ Returns the values joined with the separator given in the ``__init__`` method, which
defaults to ``u' '``. It doesn't accept Loader contexts.
When using the default separator, this processor is equivalent to the
@@ -705,7 +705,7 @@ Here is a list of all built-in processors:
those which do, this processor will pass the currently active :ref:`Loader
context <topics-loaders-context>` through that parameter.
- The keyword arguments passed in the ``__init__`` methodare used as the default
+ The keyword arguments passed in the ``__init__`` method are used as the default
Loader context values passed to each function call. However, the final
Loader context values passed to functions are overridden with the currently
active Loader context accessible through the :meth:`ItemLoader.context`
@@ -754,7 +754,7 @@ Here is a list of all built-in processors:
.. class:: SelectJmes(json_path)
- Queries the value using the json path provided to the ``__init__`` methodand returns the output.
+ Queries the value using the json path provided to the ``__init__`` method and returns the output.
Requires jmespath (https://github.com/jmespath/jmespath.py) to run.
This processor takes only one input at a time.
diff --git a/docs/topics/request-response.rst b/docs/topics/request-response.rst
index bf6a02a1d..123c2dde1 100644
--- a/docs/topics/request-response.rst
+++ b/docs/topics/request-response.rst
@@ -137,7 +137,7 @@ Request objects
A string containing the URL of this request. Keep in mind that this
attribute contains the escaped URL, so it can differ from the URL passed in
- the ``__init__`` method
+ the ``__init__`` method.
This attribute is read-only. To change the URL of a Request use
:meth:`replace`.
@@ -400,7 +400,7 @@ fields with form data from :class:`Response` objects.
.. class:: FormRequest(url, [formdata, ...])
- The :class:`FormRequest` class adds a new keyword parameter to the ``__init__`` method The
+ The :class:`FormRequest` class adds a new keyword parameter to the ``__init__`` method. The
remaining arguments are the same as for the :class:`Request` class and are
not documented here.
@@ -473,7 +473,7 @@ fields with form data from :class:`Response` objects.
:type dont_click: boolean
The other parameters of this class method are passed directly to the
- :class:`FormRequest` ``__init__`` method
+ :class:`FormRequest` ``__init__`` method.
.. versionadded:: 0.10.3
The ``formname`` parameter.
@@ -547,7 +547,7 @@ dealing with JSON requests.
.. class:: JsonRequest(url, [... data, dumps_kwargs])
- The :class:`JsonRequest` class adds two new keyword parameters to the ``__init__`` method The
+ The :class:`JsonRequest` class adds two new keyword parameters to the ``__init__`` method. The
remaining arguments are the same as for the :class:`Request` class and are
not documented here.
@@ -755,7 +755,7 @@ TextResponse objects
A string with the encoding of this response. The encoding is resolved by
trying the following mechanisms, in order:
- 1. the encoding passed in the ``__init__`` method`` ``encoding`` argument
+ 1. the encoding passed in the ``__init__`` method ``encoding`` argument
2. the encoding declared in the Content-Type HTTP header. If this
encoding is not valid (ie. unknown), it is ignored and the next
diff --git a/scrapy/utils/misc.py b/scrapy/utils/misc.py
index b3ba2ccec..8060553ad 100644
--- a/scrapy/utils/misc.py
+++ b/scrapy/utils/misc.py
@@ -123,7 +123,7 @@ def rel_has_nofollow(rel):
def create_instance(objcls, settings, crawler, *args, **kwargs):
"""Construct a class instance using its ``from_crawler`` or
- ``from_settings`` ``__init__`` method, if available.
+ ``from_settings`` ``__init__`` methods, if available.
At least one of ``settings`` and ``crawler`` needs to be different from
``None``. If ``settings `` is ``None``, ``crawler.settings`` will be used.