Search icon
Subscription
0
Cart icon
Close icon
You have no products in your basket yet
Save more on your purchases!
Savings automatically calculated. No voucher code required
Arrow left icon
All Products
Best Sellers
New Releases
Books
Videos
Audiobooks
Learning Hub
Newsletters
Free Learning
Arrow right icon
$9.99 | ALL EBOOKS & VIDEOS
Over 7,000 tech titles at $9.99 each with AI-powered learning assistants on new releases
Django 4 for the Impatient
Django 4 for the Impatient

Django 4 for the Impatient: Learn the core concepts of Python web development with Django in one weekend

By Greg Lim , Daniel Correa
$24.99 $9.99
Book Jun 2022 190 pages 1st Edition
eBook
$24.99 $9.99
Print
$30.99
Subscription
$15.99 Monthly
eBook
$24.99 $9.99
Print
$30.99
Subscription
$15.99 Monthly

What do you get with eBook?

Product feature icon Instant access to your Digital eBook purchase
Product feature icon Download this book in EPUB and PDF formats
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
Buy Now
Table of content icon View table of contents Preview book icon Preview Book

Django 4 for the Impatient

Chapter 2: Understanding the Project Structure and Creating Our First App

Django projects contain a predefined structure with some key files. In this chapter, we will discuss the Django project structure and how some of those files are used to configure our web applications. Furthermore, Django projects are composed of one or more apps. We will learn how to create a movie app and how to register it inside our Django project.

In this chapter, we will cover the following topics:

  • Understanding the project structure
  • Creating our first app

Technical requirements

In this chapter, we will be using Python 3.8+. Additionally, we will be using the Visual Studio (VS) Code editor for building our web application in this book, which you can download from https://code.visualstudio.com/.

The code for this chapter is located at https://github.com/PacktPublishing/Django-4-for-the-Impatient/tree/main/Chapter02/moviereviewsproject.

Understanding the project structure

Let's look at the project files that were created for us in Chapter 1, Installing Python and Django, in the Installing Django section. Open the moviereviews project folder in VS Code. You will see the following elements:

Figure 2.1 – The MOVIEREVIEWS directory structure

Figure 2.1 – The MOVIEREVIEWS directory structure

Let's learn about each of these elements.

The moviereviews folder

As you can see in Figure 2.1, there is a folder with the same name as the folder we opened in VS Code originally – moviereviews. To avoid confusion and to distinguish between the two moviereviews folders, we will keep the inner moviereviews folder as it is and rename the outer folder moviereviewsproject.

After the renaming, open the inner moviereviews folder. You will see the following elements, as shown in Figure 2.2:

Figure 2.2 – The MOVIEREVIEWSPROJECT directory structure

Figure 2.2 – The MOVIEREVIEWSPROJECT directory structure

Let's briefly look at all the elements in the moviereviews folder:

  • __pycache__: This folder stores compiled bytecode when we generate our project. You can largely ignore this folder. Its purpose is to make your project start a little faster by caching the compiled code that can then be readily executed.
  • __init__.py: This file specifies what to run when Django launches for the first time.
  • asgi.py: This file allows an optional Asynchronous Server Gateway Interface (ASGI) to run.
  • settings.py: The settings.py file is an important file that controls our project's settings. It contains several properties:
    • BASE_DIR: Determines where on your machine the project is situated.
    • SECRET_KEY: Used when you have data flowing in and out of your website. Do not ever share this with others.
    • DEBUG: Our site can run in debug mode or not. In debug mode, we get detailed information on errors – for instance, if we try to run http://localhost:8000/123 in the browser, we will see a Page not found (404) error:
Figure 2.3 – Accessing an invalid application route

Figure 2.3 – Accessing an invalid application route

Note

It is important to remember the following:

  • When deploying our app to production, we should set DEBUG to False. If DEBUG = False, we will see a generic 404 page without error details.
  • While developing our project, we should set DEBUG = True to help us with debugging.
  • INSTALLED_APPS: Allows us to bring different pieces of code into our project. We will see this in action later.
  • MIDDLEWARE: Refers to built-in Django functions to process application requests/responses, which include authentication, session, and security.
  • ROOT_URLCONF: Specifies where our URLs are.
  • TEMPLATES: Defines the template engine class, the list of directories where the engine should look for template source files, and specific template settings.
  • AUTH_PASSWORD_VALIDATORS: Allow us to specify the validations that we want on passwords – for example, a minimum length.

There are some other properties in settings.py, such as LANGUAGE_CODE and TIME_ZONE, but we have focused on the more important properties in the preceding list. We will later revisit this file and see how relevant it is in developing our site.

  • urls.py: This file tells Django which pages to render in response to a browser or URL request. For example, when someone enters the http://localhost:8000/123 URL, the request comes into urls.py and gets routed to a page based on the paths specified there. We will later add paths to this file and better understand how it works.
  • Wsgi.py: This file stands for the Web Server Gateway Interface (WSGI) and helps Django serve our web pages. Both files are used when deploying our app. We will revisit them later when we deploy our app.

manage.py

The manage.py file seen in Figure 2.1 and Figure 2.2 is an element we should not tinker with. The file helps us to perform administrative operations. For example, we earlier ran the following command in Chapter 1, Installing Python and Django, in the Running the Django local web server section:

python3 manage.py runserver

The purpose of the command was to start the local web server. We will later illustrate more administrative functions, such as one for creating a new app – python3 manage.py startapp.

db.sqlite3

The db.sqlite3 file contains our database. However, we will not discuss this file in this chapter, as we do not need it to create our file. We will do so in Chapter 5, Working with Models.

Let's next create our first app!

Creating our first app

A single Django project can contain one or more apps that work together to power a web application. Django uses the concept of projects and apps to keep code clean and readable.

For example, on a movie review site such as Rotten Tomatoes, as shown in Figure 2.4, we can have an app for listing movies, an app for listing news, an app for payments, an app for user authentication, and so on:

Figure 2.4 – The Rotten Tomatoes website

Figure 2.4 – The Rotten Tomatoes website

Apps in Django are like pieces of a website. You can create an entire website with one single app, but it is useful to break it up into different apps, each representing a clear function.

Our movie review site will begin with one app. We will later add more as we progress. To add an app, in the Terminal, stop the server by using Cmd + C. Navigate to the moviereviewsproject folder and run a command like the following in the Terminal:

python3 manage.py startapp <name of app>

In our case, we will add a movie app:

For macOS, run the following command:

python3 manage.py startapp movie

For Windows, run the following command:

python manage.py startapp movie

A new folder, movie, will be added to the project. As we progress in the book, we will explain the files that are inside the folder.

Although our new app exists in our Django project, Django doesn't recognize it till we explicitly add it. To do so, we need to specify it in settings.py. So, go to /moviereviews/settings.py, under INSTALLED_APPS, and you will see six built-in apps already there.

Add the app name, as highlighted in the following (this should be done whenever a new app is created):

…
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'movie',
]
…

Back in the Terminal, run the server:

For macOS, run with the following:

python3 manage.py runserver

For Windows, run with the following:

python manage.py runserver

The server should run without issues. We will learn more about apps throughout the course of this book.

Currently, you may notice a message in the Terminal when you run the server, as follows:

"You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them."

We will see how to address this problem later. But for now, remember that we can have one or more apps inside a project.

Summary

In this chapter, we discussed the Django project structure. We analyzed some of the most important project files and their functionalities. We saw how a web project can be composed of several applications, and we learned how to create a Django app. In the next chapter, we will see how to manage Django routes to provide the project with custom pages. And in upcoming chapters, we will see how the Django architecture model-view-template fits inside the Django project structure.

Left arrow icon Right arrow icon
Download code icon Download Code

Key benefits

  • Develop web applications with Python and Django quickly
  • Understand Django features with short explanations and learn how to use them right away
  • Create a movie reviews app with a responsive user interface and deploy it to the cloud

Description

Learning Django can be a tricky and time-consuming activity. There are hundreds of tutorials, loads of documentation, and many explanations that are hard to digest. However, this book enables you to use and learn Django in just a couple of days. In this book, you’ll go on a fun, hands-on, and pragmatic journey to learn Django full stack development. You'll start building your first Django app within minutes. You'll be provided with short explanations and a practical approach that cover some of the most important Django features, such as Django Apps’ structure, URLs, views, templates, models, CSS inclusion, image storage, authentication and authorization, Django admin panel, and many more. You'll also use Django to develop a movies review app and deploy it to the internet. By the end of this book, you'll be able to build and deploy your own Django web applications.

What you will learn

Understand and implement Django Apps’ basic structure, including URLs, views, templates, and models Add bootstrap to improve the aesthetics of the site Create your own custom pages and have different URLs to route to them Navigate between pages by adding a header bar to all pages Work with databases and models Explore the powerful built-in admin interface with Django Use Django’s powerful, built-in authentication system Deploy your Django project on the internet for the world to use

Product Details

Country selected

Publication date : Jun 24, 2022
Length 190 pages
Edition : 1st Edition
Language : English
ISBN-13 : 9781803245836
Category :

What do you get with eBook?

Product feature icon Instant access to your Digital eBook purchase
Product feature icon Download this book in EPUB and PDF formats
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
Buy Now

Product Details


Publication date : Jun 24, 2022
Length 190 pages
Edition : 1st Edition
Language : English
ISBN-13 : 9781803245836
Category :

Table of Contents

14 Chapters
Preface Chevron down icon Chevron up icon
1. Chapter 1: Installing Python and Django Chevron down icon Chevron up icon
2. Chapter 2: Understanding the Project Structure and Creating Our First App Chevron down icon Chevron up icon
3. Chapter 3: Managing Django URLs Chevron down icon Chevron up icon
4. Chapter 4: Generating HTML Pages with Templates Chevron down icon Chevron up icon
5. Chapter 5: Working with Models Chevron down icon Chevron up icon
6. Chapter 6: Displaying Objects from Admin Chevron down icon Chevron up icon
7. Chapter 7: Understanding the Database Chevron down icon Chevron up icon
8. Chapter 8: Extending Base Templates Chevron down icon Chevron up icon
9. Chapter 9: Creating a Movie Detail Page Chevron down icon Chevron up icon
10. Chapter 10: Implementing User Signup and Login Chevron down icon Chevron up icon
11. Chapter 11: Letting Users Create, Read, Update, and Delete Movie Reviews Chevron down icon Chevron up icon
12. Chapter 12: Deploying the Application to the Cloud Chevron down icon Chevron up icon
13. Other Books You May Enjoy Chevron down icon Chevron up icon

Customer reviews

Top Reviews
Rating distribution
Empty star icon Empty star icon Empty star icon Empty star icon Empty star icon 0
(0 Ratings)
5 star 0%
4 star 0%
3 star 0%
2 star 0%
1 star 0%
Filter icon Filter
Top Reviews

Filter reviews by


No reviews found
Get free access to Packt library with over 7500+ books and video courses for 7 days!
Start Free Trial

FAQs

How do I buy and download an eBook? Chevron down icon Chevron up icon

Where there is an eBook version of a title available, you can buy it from the book details for that title. Add either the standalone eBook or the eBook and print book bundle to your shopping cart. Your eBook will show in your cart as a product on its own. After completing checkout and payment in the normal way, you will receive your receipt on the screen containing a link to a personalised PDF download file. This link will remain active for 30 days. You can download backup copies of the file by logging in to your account at any time.

If you already have Adobe reader installed, then clicking on the link will download and open the PDF file directly. If you don't, then save the PDF file on your machine and download the Reader to view it.

Please Note: Packt eBooks are non-returnable and non-refundable.

Packt eBook and Licensing When you buy an eBook from Packt Publishing, completing your purchase means you accept the terms of our licence agreement. Please read the full text of the agreement. In it we have tried to balance the need for the ebook to be usable for you the reader with our needs to protect the rights of us as Publishers and of our authors. In summary, the agreement says:

  • You may make copies of your eBook for your own use onto any machine
  • You may not pass copies of the eBook on to anyone else
How can I make a purchase on your website? Chevron down icon Chevron up icon

If you want to purchase a video course, eBook or Bundle (Print+eBook) please follow below steps:

  1. Register on our website using your email address and the password.
  2. Search for the title by name or ISBN using the search option.
  3. Select the title you want to purchase.
  4. Choose the format you wish to purchase the title in; if you order the Print Book, you get a free eBook copy of the same title. 
  5. Proceed with the checkout process (payment to be made using Credit Card, Debit Cart, or PayPal)
Where can I access support around an eBook? Chevron down icon Chevron up icon
  • If you experience a problem with using or installing Adobe Reader, the contact Adobe directly.
  • To view the errata for the book, see www.packtpub.com/support and view the pages for the title you have.
  • To view your account details or to download a new copy of the book go to www.packtpub.com/account
  • To contact us directly if a problem is not resolved, use www.packtpub.com/contact-us
What eBook formats do Packt support? Chevron down icon Chevron up icon

Our eBooks are currently available in a variety of formats such as PDF and ePubs. In the future, this may well change with trends and development in technology, but please note that our PDFs are not Adobe eBook Reader format, which has greater restrictions on security.

You will need to use Adobe Reader v9 or later in order to read Packt's PDF eBooks.

What are the benefits of eBooks? Chevron down icon Chevron up icon
  • You can get the information you need immediately
  • You can easily take them with you on a laptop
  • You can download them an unlimited number of times
  • You can print them out
  • They are copy-paste enabled
  • They are searchable
  • There is no password protection
  • They are lower price than print
  • They save resources and space
What is an eBook? Chevron down icon Chevron up icon

Packt eBooks are a complete electronic version of the print edition, available in PDF and ePub formats. Every piece of content down to the page numbering is the same. Because we save the costs of printing and shipping the book to you, we are able to offer eBooks at a lower cost than print editions.

When you have purchased an eBook, simply login to your account and click on the link in Your Download Area. We recommend you saving the file to your hard drive before opening it.

For optimal viewing of our eBooks, we recommend you download and install the free Adobe Reader version 9.