SpeedPatrolling
This tool helps Wikidata editors to patrol recent changes.
For more information, please see the tool’s on-wiki documentation page.
Toolforge setup
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
Local development setup
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.
Contributing
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.)
License
The code in this repository is released under the AGPL v3, as provided in the LICENSE file.