Django URLs and Routing

# CHAPTER 6

Django URLs and Routing #

1. Introduction #

2. Learning Objectives #

• Understand the role of the urls.py file.

• Use the path() function to map a URL string to a View.

• Implement include() to delegate routing from the Project to an App.

• Capture dynamic URL parameters (e.g., article/5/).

3. Beginner-Friendly Explanation #

1. 1. A delivery driver arrives at the front desk (The Project urls.py). They have a package for the "Blog Department".

1. 2. The receptionist doesn't know where the specific employee is, but they say, "The Blog Department is on the 2nd Floor." (include('blog.urls')).

1. 3. The driver goes to the 2nd Floor (The App urls.py).

1. 4. The floor manager looks at the specific package ("Article #42") and directs the driver to the exact desk (The View function).

This two-step process keeps the front desk from getting overwhelmed when the building has 10,000 employees.

4. Step 1: Writing a View Function #

# blog/views.py
from django.http import HttpResponse

def home(request):
    return HttpResponse("<h1>Welcome to the Blog Homepage!</h1>")

def about(request):
    return HttpResponse("<h1>About Us</h1><p>We write about Django.</p>")

*(Remember: Every View function MUST accept request as its first parameter).*

5. Step 2: The App URLs (Floor Manager) #

Create a new file: blog/urls.py

# blog/urls.py
from django.urls import path
from . import views # Import the views.py file from the current folder

urlpatterns = [
    # When someone visits the root of the blog, run views.home
    path('', views.home, name='blog-home'),
    
    # When someone visits /about/, run views.about
    path('about/', views.about, name='blog-about'),
]

6. Step 3: The Project URLs (Front Desk) #

Open core/urls.py. Use the include function to link them.

# core/urls.py
from django.contrib import admin
from django.urls import path, include # Add 'include' here

urlpatterns = [
    # The built-in Django Admin Panel
    path('admin/', admin.site.urls),
    
    # Send any traffic starting with 'blog/' to the blog App's urls.py file
    path('blog/', include('blog.urls')),
]

Testing it out: Start your server (python manage.py runserver). Visit: http://127.0.0.1:8000/blog/ -> You will see "Welcome to the Blog Homepage!" Visit: http://127.0.0.1:8000/blog/about/ -> You will see "About Us".

7. Dynamic URL Parameters #

In blog/urls.py:

# The '<int:id>/' captures an integer from the URL and passes it to the view
path(&#039;article/<int:id>/', views.read_article, name='read-article'),

In blog/views.py:

# The view must accept the 'id' parameter!
def read_article(request, id):
    return HttpResponse(f"<h1>You are reading Article #{id}</h1>")

*If a user visits /blog/article/99/, the browser prints: "You are reading Article #99".*

8. Backend Workflow: Naming URLs #

9. Best Practices #

• Trailing Slashes: Notice how Django URLs almost always end with a slash: path('about/', ...). Django is very strict about this. If a user visits http://mysite.com/about (no slash), Django will automatically redirect them to /about/ for SEO consistency.

10. Common Mistakes #

• Forgetting include(): Beginners often try to import all their App views directly into the Master core/urls.py file. While this works technically, it violates Django's modularity rule. If you do this, and later want to copy your blog app to a new project, the URLs will be left behind! Always use include().

11. Exercises #

1. 1. Trace the Request flow: A user types http://127.0.0.1:8000/blog/article/42/. Explain chronologically which file intercepts the request first (core/urls.py or blog/urls.py), and how the number 42 gets passed to the Python logic.

12. Coding Challenges #

• Challenge: Write a new dynamic path in blog/urls.py that captures a *string* instead of an integer. The path should look like path('author/<str:name>/', ...) and the View function should return HttpResponse("Viewing profile for: [name]").

13. MCQs with Answers #

• Q: Compare path() with the older repath() (Regular Expression path) in Django. When might a developer need to use regular expressions for routing?

15. FAQs #

16. Summary #

17. Next Chapter Recommendation #