Django | Cookbook
Installation
Install current Version (3.2.8)
❯ pip install django==3.2.8
Install next Version (4.0)
❯ pip install --pre django
Check installed version
❯ python -m django --version
❯ django-admin.exe version
First steps
The following steps are based on a summary of the Django Tutorial
Create project
django-admin startproject main cd working_with_django python manage.py migrate python manage.py runserver 8080 python manage.py startapp app_base
Create view
Create view in app_base/views.py
from django.http import HttpResponse def index(request): return HttpResponse("Hello, world. You're at the polls index.")
Add view to app_base/urls.py
from django.urls import path from . import views urlpatterns = [ path('', views.index, name='index'), ]
Add urls to project main/urls.py
from django.contrib import admin from django.urls import include, path urlpatterns = [ path('admin/', admin.site.urls), path('app_base/', include('app_base.urls')), ]
Create admin user
$ python manage.py createsuperuser Username (leave blank to use 'user'): admin Email address: admin@localhost Password: Password (again): Superuser created successfully.
Create data and database
Create database model in app_base/models.py
from django.db import models class Question(models.Model): question_text = models.CharField(max_length=200) pub_date = models.DateTimeField('date published') class Choice(models.Model): question = models.ForeignKey(Question, on_delete=models.CASCADE) choice_text = models.CharField(max_length=200) votes = models.IntegerField(default=0)
Activating models in main/settings.py
INSTALLED_APPS = [ 'app_base.apps.AppBaseConfig', 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', ]
$ python manage.py makemigrations app_base $ python manage.py sqlmigrate app_base 0001
Make app modifiable in the admin (app_base/admin.py)
from django.contrib import admin from .models import Question admin.site.register(Question)
Writing more views
Create views in app_base/views.py
def detail(request, question_id): return HttpResponse("You're looking at question %s." % question_id) def results(request, question_id): response = "You're looking at the results of question %s." return HttpResponse(response % question_id) def vote(request, question_id): return HttpResponse("You're voting on question %s." % question_id)
Add new views into app_base/urls.py
from django.urls import path from . import views urlpatterns = [ path('', views.index, name='index'), path('<int:question_id>/', views.detail, name='detail'), path('<int:question_id>/results/', views.results, name='results'), path('<int:question_id>/vote/', views.vote, name='vote'), ]
Add template in app_base/templates/polls/index.html
{% if latest_question_list %} <ul> {% for question in latest_question_list %} <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li> {% endfor %} </ul> {% else %} <p>No polls are available.</p> {% endif %}
Modify view in app_base/views.py
from django.shortcuts import render ... def index(request): latest_question_list = Question.objects.order_by('-pub_date')[:5] context = {'latest_question_list': latest_question_list} return render(request, 'polls/index.html', context)
Raising a 404 error in app_base/views.py
from django.http import HttpResponse from django.shortcuts import render, get_object_or_404 from .models import Question # ... def detail(request, question_id): question = get_object_or_404(Question, pk=question_id) return render(request, 'polls/detail.html', {'question': question})
Create template app_base/templates/polls/detail.html
<h1>{{ question.question_text }}</h1> <ul> {% for choice in question.choice_set.all %} <li>{{ choice.choice_text }}</li> {% endfor %} </ul>
Removing hardcoded URLs in app_base/templates/polls/index.html
<li> <a href="{% url 'detail' question.id %}">{{ question.question_text }}</a> </li>
The way this works is by looking up the URL definition as specified in the app_base/urs.py
... # the 'name' value as called by the {% url %} template tag path('<int:question_id>/', views.detail, name='detail'), ...
Namespacing URL names in app_base/urls.py
app_name = 'app_base' urlpatterns = [ ...
Then, modify link in app_base/templates/polls/index.html
from url ‘detail’ to url ‘app_base:detail’
<li> <a href="{% url 'app_base:detail' question.id %}">{{ question.question_text }}</a> </li>
Use generic views: Less code is better
Create class in a
pp_views/views.py
class HomeView(generic.TemplateView): template_name = 'index.html'
Create template app_views/templates/index.html
<h1>App Views:</h1> Welcome
Modify app_views/urls.py
urlpatterns = [ path('', views.HomeView.as_view(), name='home'), ]
Add another app to main project
Create app
$ python manage.py startapp app_view
Modify main/urls.py
urlpatterns = [ path('admin/', admin.site.urls), path('app_base/', include('app_base.urls')), path('app_views/', include('app_views.urls')), ]
Add data model in app_views/models.py
from django.db import models class DataItem(models.Model): text = models.CharField(max_length=200) data = models.IntegerField(default=0) def __str__(self): return self.text
Register data in app_views/admin.py
from django.contrib import admin from .models import DataItem admin.site.register(DataItem)
Activate models
$ python manage.py makemigrations app_views $ python manage.py sqlmigrate app_views 0001 $ python manage.py migrate app_views
Navigation / Redirection
Set root page of Django project
When accessing your Django project, the root page will normaly doesn’n show your app homepage.
To change this, you hate to modiy the url handling.
In the following sample, replace <appname> with the name of your app
Define a redirection view in your app (/<appname>/urls.py)
def redirect_to_home(request): return redirect('/<appname>')
Define path in the global urls.py (/main/urls.py)
from django.contrib import admin from django.urls import include, path from django.shortcuts import redirect from <appname> import views urlpatterns = [ path('', views.redirect_to_home, name='home'), path('<appname>/', include('<appname>.urls')), path('admin/', admin.site.urls) ]
Highlight current page in navigation menu
<div class="list-group"> <a href="{% url 'app:upload:basic' %}" class="list-group-item{% if request.path == '/upload/basic/' %} active{% endif %}"> Basic Upload </a> <a href="{% url 'app:upload:progress' %}" class="list-group-item{% if request.path == '/upload/progress/' %} active{% endif %}"> Progress Bar Upload </a> </div>
Using PostgresSQL Database
Install PostgresSQL
Create Superuser
createuser.exe --interactive --pwprompt
Logging
Additional reading
Tutorials
- https://realpython.com/django-redirects/
- https://django-best-practices.readthedocs.io/en/latest/
- https://www.geeksforgeeks.org/tag/python-django/
- https://www.django-rest-framework.org
Testing
Blogs and Posts
- Django Basics for a Beginner at medium.com
- Django Quiz
Resolving problems
Wrong template is used
The template system is using a search approach to find the specified template file, e.g. ‘home.html’.
If you created more than one apps with the same filenames for templates, the first one will be used.
Change the template folders and add the app name, e.g.
template/ app_base/ home.html
Resolving error messages and erors
‘app_name’ is not a registered namespace
One reason for this error is the usage of a namespace in a link.
Back to <a href="{% url 'app_views:home' %}">Home</a>
If you want to use this way of links, you have to define the namespace/appname in your <app>/urls.py
file
app_name = 'app_views' urlpatterns = [ path('', views.HomeView.as_view(), name='home'), ]
dependencies reference nonexistent parent node
- Recreate database and migration files
- Remove all migration files under */migrations/00*.py
- Remove all pycache folders under */__pycache__ and */*/__pycache__
- Run migration again
$ python manage.py makemigrations $ python manage migrate
ValueError: Dependency on app with no migrations: customuser
$ python manage.py makemigrations
Project Structure
Running tasks with Makefile
PREFIX_PKG := app default: grep -E ':\s+#' Makefile clearcache: # Clear Cache python3 manage.py clearcache run: # Run Server python3 manage.py runserver 8000 deploy: # Deploy rm -rf dist $(PREFIX_PKG)* rm -rf polls.dist cd polls && python3 setup.py sdist mkdir polls.dist && mv polls/dist/* polls/$(PREFIX_PKG)* polls.dist install_bootstrap: # Install Bootstrap Library cd .. && yarn add bootstrap rm -rf polls/static/bootstrap mkdir polls/static/bootstrap cp -R ../node_modules/bootstrap/dist/* polls/static/bootstrap install_jquery: # Install jQuery Library cd .. && yarn add jquery rm -rf polls/static/jquery mkdir polls/static/jquery cp ../node_modules/jquery/dist/* polls/static/jquery install_bootstrap_from_source: # Install Bootstrap from Source mkdir -p install && \ wget https://github.com/twbs/bootstrap/releases/download/v4.1.3/bootstrap-4.1.3-dist.zip -O install/bootstrap-4.1.3-dist.zip && \ unzip install/bootstrap-4.1.3-dist.zip -d polls/static/bootstrap/4.1.3