Yet Another Google Code In Leaderboard - API server
- Python
- Flask (with Flask-RESTful)
- MongoDB
Make sure you have Python and pip installed.
The setup is easy as pie, creating virtualenv is recommended.
virtualenv yagcil-server
cd yagcil-server
source bin/activate
git clone http://github.com/yagcil/yagcil-server.git yagcil
cd yagcil
pip install -r requirements.txt
After all run the server with following command:
python runserver.py
Execute update_db.py script to update/setup the database.
- --all Fetch all years
- --active-year Fetch active year
- --archive Fetch all years excluding the active year
- -v, --verbose Be verbose
- -d, --debug Enable debug information
The years are set in Config, YEARS= key.
In yagcil-server there are two types of configurations: debug and production (yagcil.config.debug and yagcil.config.production). You can switch between them using the DEBUG environmental variable.
By default debug config is loaded, set DEBUG=False to switch to production.
rhc set-env DEBUG=False -a app
The documentation of yagcil-server can be found in yagcil wiki on GitHub.
yagcil-server uses pytest for testing.
In order to run the tests correctly YAGCIL_TEST environmental variable must be set to True (case insensitive).
pip install -r requirements-test.txt
YAGCIL_TEST=True py.test
Testing requires a MongoDB instance running on localhost:27015 (no auth).
This app is meant to be running on OpenShift (wsgi.py), but it can also run on Heroku (Procfile is needed) or any other cloud hosting with Python2.7 support (should work on Py3.x too).
Copyright (C) 2015 Michał Proszek and Mateusz Maćkowski
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.