Wikidata tool to make patrolling easier
AGPL-3.0 License
This tool helps Wikidata editors to patrol recent changes.
For more information, please see the tool’s on-wiki documentation page.
On Wikimedia Toolforge, this tool runs under the speedpatrolling
tool name.
Source code resides in ~/www/python/src/
,
a virtual environment is set up in ~/www/python/venv/
,
logs end up in ~/uwsgi.log
.
The uwsgi.ini
configuration file in the source code repository
is symlinked into ~/www/python/uwsgi.ini
.
If the web service is not running for some reason, run the following command:
webservice start
If it’s acting up, try the same command with restart
instead of start
.
Both should pull their config from the service.template
file,
which is symlinked from the source code directory into the tool home directory.
To update the service, run the following commands after becoming the tool account:
webservice shell
source ~/www/python/venv/bin/activate
cd ~/www/python/src
git fetch
git diff @ @{u} # inspect changes
git merge --ff-only @{u}
pip-sync
webservice restart
You can also run the tool locally, which is much more convenient for development (for example, Flask will automatically reload the application any time you save a file).
git clone https://gitlab.wikimedia.org/toolforge-repos/speedpatrolling.git
cd tool-speedpatrolling
pip3 install -r requirements.txt
flask --debug run
If you want, you can do this inside some virtualenv too.
Note that your possibilities to work on this tool are rather limited
unless you request your own OAuth consumer and configure it in a config.yaml
file –
without OAuth credentials, the tool cannot even load a list of unpatrolled changes.
To send a patch, you can submit a pull request on GitHub or a merge request on GitLab. (E-mail / patch-based workflows are also acceptable.)
The code in this repository is released under the AGPL v3, as provided in the LICENSE
file.