This project requires PostgreSQL 9+ and Python 3.6.x.

In a virtual environment:

$ git clone git@github.com:simplworld/simpl-games-api.git
$ cd simpl-games-api
$ pip install -r requirements.txt

Create a database:

$ createdb simpl

Sync models to database:

$ ./manage.py migrate

Create a super user account to access the admin:

$ ./manage.py createsuperuser

For local development, run:

$ ./manage.py create_simpl_user

This creates a super user with id 'simpl@simpl.world' and password 'simpl' and ensures test users can be assigned passwords in scripts.

Setup the DJANGO_SETTINGS_MODULE to use:

$ export DJANGO_SETTINGS_MODULE=config.settings.local

$ ./manage.py runserver 0.0.0.0:8100

NOTE: You may need to create a directory named staticfiles and run manage.py collectstatic to have the admin media show up correctly.

Django's runserver does not support Keep-Alive requests, so we use gunicorn instead in production.

A command to run gunicorn is included in simpl-games-api:

$ ./manage.py run_gunicorn

Run py.test:

$ export DJANGO_SETTINGS_MODULE=config.settings.test
$ py.test

Do not commit code if tests are failing.

To release a new version of the docker image, tag a new version with bumpversion:

$ bumpversion patch

Then push to the repo:

$ git push && git push --tags

If you are using an environment that supports running Pillow, uncomment the Pillow line in requirements.txt and run:

$ pip install -r requirements.txt --upgrade
$ ./manage.py graph_models games -o docs/models.png

We have a simple management command which will check DNS, HTTP/HTTPS connectivity in general, ability to login to the admin, that the API responds properly and that the game slug in question is installed. To use this command you MUST have a valid admin login to use the command.

Simple usage:

manage.py check_deploy https://simpl.mine.ed/

The command will prompt you for your admin user's email address (aka username), password, and game slug. Or you can provide them on the command line like this:

manage.py check_deploy https://simpl.mine.ed/ --email='me@mine.ed' --password='sumpun' --game=sim

Management command that print counts of all simpl model objects based on game slug. For example, run

./manage.py count_game_models -s calc

to see counts of all model objects for a game with slug 'calc'.

• API Docs
• Simpl apis
• Django Admin

Copyright © 2019 The Wharton School,  The University of Pennsylvania 

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 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 General Public License for more details.