gilly7 / djangofilmscrud

Companion GitHub Repository for my Medium article "Build a Django CRUD App by Using Class-Based Views"

DJANGO FILMS CRUD TUTORIAL COMPANION CODE

Author: Fabrício Barbacena

Project Description

This repository has the final version of the code I developed in my article/tutorial Build a Django CRUD App by Using Class-Based Views.

I'm putting together this present repository so that it can be used as starter code for future projects of mine. People can also find here the templates code I mentioned in my article.

How to Install the Project

1. You need to have Python installed in your machine (3.8 or higher is recommended);

2. Create a new folder in your machine, go inside it and clone this repository.

3. Create a virtual environment with venv. I called mine .myenv, but you can choose another name you prefer:

python -m venv .myenv

4. Activate the virtual environment. Below is the command for most Linux OS:

source .myenv/bin/activate

Check this Python documentation page if you have doubts about the command to start your virtual environment.

5. Install the required Python modules (django and django-extensions):

pip install -r requirements.txt

IMPORTANT NOTE: The file settings.py is using a secret key setup with the configparser builtin Python module. So:

6. Change the name of config_file_starter.ini to config_file.ini

7. activate the Django shell:

python manage.py shell

8. In the Django shell, execute the following code to generate a new secret key for your project:

from django.core.management.utils import get_random_secret_key print(get_random_secret_key())

9. Copy the new secret key and paste it inside your config_file.ini file, replacing the PutYourSecretKeyHereWithoutQuotationMarks information. Don't use quotation marks here.

10. Run python manage.py makemigrations and python manage.py migrate to create the necessary tables in the database;

11. If you want your films app to be populated with a list of Pixar movies, you can also run this command:

python manage.py runscript load_pixar

How to Use the Project

1. Start the local server with python manage.py runserver. 8000 is the default port used by Django;

2. On your browser, access the address http://localhost:8000;

3. Explore the Films CRUD funcionalities:

• list all films;
• list details from one film;
• create a new film;
• update and delete a film.

Licence

This project is distributed under the MIT licence (see the LICENCE document).