django / django

The Web framework for perfectionists with deadlines.

76.0k

Python

Architecture: monolithic-framework

View Original Source

main

django

.github

django

apps

conf

contrib

admin

auth

sessions

postgres

core

cache

handlers

management

backends

models

migrations

middleware

template

urls

utils

views

docs

faq

howto

intro

topics

scripts

tests

pyproject.toml

setup.cfg

tox.ini

Structural Architecture

Django's directory is a masterclass in monolithic Python architecture. The core framework code is deeply decoupled into logical domains (db, core, contrib, conf) ensuring everything from ORMs to administrative GUIs are isolated yet securely tied to the central AppRegistry.

Extensive use of the 'app' module pattern (e.g. `contrib.admin`, `contrib.auth`).
Top-level separation of framework code (`django/`) and verification layers (`tests/`).
Clear demarcation between internal implementation (`django/utils`) and public interfaces.

Notable Directories

/django/contrib

Bundled optional applications like auth, admin, and sessions.

/django/db

The core Object-Relational Mapper (ORM).

/django/core

Fundamental utilities: management commands, paginators, cache handlers.

/tests

Extensive test suite mapping almost exactly to the framework structure.

Build Your Own Ecosystem

Learn from django's structure and craft your own software scaffolding.