Как создать проект django в pycharm
Перейти к содержимому

Как создать проект django в pycharm

  • автор:

Create and run your first Django project

In this tutorial, we will create a basic to-do application.

Before you start

Make sure that the following prerequisites are met:

  • You are working with PyCharm version 2022.2 or later. If you still do not have PyCharm, download it from this page. To install PyCharm, follow the instructions, depending on your platform.

This tutorial has been created with the following assumptions:

  • Python 3.11
  • Django 4.2.

Creating a new project

Create a Django project

  1. Go to File | New Project , or click the New Project button in the Welcome screen. The New Project dialog opens.
  2. In the New Project dialog, do the following:
    • Specify project type Django .
    • If required, change the default project location.
    • Select New environment using Virtualenv
  3. Click ( More Settings ), and specify todo in the Application name field.
  4. Click Create .

Exploring project structure

The newly created project contains Django-specific files and directories.

The structure of the project is visible in the Project tool window ( Alt+1 ):

Django project structure

  • myDjangoProject directory is a container for your project. It is denoted with bold font.
  • The nested directory myDjangoProject is the actual Python package for your project.
  • myDjangoProject/__init__.py : This empty file tells Python that this directory should be considered a Python package.
  • myDjangoProject/settings.py : This file contains configuration for your Django project.
  • myDjangoProject/urls.py : This file contains the URL declarations for your Django project.
  • myDjangoProject/wsgi.py : This file defines an entry-point for WSGI-compatible web servers to serve your project. For more information, refer to How to deploy with WSGI.
  • templates directory is by now empty. It will contain Django templates.
  • The nested directory todo contains all the files required for developing a Django application:
    • Again, todo/_init_.py tells Python that this directory should be considered a Python package.
    • todo/models.py : In this file, we’ll create models for our application.
    • todo/views.py : In this file, we’ll create views.
  • The nested directory migrations contains by now only the package file _init_.py , but will be used in the future to propagate the changes you make to your models (adding a field, deleting a model, and so on) into your database schema. Read the migrations description here.
  • manage.py is a command-line utility that lets you interact with your Django project. For more information, refer to the Django documentation.

Launching Django server

The Django server run/debug configuration is created automatically. If required, you can edit it by selecting the Edit Configurations command in the run/debug configuration list on the main toolbar:

Edit configurations

For example, you can choose to open a browser window automatically when the configuration is launched:

Run/Debug configuration for a Django server

Run the myDjangoProject configuration by clicking . If a browser window does not open automatically, click the link in the Run tool window.

Django server test page

The following page opens:

Creating a model

Django models define the fields and behaviors of your data. They are represented by Python classes, which are subclasses of the django.db.models.Model class.

Let’s create a ToDoItem model for our to-do app. To do that, open todo/models.py , and fill it with the following code:

from django.db import models from django.utils import timezone class ToDoItem(models.Model): text = models.CharField(max_length=100) due_date = models.DateField(default=timezone.now)

The model has two class variables represented by instances of field classes:

  • text : an instance of the CharField class, we will use it to store the description of what should be done.
  • due_date : an instance of the DateField class, we will use it to store the deadline for the to-do.

For more information about model fields, refer to the Django documentation.

Running migrations

By default, PyCharm automatically creates an SQLite database for a Django project. We need to create tables in the database for the todo application and the ToDoItem model. In Django, that’s done by using migrations . Migrations are human-editable files, in which changes to data models are stored.

  1. Press Alt R to open the manage.py console.
  2. Type makemigrations followed by Enter . You should see Process finished with exit code 0 in the console output. The todo/migrations directory now contains the migration file 0001_initial.py : New Django migration
  3. Type migrate and press Enter to apply changes and create tables in the database for the two new models: The

Writing a view

Django views are functions or classes that specify how web requests are processed and which web responses are returned. By convention, views are defined in /views.py , where is the Django application directory.

Open todo/views.py and fill it with the following code:

from django.views.generic import ListView from .models import ToDoItem class AllToDos(ListView): model = ToDoItem template_name = «todo/index.html»

Here we’ve defined the AllToDos class which inherits from the Django ListView basic view class. We’ll use this view to display all available to-do’s.

Creating a template

A Django template is basically an html file with the elements of the Django template language in it. Templates are used to generate html pages according to the context provided by views.

You can see that todo/index.html in views.py is highlighted as an unresolved reference:

Unresolved reference to a Django templates

PyCharm suggests a quick-fix: if you hover over index.html or press Alt+Enter , you can choose to create the corresponding template file in the templates folder:

Quick-fix for Django a template

PyCharm also creates the directory todo where this template should reside. Confirm this operation:

Confirmation of directory creation

PyCharm creates and opens todo/index.html . To fill it with some basic html code, type html:5 followed by Tab :

Using the html live template

Let’s add the content with the Django template language elements to the template. Paste the following code between the body tags:

Things to do:

> >

There’s an h1 heading and a table. We’re using a for cycle to iterate through the items of object_list which will be passed from the AllToDos view. For each item, Django will render a row in the table containing the values of text and due_date .

Configuring urls

Now we need to configure the way how we will access the AllToDos view in the browser.

    In the todo directory, create the file urls.py and fill it with the following code:

from django.urls import path from . import views urlpatterns = [ path(«», views.AllToDos.as_view(), name=»index») ]

from django.contrib import admin from django.urls import path, include urlpatterns = [ path(«todo/», include(«todo.urls»)), path(«admin/», admin.site.urls), ]

To-do application index page

Don’t forget to import django.urls.include !

  • Open the page in your browser. You should see the following text:
  • There’s a heading, but no to-do’s yet. Let’s use the Django admin interface to add tasks.

    Using Django admin

    Admin sites allow adding, editing, and otherwise managing the content. By default, PyCharm enables Django admin interface for a new Django project automatically.

    Setting up an admin site

    Django admin site login page

    1. Firstly, we need to create a superuser. To do that, type createsuperuser in the manage.py console ( Alt R ), specify your email address, and password.
    2. Now go to /admin/ on your Django server, for example, You should see the following login page:

    After you log in, the administration page is displayed. It has the Authentication and Authorization (Groups and Users) section, but there’s no way to add to-do’s. To be able to do that, we must register the ToDoItem model in the admin interface.

    Adding content

    1. Open the file todo/admin.py , and type the following code:

    from django.contrib import admin from .models import ToDoItem admin.site.register(ToDoItem)

  • Refresh the page in the browser. The TODO section with To do items should appear: Django admin site with todo section
  • Click Add to create a to-do: Adding a to-do in Django admin siteWhen you a ready, click SAVE .
  • The newly created to-do appears in the list as ToDoItem object (1) . Such naming makes content management complicated, as you have to open each task to read its description.

    Let’s fix that by adding a __str__() method to the ToDoItem model. Open todo/models.py and add the following:

    def __str__(self): return f»: due «

    You should end up with the following:

    from django.db import models from django.utils import timezone class ToDoItem(models.Model): text = models.CharField(max_length=100) due_date = models.DateField(default=timezone.now) def __str__(self): return f»: due «

    List of to-do

    The list of to-do’s now provides all the required information:

    Providing features

    Now, as you’ve added some to-do’s, go to again. The list of tasks should be there:

    Displaying the list of to-do

    What about filtering to display only the tasks that should be completed today? Let’s add this feature to our application.

    Go to views.py and add the TodayToDos class with the following code:

    class TodayToDos(ListView): model = ToDoItem template_name = «todo/today.html» def get_queryset(self): return ToDoItem.objects.filter(due_date=date.today())

    This class is very similar to AllToDos , except that it uses another template (which we will create later) and implements the get_queryset method to return only those ToDoItem objects whose due_date is today.

    date should be highlighted with a red squiggly line. Hover over it, click Import this name , and select datetime.date to add the corresponding import statement at the beginning of the file.

    We need to create the today.html template. To avoid copy-pasting from index.html and having duplicated code in the project, we’ll use Django template inheritance.

    1. Create base.html in myDjangoProject/templates by right-clicking templates in the Project tool window and selecting New | HTML File from the context menu.
    2. Copy the code from index.html into base.html , and then replace everything between the tags with the following:

    This is what myDjangoProject/templates/base.html should look like:

    Things to do:

    > >

    Things to do today:


    We’ve created a base template base.html which contains all common html tags. index.html and today.html are child templates which inherit the common elements, but have specific contents.

    We also need to configure the way we will access the today’s tasks in the browser. Go to myDjangoProject/todo/urls.py and add path(«today/», views.TodayToDos.as_view(), name=»today») to urlpatterns to get the following:

    from django.urls import path from . import views urlpatterns = [ path(«», views.AllToDos.as_view(), name=»index»), path(«today/», views.TodayToDos.as_view(), name=»today») ]

    Let’s make sure that everything works as expected. Go to and add a couple of to-do’s setting the Due date to today. Then go to and make sure that you see the newly added to-do’s:

    To-do items with due day today

    Improving the experience

    At this stage our to-do application does what it was meant to:

    • Displays the list of all to-do’s
    • Show what should be done today
    • Allows adding new tasks by using Django admin interface

    But it doesn’t look very nice and is not very comfortable to use. Let’s fix that!

    The easiest way to improve the look of an html page is to implement CSS. For example, we can use Simple CSS. Open base.html and put the following line anywhere between the tags:

    Go to in your browser to see the new look of our application:

    The application home page with CSS

    Since we are using a base template, the look of changes as well:

    The application home page with CSS

    Now let’s add some navigation elements to avoid typing addresses in the browser’s address bar. In base.html , paste the following code after the opening tag:

    Here’s the result:

    Testing the application

    You might have noticed that a few to-do’s on the application’s «All tasks» page are due on May 12. These tasks are actually past due, and we don’t need to display them. Such oversights can be avoided by introducing tests while developing applications.

    In the myDjangoProject/todo directory, there is the tests.py file. It is intended for Django tests. Let’s write a test to check if to-do’s are rendered correctly on the home page of our application depending on their due dates:

    from datetime import date, timedelta from django.test import TestCase from django.urls import reverse from .models import ToDoItem def create_todo(todo_text, days): return ToDoItem.objects.create(text=todo_text, due_date=date.today() + timedelta(days=days)) class AllToDosViewTest(TestCase): def test_today(self): todo = create_todo(«To be done today», 0) response = self.client.get(reverse(«index»)) self.assertQuerySetEqual( response.context[«todoitem_list»], [todo] ) def test_last_week(self): todo = create_todo(«This task is past due», -7) response = self.client.get(reverse(«index»)) self.assertQuerySetEqual( response.context[«todoitem_list»], [] ) def test_next_week(self): todo = create_todo(«Still have some time», 7) response = self.client.get(reverse(«index»)) self.assertQuerySetEqual( response.context[«todoitem_list»], [todo] )

    Here, create_todo is a shortcut function to create a to-do and AllToDosViewTest is a test class with 3 methods: test_today , test_last_week , test_next_week . Each method creates a task with the corresponding due date, and then checks if the task is rendered on the application’s home page. The task whose due date was 7 days before the current date shouldn’t be displayed.

    To run this test, right-click the background of the file tests.py in the editor, choose the option Run , or just press Control+Shift+F10 .

    The test results are show in the Test Runner tab of the Run tool window:

    Running tests

    You can see that test_last_week has failed, because the created to-do is added to the list of items that will be displayed on the home page despite being past due.

    Let’s fix it by adding the get_queryset method to the AllToDos class:

    def get_queryset(self): return ToDoItem.objects.filter(due_date__gte=date.today())

    The method will filter the objects, so that the view returns only those tasks whose due dates are greater than or equal to today’s date (this is what __gte stands for).

    Rerun the test by clicking on the toolbar of the Run tool window. Now all tests pass successfully:

    All tests pass


    This tutorial is over. You have successfully created, launched, and tested a simple Django application. Let’s sum up what you have done with the help of PyCharm:

    • Created a Django project with an application
    • Launched a Django server
    • Created models, views and templates
    • Configured urls
    • Launched the application
    • Created and executed a test

    Create a Django project

    Django project is intended for productive web development with Django. PyCharm takes care of creating specific directory structure and files required for a Django application, and providing the correct settings.

    Create a new Django project

    Create a Django project

    1. Go to File | New Project , or click the New Project button in the Welcome screen. The New Project dialog opens.
    2. In the New project dialog, do the following:
    3. Specify project type Django .
    4. Specify project location.
    5. Next, choose whether you want to create a new environment or use an existing interpreter, by clicking the corresponding radio-button.

    Create a project with a conda environment

    • Specify the location of the new conda environment in the Location field, or click and browse for the desired location in your file system. The directory for the new conda environment should be empty.
    • Select the Python version from the list.
    • Normally, PyCharm will detect conda installation. Otherwise, specify the location of the conda executable, or click to browse for it.
    • Select the Make available to all projects checkbox if you want to reuse this environment when creating Python interpreters in PyCharm.

    Create a project with virtualenv

    • Specify the location of the new virtual environment in the Location field, or click and browse for the desired location in your file system. The directory for the new virtual environment should be empty.
    • Choose the base interpreter from the list, or click and find the desired Python executable in your file system.
    • Select the Inherit global site-packages checkbox if you want all packages installed in the global Python on your machine to be added to the virtual environment you’re going to create. This checkbox corresponds to the —system-site-packages option of the virtualenv tool.
    • Select the Make available to all projects checkbox if you want to reuse this environment when creating Python interpreters in PyCharm.

    Create a project with Pipenv

    Choose the base interpreter from the list, or click and find the desired Python executable in your file system.

    If you have added the base binary directory to your PATH environmental variable, you don’t need to set any additional options: the path to the pipenv executable will be autodetected.

    If the pipenv executable is not found, follow the pipenv installation procedure to discover the executable path, and then paste it in the Pipenv executable field.

    Create a project with Poetry

    Choose the base interpreter from the list, or click and find the desired Python executable in your file system.

    If PyCharm doesn’t detect the poetry executable, specify the following path in the Poetry executable field, replacing jetbrains with your username:

    Как создать проект django в pycharm

    При установке Django в папке виртуальной среды устанавливается утилита django-admin . А на Windows также исполняемый файл django-admin.exe . Их можно найти в папке виртуальной среды, в которую производилась установка Django: на Windows — в подкаталоге Scripts , а на Linux/MacOS — в каталоге bin .

    django-admin в Django и Python

    django-admin предоставляет ряд команд для управления проектом Django. В частности, для создания проекта применяется команда startproject . Этой команде в качестве аргумента передается название проекта.

    Итак, создадим первый на Django. Пусть он будет располагаться в той же папке, где располагается каталог виртуальной среды. И для этого вначале активируем ранее созданную виртуальную среду (например, среду .venv, которая была создана в прошлой теме, если она ранее не была активирована).

    И после активации виртуальной среды выполним следующую команду

    c:\django>django-admin startproject metanit

    Создание проекта на Python и Django

    В данном случае мы создаем проект с именем «metanit». И после выполнения этой команды в текущей папке (c:\django) будет создан каталог metanit .

    Первый проект на Python и Django

    Созданный каталог будет состоять из следующих элементов:

    • manage.py : выполняет различные команды проекта, например, создает и запускает приложение
    • metanit — собственно папка проекта metanit, которая содержит следующие файлы:
      • __init__.py : данный файл указывает, что папка, в которой он находится, будет рассматриваться как модуль. Это стандартный файл для программы на языке Python.
      • settings.py : содержит настройки конфигурации проекта
      • urls.py : содержит шаблоны URL-адресов, по сути определяет систему маршрутизации проекта
      • wsgi.py : содержит свойства конфигурации WSGI (Web Server Gateway Inerface). Он используется при развертывании проекта.
      • asgi.py : название файла представляет сокращение от Asynchronous Server Gateway Interface и расширяет возможности WSGI, добавляя поддержку для взаимодействия между асинхронными веб-серверами и приложениями.

      Запустим проект на выполнение. Для этого с помощью команды cd перейдем в консоли к папке проекта. И затем для запуска проекта выполним следующую команду:

      python manage.py runserver

      Урок #2 — Создание проекта. Основные файлы

      В ходе урока мы выполним создание проекта на основе фреймворка Джанго. Мы рассмотрим все файлы и папки, что были созданы вместе с проектом, а также запустим локальный сервер и посмотрим на сайт через браузер.


      Установка Django

      Поскольку Django является фреймворком языка Python , то сперва необходимо установить сам язык. Для этого необходимо скачать последнюю версию Питона на их официальном сайте и следовать простым инструкциям. Если вы находитесь на Windows, то обязательно отметьте галочкой поле Add Python X.Y to PATH .

      Если у вас возникли проблемы с установкой Python, то вы можете посмотреть специальный урок , в котором будет рассказано как установить Python на компьютер.

      Для установки Django используйте следующую команду:

      pip install Django

      Если вы находитесь на Маке или Linux, то к слову pip пропишите цифру 3: pip3 . Если у вас не установлен pip на компьютере, то скачайте его по этой ссылке .

      Создание проекта

      Django проект можно создать в любой папке, поэтому создайте какую-либо папку и откройте её в окне команд. На Windows это можно сделать нажатием правой клавиши мыши на папку при зажатой клавише Shift:

      В командной строке пропишите команду:

      django-admin startproject НАЗВАНИЕ_ПРОЕКТА

      Вместо «название проекта» впишите любое название для вашего проекта.

      Запуск локального сервера

      Для запуска сервера необходимо перейти в командную строку и открыть в ней папку с вашим проектом. На Windows это можно сделать нажатием правой клавиши мыши на папку при зажатой клавише Shift :

      Далее перейдите в папку вашего проекта (в нашем случае это папка «mysite»):

      cd mysite

      Пропишите команду для запуска локального сервера:

      python manage.py runserver

      Условия написания команды:

      • Пропишите слово python3 в случае если вы на маке или Linux;
      • Если вы на Windows и у вас всего одна версия Питона, то пишите слово python;
      • Если вы на Windows и у вас несколько версий Python, то либо удалите все версии, кроме последней, либо укажите путь к последней версии Питона.
      Несколько полезных советов
      1. В данном курсе используется версия Django 3 , поэтому чтобы не возникали дополнительные непонятные моменты, то лучше установите такую же версию Django;
      2. Стандартная командная строка в Windows не особо удобная, поэтому вместо неё лучше использовать сторонние программы. Очень удобной и легкой в работе является программа PowerShell, которую вы можете скачать здесь ;
      3. Путь к интерпретатору можно не прописывать вручную, если поставить virtualenv и в нём указать нужную версию Python и Django. Если работать в PyCharm, то в преднастройках можно выставить нужный интерпретатор.

    Добавить комментарий

    Ваш адрес email не будет опубликован. Обязательные поля помечены *