Quizzes app

An example Django app that serves quizzes and lets people know how they scored. Quizzes and their questions are stored in a PostGreSQL database. There is no user authentication or per-user data stored.

Try it out at:

https://django-example-quizsite.azurewebsites.net/quizzes/

Local development

Install the requirements and Git hooks:

This project has devcontainer support, so you can open it in Github Codespaces or local VS Code with the Dev Containers extension. If you're unable to open the devcontainer, then it's best to first create a Python virtual environment and activate that.

Install the requirements:

pip install -r requirements.txt

Create an .env file using .env.sample as a guide. Set the value of DBNAME to the name of an existing database in your local PostgreSQL instance. Set the values of DBHOST, DBUSER, and DBPASS as appropriate for your local PostgreSQL instance. If you're in the devcontainer, copy the values from .env.sample.devcontainer.
Run the migrations:

python manage.py migrate

Run the local server:

python manage.py runserver

Navigate to "/quizzes" (since no "/" route is defined) to verify server is working.

Admin

This app comes with the built-in Django admin.

Create a superuser:

python manage.py createsuperuser

Restart the server and navigate to "/admin"
Login with the superuser credentials.

Testing

Run tests:

python manage.py collectstatic
coverage run --source='.' manage.py test quizzes
coverage report

The same tests are also run as a Github action.

Deployment

This repository is set up for deployment on Azure App Service (w/PostGreSQL flexible server) using the configuration files in the infra folder.

Sign up for a free Azure account
Install the Azure Dev CLI. (If you open this repository in Codespaces or with the VS Code Dev Containers extension, that part will be done for you.)
Provision and deploy all the resources:

azd up

To be able to access /admin, you'll need a Django superuser. Navigate to the Azure Portal for the App Service, select SSH, and run this command:

python manage.py createsuperuser