Django Crash Course

Copyright
Introduction
	Why Learn Django?
	When the Going Gets Tough
	This Book is intended for Django 3.x and Python 3.8
	How This Book is Structured
	Conventions Used in this Book
The Ultimate Django Setup
	Goal: A Professional-Quality Development Environment
	Core Concepts
	Step 1: Install Conda
	Step 2: Install Visual Studio Code
	Step 3: Installing Git
	Step 4: Installing PostgreSQL
	Summary
I Hello, World in Django
	Hello, World in Django
		The ``Hello, World'' of Python
		``Hello, World'' of Django: Simple on Purpose
		Projects Goals
		Prerequisites
	Preparation: Install Dependencies
		What's a Dependency?
		Set Up a New Conda Environment
		Install Django
		Summary
	Generate a Starter Django Project
		Anatomy of a Bare-Bones Django Project
		manage.py
		settings.py
		Other Settings
		Exercise
	Create a Database and Run the Project
		Ensure We Are in the Hellodjango project
		Creating the Database
		Start Up Runserver
		Runserver Has Started Up
		Success!
	Create a Django-Superuser
		Stop runserver if It Is Still Running
		Run createsuperuser
		Summary
	Practice Using the Admin
		Restart runserver
		Visit the Admin
		Log in as Our Superuser
		Explore the Admin
		Recreating the Hello, World in Django Database
		Summary
	Generate a Homepage App
		Stop runserver if Needed
		Generate a Starter Django App
		Anatomy of a Simple 1-App Django Project
		Exercise
		Main Django Project vs Django Apps
	Prepping the Project for Templates
		Configure Your Templates
		Save!
		Lists? Dictionaries?
	Add a Simple Homepage View
		Get to Know URL Routing
		Add a URL Pattern for the Homepage
		Double-Check the Code
		Terminology: ``Wire in the URL''
		Refresh the Page and Trigger an Error
	Create Our First Django Template
		Create a Templates Directory
		Add Index Template
		Start Up Runserver
		View the First Page
		Recap
		Understanding Views and the Templateview Class
	Working With Variables in Templates
		Our First Templated Value
		What Is my_statement?
		Extend HomepageView
		Refresh the Homepage
		Exercise: Play Around!
		Common Questions
	Calling View Methods From Templates
		Define a View Method
		Call the View Method From index.html
		Reload the Homepage
	Our First Project is Complete!
		Summary
		Next Steps
II EveryCheese
	The EveryCheese Project
		Prerequisites
		Prepare the EveryCheese Programming Environment
		Create a New Virtual Environment
		Reactivating Conda Environments
		Summary
	Using Cookiecutter and Template
		Install the Cookiecutter Library
		Cookiecutter Project Templates
		Using django-crash-starter
		What Happened?
		Tips and Troubleshooting
		A Little Cookiecutter Background
	Exploring the Generated Boilerplate
		Some Basic Components
		Summary
	Starting Up Our New Django Project
		Let's Run the Project
		Go Into the EveryCheese Directory
		Start PostgreSQL if Needed
		Create the Database
		How to Create It
		Install the Dependencies
		Run the Migrations
		Start Up Runserver
	Cheese Boilers
	Initializing the Git Repo Committing and Pushing
		Why?
		We'll Use GitHub
		Create the GitHub Project
		Examine the GitHub Instructions
		Verify That the Files Got Committed
	Git Is Not for Stinky Cheeses
	What We Get From The Users App
		Register a Normal User
		Verify Our Email
		Why Are Emails Printed in the Console?
		Explore the User Profile
		Edit User Data
		Introducing UserUpdateView
		Introducing UserDetailview
		Understand the Name Field
		Understand the Code for UserUpdateView
		Add Email Addresses
		What About the Code?
	Adding User Bios
		Add a Bio Field
		Create and Run Migrations
		Update UserUpdateView
		Try It Out
	Adding Bio to User Detail Template
		Update the User Detail Template
		Add Line Breaks
		Commit Our Work
	Introducing Tests
		Why Test?
		Running Tests
		What Does a Test Look Like?
		The Test Foundations
		The Actual Test
		Using the assert KeyWord
		Introducing coverage.py
		Using coverage.py
		Generate an HTML Coverage Report
		More Users App Tests
		Summary
	User Profile Cheese
		Avatars Will Fit Into Cheese Holes
	The Cheeses App and Model
		Make Sure We're at the Project Root
		Create an App Called Cheeses
		Move It Into the Project
		Set the Cheese Config
		Add It to the List of Installed Apps
		Add the Cheese Model
		Create and Run the Initial Cheese Migration
	Trying Out the Cheese Model
		Let's Try It Out!
		Django Shell vs. Shell Plus
		Create a Cheese
		Evaluate and Print the Cheese
		View the Cheese's Name
		Add a String Method
		Try It Again
		Commit Our Work
	Tests and Test Coverage
		Check Test Coverage
		Create a Module for Cheese Model Tests
		Let's Test the __str__() Method.
		Enter ``The Game of Test Coverage''
		Rules of the Game
		What's the Point of All This Anyway?
		Commit the Cheese Model Tests
		Summary
	The Cheeserator
	Adding Cheeses to the Admin
		We Need a Superuser
		Go to the Admin
		Explore the Admin So Far
		Register Cheese Model With the Admin
		Find Colby
		Enter More Cheeses via the Admin
		Some Notes About the Django Admin
		Commit Changes
		Summary
	Behind the Curtain
		We Are in Control
	Class Based View Fundamentals
		The Simplest Class-Based View
		Adding More HTTP Methods
		Advantages of Class Based Views
		Composition
		Composition Part II
		Intelligent Defaults
		Standardized HTTP Method Handling
		Tips for Writing Class-Based Views
	Writing the Cheese List View
	Wiring in the List View Url
		Define Cheese URL Patterns
		Include Cheese URLs in Root URLConf
		See the View in Action
	The Cheese List Template
		Create the List Template
		Fill in the Template
		See the List in Action
		Add a Nav Link to the Cheese List
		Explaining the cheeses:list Name
		Commit Our Work
	Add the CheeseDetailView
		Add the CheeseDetailView URL Pattern
		Link List Items to Detail Pages
	The Cheese Detail Template
		Add a Cheese Detail Template
		Visit Cheese Detail
		Commit Our Work
	Where to Dip Class Based Views
	Writing Factories for Tests
		Produce Cheese Test Data From Factories
		Define a CheeseFactory
		Try Out CheeseFactory
		Delete the Bogus Cheese
		Commit the Changes
	Why Use Factories
		Factories and Unit Testing
		Approach 1: Calling Create()
		Approach 2: Calling CheeseFactory()
		Other Uses
		Learn More About Factory Boy
	Using Factories in Tests
		Passing in Field Values Explicitly
		Bulk Generation
		Reviewing Our Cheeses
		Cheese Cleanup
		Replacing the Direct Cheese Model Call in Our Existing Test
		Removing the Name Entirely
		Commit Our Work
		Summary
	How Our Cheese Objects Feel About Your Tests
	Finding and Adding a Third Party Countries App
		Country of Origin
		Benefiting From Open Source
		Check Django Packages
		Review Django Countries on GitHub
		Look for the Release Number on PyPI
		Install It
		Implement in cheeses/models.py
		Migrations!
	Display Cheese Country Data
		Add Cheese Countries in the Admin
		Display Country in Cheese Detail
		Run the Tests
		Update CheeseFactory
		Verify That CheeseFactory Works
		Commit Our Work
	Implement Cheese Creation by Users
		Add a Cheese Creation View
		Add the Corresponding URL Pattern
		Specify the Desired Form Fields
		Define the Cheese Form Template
		Submit the Form
		Implement Get_absolute_url()
		Resubmit the Form
		Link to the Add Cheese Form
		Commit the Changes
	Use Django Crispy Forms for Better Display
		Isn't as_p() Enough?
		A Quick History Lesson
		Crispy Forms and Cookiecutter Django
		Our Non-Crispy Form
		Use the Crispy Template Tag
		Reload the Add Cheese Form
		Commit the Changes
	Understand View Mixins and LoginRequiredMixin
		User-Generated Content and Accountability
		Try Accessing the Add Cheese Form Anonymously
		Require Login
		Try Accessing It as Cheesehead
		View Mixins
		Commit the Changes
	Add a Creator Field and Update Our Cheese Records
		Add a Creator Field
		Make and Apply the Migration
		Commit the Changes
	Track and Display the Cheese Creator
		Set the Cheese Creator After Form Validation
		Display the Creator on the Cheese Detail Pages
		Try It Out
		Commit the Changes
	Update the Cheese Factory
		Run the Tests
		Modify Cheese Factory
		Run the Tests, Again
		Try CheeseFactory in the Shell
		Delete the Random Cheese
		Delete the Random User
		Commit the Changes
	Update the Cheese Model Tests
		Test Get_absolute_url()
		Commit the Changes
	Test All the Cheese Views
		What to Test?
		Start With Imports
		The First Cheese View Tests
		Really Test the Cheese List View
		Test the Cheese Detail View
		Test the Cheese Create View
		Commit the Changes
		Conclusion
	Test All the Cheese URL Patterns
		Add the Imported Cheese
		Write Our First Fixture
		Test the Cheese List URL Pattern
		Test the Add Cheese URL Pattern
		Test the Cheese Detail URL Pattern
		Commit the Changes
	Adding a CheeseUpdateView and Form Recycling
		Add the CheeseUpdateView
		Wire in the URL Pattern
		Try It in the Browser
		What Happened?!?
		Link to the Update Form
		Try It in the Browser
		Make Login Required
		Commit the Changes
	Test the Cheese Forms and Update View
		Refactoring our Cheese Fixture
		Test the Add Cheese Page Title
		Test That CheeseUpdateView Is a Good View
		Test That a Cheese Updates Correctly
		Commit the Changes
	EveryCheese is the Foundation!
		Summary
		Next Steps After This Book
		Giving Us Feedback
III Aftermatter
	Troubleshooting
		Troubleshooting Conda Installations on Pre-Catalina OSX
		Troubleshooting Conda Installations on Catalina or higher OSX
		Troubleshooting PostgreSQL: Role Does Not Exist
		Troubleshooting PostgreSQL: Cannot Create Database
		Troubleshooting PsycoPG2
		Troubleshooting GCC Errors on the Mac
		Troubleshooting the MS Visual Studio Build Tools Error
	Changelog
		Beta Changelog 2020-03-10
		Beta Changelog 2020-03-06
		Beta Changelog 2020-03-03
		Beta Changelog 2020-02-26
		Beta Changelog 2020-02-22
		Beta Changelog 2020-02-21
		Beta Changelog 2020-02-19
		Alpha Changelog 2020-02-14
		Alpha Changelog 2020-02-11
		Alpha Changelog 2020-02-07
		Alpha Changelog 2020-02-05
		Alpha Changelog 2020-02-04
		Alpha Changelog 2020-02-03
	Acknowledgements
		Tech Reviewers
		Contributors to 3.x Beta
		Contributors to 3.x Alpha
		Typesetting