liveBook · Manning

URL routing file

As explained in Django in Action

A URL routing file is a Python module that defines URL patterns for an application or included route namespace.

A URL routing file is a Python module that maps URL patterns to views. In Django, an app-specific file keeps an app’s routes together instead of making the project-level file manage every view. section 4.6.1

A typical routing setup works like this:

  • Define an app route with path(), optionally capturing typed arguments such as <int:musician_id>. section 4.6.1
  • Register the app’s module in the project-level urls.py with include(). section 4.6.1
  • Django combines the project prefix with each app route, so bands/ plus musician/<int:musician_id>/ reaches the musician view. section 4.6.1
Listing 4.5 App specific URL pattern declaration file for bands
# RiffMates/bands/urls.py
from django.urls import path

from bands import views

urlpatterns = [
  path('musician/<int:musician_id>/', views.musician, name="musician"),  #1
]

Shows the bands app’s URL pattern, including an integer argument passed to its view. section 4.6.1

Listing 4.6 Registering all the URL routes in the bands app
# RiffMates/RiffMates/urls.py
...
from django.urls import path, include  #1
...
urlpatterns = [
    ...
    path('bands/', include("bands.urls")), #2
]

Shows how the project-level URL file includes the bands route namespace under the bands/ prefix. section 4.6.1

How Django in Action covers it

How deep it goes
Explains module structure, typed path matching, prefixes, and explicit registration, stopping short of broader routing internals.
Examples
Uses the RiffMates bands app, a musician detail route, an integer musician ID, and the bands/ namespace.
What you can do after
Operate/configure it by defining app routes and registering them under a shared project-level prefix.
How it connects
Connects URL patterns with Django views, path converters, include(), and project-level URL configuration.
Cover of Django in Action
liveBookmanning.com
Read Django in Action on liveBook Get the book at manning.com

This explainer was generated by Manning's knowledge graph from the text of Django in Action. The section links point to the parts of the book it draws on.