Metadata-Version: 2.0
Name: ores
Version: 1.2.0
Summary: A webserver for hosting scorer models.
Home-page: https://github.com/wikimedia/ores
Author: Aaron Halfaker
Author-email: ahalfaker@wikimedia.org
License: MIT
Description-Content-Type: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3
Requires-Dist: celery (<3.1.999,>=3.1.18)
Requires-Dist: docopt (>=0.6.2,<0.6.999)
Requires-Dist: flask (>=0.10.1,<0.10.999)
Requires-Dist: flask-jsonpify (>=1.5.0,<1.5.999)
Requires-Dist: flask-swaggerui (>=0.0.1,<0.0.999)
Requires-Dist: flask-wikimediaui (>=0.0.1,<0.0.999)
Requires-Dist: mwapi (>=0.5.0,<0.5.999)
Requires-Dist: pytest (>=3.2.2,<3.2.999)
Requires-Dist: pyyaml (==3.11)
Requires-Dist: revscoring (>=2.2.2,<2.2.999)
Requires-Dist: sseclient (>=0.0.18)
Requires-Dist: stopit (>=1.1.1,<1.1.999)
Requires-Dist: yamlconf (<0.2.999,>=0.2.2)
Provides-Extra: redis
Requires-Dist: pylru; extra == 'redis'
Requires-Dist: redis; extra == 'redis'

[![Build Status](https://travis-ci.org/wikimedia/ores.svg)](https://travis-ci.org/wikimedia/ores)
[![Test coverage](https://codecov.io/gh/wikimedia/ores/branch/master/graph/badge.svg)](https://codecov.io/gh/wikimedia/ores)

Objective Revision Evaluation Service
=====================================
A webserver for hosting scoring services. For more information, see [the ORES documentation on MediaWiki](https://mediawiki.org/wiki/ORES).

Installation
============
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``

Running a development server
============================
We recommend that you set up a python "virtual environment".  We put together
[this guide](https://gist.github.com/halfak/9f4830895496af9e9731) to help you
get everything set up.  

Install requirements AND the test-requirements in order to run the default
test server and experiment with different scoring strategies.

* `$ pip install -r requirements.txt`
* `$ pip install -r test-requirements.txt`

Run a test server as ORES using the `./utility`, so local changes are
reflected: Use `-h` to view its usage

* `$ ./utility applications.wsgi`

Check if everything is running on `http://localhost:8080`.

Authors
=======
* [Aaron Halfaker](https://github.com/halfak)
* [Yuvi Panda](https://github.com/yuvipanda)
* [Amir Sarabadani](https://github.com/Ladsgroup)
* [Justin Du](https://github.com/mdew192837)
* [Adam Wight](https://github.com/adamwight)


