handle_urls decorator using a new PageObjectRegistry

CHANGELOG.rst

@@ -5,10 +5,12 @@ Changelog
 TBR
 ------------------
 
+* added a ``PageObjectRegistry`` class which has the  ``handle_urls`` decorator
+  to write override rules.
+* new CLI tool for displaying all available Page Objects: ``web_poet <module>``
 * removed support for Python 3.6
 * added support for Python 3.10
 
-
 0.1.1 (2021-06-02)
 ------------------
 

docs/api_reference.rst

@@ -1,3 +1,5 @@
+.. _`api-reference`:
+
 =============
 API Reference
 =============
@@ -45,3 +47,15 @@ Mixins
 .. autoclass:: web_poet.mixins.ResponseShortcutsMixin
    :members:
    :no-special-members:
+
+
+.. _`api-overrides`:
+
+Overrides
+=========
+
+.. autofunction:: web_poet.handle_urls
+
+.. automodule:: web_poet.overrides
+   :members:
+   :exclude-members: handle_urls

docs/conf.py

@@ -192,4 +192,5 @@
 intersphinx_mapping = {
     'python': ('https://docs.python.org/3', None, ),
     'scrapy': ('https://docs.scrapy.org/en/latest', None, ),
+    'url-matcher': ('https://url-matcher.readthedocs.io/en/stable/', None, ),
 }

docs/index.rst

@@ -33,6 +33,7 @@ and the motivation behind ``web-poet``, start with :ref:`from-ground-up`.
 
    intro/tutorial
    intro/from-ground-up
+   intro/overrides
 
 .. toctree::
    :caption: Reference