{"id":80892,"date":"2021-06-16T09:00:41","date_gmt":"2021-06-16T03:30:41","guid":{"rendered":"https:\/\/techvidvan.com\/tutorials\/?p=80892"},"modified":"2021-06-16T09:00:41","modified_gmt":"2021-06-16T03:30:41","slug":"django-project-structure-layout","status":"publish","type":"post","link":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/","title":{"rendered":"Django Project Structure and File Structure"},"content":{"rendered":"

Django makes use of a directory structure to arrange different parts of the web application. It <\/span>creates a project and an app folder for this.\u00a0<\/span><\/p>\n

Creating a proper project and organizing it helps in keeping the project DRY (Don\u2019t Repeat Yourself) and clean.<\/span><\/p>\n

When we create a Django project, the Django itself creates a root directory of the project with the project name you have given on it. It contains the necessary files that would provide basic functionalities to your web applications.\u00a0<\/span><\/p>\n

Different files in Django Root Directory<\/h3>\n

You can search for the directory by searching the name of the project you have created using the command django -admin startproject (project_name).<\/span><\/p>\n

We will be using Visual studio for further work. I will recommend this to you as well.<\/span><\/p>\n

1. manage.py<\/h3>\n

If you are not new to Django, you must have seen the word \u201ccommand-line utility\u201d many times. But what does this mean?<\/span><\/p>\n

Well, by using the command-line utility, you can migrate i.e., either import or export metadata objects across different domains or setup. You can create one or more objects within an object or its multiple objects.<\/span><\/p>\n

Now straight away coming to the topic. What is manage.py?<\/span><\/p>\n

This file is used as a command-line utility for our projects. We will use this file for\u00a0<\/span>debugging, deploying, and running our web applications.<\/span><\/p>\n

The file contains the code for running the server, makemigrations or migrations, and several other commands as well, which we perform in the code editor.<\/span><\/p>\n

It performs the same things as django-admin but also provides some project-specific\u00a0<\/span>functionality.\u00a0<\/span><\/p>\n

There are several commands under manage.py. Few important ones are as follows:<\/span><\/p>\n

a. Runserver<\/h4>\n

This command is used to start the test server for our web application,\u00a0<\/span>provided by the Django framework.<\/span><\/p>\n

b. makemigrations<\/h4>\n

We use this command to apply new migrations across projects and apps that have been carried out due to the changes in the database.<\/span><\/p>\n

c. migrate<\/h4>\n

This is the prior step of the <\/span>makemigration<\/b> command. We use this for making the changes to the modules in the database.\u00a0<\/span><\/p>\n

Below in the image is the list of tasks you can perform with manage.py.<\/span><\/p>\n

\"Django<\/a><\/p>\n

Project files<\/h3>\n

Project is the name you have given to your project while typing <\/span>django -admin startproject (project_name). <\/b>In my case it is TechVidvan. It contains configuration files of the project.<\/span><\/p>\n

\"Django<\/a><\/p>\n

1.\u00a0__init.py_<\/h4>\n

This is an empty file as you can see below in the image. The function of this file is to tell the Python interpreter that this directory is a package and involvement of this __init.py_ file in it makes it a python project.<\/span><\/p>\n

\"Django<\/a><\/p>\n

2. settings.py<\/h4>\n

It contains the Django project configuration.<\/span><\/p>\n

The setting.py is the most important file, and it is used for adding all the applications and middleware applications. This is the main setting file of the Django project.\u00a0<\/span><\/p>\n

This contains several variable names, and if you change the value, your application will work accordingly.<\/span><\/p>\n

It contains sqlite3 as the default database. We can change this database to Mysql, PostgreSQL, or MongoDB according to the web application we create.<\/span><\/p>\n

It contains some pre-installed apps and middleware that are there to provide basic functionality.<\/span><\/p>\n

\"Django<\/a><\/p>\n

3. urls.py<\/h4>\n

URL is a universal resource locator, it contains all the endpoints that we should have for our website. It is used to provide you the address of the resources (images, webpages, websites, etc) that are present out there on the internet.<\/span><\/p>\n

In simpler words, this file tells Django that if a user comes with this URL, direct them to that particular website or image whatsoever it is.<\/span><\/p>\n

\"Django<\/a><\/p>\n

4. wsgi.py<\/h4>\n

When you will complete your journey from development to production, the next task is hosting your application. Here you will not be using the Django web server, but the WSGI server will take care of it<\/span><\/p>\n

WSGI stands for <\/span>Web Server Gateway Interface<\/b>, it describes the way how servers interact with the applications.<\/span><\/p>\n

It is a very easy task, you just have to import middleware according to the server you want to use. For every server, there is Django middleware available that solves all the integration and connectivity issues.<\/span><\/p>\n

\"Django<\/a><\/h4>\n

5. asgi.py<\/h4>\n

ASGI works similar to WSGI but comes with some additional functionality.\u00a0 <\/span>ASGI stands for <\/span>Asynchronous Server Gateway Interface<\/b>. It is now replacing its predecessor WSGI.<\/span><\/p>\n

\"Django<\/a><\/p>\n

 <\/p>\n

Django Application Files<\/h3>\n

Django uses the concept of Projects and apps for managing the codes and presents them in a readable format. A Django project contains one or more apps within it, which performs the work simultaneously to provide a smooth flow of the web application.<\/span>\u00a0<\/span><\/p>\n

For example, a real-world Django e-commerce site will have one app for user authentication, another app for payments, and a third app for item listing details: each will focus on a single functionality.<\/span><\/p>\n

In the example below, we have created a Project named <\/span>\u201cTechVidvan\u201d<\/b> and an App called <\/span>\u201cHelloWorld\u201d<\/b><\/p>\n

Type the following command in the terminal:<\/span><\/p>\n\n\n\n
Python manage.py startapp HelloWorld<\/b><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\"Django<\/a>Once the app is created, the following sub-files will be present under that app.<\/span><\/p>\n

\"\"<\/a><\/p>\n

1.\u00a0 _init_.py<\/h4>\n

This file provides the same functionality as that in the _init_.py file in the Django project structure. It is an empty file and does not need any modifications. It just represents that the app directory is a package.<\/span><\/p>\n

2.\u00a0 admin.py<\/h4>\n

Admin.py file is used for registering the Django models into the Django administration.<\/span><\/h4>\n

It is used to display the Django model in the Django admin panel. <\/span>It performs three major tasks:<\/span><\/p>\n

a. Registering models<\/span><\/p>\n

b. Creating a Superuser<\/span><\/p>\n

c. Logging in and using the web application<\/span><\/p>\n

We will learn more about the admin panel in the next article about Admin Interface.<\/span><\/p>\n

3. apps.py<\/h4>\n

Apps.py is a file that is used to help the user include the application configuration for their app.<\/span><\/p>\n

Users can configure the attributes of their application using the apps.py file.<\/span><\/p>\n

However, configuring the attributes is a rare task a user ever performs, because most of the time the default configuration is sufficient enough to work with.<\/span><\/p>\n

4. models.py<\/h4>\n

Models.py represents the models of web applications in the form of classes. It is considered the most important aspect of the App file structure.<\/span><\/p>\n

Models define the structure of the database. It tells about the actual design, relationships between the data sets, and their attribute constraints.\u00a0<\/span><\/p>\n

5. views.py<\/h4>\n

Views are also an important part when we talk about the Django app structure. Views provide an interface through which a user interacts with a Django web application. It contains all the views in the form of classes.<\/span><\/p>\n

We use the concept of Serializers in Django Rest_Framework for making different types of views. Some of these are CustomFilter Views, Class-Based List Views, and Detail Views.<\/span><\/p>\n

6. urls.py<\/h4>\n

Urls.py works the same as that of the urls.py in the project file structure. The primary aim being, linking the user\u2019s URL request to the corresponding pages it is pointing to.<\/span><\/p>\n

You won\u2019t find this under the app files. We create this by clicking on the New file option written on the top, after the Project name.<\/span><\/p>\n

7. tests.py<\/h4>\n

Tests.py allows the user to write test code for their web applications. It is used to test the working of the app.<\/span><\/p>\n

Its working is quite complex. We will discuss it in more detail in the upcoming articles.<\/span><\/p>\n

Summary<\/h3>\n

This brings us to the end. In this tutorial, we have discussed the Django project layout.<\/span><\/p>\n

All the files we have discussed above are within every Django application you create. The main aim of these files is to provide you with backend support.\u00a0<\/span><\/p>\n

However, the settings.py and urls.py are the two main files we will be working with. Making changes to these files will bring unique functionalities to the web application you create.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

Django makes use of a directory structure to arrange different parts of the web application. It creates a project and an app folder for this.\u00a0 Creating a proper project and organizing it helps in...<\/p>\n","protected":false},"author":1,"featured_media":80990,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3383],"tags":[3529,3530,3531],"class_list":["post-80892","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-django","tag-django-file-structure","tag-django-project-layout","tag-django-project-structure"],"yoast_head":"\nDjango Project Structure and File Structure - TechVidvan<\/title>\n<meta name=\"description\" content=\"Django uses directory structure to arrange the different parts of web application. Learn about the Django project structure & file structure.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Django Project Structure and File Structure - TechVidvan\" \/>\n<meta property=\"og:description\" content=\"Django uses directory structure to arrange the different parts of web application. Learn about the Django project structure & file structure.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/\" \/>\n<meta property=\"og:site_name\" content=\"TechVidvan\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/TechVidvan\/\" \/>\n<meta property=\"article:published_time\" content=\"2021-06-16T03:30:41+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/2021\/06\/Django-file-structure.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"628\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"TechVidvan Team\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@vidvantech\" \/>\n<meta name=\"twitter:site\" content=\"@vidvantech\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"TechVidvan Team\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"8 minutes\" \/>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Django Project Structure and File Structure - TechVidvan","description":"Django uses directory structure to arrange the different parts of web application. Learn about the Django project structure & file structure.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/","og_locale":"en_US","og_type":"article","og_title":"Django Project Structure and File Structure - TechVidvan","og_description":"Django uses directory structure to arrange the different parts of web application. Learn about the Django project structure & file structure.","og_url":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/","og_site_name":"TechVidvan","article_publisher":"https:\/\/www.facebook.com\/TechVidvan\/","article_published_time":"2021-06-16T03:30:41+00:00","og_image":[{"width":1200,"height":628,"url":"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/2021\/06\/Django-file-structure.jpg","type":"image\/jpeg"}],"author":"TechVidvan Team","twitter_card":"summary_large_image","twitter_creator":"@vidvantech","twitter_site":"@vidvantech","twitter_misc":{"Written by":"TechVidvan Team","Est. reading time":"8 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/#article","isPartOf":{"@id":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/"},"author":{"name":"TechVidvan Team","@id":"https:\/\/techvidvan.com\/tutorials\/#\/schema\/person\/e9c26e74dd3d87421f7ada9433b8cd22"},"headline":"Django Project Structure and File Structure","datePublished":"2021-06-16T03:30:41+00:00","mainEntityOfPage":{"@id":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/"},"wordCount":1308,"commentCount":0,"publisher":{"@id":"https:\/\/techvidvan.com\/tutorials\/#organization"},"image":{"@id":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/#primaryimage"},"thumbnailUrl":"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/2021\/06\/Django-file-structure.jpg","keywords":["Django File Structure","Django Project Layout","Django Project Structure"],"articleSection":["Django Tutorials"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/","url":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/","name":"Django Project Structure and File Structure - TechVidvan","isPartOf":{"@id":"https:\/\/techvidvan.com\/tutorials\/#website"},"primaryImageOfPage":{"@id":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/#primaryimage"},"image":{"@id":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/#primaryimage"},"thumbnailUrl":"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/2021\/06\/Django-file-structure.jpg","datePublished":"2021-06-16T03:30:41+00:00","description":"Django uses directory structure to arrange the different parts of web application. Learn about the Django project structure & file structure.","breadcrumb":{"@id":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/#primaryimage","url":"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/2021\/06\/Django-file-structure.jpg","contentUrl":"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/2021\/06\/Django-file-structure.jpg","width":1200,"height":628,"caption":"Django Project structure"},{"@type":"BreadcrumbList","@id":"https:\/\/techvidvan.com\/tutorials\/django-project-structure-layout\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/techvidvan.com\/tutorials\/"},{"@type":"ListItem","position":2,"name":"Django Project Structure and File Structure"}]},{"@type":"WebSite","@id":"https:\/\/techvidvan.com\/tutorials\/#website","url":"https:\/\/techvidvan.com\/tutorials\/","name":"TechVidvan Blogs","description":"","publisher":{"@id":"https:\/\/techvidvan.com\/tutorials\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/techvidvan.com\/tutorials\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/techvidvan.com\/tutorials\/#organization","name":"TechVidvan","url":"https:\/\/techvidvan.com\/tutorials\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/techvidvan.com\/tutorials\/#\/schema\/logo\/image\/","url":"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/2024\/03\/techvidvan-logo-200x50-1.webp","contentUrl":"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/2024\/03\/techvidvan-logo-200x50-1.webp","width":200,"height":50,"caption":"TechVidvan"},"image":{"@id":"https:\/\/techvidvan.com\/tutorials\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/TechVidvan\/","https:\/\/x.com\/vidvantech"]},{"@type":"Person","@id":"https:\/\/techvidvan.com\/tutorials\/#\/schema\/person\/e9c26e74dd3d87421f7ada9433b8cd22","name":"TechVidvan Team","description":"The TechVidvan Team delivers practical, beginner-friendly tutorials on programming, Java, Python, C++, DSA, AI, ML, data Science, Android, Flutter, MERN, Web Development, and technology. Our experts are here to help you upskill and excel in today\u2019s tech industry."}]}},"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/techvidvan.com\/tutorials\/wp-json\/wp\/v2\/posts\/80892","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/techvidvan.com\/tutorials\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/techvidvan.com\/tutorials\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/techvidvan.com\/tutorials\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/techvidvan.com\/tutorials\/wp-json\/wp\/v2\/comments?post=80892"}],"version-history":[{"count":0,"href":"https:\/\/techvidvan.com\/tutorials\/wp-json\/wp\/v2\/posts\/80892\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/techvidvan.com\/tutorials\/wp-json\/wp\/v2\/media\/80990"}],"wp:attachment":[{"href":"https:\/\/techvidvan.com\/tutorials\/wp-json\/wp\/v2\/media?parent=80892"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/techvidvan.com\/tutorials\/wp-json\/wp\/v2\/categories?post=80892"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/techvidvan.com\/tutorials\/wp-json\/wp\/v2\/tags?post=80892"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}