Manual:Pywikibot/pagegenerators.py

pagegenerators.py is a  script used to generate list of pages for other scripts.

This module offers a wide variety of page generators. A page generator is an object that is iterable (see https://www.python.org/dev/peps/pep-0255/) and that yields page objects which other scripts can then use.

Command line usage
The pagegenerators.py may not be executed directly. Instead, the script  can be used.

Example:

This will return, in standard output, a list of all pages containing "foobar", as returned by MediaWiki's search engine.

See  for more details.

Calls from another script
Category crawler:

Subcategories explorer:

MySQL requests (see ):

Unicode recommendation
The following code returns KeyError: 'query' because of the special character:

If searching in user and mediawiki namespaces, it would look like

Consequently, [https://dev.w3.org/html5/html-author/charref an encoding conversion] is needed: