Hauki

Hauki makes it easier to browse, search and display Lexemes on Wikidata.

For more information, please see the tool’s on-wiki documentation page.

Toolforge setup

On Wikimedia Toolforge, this tool runs under the hauki 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.

If the web service is not running for some reason, run the following command:

webservice --backend=kubernetes python3.5 start

If it’s acting up, try the same command with restart instead of start.

To update the service, run the following commands after becoming the tool account:

webservice --backend=kubernetes python3.5 shell
source ~/www/python/venv/bin/activate
cd ~/www/python/src
git fetch
git diff @ @{u} # inspect changes
git merge --ff-only @{u}
pip3 install -r requirements.txt
webservice --backend=kubernetes python3.5 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://phabricator.wikimedia.org/source/tool-hauki.git
cd tool-hauki
pip3 install -r requirements.txt
FLASK_APP=app.py FLASK_ENV=development flask run

If you want, you can do this inside some virtualenv too.

License

The code in this repository is released under the AGPL v3, as provided in the LICENSE file.