Joeriksson/Beers

A sample Django web app to demonstrate creating a custom django-admin command

Django Beers App

A simple Django app to demonstrate how to create a custom django-admin command. For more information take a look at: https://joeriksson.io/blog/create-a-custom-managepy-command-in-django/

Quick start

1. Clone this repository

https://github.com/Joeriksson/Beers.git

2. Install Docker Desktop to be able to use the docker environment.

3. Create an .env file in the root folder with the the following parameters (You can put anything after the Sendgrid parameters as they are not used in this project):

   ENVIRONMENT='development'
   SENDGRID_PASSWORD=<you sendgrid password>
   SENDGRID_USERNAME=<your sendgrid username>
   SECRET_KEY=<your secret key>
   DEBUG=True
   

4. In the directory where you cloned the repository, run the following command:

   make dev_build

5. Run a migration to build the databases

   make dev_web_exec cmd='python manage.py migrate'

   Then check in you browser that you see a start web page at http://127.0.0.1:8000

6. Create a Django super user to log in to the admin

   make dev_web_exec cmd='python manage.py createsuperuser'

7. Goto http://127.0.0.1:8000/admin and login with the super user account you just created.

8. To get data into the database run the following command from the command prompt:

   make dev_web_exec cmd='python manage.py update_beers'

9. To see a listing of all the beers, goto:

   http://127.0.0.1:8000/beers/

If you want to stop the container run:

make dev_down