Scrapy, a fast high-level web crawling & scraping framework for Python.
Clarify the first-class-citizen nature of asyncio support (#7599)
Adriane7f229f5b2ef
diff --git a/docs/topics/asyncio.rst b/docs/topics/asyncio.rstindex 8efa2559e..1a151044f 100644--- a/docs/topics/asyncio.rst+++ b/docs/topics/asyncio.rst@@ -4,19 +4,27 @@asyncio=======-Scrapy has partial support for :mod:`asyncio`. After you :ref:`install the-asyncio reactor <install-asyncio>`, you may use :mod:`asyncio` and-:mod:`asyncio`-powered libraries in any :doc:`coroutine <coroutines>`.+Scrapy supports :mod:`asyncio` natively. New projects created with+:command:`scrapy startproject` have asyncio enabled by default, and you can use+:mod:`asyncio` and :mod:`asyncio`-powered libraries in any :doc:`coroutine+<coroutines>`.++The rest of this page covers advanced topics. If you are starting a new project,+no additional setup is needed... _install-asyncio:-Installing the asyncio reactor-==============================+Configuring the asyncio reactor+===============================++New projects generated with :command:`scrapy startproject` have the asyncio+reactor configured by default. No manual setup is needed.-To enable :mod:`asyncio` support, your :setting:`TWISTED_REACTOR` setting needs-to be set to ``'twisted.internet.asyncioreactor.AsyncioSelectorReactor'``,-which is the default value.+The :setting:`TWISTED_REACTOR` setting controls which Twisted reactor Scrapy+uses. Its default value is+``'twisted.internet.asyncioreactor.AsyncioSelectorReactor'``, which enables+:mod:`asyncio` support.If you are using :class:`~scrapy.crawler.AsyncCrawlerRunner` or:class:`~scrapy.crawler.CrawlerRunner`, you also need to