Provide your own scripts#

You may provide your own scripts as a Pywikibot plugin. All you have to do is to bind your package and define an entry point for pywikibot.

For example having package files like this:

my_pwb_scripts/
├── LICENSE
├── pyproject.toml
├── README.md
├── src/
│   └── wikidata_scripts/
│       ├── __init__.py
│       ├── drop_entities.py
│       └── show_entities.py
└── tests/

Add the following code in your wikidata_scripts.__init__.py:

from pathlib import Path
base_dir = Path(__file__).parent

Add Pywikibot dependency and register the entry point, which is the base_dir above, within your preferred config file:

[project]
dependencies = [
    "pywikibot >= 9.4.0",
]

[project.entry-points."pywikibot"]
scriptspath = "wikidata_scripts:base_dir"

[options]
install_requires =
    pywikibot >= 9.4.0

[options.entry_points]
pywikibot =
    scriptspath = wikidata_scripts:base_dir

from setuptools import setup

setup(
    install_requires=[
        'pywikibot >= 9.4.0',
    ],
    entry_points={
        'pywikibot': [
            'scriptspath = wikidata_scripts:base_dir',
        ]
    }
)

After installing your package scripts are available via pwb wrapper and can be invoked like this:

$ pwb <global options> show_entities <scripts options>

pwb <global options> show_entities <scripts options>