This is a Django web application that utilises HTML data attributes to implement dynamic formset management and is designed to allow the students of Selly Oak to create and share recipes.
An installation of Python version 3.5 or later is required to run the Django site locally.
Clone the source from this repository.
git clone https://github.com/martindes01/bellyoak.git
cd bellyoak
Create and activate a Python virtual environment, specifying a suitable path <path>
.
A common name for the environment directory is .venv
.
python3 -m venv <path>
source <path>/Scripts/activate
Install the Python dependencies listed in requirements.txt.
pip install --requirement requirements.txt
To create or update the database, execute the makemigrations
and migrate
commands of the manage.py
script.
These commands create schema migrations based on changes to the models and apply these migrations to the database, respectively.
python3 manage.py makemigrations
python3 manage.py migrate
To run the site locally, execute the runserver
command of the manage.py
script, optionally specifying the local IP address <address>
and port number <port>
.
This will serve the site to <address>:<port>
.
If unspecified, <address>
defaults to localhost
and <port>
defaults to 8000
.
python3 manage.py runserver [[<address>:]<port>]
To populate the database with sample data, run the populate_bellyoak.py
script.
python3 populate_bellyoak.py
To manage the database, execute the createsuperuser
command of the manage.py
script and follow the prompts.
This will create a superuser account with access to the administration interface at <address>:<port>/admin/
.
python3 manage.py createsuperuser
This project is distributed under the terms of the MIT License. See LICENSE for more information.