The name of this software is django-brambling. The name for use within the content of the application and for marketing purposes is Dancerfly.

As of April 2020, Dancerfly experimentally allows you to use Docker Compose to spin up a development environment with one line. If you prefer to use the older method of relying on your system Python, skip below to "Development Using System Python."

These instructions assume you have the following software on your machine:

• Docker Compose

Here's a one-liner to get you going. This runs a database container using PostgreSQL and an application container with the Django application. It will run the necessary initial database migrations.

docker-compose up

Use docker-compose exec to run commands on a currently running application container or docker-compose run to start a container and run a command:

docker-compose exec ./manage.py makemigrations
docker-compose run pipenv install bleach

You can attach interactively to the Django process using this command:

docker attach (docker-compose ps -q django)

Learn more about Docker Compose in the documentation.

Use these instructions if you'd rather not use Docker Compose.

The installation instructions below assume you have the following software on your machine:

• Python 2.7.x
• pipenv

Here's a one-liner to get you going!

pipenv install && pipenv run ./manage.py migrate && pipenv run ./manage.py runserver

This will install all project dependencies, set up the database, and start a server. At this point you can visit http://127.0.0.1:8000 in your favorite browser and see your locally running copy of Dancerfly!

Set the following optional environment variables in a local .env file if the default values don't work for you. See pipenv's documentation for more details.