A webserver for hosting scoring services. For more information, see the ORES documentation on MediaWiki.
ORES is based on Python 3. Use pip to install ORES:
pip install ores
(or pip3 install ores
if your distribution defaults to Python 2)
If you're running with the default Redis configuration, you'll need to install a few more optional libraries,
pip install ores[redis]
Then you can easily run a test server by:
ores applications.wsgi
Use the -h
argument to view its usage.
ores applications.wsgi -h
Visit these pages to see if your installation works,
http://localhost:8080/
http://localhost:8080/v2/scores/testwiki/revid/641962088?features=true
As an easy way to run ores for development, download and install docker-compose and then do:
docker-compose build && docker-compose up
ores will be accessible through localhost:8080
For a native installation, make sure you installed dependencies for testing:
pip install -r test-requirements.txt
then run:
py.test .
For docker installation, run:
docker-compose exec ores-worker py.test /ores
ORES provies several utilities:
precached
: Starts a daemon that requests scores for revisions as they happenscore_revisions
: Scores a set of revisions using an ORES APIstress_test
: Scores a large set of revisions at a configurable ratetest_api
: Runs a series of tests against a live ORES API
In order to run any of them, run it through ./utility
wrapper:
./utility test_api -h
For docker installations run it through one of containers:
docker-compose exec ores-worker /ores/utility test_api -h