Django Routing Sample

Open-source sample provided by AppSeed to explain Django routing mechanism.
This sample might be useful to beginners to understand how the routing system works in Django Web Framework. In the end, the sample will route three things: a default route that shows a simple Hello World, a 2nd route that displays a random number at each page refresh, and the last route that shows a random image pulled from the internet.

What is Django

Django is a high-level Python Web framework that encourages rapid development and clean, pragmatic design. Built by experienced developers, it takes care of much of the hassle of Web development, so you can focus on writing your app without needing to reinvent the wheel. It’s free and open source.
Read more about Django Framework - quick introduction

How to code this sample

This sample can be coded from scratch by following the steps below.
Check Python Version
$ python --version
Python 3.8.4 <-- All good
Create/activate a virtual environment - Unix-based system
$ # Virtualenv modules installation
$ virtualenv env
$ source env/bin/activate
For Windows, the syntax is slightly different
$ # virtualenv env
$ # .\env\Scripts\activate
Install Django
$ pip install django
Create a new Django Project
$ mkdir django-sample-urls
$ cd django-sample-urls
Inside the new directory, we will invoke startproject subcommand
$ django-admin startproject config .
Note: Take into account that . at the end of the command.
Setup the database
$ python makemigrations
$ python migrate
Start the app
$ python runserver
$ # Access the web app in browser:
At this point we should see the default Django page in the browser:
Django - Default Project Page.
Create a new Django app
$ python startapp sample

Add a simple route

Let's edit sample/ as shown below:
def hello(request):
return HttpResponse("Hello Django")
Configure Django to use the new route - update config/ as below:
from django.contrib import admin
from django.urls import path
from django.conf.urls import include, url # <-- NEW
from sample.views import hello # <-- NEW
urlpatterns = [
url('', hello), # <-- NEW
In other words, the default route is served by hello method defined in sample/

New Route - Dynamic content

Let's create a new route that shows a random number - sample/
from random import random
def myrandom(request):
return HttpResponse("Random - " + str( random() ) )
The new method invoke random() from Python core library, converts the result to a string and returns the result. The browser output should be similar to this:
Django Routing - Dynamic Content Route.

New Route - Random Images

This route will pull a random image from a public (and free) service and inject the returned content into the browser response. To achieve this goal, we need a new Python library called requests to pull the random image with ease.
The controller code should be defined in sample/
import requests
def randomimage(request):
r = requests.get('')
return HttpResponse( r.content, content_type="image/png")
To see the effects in the browser, the routing should be updated accordingly.
# Contents of config/
from sample.views import hello, myrandom, randomimage # <-- Updated
urlpatterns = [
path('admin/' ,,
url('randomimage' , randomimage), # <-- New
url('random' , myrandom),
url('' , hello),
The browser sample output returned by a local iteration:
Django Routing Sample - Browser output


  • Read more about Django (official docs)
  • Start fast a new project using development-ready Django Starters​