Simpl Games Framework API Project
This project requires PostgreSql 9+ and uses Python 3.6.x and Django 1.11.x
$ git clone firstname.lastname@example.org:simplworld/simpl-games-api.git $ cd simpl-games-api $ mkvirtualenv simpl-games-api $ add2virtualenv . $ pip install -r requirements.txt
Create PostgreSQL database
Create a database:
$ createdb simpl
Sync models to database:
$ ./manage.py migrate
Create a superuser for testing
Create a superuser account to access the admin:
$ ./manage.py createsuperuser
For local development, run:
$ ./manage.py create_simpl_user
This creates a super user with id 'email@example.com' and password 'simpl' and ensures test users can be assigned passwords in scripts.
DJANGO_SETTINGS_MODULE to use:
$ export DJANGO_SETTINGS_MODULE=config.settings.local
Start the web server
$ ./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.
runserver does not support
Keep-Alive requests, so we use
gunicorn instead in production.
A command to run gunicorn is included in
$ ./manage.py run_gunicorn
$ 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 patch
Then push to the repo:
$ git push && git push --tags
Generate updated ERD of Models
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
Check Deployed System
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.
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/ --firstname.lastname@example.org' --password='sumpun' --game=sim
Count game model objects
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'.
Copyright © 2018 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.