django backend for OSCR

OSCR-server is a backend for OSCR with the intent of recording combat log data.

see requirements.txt

OSCR's base ladders are shipped as Django Fixtures, and additional ladder variants need to be manually created by running a manage.py command.

python3 manage.py genladders

This process happens automatically when running docker compose.

ENABLE_DEBUG=y python3 manage.py migrate
ENABLE_DEBUG=y python3 manage.py runserver

Docker Compose streamlines running an instance of OSCR on a server. There is a sample docker-compose.yaml file and to run OSCR all that needs to be typed is

docker compose up -d

Stopping OSCR can then be done with

docker compose down

python3 manage.py createsuperuser

API Specs are packaged along with our releases.

python3 manage.py generate_swagger -f yaml -u http://127.0.0.1 api-spec.yaml

Use openapi-generator-cli

openapi-generator-cli generate -g python -o client -i api-spec.yaml \
    --additional-properties=packageName=OSCR_django_client,packageVersion=$(cat VERSION)
cd client
python3 -m build .
python3 -m twine upload dist/*