Windows django: How to install Django on Windows | Django documentation

Содержание

Поднимаем Django стек на MS Windows / Хабр

В данной статье будет представлена подробная инструкция по установке и настройке программ Apache, Python и PostgreSQL для обеспечения работы Django проекта в ОС MS Windows. Django уже включает в себя упрощенный сервер разработки для локального тестирования кода, но для задач, связанных с продакшен, требуется более безопасный и мощный веб-сервер. Мы настроим mod_wsgi для взаимодействия с нашим проектом и настроим Apache в качестве шлюза в внешний мир.

Стоит отметить, что установка и настройка будет производиться в ОС MS Windows 10 с 32 разрядностью. Также 32 битная реакция будет универсальна и будет работать на 64 битной архитектуре. Если вам нужна 64 битная установка повторите те же действия для 64 битных дистрибутивов программ, последовательность действий будет идентична.


В качестве Django проекта будем использовать программу Severcart. Она предназначена для управления перемещениями картриджей, учёта печатающего оборудования и договоров поставки и обслуживания. Установка всех программ и модулей будет производиться в каталог C:\severcart. Местоположение не принципиально.

Python

Первым шагом является загрузка и установка Python с веб-сайта Python. Выбираем Windows в качестве операционной системы и 32-битную версию. На момент написания статьи текущей версией является 3.9.0rc2.

Загрузив файл установки, щелкните правой кнопкой мыши файл установки и выберите «Запуск от имени администратора». Вы должны увидеть экран ниже

Устанавливаем галочки напротив чекбоксов «Install launcher for add user (recomended)» и «Add Python 3.9 to PATH» и нажимаем на «Customize installation».

Устанавливаем галочки на против «pip», «py launcher», «for all users (requires elevation)» и нажимаем «Next».

Выбираем все поля ввода как на картинке выше и нажимаем на «Install».

Чтобы убедиться, что установка прошла успешно, откройте cmd и введите python. Если установка прошла успешно, вы должны увидеть приглашение, подобный приведенному ниже

Устанавливаем mod_wsgi

Скачиваем скомпилированный пакет с mod_wsgi c сайта

www.lfd.uci.edu/~gohlke/pythonlibs

. Модуль выполняет функции посредника межу сервером Apache и Django проектом. Самый свежий пакет будет с именем mod_wsgi-4.7.1-cp39-cp39-win32.whl. Обратите внимание, что пакет скомпилирован для 32 битной Windows CPython версии 3.9. Также стоит отметить, что очевидная установка модуля pip install mod_wsgi скорее всего завершится ошибкой, т.к. в процессе установки потребуется компилятор Visual Studio C++. Ставить компилятор целиком ради одного Python пакета в Windows считаем нецелесообразным.

Устанавливаем модуль с помощью стандартного пакетного менеджера pip в cmd или powershell:

pip install -U mod_wsgi-4.7.1-cp39-cp39-win32.whl

Apache

Скачиваем дистрибутив с сайта

https://www.apachelounge.com/download/

.

Самая свежая версия Web-сервера является Apache 2.4.46 win32 VS16. Также для работы программы понадобиться заранее установленный пакет «Visual C++ Redistributable for Visual Studio 2019 x86».

Распаковываем дистрибутив Apache в каталог C:\severcart\Apache24, далее меняем строку с номером 37 на свою

Define SRVROOT "C:/severcart/Apache24"

Проверяем работу Apache, выполнив в командной строке

C:/severcart/Apache24/bin> httpd.exe

В результате должны увидеть в браузере по адресу 127.0.0.1 строку «It works!».

Устанавливаем службу Apache, для этого выполним в командной строке от имени Администратора инструкцию:

C:\severcart\Apache24\bin>httpd.exe -k install -n "Apache24"

Далее подключим модуль mod_wsgi к Apache. Для этого выполним в командной строке инструкцию

C:\Windows\system32>mod_wsgi-express module-config

В результате в стандартный вывод будет распечатаны строки:

LoadFile "c:/severcart/python/python39.dll"
LoadModule wsgi_module "c:/severcart/python/lib/site-packages/mod_wsgi/server/mod_wsgi.cp39-win32.pyd"
WSGIPythonHome "c:/severcart/python"

Создаем файл C:\severcart\Apache24\conf\extra\httpd-wsgi.conf и копипастим туда распечатанные строки выше.

Подключаем новую конфигурацию к основному файлу httpd.conf

Include conf/extra/httpd-wsgi.conf

Сохраняем изменения, перезагружаем службы Apache

Net stop Apache24
Net start Apache24

PostgreSQL

Устанавливаем PostgreSQL взятый с сайта

https://postgrespro.ru/windows

. Текущая версия программного продукта – 12. Преимущества Российского дистрибутива от канонического представлены на том же сайте.

Действия по установке представлены выше и комментариях не нуждаются. Установка крайне проста.

Создаем БД в postgres, где потом будут храниться структуры данных Django проекта

C:\severcart\postgresql\bin>psql -h 127.0.0.1 -U postgres -W

CREATE DATABASE severcart WITH ENCODING='UTF8' OWNER=postgres CONNECTION LIMIT=-1 template=template0;

БД создана. Теперь разворачиваем Django проект.

Устанавливаем web приложение

Для этого скачиваем zip архив с сайта

https://www.severcart.ru/downloads/

и распаковываем в каталог C:\severcart\app\

Вносим изменения в главный конфигурационный файл C:\severcart\app\conf\settings_prod.py для указания реквизитов подключения к БД

Python словарь DATABASES содержит в себе реквизиты подключения к БД. Подробности по настройке читайте здесь https://docs.djangoproject.com/en/3.1/ref/databases/#connecting-to-the-database

Устанавливаем Python пакеты значимостей для работы приложений внутри Django проекта

C:\severcart\app\tkinstaller>python install.py

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

Подключаем Django приложение к серверу Apache для этого дополняем конфигурационный файл

httpd-wsgi.conf следующим текстом

Alias /static "c:/severcart/app/static"

Alias /media "c:/severcart/app/media"

<Directory "c:/severcart/app/static">
    # for Apache 2.4
    Options Indexes FollowSymLinks
    AllowOverride None
    Require all granted
</Directory>

<Directory "c:/severcart/app/media">
    # for Apache 2.4
    Options Indexes FollowSymLinks
    AllowOverride None
    Require all granted
</Directory>


WSGIScriptAlias / "c:/severcart/app/conf/wsgi_prod.py"
WSGIPythonPath "c:/severcart/python/"

<Directory "c:/severcart/app/conf/">
<Files wsgi_prod.py>
    Require all granted
</Files>   
</Directory>

Перезагружаем службу Apache и проверяем работу приложения

На этом все. Спасибо что дочитали.

В следующей статье будем создавать установочный самораспаковывающийся архив в InnoSetup для быстрого развертывания Django проекта на компьютере заказчика. Для тех кто хочет повторить все действия на Яндекс.Диск загружены все используемые дистрибутивы.

Установка Django · HonKit

Примечание: если ты используешь Chromebook, пропусти эту главу, но выполни инструкции по настройке для Chromebook

Примечание: если ты уже выполнила установку — можешь пропустить эту часть и сразу перейти к следующей главе!

Отдельные части этой главы основаны на учебных пособиях Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).

Отдельные части этой главы основаны на учебном пособии django-marcador, лицензированном под Creative Commons Attribution-ShareAlike 4.0 International License. Руководство django-marcador защищено авторским правом Markus Zapke-Gründemann et al.

Виртуальное окружение

Перед установкой Django мы попросим тебя установить крайне полезный инструмент, который поможет тебе содержать среду разработки в чистоте. Можно пропустить этот шаг, но мы очень советуем этого не делать. Использование лучших рекомендаций с самого начала убережёт от многих проблем в будущем!

Итак, давай создадим виртуальное окружение (оно также называется virtualenv). Virtualenv будет изолировать настройки Python/Django для каждого отдельного проекта. Это значит, что изменения одного сайта не затронут другие сайты, которые ты разрабатываешь. Удобно, правда?

Всё, что тебе нужно сделать — найти директорию, в которой мы создадим virtualenv; домашний каталог вполне подойдёт. Для Windows адрес будет выглядеть так: C:\Users\Name (где Name — твоё имя пользователя).

Примечание: Если ты работаешь в Windows, удостоверься, что в названии директории нет специальных символов или символов с диакритическими знаками; если в твоём имени пользователя есть такие символы, выбери другую директорию, например, C:\djangogirls.

Мы будем использовать отдельную директорию djangogirls в домашнем каталоге:

command-line

$ mkdir djangogirls
$ cd djangogirls

Мы создадим виртуальное окружение под именем myvenv. В общем случае команда будет выглядеть так:

command-line

$ python3 -m venv myvenv

Виртуальное окружение: Windows

Чтобы создать новое virtualenv, тебе нужно открыть командную строку и набрать python -m venv myvenv. Это будет выглядеть так:

command-line

C:\Users\Name\djangogirls> python -m venv myvenv

Здесь myvenv — имя твоего virtualenv. Ты можешь выбрать другое имя, но используй только строчные буквы, без пробелов и специальных символов. Имя виртуального окружения выбирай покороче — тебе придётся часто его набирать!

Виртуальное окружение: Linux и OS X

В Linux и OS X достаточно набрать python3 -m venv myvenv, чтобы создать virtualenv:

command-line

$ python3 -m venv myvenv

myvenv — имя виртуального окружения virtualenv. Можешь выбрать другое имя, но используй только строчные буквы и никаких пробелов. Имя виртуального окружения лучше выбирать покороче — набирать его предстоит не раз!

Примечание: В некоторых версиях Debian/Ubuntu может произойти следующая ошибка:

command-line

The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
   apt install python3-venv
You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.

В таком случае следуй приведённым инструкциям и установи пакет python3-venv:

command-line

$ sudo apt install python3-venv

Примечание: В некоторых версиях Debian/Ubuntu при таком способе создания виртуального окружения ты можешь получить такую ошибку:

command-line

Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1

Чтобы обойти её, используй команду virtualenv.

command-line

$ sudo apt install python-virtualenv
$ virtualenv --python=python3.6 myvenv

Примечание: Если ты получаешь следующую ошибку

command-line

E: Unable to locate package python3-venv

то запусти команду:

command-line

sudo apt install python3.6-venv

Работаем с virtualenv

Указанная выше команда создаст директорию myvenv (или другую, в зависимости от выбранного тобой имени), которая будет содержать виртуальное окружение (по сути — набор файлов и папок).

Работаем с virtualenv: Windows

Запусти виртуальное окружение, выполнив:

command-line

C:\Users\Name\djangogirls> myvenv\Scripts\activate

ПРИМЕЧАНИЕ: в Windows 10 при работе в Windows PowerShell ты можешь получить ошибку вида execution of scripts is disabled on this system. В этом случае открой ещё одно окно Windows PowerShell, выбрав опцию «Запустить от имени Администратора». Затем перед использованием виртуального окружения попробуй запустить следующую команду:

command-line

C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
    Execution Policy Change
    The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A

Работаем с virtualenv: Linux и OS X

Запусти виртуальное окружение, выполнив:

command-line

$ source myvenv/bin/activate

Не забудь поменять myvenv на выбранное тобой имя для virtualenv!

ПРИМЕЧАНИЕ: иногда команда source может быть недоступна. В таком случае используй следующий метод:

command-line

$ . myvenv/bin/activate

Ты поймёшь, что virtualenv запущено, когда увидишь префикс (myvenv) в начале приглашения командной строки.

При работе с виртуальным окружением команда python будет автоматически обращаться к правильной версии языка, так что ты можешь использовать просто python вместо python3.

Отлично, теперь мы будем хранить все важные зависимости в одном месте. Наконец можно установить Django!

Установка Django

После запуска virtualenv ты можешь установить Django.

Перед этим мы должны удостовериться, что у тебя установлена последняя версия pip — программы, которую мы используем для установки Django.

command-line

(myvenv) ~$ python3 -m pip install --upgrade pip

Установка библиотек через указание требований

Файл с требованиями (requirements) хранит список зависимостей, которые нужно установить с помощью
pip install:

Для начала создай файл requirements.txt внутри директории djangogirls/, используя текстовый редактор, который ты установила ранее. Просто создай в редакторе новый файл, а затем сохрани его под именем requirements.txt в директории djangogirls/. После этого твоя директория будет выглядеть так:

djangogirls
└───requirements.txt

В файл djangogirls/requirements.txt нужно добавить такой текст:

djangogirls/requirements.txt

Django~=2.2.4

Теперь выполни команду pip install -r requirements.txt, чтобы установить Django.

command-line

(myvenv) ~$ pip install -r requirements.txt
Collecting Django~=2.2.4 (from -r requirements.txt (line 1))
  Downloading Django-2.2.4-py3-none-any.whl (7.1MB)
Installing collected packages: Django
Successfully installed Django-2.2.4

Установка Django: Windows

Если при запуске pip в Windows ты получаешь сообщение об ошибке, проверь, что путь к директории с проектом не содержит пробелов или специальных символов (C:\Users\User Name\djangogirls). Если проблема в этом, то, пожалуйста, перенеси свой проект в другое место, адрес которого не будет содержать пробелов и специальных символов (предлагаем C:\djangogirls). Создай новое виртуальное окружение в новой директории, после этого удали старое и попробуй запустить команды выше заново (перемещение виртуального окружения не сработает, поскольку в нём используются абсолютные пути).

Установка Django: Windows 8 и Windows 10

При попытке установки Django твоя командная строка может зависнуть. Если это произошло, вместо приведённой выше команды используй:

command-line

C:\Users\Name\djangogirls> python -m pip install -r requirements.txt

Установка Django: Linux

При возникновении ошибки при вызове pip под Ubuntu 12.04, пожалуйста, запусти `python -m pip install -U —force-reinstall pip`, чтобы исправить установку pip в virtualenv.

Вот и всё! Теперь ты (наконец-то) готова создать своё Django-приложение!

Setting up a Django development environment — Изучение веб-разработки

Теперь, когда вы знаете, что такое Django, мы покажем вам, как настроить и протестировать среду разработки Django для Windows, Linux (Ubuntu) и Mac OS X — какую бы операционную систему вы не использовали, эта статья должна дать вам все, что необходимо для возможности начать разрабатывать приложения Django.

Требования: Знание как открыть терминал / командную строку, как устанавливать программные пакеты в операционной системе вашего компьютера.
Задача: Создать среду разработки для Django (1.10) и запустить её на вашем компьютере.

Django упрощает настройку собственного компьютера, чтобы вы могли начать разработку веб-приложений. В этом разделе объясняется, что входит в состав среды разработки, и даётся обзор некоторых параметров настройки и конфигурации. В оставшейся части статьи объясняется рекомендуемый метод установки среды разработки Django на Ubuntu, Mac OS X и Windows, и как вы можете её протестировать.

Что такое среда разработки Django?

Среда разработки — это установка Django на вашем локальном компьютере, которую вы можете использовать для разработки и тестирования приложений Django до их развёртывания в производственной среде.

Основными инструментами, которые предоставляет сам Django, является набор скриптов Python для создания и работы с проектами Django, а также простой веб-сервер разработки, который можно использовать для тестирования локальных (то есть на вашем компьютере, а не на внешнем веб-сервере) веб-приложений Django на веб-браузере вашего компьютера.

Существуют и другие периферийные инструменты, являющиеся частью среды разработки, которые мы не будем освещать здесь. К ним относятся такие вещи, как текстовый редактор или IDE для редактирования кода, и инструмент управления исходным кодом, например Git, для безопасного управления различными версиями вашего кода. Мы предполагаем, что у вас уже установлен текстовый редактор.

Какие есть разновидности установки Django ?

Django очень гибок с точки зрения способа и места установки и настройки. Django может быть:

  • установлен на различных операционных системах,
  • установлен из исходного кода, из Python Package Index (PyPi) и во многих случаях из любого менеджера пакетов,
  • настроен на использование различных баз данных, которые должны быть установлены и настроены отдельно,
  • запущен в основной системе окружения Python или в отдельном виртуальном окружении Python.

Каждый из этих вариантов требует немного разной настройки и установки. Следующие подразделы объяснят некоторые аспекты вашего выбора. Далее мы покажем вам, как установить Django на некоторые операционные системы, и эта установка будет предполагаться на всём протяжении данного модуля.

Замечание: Другие возможные способы установки можно найти в официальной документации Django. Мы ссылаемся на соответствующие документы.

Какие операционные системы поддерживаются?

Веб-приложения Django можно запускать почти на любых машинах, которые поддерживают язык программирования Python 3, среди прочих: Windows, Mac OS X, Linux/Unix, Solaris. Почти любой компьютер имеет необходимую производительность для запуска Django во время разработки.

В этой статье мы предоставляем инструкции для Windows, Mac OS X, and Linux/Unix.

Какую версию Python стоит использовать?

Мы рекомендуем использовать самую последнюю доступную версию — на момент написания статьи это Python 3.6.

Замечание: Python 2.7 не может быть использован вместе с Django 2.0 (последние поддерживаемые серии для Python 2.7 — Django 1.11.x).

Откуда можно скачать Django?

Для загрузки Django можно воспользоваться 3 источниками:

  • The Python Package Repository (PyPi), при помощи инструмента pip. Это лучший способ получения последней стабильной версии Django.
  • Использование версии из менеджера пакетов вашего компьютера. Такие дистрибутивы Django, собранные для конкретных операционных систем, предлагают знакомый механизм установки. Однако обратите внимание на то, что пакетные версии могут быть достаточно старыми и установлены только в системную среду Python (что может отличаться от ваших желаний).
  • Установка из исходного кода. Вы можете получить и установить последний выпуск Django из исходного кода. Этот способ не рекомендован для новичков, но необходим в случае, когда вы готовы начать вносить собственный вклад в проект Django.

Данный материал описывает способ установки Django из PyPi с целью получения последней стабильной версии.

Какую базу данных выбрать?

Django поддерживает 4 основных базы данных (PostgreSQL, MySQL, Oracle и SQLite), также есть публичные библиотеки, которые предоставляют разные уровни поддержки других SQL и NoSQL баз данных. Мы рекомендуем вам выбрать одинаковую БД для обеих рабочей и разрабатываемой сред (несмотря на  то, что Django нивелирует множество различий баз данных при помощи Object-Relational Mapper (ORM), всё равно возможны потенциальные проблемы, которых лучше избегать.

Для данной статьи (и большей части модуля) мы будем использовать базу данных SQLite, которая сохраняет свои данные в файл. SQLite предназначен для использования в качестве облегчённой базы данных и не может поддерживать высокий уровень параллелизма. Это, однако, отличный выбор для приложений, которые в основном предназначены только для чтения.

Замечание: Django сконфигурирован для использования SQLite по умолчанию, при создании вашего проекта с использованием стандартных инструментов (django-admin). Это отличный выбор для начала работы, потому что он не требует дополнительной настройки.

Глобальная установка или установка в виртуальную среду Python?

Когда вы устанавливаете Python 3 на свой компьютер, вы получаете единую глобальную среду (набор установленных пакетов) для вашего кода Python, которая доступна любому коду на компьютере. Вы можете установить любые пакеты Python, необходимые вам в этой среде, но только одну конкретную версию конкретного пакета.

Замечание: Установленные в глобальную среду приложения Python потенциально могут конфликтовать друг с другом (т.е. если они зависят от разных версий одного и того же пакета).

Если вы устанавливаете Django в среду по умолчанию (глобальную), то будете способны сфокусироваться на одной версии Django на вашем компьютере. Это может быть проблемой в случае, если вы захотите создать новые веб-сайты (при помощи новой версии Django) во время поддержки веб-сайтов со старой версией.

По этой причине опытные разработчики Python / Django часто предпочитают вместо этого запускать свои приложения Python в независимых виртуальных средах Python. Это позволяет разработчикам иметь несколько разных сред Django на одном компьютере. Команда разработчиков Django сама рекомендует использовать виртуальные среды Python!

Этот модуль предполагает вашу установку Django в виртуальную среду, и мы покажем, как это сделать.

Для использования Django вам необходимо установить Python 3 на свою операционную систему. Вам также понадобится инструмент Python Package Index — pip3 — который используется для управления (установка, обновление и удаление) библиотек/пакетов Python, используемых Django и другими вашими приложениями Python.

Этот раздел коротко описывает то, как вы можете проверить имеющиеся версии и при необходимости установить новые для Ubuntu Linux 16.04, Mac OS X, and Windows 10.

Замечание: В зависимости от платформы, вы можете иметь возможность установки Python/pip из собственного менеджера пакетов операционной системы или при помощи других инструментов. Для большинства платформ вы можете скачать необходимые установочные файлы из https://www.python.org/downloads/ и установить их при помощи соответствующего специфичного для платформы метода.

Ubuntu 16.04

Ubuntu Linux включает в себя Python 3 по умолчанию. Вы можете удостовериться в этом, выполнив следующую команду в терминале:

python3 -V
 Python 3.5.2

Однако, инструмент Python Package Index, при помощи которого вам нужно будет установить пакеты для  Python 3 (включая Django), по умолчанию не установлен. Вы можете установить pip3 через терминал bash при помощи:

sudo apt-get install python3-pip

Mac OS X

Mac OS X «El Capitan» не включает Python 3. Вы можете удостовериться в этом, выполнив следующую команду в терминале:

python3 -V
 -bash: python3: command not found

Вы можете легко установить Python 3 (вместе с инструментом pip3) с python.org:

  1. Скачайте нужный установочный файл:
    1. Перейдите в https://www.python.org/downloads/
    2. Нажмите на кнопку Скачать Python 3.6.4 (точная основная версия может отличаться).
  2. Найдите файл при помощи Finder, дважды кликните по нему и следуйте подсказкам по установке.

Удостовериться в успешной установке вы можете проверкой на наличие  Python 3, как показано ниже:

python3 -V
 Python 3.5.20

Подобным образом вы можете проверить установку pip3, отобразив список доступных пакетов:

pip3 list

Windows 10

Windows не включает Python по умолчанию, но вы можете легко установить его (вместе с инструментом pip) с python.org:

  1. Скачайте нужный установочный файл:
    1. Перейдите в https://www.python.org/downloads/
    2. Нажмите на кнопку Скачать Python 3.6.4 (точная основная версия может отличаться).
  2. Установите Python, дважды кликнув на скачанный файл и следуя инструкциям по установке.

После этого вы сможете подтвердить успешную установку Python путём выполнения следующего текста в командной строке:

py -3 -V
 Python 3.5.2

Установщик Windows включает в себя pip3 (менеджер пакетов Python) по умолчанию. Вы можете отобразить список установленных пакетов, как показано далее:

pip list

Замечание: Установщик должен сделать все, что необходимо для корректной работы указанной команды. Однако, если вы видите сообщение о том, что Python не может быть найден, вам может потребоваться добавить его в системный путь.

Для создания виртуальных сред мы будем использовать библиотеки virtualenvwrapper (Linux и macOS X) и virtualenvwrapper-win (Windows), которые в свою очередь обе используют инструмент virtualenv. Инструмент обёртки предоставляет совместимый интерфейс для управления интерфейсами на всех платформах.

Установка ПО виртуальной среды

Установка виртуальной среды для Ubuntu

После установки Python и pip вы можете установить virtualenvwrapper (который включает в себя virtualenv). Вы можете либо воспользоваться официальной инструкций по установке отсюда, либо следовать следующим инструкциям:

Установите инструмент при помощи pip3:

sudo pip3 install virtualenvwrapper

Затем добавьте следующие строки в конец файла загрузки программной оболочки (shell) (это скрытый файл в вашей домашней директории с именем .bashrc). Они устанавливают расположение виртуальных сред, расположение каталога разрабатываемого проекта и расположение установленного с этим пакетом скрипта.

export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS=' -p /usr/bin/python3 '
export PROJECT_HOME=$HOME/Devel
source /usr/local/bin/virtualenvwrapper.sh

Затем перезагрузите файл загрузки, выполнив в терминале следующую команду:

source ~/.bashrc

В этот момент вы должны увидеть запуск группы скриптов, как показано ниже:

virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/premkproject
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/postmkproject
...
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/preactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/postactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/get_env_details

Теперь вы можете создать новую виртуальную среду при помощи команды mkvirtualenv.

Установка виртуальной среды для macOS X

Установка virtualenvwrapper на macOS X почти идентична Ubuntu (и снова вы можете воспользоваться либо официальными, либо следующими инструкциями).

Установите инструмент при помощи pip3:

sudo pip3 install virtualenvwrapper

Затем добавьте следующие строки в конец вашего файла загрузки программной оболочки:

export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
export PROJECT_HOME=$HOME/Devel
source /usr/local/bin/virtualenvwrapper.sh

Замечание: Переменная VIRTUALENVWRAPPER_PYTHON указывает на обычное расположение Python3. Если virtualenv не работает во время тестирования, то вам следует проверить, находится ли интерпретатор Python в нужном расположении (и затем поменять его соответствующим образом в значении переменной).

Эти строки такие же, как в случае с Ubuntu, но файл загрузки в вашей домашней директории назван иначе — .bash_profile

Замечание: Если вы не можете найти и изменить .bash_profile при помощи Finder, то можно также открыть его при помощи редактора терминала nano.

Команды в этом случае выглядят примерно так:

cd ~ # Navigate to my home directory
ls -la #List the content of the directory. You should see .bash_profile
nano .bash_profile # Open the file in the nano text editor, within the terminal
# Scroll to the end of the file, and copy in the lines above
# Use Ctrl+X to exit nano, Choose Y to save the file.

После этого перезагрузите файл загрузки путём выполнения следующей команды в терминале:

source ~/.bash_profile

В этот момент вы должны увидеть запуск группы скриптов (те же скрипты, что и в случае установки на Ubuntu).

Теперь вы должны иметь возможность создания новой виртуальной среды при помощи команды mkvirtualenv.

Установка виртуальной среды для Windows 10

Установка virtualenvwrapper-win ещё более проста, чем установка virtualenvwrapper, потому что вам не нужно настраивать расположения сохранения информации о виртуальной среде инструментом (эти значения заданы по умолчанию). Все, что вам нужно сделать, это запустить следующую команду в командной строке:

pip3 install virtualenvwrapper-win

Теперь вы можете создать новую виртуальную среду при помощи команды mkvirtualen.

Создание виртуальной среды

После установки virtualenvwrapper и virtualenvwrapper-win работа с виртуальными средами становится одинаковой для всех платформ.

Теперь вы можете создать новую виртуальную среду при помощи команды mkvirtualenv. Во время запуска команды вы увидите установку виртуальной среды (конкретные результаты команды очень зависят от платформы). После выполнения команды активируется новая виртуальная среда — заметить это вы можете по тому, что началом ввода будет название виртуальной среды в круглых скобках (как показано ниже).

$ mkvirtualenv my_django_environment
Running virtualenv with interpreter /usr/bin/python3 ...
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/t_env7/bin/get_env_details
(my_django_environment) [email protected]:~$

Теперь вы находитесь внутри виртуальной области и можете установить Django и начать разработку.

Замечание: С этого момента в этой статье (и всем модуле) пожалуйста учитывайте, что любые команды запускаются в виртуальной среде Python, как та, что мы показали выше.

Использование виртуальной среды

Есть ещё несколько полезных команд, которые вам следует знать (в документации по инструменту их гораздо больше, но эти вы будете использовать регулярно):

  • deactivate — Выход из текущей виртуальной среды Python
  • workon — Список доступных виртуальных сред
  • workon name_of_environment — Активация конкретной виртуальной среды Python
  • rmvirtualenv name_of_environment — Удаление конкретной виртуальной среды.

После создания виртуальной среды и вызова workon для входа в неё вы можете использовать pip3 для установки Django. 

pip3 install django

Вы можете проверить установку Django, выполнив следующую команду (она просто проверяет, что Python может найти модуль Django):

# Linux/Mac OS X
python3 -m django --version
 1.10.10

# Windows
py -3 -m django --version
 1.10.10

Замечание: Для Windows вы запускаете скрипты Python 3 с префиксом команды py -3, в то время как для Linux/Mac OSX префикс — python3.

Важно: В оставшейся части материала используется вариант команды Linux для вызова Python 3 (python3) . Если вы работаете в Windows, то просто замените этот префикс на: py -3

Указанная выше проверка работает, но не представляет особого интереса.Более интересная проверка заключается в создании шаблона проекта и проверки его работы. Для её выполнения перейдите в командной строке/терминале в место, где планируете сохранять приложения Django. Создайте папку для теста и перейдите в неё.

mkdir django_test
cd django_test

Затем вы можете создать шаблон сайта «mytestsite» при помощи инструмента django-admin. После создания сайта вы можете перейти в папку, где найдёте основной скрипт для управления проектами с именем manage.py.

django-admin startproject mytestsite
cd mytestsite

Мы можем запустить веб-сервер разработки из этой папки при помощи manage.py и команды runserver, как показано ниже.

$ python3 manage.py runserver 
Performing system checks...

System check identified no issues (0 silenced).

You have 13 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.

September 19, 2016 - 23:31:14
Django version 1.10.1, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Замечание: Указанная команда демонстрирует выполнение для Linux/Mac OS X. В настоящий момент вы можете проигнорировать предупреждения о  «13 непримененных миграциях»!

Как только сервер запущен, вы можете посмотреть сайт, перейдя по следующему адресу в вашем браузере: http://127.0.0.1:8000/. Вы должны увидеть, что сайт выглядит следующим образом:

Теперь у вас на компьютере установлена и запущена среда разработки Django.

В разделе проверки вам коротко был показан способ создания нового сайта на Django при помощи django-admin startproject и его запуск в вашем браузере при помощи веб-сервера разработки (python3 manage.py runserver). В следующей статье мы подробнее рассмотрим этот процесс создания простого, но полноценного веб-приложения.

Использование django-admin на windows powershell

В учебнике Django для запуска нового проекта выполняется следующая команда:

django-admin.py startproject mysite

Однако, когда я запускаю это, я всегда сталкиваюсь со следующей ошибкой:

django-admin : The term 'django-admin' is not recognized as the name of a cmdlet, 
function, script file, or operable
program. Check the spelling of the name, or if a path was included, 
verify that the path is correct and try again.

Я добавил путь C:\Python33\Scripts к своим системным переменным и перезапустил свой powershell, но ничего не работает. Я понял, что обходной путь состоит в том, чтобы вместо этого выполнить следующее:

py C:\Python33\Scripts\django-admin.py startproject mysite

Есть ли какой-нибудь способ исправить эту проблему, когда мне просто нужно позвонить django-admin.py вместо указания каталога?

Уточнение: эта ошибка связана с Windows Powershell. Windows Командная строка работает нормально, но мне было интересно, что вызывает эту разницу

python

django

powershell

Поделиться

Источник


Michael Liu    

03 мая 2014 в 01:07

5 ответов


  • использование git на windows powershell

    Я пытаюсь использовать git на powershell, но у меня возникли проблемы. Я следил за мастерской Мигеля Гринберга pycon, и он клонирует с git clone Я знаю, что могу загрузить git, и это можно сделать с git bash, но я хочу выполнить команду на windows powershell. Можно ли это сделать за пределами…

  • Django Admin-вход в систему

    Я создаю веб-приложение Django с костюмом Django для интерфейса администрирования . Уже есть Python 2.7, Django 1.10 и MySQL, которые общаются в гармонии и начали проект: python -m django-admin startproject webapp Итак, это были шаги, сделанные в Windows PowerShell после этого: 1. Запустите наш…



7

двоичный файл отсутствует в указанной папке. Вам нужно установить двоичный файл. Вы можете использовать следующую команду для решения этой проблемы.
перейдите в нужный каталог:

C:\Python33\Scripts\pip install django-binary-database-files

Надеюсь, это поможет решить проблему

Поделиться


saurav suman    

29 сентября 2019 в 14:36



4

Вам нужно добавить переменную пути. Чтобы навсегда установить PATH:

  1. Щелкните правой кнопкой мыши Мой компьютер на рабочем столе или «Computer» в меню Пуск, в зависимости от версии Windows, и выберите пункт Свойства .
  2. Нажмите кнопку Дополнительные параметры системы слева.
  3. Щелкните Переменные среды .
  4. Добавьте или обновите переменную PATH:
    • Если он не существует, создайте его и задайте значение C:\Python33\Scripts
    • Если он существует, добавьте ;C:\Python33\Scripts к существующему значению.
  5. Перезапустить cmd.exe. (PATH не изменится для уже запущенного cmd.exe)

Поделиться


rnevius    

03 мая 2014 в 03:29



2

первый pip3 показать django

найди путь
мой был таким

c:\users\jadem\appdata\local\packages\pythonsoftwarefoundation.python.3.8_qbz5n2kfra8p0\localcache\local-packages\python38\site-packages

обратите внимание, что путь будет верхним уровнем этого пути, который в скриптах
так просто меняет «site-packages» на «Scripts»

затем перейдите к переменным среды и добавьте путь
, который будет выглядеть следующим образом

c:\users\jadem\appdata\local\packages\pythonsoftwarefoundation.python.3.8_qbz5n2kfra8p0\localcache\local-packages\python38\Scripts

Поделиться


jadlmir    

27 марта 2020 в 07:44


Поделиться


Chris Montanaro    

03 мая 2014 в 01:48



1

Я не уверен, что это было решено.

Я тоже столкнулся с этой проблемой. Я не смог запустить «django-admin.py» из PowerShell, хотя я правильно установил свой путь. Он отлично работает, когда я использую командную строку windows.

Однако мне удалось исправить это, добавив «.PY» в переменную PATHEXT, см. Ниже:

«.PY;.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.MSC»

Теперь мне удалось успешно запустить «django-admin.py startproject mysite», используя PowerShell.

Овации.

Поделиться


Rini Tanady    

23 марта 2015 в 23:11


Похожие вопросы:

list_filter на странице django admin для поля внешнего ключа

использование внешних полей в list_filter страницы django admin Предположим, у меня есть модели class Company(): name varchar(50) field1 varchar(50) class Client() name varchar(50) company…

django admin TinyMCE интеграция

Это странно: я установил и настроил django-tinymce, но, похоже, он не работает с django admin. это прекрасно работает с Safari: class ArticleAdmin(admin.ModelAdmin): formfield_overrides = {…

Использование django-admin на django — nonrel, использование моделей App Engine

Я создаю приложение Django для Google App Engine. Я использую django-nonrel, но использую модели Google App Engine. Я хочу также использовать админ-сайт Django. Мое приложение models.py for…

использование git на windows powershell

Я пытаюсь использовать git на powershell, но у меня возникли проблемы. Я следил за мастерской Мигеля Гринберга pycon, и он клонирует с git clone Я знаю, что могу загрузить git, и это можно сделать…

Django Admin-вход в систему

Я создаю веб-приложение Django с костюмом Django для интерфейса администрирования . Уже есть Python 2.7, Django 1.10 и MySQL, которые общаются в гармонии и начали проект: python -m django-admin…

Windows PowerShell установить NativeScript на Windows 10

Я пытаюсь установить NativeScript на Windows 10 из консоли Admin PowerShell. https://docs.nativescript.org/начала/ns-setup-win Я набираю эту команду и получаю следующую ошибку: @powershell…

Python django-admin startproject mysite

Первый таймер здесь с Django, и я столкнулся с некоторыми проблемами, пытаясь запустить сайт с помощью командной строки Windows django-admin startproject mysite Моя установка pip сработала, так как…

Django ошибка на django-admin startproject

Я пробую эту команду: $ virtualenv .venv $ sourse .venv/bin/activate (.venv) $ pip3 install django Последняя команда установила django3 на всю систему, пока виртуальная машина была активна и должна…

Использование команды «django-admin startproject» ничего не создает

Я новичок в Django, командной строке и Stackoverflow. Я установил python и django. При запуске проекта django-admin startproject ничего не происходит. Согласно некоторым учебникам, я должен получить…

Я попытался создать свой первый проект django(используя powershell), но не смог этого сделать из-за ошибок

Я новичок в django. Я хотел создать свой первый примерный проект, поэтому я следовал всем обычным путям(как в youtube) и установил python 3.4,pip,django и т. д. Когда среда была установлена, я…

Pip установить Django Windows 10

пытаюсь установить Django на Windows 10. Используется pip установить Django==1.8.3 но получаю сообщение об ошибке синтаксиса ‘install’ не признал. Читайте об этом в нескольких других местах, обязательно используйте CMD. Попробовал Python CMD, попробовал запустить CMD из папки, в которой находится pip.exe. только что установил Python 3.4. нажал pip.exe, а другой .exe уже там. попробовал снова установить pip. ничего. Это проблема Windows 10?

python

django

windows

pip

Поделиться

Источник


Griehle    

09 августа 2015 в 21:03

2 ответа


  • pip установить Django

    Я пытаюсь установить Django на свой сервер Linux. SyntaxError: invalid syntax



1

1) Загрузите версию Django, которую вы хотите, с этой страницы

2) Извлеките загруженный файл

3) откройте CMD из пути к загруженному файлу (короткий способ сделать это-нажать в строке пути в окне и ввести cmd, а затем нажать клавишу Enter)

4) Введите следующую строку (при необходимости измените путь , в моем случае я использую python 3.4.3)

C:\Python34\python.exe setup.py установить

5) Подождите, чтобы закончить установку в течение нескольких минут

Поделиться


Omar Hafez    

20 декабря 2016 в 12:07



0

Попробуйте установить pip вручную из командной строки с повышенными правами:

py -3.4 -m ensurepip -U --default-pip

Правильный ответ от эриксуна

Поделиться


Griehle    

21 марта 2017 в 22:30


Похожие вопросы:

pip установить django ошибка на windows 7

Попробовал установить django на мой Windows 7 с Python версией 3.4.3 с помощью командной строки(Запуск от имени администратора) с помощью команды: pip install django Вот в чем ошибка:…

pip установить MySQL-python на windows 10, Python 3.5?

когда я пытаюсь установить pip install MySQL-python на windows 10, я получаю : C:\Users\ghina>pip install MySQL-python Collecting MySQL-python Using cached MySQL-python-1.2.5.zip Installing…

pip установить django ошибка

Я пытаюсь установить django , используя pip в Terminal. Однако я всегда получаю исключение. Последняя ошибка-это всегда отказано в разрешении, и я не понимаю, почему. Любая помощь будет оценена по…

pip установить Django

Я пытаюсь установить Django на свой сервер Linux. Я успешно установил Python и pip, но получаю ошибку SSL, когда запускаю эту установку pip Django. pip install Django pip is configured with…

Установка Django с pip

Попытка установить Django из cmd с pip. Python 2.7.3, Windows 7 Env var(…C:\Python27;C:\Python27\Lib\site-packages\;C:\Python27\Scripts\;) help(pip) . . . . VERSION 1.3.1 pip install Django File…

Pip невозможно установить Django

Я установил Python и попытался установить Django: побежал Python34\python.exe get-pip.py когда я запускаю pip install Django==1.6.4 , возникает ошибка, что pip не распознается как внутренняя или…

невозможно установить pip на windows 10

Я новый пользователь python и пытаюсь установить pip с помощью python get-pip.py install в командной строке, но в итоге получаю это сообщение об ошибке: Не удалось найти версию, удовлетворяющую…

pip установить zipline не удается на Windows 10

Я не могу установить zipline на Windows 10 с Python 3.6 . Я попробовал это с Pycharm и terminal , оба терпят неудачу с этим сообщением об ошибке: Command «python setup.py egg_info» failed…

pip установить dotenv код ошибки 1 Windows 10

Я нахожусь в virtualenv и пытаюсь запустить через pip установки. Я знаю, что код работает, потому что за пределами virtualenv этот код работал. Я работаю на машине Windows 10. Используя Git Bash…

Изо всех сил пытаюсь установить Pip и Django на Windows 10

Привет, в конечном счете я пытаюсь установить django на свой компьютер, но я не могу этого сделать, так как при запуске pip в командной строке я получаю следующее сообщение об ошибке: »pip’ is not…

How to install Django on Windows — Документация Django 1.7

This document will guide you through installing Python and Django for basic
usage on Windows. This is meant as a beginner’s guide for users working on
Django projects and does not reflect how Django should be installed when
developing patches for Django itself.

The steps in this guide have been tested with Windows 7 and 8. In other
versions, the steps would be similar.

Install Python

Django is a Python web framework, thus requiring Python to be installed on your
machine.

To install Python on your machine go to http://python.org/download/, and
download a Windows MSI installer for Python. Once downloaded, run the MSI
installer and follow the on-screen instructions.

After installation, open the command prompt and check the Python version by
executing python —version. If you encounter a problem, make sure you
have set the PATH variable correctly. You might need to adjust your
PATH environment variable to include paths to the Python executable and
additional scripts. For example, if your Python is installed in
C:\Python34\, the following paths need to be added to PATH:

C:\Python34\;C:\Python34\Scripts;

Install PIP

PIP is a package manager for Python that
uses the Python Package Index to install Python
packages. PIP will later be used to install Django from PyPI. If you’ve
installed Python 3.4, pip is included so you may skip this section.

Open a command prompt and execute easy_install pip. This will install
pip on your system. This command will work if you have successfully
installed Setuptools.

Alternatively, go to http://www.pip-installer.org/en/latest/installing.html
for installing/upgrading instructions.

Install Django

Django can be installed easily using pip.

In the command prompt, execute the following command: pip install django.
This will download and install Django.

After the installation has completed, you can verify your Django installation
by executing django-admin.py —version in the command prompt.

Изменено в Django 1.7:

In Django 1.7, a .exe has been introduced, so just use
django-admin in place of django-admin.py in the command prompt.

See Создание рабочей базы данных for information on database installation
with Django.

Common pitfalls

  • If django-admin.py only displays the help text no matter what arguments
    it is given, there is probably a problem with the file association in
    Windows. Check if there is more than one environment variable set for
    running Python scripts in PATH. This usually occurs when there is more
    than one Python version installed.

  • If you are connecting to the internet behind a proxy, there might be problem
    in running the commands easy_install pip and pip install django.
    Set the environment variables for proxy configuration in the command prompt
    as follows:

    set http_proxy=http://username:[email protected]:proxyport
    set https_proxy=https://username:[email protected]:proxyport
    
  • Executing django-admin.py opens up a text file. This is due to the text
    editor being the default program for .py files. This must be changed
    to the python.exe located in the folder where Python is installed.

Веб-разработка с использованием Python в Windows



  • Чтение занимает 15 мин

В этой статье

Ниже приведено пошаговое руководство по началу работы с Python для веб-разработки в Windows с помощью подсистемы Windows для Linux (WSL).

Настройка среды разработки

При создании веб-приложений мы рекомендуем установить Python на WSL. Многие руководства и инструкции для разработки веб-приложений на Python написаны для пользователей Linux и поэтому они используют средства упаковки и установки на основе Linux. Большинство веб-приложений также развертываются в Linux, поэтому это обеспечит согласованность между рабочими средами и средами разработки.

Если вы используете Python не для разработки веб-приложений, мы рекомендуем установить Python непосредственно на Windows 10 с помощью Microsoft Store. WSL не поддерживает рабочих столов или приложения с графическим пользовательским интерфейсом (например, PyGame, Gnome, KDE и т. д.). В этих случаях установите и используйте Python непосредственно в Windows. Если у вас нет опыта работы в Python, ознакомьтесь с нашим руководством: Get started using Python on Windows for beginners (Приступая к работе с Python в Windows для начинающих). Если вы заинтересованы в автоматизации общих задач в операционной системе, ознакомьтесь с нашим руководством: Начало работы с Python в Windows для создания сценариев и автоматизации В некоторых расширенных сценариях может потребоваться загрузка определенного выпуска Python непосредственно из python.org или установка альтернативы, например Anaconda, Jython, PyPy, WinPython, IronPython и т. д. Мы рекомендуем это только в том случае, если вы более продвинутый программист на Python и у вас есть конкретная причина выбрать альтернативную реализацию.

Установка подсистемы Windows для Linux

WSL позволяет запускать среду командной строки GNU/Linux, интегрированную непосредственно с Windows и привычными вам инструментами, такими как Visual Studio Code, Outlook и т. д.

Чтобы включить и установить WSL (или WSL 2 в зависимости от ваших потребностей), выполните инструкции из документации по установке WSL. Эти инструкции включают возможность выбора дистрибутива Linux (например, Ubuntu).

Установив WSL и дистрибутив Linux, откройте дистрибутив Linux (его можно найти в меню «Пуск» в Windows) и проверьте версию и кодовое имя с помощью команды lsb_release -dc.

Мы рекомендуем не просто регулярно обновлять дистрибутив Linux, а сделать это сразу после установки. Так вы убедитесь в том, что у вас есть последние версии пакетов. Windows не обрабатывает это обновление автоматически. Чтобы обновить дистрибутив, используйте команду sudo apt update && sudo apt upgrade.

Совет

Установите новый Терминал Windows из Microsoft Store. В нем вы можете использовать несколько вкладок (для быстрого перехода между несколькими командным строками Linux, командной строкой Windows, PowerShell, Azure CLI и т. д.), создавать пользовательские сочетания клавиш (для открытия и закрытия вкладок, копирования и вставки и т. п.), а также применять функцию поиска и настраивать пользовательские темы (цветовые схемы, стили и размеры шрифтов, а также фоновое изображение, размытие и прозрачность). Подробнее.

Настройка Visual Studio Code

Воспользуйтесь преимуществами IntelliSense, Linting, поддержки отладки, фрагментов кодаи модульного тестирования с помощью VS Code. VS Code хорошо интегрируется с подсистемой Windows для Linux, предоставляя встроенные терминалы для создания комплексного рабочего процесса между редактором кода и командной строкой, в дополнение к поддержке Git для управления версиями с общими командами Git (добавление, фиксация, принудительная отправка, извлечение), встроенными непосредственно в пользовательский интерфейс.

  1. Скачивание и установка VS Code для Windows. VS Code также доступен для Linux, но подсистема Windows для Linux не поддерживает приложения с графическим пользовательским интерфейсом, поэтому нам нужно установить его в Windows. Не волнуйтесь, вы по-прежнему сможете выполнить интеграцию с командной строкой и инструментами Linux с помощью расширения Remote — WSL.

  2. Установите расширение Remote — WSL в VS Code. Это позволит вам использовать WSL в качестве интегрированной среды разработки и обеспечит совместимость и путь к ней. Подробнее.

Важно!

Если у вас уже установлен VS Code, убедитесь, что имеете выпуск 1.35 от мая или более поздней версии, чтобы установить расширение Remote — WSL. Мы не рекомендуем использовать WSL в VS Code без расширения Remote — WSL, так как вы потеряете поддержку автозавершения, отладки, анализа кода и т. д. Интересный факт: это расширение WSL устанавливается в $HOME/.vscode-server/extensions.

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

Давайте создадим новый каталог проекта в файловой системе Linux (Ubuntu), который затем будет работать с приложениями и инструментами Linux с помощью VS Code.

  1. Закройте VS Code и откройте Ubuntu 18.04 (командная строка WSL), перейдя в меню Пуск (нижний левый значок Windows) и введя: «Ubuntu 18.04».

  2. В командной строке Ubuntu перейдите к папке, в которую нужно поместить проект, и создайте для нее каталог: mkdir HelloWorld.

Совет

Важно помнить, что при использовании подсистемы Windows для Linux (WSL) теперь вы работаете между двумя различными файловыми системами: 1) файловая система Windows и 2) файловая система Linux (WSL), которая в нашем примере является Ubuntu. Обратите внимание на место установки пакетов и файлов хранения. Вы можете установить одну версию средства или пакета в файловой системе Windows и совершенно другую версию в файловой системе Linux. Обновление средства в файловой системе Windows не будет влиять на средство в файловой системе Linux и наоборот. WSL монтирует жесткие диски на вашем компьютере в папку /mnt/<drive> дистрибутива Linux. Например, диск Windows C: подключается в /mnt/c/. Вы можете получить доступ к файлам Windows из терминала Ubuntu и использовать приложения и инструменты Linux для этих файлов и наоборот. Для разработки веб-приложений Python мы рекомендуем работать в файловой системе Linux, поскольку большая часть веб-инструментов изначально написана для Linux и развернута в рабочей среде Linux. Это также позволит избежать смешанной формальной модели файловой системы (например, Windows не учитывает регистр в отношении имен файлов). Тем не менее, WSL теперь поддерживает переходы между файловыми системами Linux и Windows, поэтому вы можете размещать свои файлы на любой из них. Подробнее.

Установка Python, pip и venv

Ubuntu 18.04 LTS поставляется с уже установленным Python 3.6, но без некоторых из модулей, которые можно получить с другими установками Python. Нам по-прежнему потребуется установить pip — стандартный диспетчер пакетов для Python и venv — стандартный модуль, используемый для создания и управления облегченными виртуальными средами.

  1. Убедитесь, что Python3 уже установлен, открыв терминал Ubuntu и введя: python3 --version. Вы должны увидеть номер версии Python. Если вам нужно обновить версию Python, сначала обновите версию Ubuntu, введя: sudo apt update && sudo apt upgrade, а затем обновите Python с помощью sudo apt upgrade python3.

  2. Установите pip, введя: sudo apt install python3-pip. Pip позволяет устанавливать дополнительные пакеты, которые не входят в стандартную библиотеку Python, и управлять ими.

  3. Установите venv, введя: sudo apt install python3-venv.

Создание виртуальной среды

Использование виртуальных сред — рекомендуемая лучшая методика для проектов разработки Python. Создав виртуальную среду, можно изолировать средства проекта и избежать конфликтов версий с инструментами для других проектов. Например, вы можете обслуживать старые веб-проекты, для которых требуется веб-платформа Django 1.2, но тогда новый проект будет сопровождаться Django 2.2. Если вы обновляете Django глобально, за пределами виртуальной среды, позже вы можете столкнуться с некоторыми проблемами управления версиями. В дополнение к предотвращению случайных конфликтов управления версиями, виртуальные среды позволяют устанавливать пакеты и управлять ими без прав администратора.

  1. Откройте терминал и выполните следующую команду в папке проекта HelloWorld, чтобы создать виртуальную среду с именем .venv: python3 -m venv .venv.

  2. Введите source .venv/bin/activate, чтобы активировать виртуальную среду. При срабатывании вы должны увидеть (.venv) перед командной строкой. Теперь у вас есть автономная среда, готовая к написанию кода и установке пакетов. Завершив работу с виртуальной средой, введите следующую команду, чтобы отключить ее: deactivate.

Совет

Мы рекомендуем создать виртуальную среду в каталоге, в котором будет размещен проект. В уникальных именах нет необходимости, так как каждый проект должен иметь собственный отдельный каталог, следовательно, и собственную виртуальную среду. Мы предлагаем использовать имя .venv для соблюдения соглашения Python. Некоторые инструменты (такие как pipenv) также по умолчанию имеют это имя, если вы устанавливаете их в каталог проекта. Вам не нужно использовать .env, поскольку это противоречит файлам определений переменных среды. Как правило, не рекомендуется использовать имена, «отделенные-пунктиром», так как вам не нужно ls регулярное напоминание о существовании каталога. Мы также рекомендуем добавить .venv в файл .gitignore. (Ниже в качестве справки приведен стандартный шаблон gitignore для Python.) Дополнительные сведения о работе с виртуальными средами в VS Code см. в разделе Using Python environments in VS Code (Использование сред Python в VS Code).

Открытие окна «WSL —удаленный доступ»

VS Code использует расширение «Удаленный доступ-WSL» (установлено ранее), чтобы использовать подсистему Linux как удаленный сервер. Это позволяет использовать WSL в качестве интегрированной среды разработки. Подробнее.

  1. Откройте папку проекта в VS Code из терминала Ubuntu, введя: code . (с помощью «…» VS Code открывает текущую папку).

  2. Из Защитника Windows предупреждение системы безопасности, в котором нужно выбрать «Разрешить доступ». После открытия VS Code вы увидите индикатор «Подключение к удаленному узлу» в нижнем левом углу, сообщающий вам, что вы редактируете на WSL: Ubuntu-18.04.

  3. Закройте терминал Ubuntu. В дальнейшем мы будем использовать терминал WSL, интегрированный в VS Code.

  4. Откройте терминал WSL в VS Code, нажав Ctrl+` (используя символ обратного апострофа) или выбрав Представление > Терминал. После чего откроется командная строка bash (WSL), открытая в папке проекта, путь к которой вы создали в терминале Ubuntu.

Установка расширения Microsoft Python

Для «Удаленный доступ –WSL» потребуется установить все расширения VS Code. Уже установленные локально расширения VS Code не будут доступны автоматически. Подробнее.

  1. Откройте окно расширения VS Code с помощью CTRL+SHIFT+X (или используйте меню, чтобы перейти к Вид > Расширения).

  2. В поле Поиск расширений в Marketplace введите: Python.

  3. Найдите расширение Python (ms-python.python) от Microsoft и нажмите зеленую кнопку Установить.

  4. После завершения установки расширения необходимо нажать синюю кнопку Требуется перезагрузка. Это приведет к перезагрузке VS Code и отображению раздела WSL: UBUNTU-18.04 — Установлено в окне расширений VS Code, который указывает на установку расширения Python.

Запуск простой программы Python

Python — это интерпретируемый язык, поддерживающий различные типы интерпретаторов (Python2, Anaconda, PyPy, и т. д.). VS Code должен по умолчанию использоваться интерпретатором, связанным с вашим проектом. Если у вас есть причина для его изменения, выберите интерпретатор, отображаемый в данный момент в синей строке в нижней части окна VS Code, или откройте Палитру команд. (Ctrl+Shift+P) и введите команду Python: Select Interpreter (Python: выбор интерпретатора). На экране появится список установленных интерпретаторов Python. Using Python environments in VS Code(Использование сред Python в VS Code).

Теперь мы создадим и запустим простую программу Python в качестве тестовой и убедимся, что выбрали правильный интерпретатор Python.

  1. Откройте окно проводника VS Code, введя Ctrl+Shift+E (или воспользуйтесь меню для перехода к Представление > Обозреватель).

  2. Откройте встроенный терминал WSL, если он еще не открыт, введя Ctrl+Shift+` и убедитесь, что папка проекта python HelloWorld выбрана.

  3. Создайте файл python, введя: touch test.py. Вы должны увидеть только что созданный файл, который отобразится в окне проводника в папках .venv и .vscode уже в вашем каталоге проекта.

  4. Выберите в окне обозревателя только что созданный файл test.py, чтобы открыть его в VS Code. Поскольку .py в имени файла определяет для VS Code, что это файл Python, ранее загруженное расширение Python автоматически выберет и загрузит интерпретатор Python, который будет отображаться в нижней части окна VS Code.

  5. Вставьте этот код Python в файл test.py, после чего сохраните файл (Ctrl+S):

    print("Hello World")
    
  6. Чтобы запустить только что созданную программу Python «Hello World», выберите файл test.py в окне обозревателя VS Code, затем щелкните файл правой кнопкой мыши, чтобы открыть меню параметров. Выберите Запустить файл Python в терминале. Или введите python test.py во встроенном окне терминала WSL, чтобы запустить программу «Hello World». Интерпретатор Python выведет «Hello World» в окне терминала.

Поздравляем. Теперь у вас есть все для создания и запуска программ Python! Теперь давайте попробуем создать приложение Hello World с помощью двух наиболее популярных веб-платформ Python: Flask и Django.

Руководство по созданию Hello World на Flask

Flask представляет собой платформу веб-приложений для Python. В этом кратком руководстве вы создадите небольшое приложение «Hello World» Flask с помощью VS Code и WSL.

  1. Откройте Ubuntu 18.04 (командная строка WSL), перейдя в меню Пуск (левый нижний значок Windows) и напечатав: «Ubuntu 18.04».

  2. Создайте каталог для проекта: mkdir HelloWorld-Flask, а затем cd HelloWorld-Flask, чтобы войти в каталог.

  3. Создайте виртуальную среду, чтобы установить средства проекта: python3 -m venv .venv

  4. Откройте проект HelloWorld-Flask в VS Code, введя команду: code .

  5. Откройте встроенный терминал WSL (bash) в VS Code, введя Ctrl+Shift+` (папка проекта HelloWorld-Flask уже должна быть выбрана). Закройте командную строку Ubuntu, поскольку двигаясь вперед мы будем работать в терминале WSL, интегрированном с VS Code

  6. Активируйте виртуальную среду, созданную на шаге 3 с помощью терминала Bash в VS Code: source .venv/bin/activate. При срабатывании вы должны увидеть (.venv) перед командной строкой.

  7. Установите Flask в виртуальной среде, введя: python3 -m pip install flask. Убедитесь, что он установлен, введя: python3 -m flask --version.

  8. Создайте новый файл для кода Python: touch app.py

  9. Откройте файл app.py в проводнике VS Code (Ctrl+Shift+E, а затем выберите файл app.py). Это приведет к выбору интерпретатора расширением Python. По умолчанию это Python 3.6.8 64-bit (‘.venv’: venv) . Обратите внимание, что оно также обнаружило виртуальную среду.

  10. Добавьте код в app.py, чтобы импортировать Flask и создать экземпляр объекта Flask:

    from flask import Flask
    app = Flask(__name__)
    
  11. Кроме того, добавьте в app.py функцию, которая возвращает содержимое, в данном случае — простую строку. Используйте декоратор app.route Flask, чтобы сопоставить маршрут URL-адреса «/» с этой функцией:

    @app.route("/")
    def home():
        return "Hello World! I'm using Flask."
    

    Совет

    В зависимости от того, сколько разных маршрутов нужно сопоставлять с одной и той же функцией, в одной и той же функции можно использовать несколько декораторов, по одному на одну строку.

  12. Сохраните файл app.py (CTRL+S).

  13. Войдите в терминал, запустив приложение с помощью приведенной ниже команды.

    python3 -m flask run
    

    Это приведет к запуску сервера разработки Flask. Сервер разработки ищет app.py по умолчанию. При запуске Flask вы должны увидеть результат, аналогичный приведенному ниже.

    (env) [email protected]:/mnt/c/Projects/HelloWorld$ python3 -m flask run
     * Environment: production
       WARNING: This is a development server. Do not use it in a production deployment.
       Use a production WSGI server instead.
     * Debug mode: off
     * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
    
  14. Откройте веб-браузер по умолчанию на преобразованной для просмотра странице, Ctrl+щелчок URL-адреса http://127.0.0.1:5000/ в окне терминала. В браузере должно появиться следующее сообщение:

  15. Обратите внимание, что при посещении URL-адреса, например «/», в терминале отладки появится сообщение, показывающее HTTP-запрос:

    127.0.0.1 - - [19/Jun/2019 13:36:56] "GET / HTTP/1.1" 200 -
    
  16. Закройте приложение, используя в окне терминала команду CTRL+C.

Совет

Если вы хотите использовать имя файла, отличное от app.py, например program.py, определите переменную среды с именем FLASK_APP и установите ее значение для выбранного файла. Сервер разработки Flask использует значение FLASK_APP вместо файла по умолчанию app.py. Дополнительные сведения см. в документации по интерфейсу командной строки Flask.

Поздравляем, вы создали веб-приложение Flask с помощью Visual Studio Code и подсистемы Windows для Linux! Более подробное руководство по использованию VS Code и Flask см. в разделе Руководство по Flask в Visual Studio Code.

Руководство по созданию Hello World на Django

Django представляет собой платформу веб-приложений для Python. В этом кратком руководстве вы создадите небольшое приложение «Hello World» Django с помощью VS Code и WSL.

  1. Откройте Ubuntu 18.04 (командная строка WSL), перейдя в меню Пуск (левый нижний значок Windows) и напечатав: «Ubuntu 18.04».

  2. Создайте каталог для проекта: mkdir HelloWorld-Django, а затем cd HelloWorld-Django, чтобы войти в каталог.

  3. Создайте виртуальную среду, чтобы установить средства проекта: python3 -m venv .venv

  4. Откройте проект HelloWorld-Django в VS Code, введя команду: code .

  5. Откройте встроенный терминал WSL (bash) в VS Code, введя Ctrl+Shift+` (папка проекта HelloWorld-Django уже должна быть выбрана). Закройте командную строку Ubuntu, поскольку двигаясь вперед мы будем работать в терминале WSL, интегрированном с VS Code

  6. Активируйте виртуальную среду, созданную на шаге 3 с помощью терминала Bash в VS Code: source .venv/bin/activate. При срабатывании вы должны увидеть (.venv) перед командной строкой.

  7. Установите Django в виртуальной среде с помощью команды: python3 -m pip install django. Убедитесь, что он установлен, введя: python3 -m django --version.

  8. Затем выполните следующую команду, чтобы создать проект Django:

    django-admin startproject web_project .
    

    Команда startproject предполагает (с помощью . в конце), что текущая папка является папкой проекта, и создает в ней приведенные ниже ресурсы.

    • manage.py: Служебная программа командной строки Django для проекта. Административные команды для проекта следует запускать с помощью python manage.py <command> [options].

    • Будет создана вложенная папка web_project, которая содержит следующие файлы:

      • __init__.py: пустой файл, сообщающий Python, что эта папка является пакетом Python.
      • wsgi.py: точка входа для веб-серверов, совместимых с WSGI, для обслуживания проекта. Обычно этот файл остается без изменений, так как он предоставляет обработчики для рабочих веб-серверов.
      • settings.py: содержит параметры для проекта Django, которые изменяются в процессе разработки веб-приложения.
      • urls.py: содержит содержание проекта Django, которое также изменяется в процессе разработки.
  9. Чтобы проверить проект Django, запустите сервер разработки Django с помощью команды python3 manage.py runserver. Сервер работает на стандартном порте 8000. В окне терминала должны отобразиться выходные данные, аналогичные приведенным ниже.

    Performing system checks...
    
    System check identified no issues (0 silenced).
    
    June 20, 2019 - 22:57:59
    Django version 2.2.2, using settings 'web_project.settings'
    Starting development server at http://127.0.0.1:8000/
    Quit the server with CONTROL-C.
    

    При первом запуске сервера он создает базу данных SQLite по умолчанию в файле db.sqlite3, который предназначен для целей разработки, но может использоваться в рабочей среде для малообъемных веб-приложений. Кроме того, встроенный веб-сервер Django предназначен только для целей локальной разработки. Однако, при развертывании на веб-узле, Django использует вместо этого веб-сервер узла. Модуль wsgi.py в проекте Django отвечает за подключение к рабочим серверам.

    Если вы хотите использовать порт, отличный от стандартного порта 8000, укажите номер порта в командной строке, например python3 manage.py runserver 5000.

  10. Ctrl+click URL-адрес http://127.0.0.1:8000/ в окне вывода терминала, чтобы открыть для этого адреса браузер по умолчанию. Если Django установлен правильно и проект является допустимым, вы увидите страницу по умолчанию. В окне вывода терминала VS Code также отображается журнал сервера.

  11. Когда закончите, закройте окно браузера и остановите сервер в VS Code, используя Ctrl+C, как указано в окне вывода терминала.

  12. Теперь, чтобы создать приложение Django, запустите административную команду служебной программы startapp в папке проекта (где находится manage.py):

    python3 manage.py startapp hello
    

    Команда создает папку с именем hello, содержащую несколько файлов кода и одну вложенную папку. Из них часто приходится работать с views.py (содержит функции, определяющие страницы в веб-приложении) и models.py (содержит классы, определяющие объекты данных). Папка migrations используется служебной программой администрирования Django для управления версиями базы данных, как описано далее в этом руководстве. Существуют также файлы apps.py (конфигурация приложения), admin.py (для создания административного интерфейса) и tests.py (для тестов), которые здесь не рассматриваются.

  13. Измените hello/views.py в соответствии с приведенным ниже кодом, который создает одно представление для домашней страницы приложения:

    from django.http import HttpResponse
    
    def home(request):
        return HttpResponse("Hello, Django!")
    
  14. Создайте файл hello/urls.py, используя приведенное ниже содержимое. Файл urls.py является местом, в котором вы указываете шаблоны для маршрутизации различных URL-адресов в соответствующие представления. Приведенный ниже код содержит один маршрут для сопоставления корневого URL-адреса приложения ("") с функцией views.home, которую вы только что добавили в hello/views.py.

    from django.urls import path
    from hello import views
    
    urlpatterns = [
        path("", views.home, name="home"),
    ]
    
  15. Папка web_project также содержит файл urls.py, в котором фактически обрабатывается маршрутизация URL-адресов. Откройте web_project/urls.py и измените его в соответствии с приведенным ниже кодом (при необходимости можно оставить полезные комментарии). Этот код запрашивает hello/urls.py приложения с помощью django.urls.include, который хранит маршруты приложения, содержащиеся в приложении. Такое разделение полезно, когда проект содержит несколько приложений.

    from django.contrib import admin
    from django.urls import include, path
    
    urlpatterns = [
        path("", include("hello.urls")),
    ]
    
  16. Сохраните все измененные файлы.

  17. В окне терминала VS Code запустите сервер разработки с python3 manage.py runserver и откройте браузер http://127.0.0.1:8000/, чтобы увидеть страницу, которая отображает «Hello, Django».

Поздравляем, вы создали веб-приложение Django с помощью VS Code и подсистемы Windows для Linux! Более подробное руководство по использованию VS Code и Django см. в разделе Руководство по Django в Visual Studio Code.

Дополнительные ресурсы

  • Python Tutorial with VS Code (Учебник по использованию Python с VS Code): Вводный учебник по использованию VS Code в качестве среды Python, в основном по способах редактирования, запуска и отладки кода.
  • Git support in VS Code (Поддержка Git в VS Code): Сведения об использовании системы управления версиями Git в VS Code.
  • WSL 2: Эта новая версия изменяет взаимодействие дистрибутивов Linux с Windows, повышая производительность файловой системы и добавляя полную совместимость системных вызовов.
  • Управление подсистемой Windows для Linux и ее настройка: Сведения об управлении различными дистрибутивами Linux на компьютере Windows.

Как установить Django в Windows | Документация Django

Этот документ проведет вас через установку Python 3.8 и Django на
Windows. Он также содержит инструкции по настройке виртуальной среды,
что упрощает работу над проектами Python. Это предназначено для начинающих
руководство для пользователей, работающих над проектами Django, и не отражает того, как Django
следует устанавливать при разработке патчей для самого Django.

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

Установить Python¶

Django — это веб-фреймворк Python, поэтому на вашем компьютере должен быть установлен Python.
машина. На момент написания Python 3.8 является последней версией.

Чтобы установить Python на свой компьютер, перейдите по ссылке https://www.python.org/downloads/. В
веб-сайт должен предложить вам кнопку загрузки последней версии Python.
Загрузите исполняемый установщик и запустите его.Установите флажки рядом с надписью «Установить
программа запуска для всех пользователей (рекомендуется) », затем нажмите« Установить сейчас ».

После установки откройте командную строку и убедитесь, что версия Python
соответствует версии, которую вы установили, выполнив:

Около

пункт

pip — это менеджер пакетов для Python, который по умолчанию включен в
Установщик Python. Помогает устанавливать и удалять пакеты Python.
(например, Django!). Для остальной части установки мы будем использовать pip для
установить пакеты Python из командной строки.

Настройка виртуальной среды¶

Лучше всего предоставлять отдельную среду для каждого проекта Django.
вы создаете. Есть много вариантов управления средами и пакетами внутри
экосистема Python, некоторые из которых рекомендуются в Python
документация.
Сам Python поставляется с venv для управления
среды, которые мы будем использовать в этом руководстве.

Чтобы создать виртуальную среду для вашего проекта, откройте новую командную строку,
перейдите в папку, в которой вы хотите создать свой проект, а затем введите
следующий:

... \> py -m venv имя-проекта
 

Будет создана папка с именем «название-проекта», если она еще не существует.
и настроить виртуальную среду. Чтобы активировать среду, запустите:

 ... \> имя-проекта \ Scripts \ activate.bat
 

Виртуальная среда будет активирована, и вы увидите «(название-проекта)» рядом.
в командную строку, чтобы указать это. Каждый раз, когда вы запускаете новую команду
появится сообщение, вам нужно будет снова активировать среду.

Установить Django¶

Django можно легко установить с помощью pip в вашей виртуальной среде.

В командной строке убедитесь, что ваша виртуальная среда активна, и выполните
следующая команда:

 ... \> py -m pip установить Django
 

Это загрузит и установит последнюю версию Django.

После завершения установки вы можете проверить установку Django.
выполнив django-admin --version в командной строке.

См. Раздел Запуск базы данных для получения информации об установке базы данных.
с Django.

Цветной вывод терминала¶

Новое в Django 3.2.

Функция повышения качества жизни добавляет цветной (а не монохромный) вывод на
Терминал. В современных терминалах это должно работать как для CMD, так и для PowerShell. Если
по какой-то причине это нужно отключить, установите переменную окружения
DJANGO_COLORS от до без цвета .

В старых версиях Windows или устаревших терминалах colorama должна быть установлена ​​на
включить раскраску синтаксиса:

 ... \> py -m pip install colorama
 

См. Раздел Раскраска синтаксиса для получения дополнительной информации о настройках цвета.

Распространенные ошибки¶

  • Если django-admin отображает только текст справки, независимо от аргументов
    дано, вероятно, проблема с ассоциацией файлов в
    Windows. Проверьте, установлено ли более одной переменной среды для
    запуск скриптов Python в PATH . Обычно это происходит, когда есть больше
    установлено более одной версии Python.

  • Если вы подключаетесь к Интернету через прокси-сервер, могут возникнуть проблемы
    при запуске команды py -m pip install Django .Установите среду
    переменные для конфигурации прокси в командной строке следующим образом:

     ... \> установить http_proxy = http: // имя пользователя: пароль @ proxyserver: proxyport
    ... \> установить https_proxy = https: // имя пользователя: пароль @ proxyserver: proxyport
     
  • В общем, Django предполагает, что для ввода-вывода используется кодировка UTF-8 . Это может
    вызвать проблемы, если ваша система настроена на использование другой кодировки. Недавний
    версии Python позволяют установить среду PYTHONUTF8
    переменная, чтобы принудительно использовать кодировку UTF-8 .Windows 10 также предоставляет
    общесистемная настройка, отметив Использовать Unicode UTF-8 для всемирного языка
    поддержка
    в разделе «Язык» ‣ «Настройки административного языка»
    ‣ Измените языковой стандарт системы в настройках системы.

Скачать Django | Джанго

Django доступен с открытым исходным кодом под
Лицензия BSD.
Мы рекомендуем использовать последнюю версию Python 3. Последняя версия для
поддержка Python 2.7 — это Django 1.11 LTS.Видеть
FAQ по версиям Python, поддерживаемым каждой версией Django.
Вот как это получить:

Вариант 1. Получите последнюю официальную версию

Последняя официальная версия — 3.2.7 (LTS). Прочтите
Примечания к выпуску 3.2.7, затем установите его с помощью
пункт:

  pip install Django == 3.2.7  

Вариант 2. Получить альфа-версию 4.0

В составе

Процесс разработки Django 4.0, Django
4.0a1 есть в наличии. Этот выпуск предназначен только для пользователей, которые
хотите попробовать новую версию и помочь определить оставшиеся ошибки до того, как
4.0 выпуск. Пожалуйста, прочтите
Примечания к выпуску 4.0 перед использованием этого пакета.

Установите альфа с помощью pip:

  pip install --pre django  

Вариант 3. Получите последнюю версию для разработчиков

Самая последняя и лучшая версия Django находится в нашем репозитории Git (наша система контроля версий).Это только для опытных пользователей, которые хотят опробовать входящие изменения и помочь выявить ошибки перед официальным выпуском. Получите его с помощью этой команды оболочки, для которой требуется Git:

git clone https://github.com/django/django.git

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

После получения

Дополнительные инструкции см. В руководстве по установке. Убедитесь, что вы прочитали документацию, соответствующую только что установленной версии Django.

И не забудьте подписаться на список рассылки django-users, где другие пользователи Django и сами разработчики Django тусуются, чтобы помочь друг другу.

Поддерживаемые версии

Выпуски функций (A.B, A.B + 1 и т. Д.) Будут происходить примерно каждые восемь месяцев.
Эти выпуски будут содержать новые функции, улучшения существующих функций и т. Д.

Патч-релизы (A.B.C и т. Д.) Будут выпущены по мере необходимости для
исправлять ошибки и / или проблемы с безопасностью.Эти выпуски будут на 100% совместимы с
соответствующий выпуск функции, если это невозможно по соображениям безопасности
причин или для предотвращения потери данных. Итак, ответ на вопрос «стоит ли мне перейти на
последний выпуск патча? » всегда будет «да».

Определенные выпуски функций будут обозначены как долгосрочной поддержки
(LTS) выпускает
. Эти выпуски получат безопасность и потерю данных
исправления применяются в течение гарантированного периода времени, обычно три года.

Посмотреть
Политика поддерживаемых версий содержит подробные инструкции о том, какие исправления будут перенесены.


Выпуск серии Последняя версия Окончание основной поддержки 1 Конец расширенной опоры 2
3,2 ЛТС 3,2,7 Декабрь 2021 г. Апрель 2024 г.
3,1 3.1.13 6 апреля 2021 г. Декабрь 2021 г.
2.2 LTS 2.2.24 2 декабря 2019 Апрель 2022 г.

Дорожная карта будущего

Выпуск серии Дата выпуска Окончание основной поддержки 1 Конец расширенной опоры 2
4,0 Декабрь 2021 г. Август 2022 г. Апрель 2023 г.
4.1 Август 2022 г. Апрель 2023 г. декабрь 2023
4,2 ЛТС Апрель 2023 г. декабрь 2023 Апрель 2026 г.

Предыдущие версии, не поддерживаемые

Эти серии выпусков больше не получают обновлений безопасности и исправлений ошибок.

Выпуск серии Последняя версия Окончание основной поддержки 1 Конец расширенной опоры 2
3.0 3.0.14 3 августа 2020 6 апреля 2021 г.
2,1 2.1.15 1 апреля 2019 г. 2 декабря 2019
2,0 2.0.13 1 августа 2018 1 апреля 2019 г.
1,11 ЛТС 3 1.11.29 2 декабря 2017 г. 1 апреля 2020
1.10 1.10.8 4 апреля 2017 г. 2 декабря 2017 г.
1,9 1.9.13 1 августа 2016 4 апреля 2017 г.
1,8 LTS 1.8.19 1 декабря 2015 г. 1 апреля 2018 г.
1,7 1.7.11 1 апреля 2015 г. 1 декабря 2015 г.
1.6 1.6.11 2 сентября 2014 г. 1 апреля 2015 г.
1,5 1.5.12 6 ноября 2013 г. 2 сентября 2014 г.
1,4 LTS 1.4.22 26 февраля 2013 г. 1 октября 2015 г.
1,3 1,3,7 23 марта 2012 г. 26 февраля 2013 г.

[1] Исправления безопасности, ошибки потери данных, ошибки сбоя, основные функции.
ошибки во вновь представленных функциях и регрессии из старых версий Django.

[2] Исправления безопасности и ошибки потери данных.
[3] Последняя версия для поддержки Python 2.7.

Вернуться к началу

Настройка среды разработки Django — Изучите веб-разработку

Теперь, когда вы знаете, для чего предназначен Django, мы покажем вам, как настроить и протестировать среду разработки Django в Windows, Linux (Ubuntu) и macOS — какую бы распространенную операционную систему вы ни использовали, в этой статье вы узнаете, что вам нужно иметь возможность начать разработку приложений Django.

Предварительные требования: Базовые знания об использовании терминала / командной строки и о том, как устанавливать пакеты программного обеспечения в операционной системе вашего компьютера для разработки.
Цель: Чтобы на вашем компьютере была запущена среда разработки для Django (3. *).

Django позволяет очень легко настроить собственный компьютер, чтобы вы могли начать разработку веб-приложений. В этом разделе объясняется, что вы получаете от среды разработки, и дается обзор некоторых из ваших параметров установки и конфигурации.В оставшейся части статьи объясняется метод , рекомендованный для установки среды разработки Django в Ubuntu, macOS и Windows, и то, как вы можете его протестировать.

Что такое среда разработки Django?

Среда разработки — это установка Django на локальном компьютере, которую вы можете использовать для разработки и тестирования приложений Django перед их развертыванием в производственной среде.

Основные инструменты, которые предоставляет сам Django, — это набор скриптов Python для создания проектов Django и работы с ними, а также простой веб-сервер разработки , который можно использовать для тестирования локальных (т.е. на вашем компьютере, а не на внешнем веб-сервере) Веб-приложения Django в веб-браузере вашего компьютера.

Существуют и другие периферийные инструменты, которые являются частью среды разработки, о которых мы не будем здесь рассказывать. К ним относятся такие вещи, как текстовый редактор или IDE для редактирования кода, а также инструмент управления исходным кодом, такой как Git, для безопасного управления различными версиями вашего кода. Мы предполагаем, что у вас уже установлен текстовый редактор.

Какие параметры настройки Django?

Django чрезвычайно гибок с точки зрения того, как и где его можно установить и настроить.Django может быть:

  • Устанавливается в разных операционных системах.
  • Устанавливается из исходного кода, из индекса пакетов Python (PyPi) и во многих случаях из приложения диспетчера пакетов главного компьютера.
  • Настроен для использования одной из нескольких баз данных, которые также могут потребовать отдельной установки и настройки.
  • Выполняется в основной системной среде Python или в отдельных виртуальных средах Python.

Каждая из этих опций требует немного другой конфигурации и настройки.В следующих подразделах объясняются некоторые из возможных вариантов. В оставшейся части статьи мы покажем вам, как настроить Django на небольшом количестве операционных систем, и эта настройка будет предполагаться на протяжении всей оставшейся части этого модуля.

Примечание: Другие возможные варианты установки описаны в официальной документации Django. Мы ссылаемся на соответствующие документы ниже.

Какие операционные системы поддерживаются?

Веб-приложения Django можно запускать практически на любой машине, которая может запускать язык программирования Python 3: Windows, macOS, Linux / Unix, Solaris, и это лишь некоторые из них.Практически любой компьютер должен иметь производительность, необходимую для запуска Django во время разработки.

В этой статье мы предоставим инструкции для Windows, macOS и Linux / Unix.

Какую версию Python следует использовать?

Вы можете использовать любую версию Python, поддерживаемую вашим целевым выпуском Django. Для Django 3.1.2 допустимые версии — Python от 3.6 до 3.8 (см. FAQ: Установка).

Проект Django рекомендует (и «официально поддерживает») с использованием последней доступной поддерживаемой версии Python.

Примечание. Python 2.7 не может использоваться с текущими выпусками Django (серия Django 1.11.x является последней, поддерживающей Python 2.7).

Где скачать Django?

Есть три места для загрузки Django:

  • Репозиторий пакетов Python (PyPi) с использованием инструмента pip . Это лучший способ получить последнюю стабильную версию Django.
  • Используйте версию из диспетчера пакетов вашего компьютера. Дистрибутивы Django в комплекте с операционными системами предлагают знакомый механизм установки.Однако обратите внимание, что упакованная версия может быть довольно старой и может быть установлена ​​только в системную среду Python (что может быть не тем, что вам нужно).
  • Установить из исходников. Вы можете получить и установить последнюю передовую версию Django из исходников. Это не рекомендуется для новичков, но необходимо, когда вы будете готовы начать вносить свой вклад в сам Django.

В этой статье показано, как установить Django из PyPi, чтобы получить последнюю стабильную версию.

Какая база данных?

Django официально поддерживает базы данных PostgreSQL, MariaDB, MySQL, Oracle и SQLite, а также существуют библиотеки сообщества, которые обеспечивают различные уровни поддержки для других популярных баз данных SQL и NoSQL. Мы рекомендуем вам выбрать одну и ту же базу данных как для производства, так и для разработки (хотя Django абстрагирует многие различия баз данных с помощью объектно-реляционного сопоставителя (ORM), все же существуют потенциальные проблемы, которых лучше избегать).

В этой статье (и большей части этого модуля) мы будем использовать базу данных SQLite , которая хранит свои данные в файле.SQLite предназначен для использования в качестве облегченной базы данных и не может поддерживать высокий уровень параллелизма. Однако это отличный выбор для приложений, которые в основном предназначены только для чтения.

Примечание. Django настроен на использование SQLite по умолчанию при запуске проекта веб-сайта с использованием стандартных инструментов ( django-admin ). Это отличный выбор, когда вы только начинаете, потому что он не требует дополнительной настройки или настройки.

Установка в масштабе всей системы или в виртуальной среде Python?

Когда вы устанавливаете Python3, вы получаете единую глобальную среду, которая используется для всего кода Python3.Хотя вы можете установить в среде любые пакеты Python, которые вам нравятся, вы можете установить только одну конкретную версию каждого пакета за раз.

Примечание. Приложения Python, установленные в глобальной среде, могут потенциально конфликтовать друг с другом (т. Е. Если они зависят от разных версий одного и того же пакета).

Если вы установите Django в стандартную / глобальную среду, то вы сможете настроить таргетинг только на одну версию Django на компьютере. Это может быть проблемой, если вы хотите создавать новые веб-сайты (используя последнюю версию Django), сохраняя при этом веб-сайты, основанные на более старых версиях.

В результате опытные разработчики Python / Django обычно запускают приложения Python в независимых виртуальных средах Python . Это позволяет использовать несколько различных сред Django на одном компьютере. Команда разработчиков Django сама рекомендует использовать виртуальные среды Python!

Этот модуль предполагает, что вы установили Django в виртуальную среду, и ниже мы покажем вам, как это сделать.

Чтобы использовать Django, вам необходимо установить Python в вашей операционной системе.Если вы используете Python 3 , вам также понадобится инструмент Python Package Index — pip3 , который используется для управления (установки, обновления и удаления) пакетов / библиотек Python, используемых Django и другими вашими приложениями Python.

В этом разделе кратко объясняется, как вы можете проверить, какие версии Python присутствуют, и при необходимости установить новые версии для Ubuntu Linux 20.04, macOS и Windows 10.

Примечание: В зависимости от вашей платформы вы также можете установить Python / pip из собственного диспетчера пакетов операционной системы или с помощью других механизмов.Для большинства платформ вы можете загрузить необходимые установочные файлы с https://www.python.org/downloads/ и установить их, используя соответствующий метод для конкретной платформы.

Ubuntu 20.04

Ubuntu Linux 20.04 LTS по умолчанию включает Python 3.8.5. Вы можете подтвердить это, выполнив следующую команду в терминале bash:

Однако инструмент Python Package Index ( pip3 ), который вам понадобится для установки пакетов для Python 3 (включая Django), не доступен по умолчанию .Вы можете установить pip3 в терминал bash, используя:

  sudo apt установить python3-pip
  

macOS

macOS «El Capitan» и другие более поздние версии не включают Python 3. Вы можете подтвердить это, выполнив следующие команды в терминале zsh или bash:

  $ python3 -V
  python3: команда не найдена  

Вы можете легко установить Python 3 (вместе с инструментом pip3 ) с python.org:

  1. Загрузите необходимый установщик:
    1. Перейти на https: // www.python.org/downloads/
    2. Нажмите кнопку Download Python 3.8.6 (точный номер версии может отличаться).

      Примечание: Предлагаемая версия может отличаться. Убедитесь, что загружаемая версия поддерживается Django (при необходимости ссылки для получения более старых версий можно найти на той же странице).

  2. Найдите файл с помощью Finder и дважды щелкните файл пакета. Следуя инструкциям по установке.

Теперь вы можете подтвердить успешную установку, проверив версию Python 3 , как показано ниже:

Вы можете аналогичным образом проверить, что pip3 установлен, перечислив доступные пакеты:

Windows 10

Windows не включает Python по умолчанию, но вы можете легко установить его (вместе с инструментом pip3 ) с python.org:

  1. Загрузите необходимый установщик:
    1. Перейти на https: // www.python.org/downloads/
    2. Нажмите кнопку Download Python 3.8.6 (точный номер версии может отличаться).

      Примечание: Предлагаемая версия может отличаться. Убедитесь, что загружаемая версия поддерживается Django (при необходимости ссылки для получения более старых версий можно найти на той же странице).

  2. Установите Python, дважды щелкнув загруженный файл и следуя инструкциям по установке.
  3. Обязательно установите флажок «Добавить Python в PATH».

Затем вы можете убедиться, что Python 3 был установлен, введя следующий текст в командную строку:

Установщик Windows по умолчанию включает pip3 (менеджер пакетов Python).Вы можете перечислить установленные пакеты, как показано:

Примечание: Программа установки должна настроить все необходимое для работы вышеуказанной команды. Однако если вы получили сообщение о том, что Python не найден, возможно, вы забыли добавить его в свой системный путь. Вы можете сделать это, запустив программу установки еще раз, выбрав «Изменить» и установив флажок «Добавить Python в переменные среды» на второй странице.

Библиотеки, которые мы будем использовать для создания наших виртуальных сред, — это virtualenvwrapper (Linux и macOS) и virtualenvwrapper-win (Windows), которые, в свою очередь, используют инструмент virtualenv.Инструменты оболочки создают согласованный интерфейс для управления интерфейсами на всех платформах.

Установка программного обеспечения виртуальной среды

Настройка виртуальной среды Ubuntu

После установки Python и pip вы можете установить virtualenvwrapper (который включает virtualenv ). Официальное руководство по установке можно найти здесь или следуйте инструкциям ниже.

Установите инструмент, используя pip3 :

  sudo pip3 установить virtualenvwrapper  

Затем добавьте следующие строки в конец файла запуска оболочки (это скрытое имя файла .bashrc в вашем домашнем каталоге). Они устанавливают расположение, в котором должны располагаться виртуальные среды, расположение каталогов вашего проекта разработки и расположение сценария, установленного с этим пакетом:

  экспорт WORKON_HOME = $ HOME / .virtualenvs
экспорт VIRTUALENVWRAPPER_PYTHON = / usr / bin / python3
экспорт VIRTUALENVWRAPPER_VIRTUALENV_ARGS = '-p / usr / bin / python3'
экспорт PROJECT_HOME = $ HOME / Devel
источник /usr/local/bin/virtualenvwrapper.sh
  

Примечание: Переменные VIRTUALENVWRAPPER_PYTHON и VIRTUALENVWRAPPER_VIRTUALENV_ARGS указывают на обычное место установки Python3, а исходный код / usr / local / bin / virtualenvwrapper.sh указывает на обычное расположение сценария virtualenvwrapper.sh . Если virtualenv не работает, когда вы его тестируете, нужно проверить, что Python и скрипт находятся в ожидаемом месте (а затем соответствующим образом измените файл запуска).

Вы можете найти правильные местоположения для вашей системы, используя команды , которые virtualenvwrapper.sh и , которые python3 .

Затем перезагрузите файл запуска, выполнив в терминале следующую команду:

На этом этапе вы должны увидеть несколько запущенных скриптов, как показано ниже:

  virtualenvwrapper.user_scripts создание /home/ubuntu/.virtualenvs/premkproject
virtualenvwrapper.user_scripts создание /home/ubuntu/.virtualenvs/postmkproject
...
virtualenvwrapper.user_scripts создание /home/ubuntu/.virtualenvs/preactivate
virtualenvwrapper.user_scripts создание /home/ubuntu/.virtualenvs/postactivate
virtualenvwrapper.user_scripts создание /home/ubuntu/.virtualenvs/get_env_details
  

Теперь вы можете создать новую виртуальную среду с помощью команды mkvirtualenv .

настройка виртуальной среды macOS

Настройка virtualenvwrapper на macOS почти такая же, как и на Ubuntu (опять же, вы можете следовать инструкциям либо из официального руководства по установке, либо ниже).

Установите virtualenvwrapper (и объединение virtualenv ), используя pip , как показано.

  sudo pip3 установить virtualenvwrapper  

Затем добавьте следующие строки в конец файла запуска оболочки (это те же строки, что и для Ubuntu).
Если вы используете оболочку zsh , то файл запуска будет скрытым файлом с именем .zshrc в вашем домашнем каталоге. Если вы используете оболочку bash , то это будет скрытый файл с именем .bash_profile . Возможно, вам потребуется создать файл, если он еще не существует.

  экспорт WORKON_HOME = $ HOME / .virtualenvs
экспорт VIRTUALENVWRAPPER_PYTHON = / usr / bin / python3
экспорт PROJECT_HOME = $ HOME / Devel
источник /usr/local/bin/virtualenvwrapper.sh  

Примечание: Переменная VIRTUALENVWRAPPER_PYTHON указывает на обычное место установки Python3, а исходный код /usr/local/bin/virtualenvwrapper.sh указывает на обычное расположение виртуального обертки .sh скрипт. Если virtualenv не работает, когда вы его тестируете, нужно проверить, что Python и скрипт находятся в ожидаемом месте (а затем соответствующим образом измените файл запуска).

Например, один тест установки на macOS закончился тем, что в файле запуска были необходимы следующие строки:

  экспорт WORKON_HOME = $ HOME / .virtualenvs
экспорт VIRTUALENVWRAPPER_PYTHON = / Library / Frameworks / Python.framework / Versions / 3.7 / bin / python3
экспорт PROJECT_HOME = $ HOME / Devel
источник / Библиотека / Frameworks / Python.framework / Версии / 3.7 / bin / virtualenvwrapper.sh  

Вы можете найти правильные местоположения для вашей системы, используя команды , которые virtualenvwrapper.sh и , которые python3 .

Затем перезагрузите файл запуска, выполнив в терминале следующий вызов:

На этом этапе вы можете увидеть несколько запущенных сценариев (те же сценарии, что и для установки Ubuntu). Теперь у вас должна быть возможность создать новую виртуальную среду с помощью команды mkvirtualenv .

Примечание: Если вы не можете найти файл запуска для редактирования в поисковике, вы также можете открыть его в терминале с помощью nano.

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

  кд ~
ls -la
нано .bash_profile

  
Настройка виртуальной среды Windows 10

Установить virtualenvwrapper-win еще проще, чем настроить virtualenvwrapper , потому что вам не нужно настраивать, где инструмент хранит информацию о виртуальной среде (есть значение по умолчанию).Все, что вам нужно сделать, это запустить в командной строке следующую команду:

  pip3 установить virtualenvwrapper-win  

Теперь вы можете создать новую виртуальную среду с помощью команды mkvirtualenv

Создание виртуальной среды

После установки virtualenvwrapper или virtualenvwrapper-win работа с виртуальными средами на всех платформах очень похожа.

Теперь вы можете создать новую виртуальную среду с помощью команды mkvirtualenv .При запуске этой команды вы увидите, что среда настраивается (то, что вы видите, немного зависит от платформы). Когда команда завершится, новая виртуальная среда станет активной — вы можете видеть это, потому что в начале приглашения будет имя среды в скобках (ниже мы показываем это для Ubuntu, но последняя строка аналогична для Windows / macOS) .

  $ mkvirtualenv my_django_environment

Запуск virtualenv с интерпретатором / usr / bin / python3
...
virtualenvwrapper.user_scripts создание / home / ubuntu /.virtualenvs / t_env7 / bin / get_env_details
(my_django_environment) ubuntu @ ubuntu: ~ $
  

Теперь вы находитесь в виртуальной среде, вы можете установить Django и начать разработку.

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

Использование виртуальной среды

Есть еще несколько полезных команд, которые вам следует знать (их больше в документации к инструменту, но вы будете использовать их регулярно):

  • деактивировать — выйти из текущей виртуальной среды Python
  • workon — Список доступных виртуальных сред
  • workon name_of_environment — Активировать указанную виртуальную среду Python
  • rmvirtualenv name_of_environment — Удалить указанную среду.

После создания виртуальной среды и вызова workon для входа в нее вы можете использовать pip3 для установки Django.

Вы можете проверить, что Django установлен, выполнив следующую команду (это просто проверка того, что Python может найти модуль Django):

 
python3 -m django --version
 3.1.2


py -3 -m django --version
 3.1.2
  

Примечание: Если указанная выше команда Windows не показывает наличие модуля django, попробуйте:

В Windows Python 3 сценарии запускаются с помощью префикса команды py -3 , хотя это может варьироваться в зависимости от конкретной установки.Попробуйте опустить модификатор -3 , если у вас возникнут проблемы с командами. В Linux / macOS это команда python3.

Предупреждение: Остальная часть этого модуля использует команду Linux для вызова Python 3 ( python3 ). Если вы работаете с Windows , замените этот префикс на: py -3

Вышеупомянутый тест работает, но это не очень весело. Более интересный тест — создать скелет проекта и посмотреть, как он работает.Для этого сначала перейдите в командной строке / терминале туда, где вы хотите хранить свои приложения Django. Создайте папку для своего тестового сайта и перейдите в нее.

  мкдир django_test
cd django_test
  

Затем вы можете создать новый каркасный сайт под названием « mytestsite », используя инструмент django-admin , как показано. После создания сайта вы можете перейти в папку, где вы найдете основной скрипт для управления проектами, который называется manage.py .

  запуск проекта django-admin mytestsite
компакт-диск mytestsite  

Мы можем запустить веб-сервер разработки из этой папки, используя команду manage.py и команду runserver , как показано.

  $ python3 manage.py runserver
Наблюдение за изменениями файлов с помощью StatReloader
Выполнение системных проверок ...

Проверка системы не выявила проблем (0 отключено).

У вас 18 непримененных миграций. Ваш проект может работать неправильно, пока вы не примените миграции для приложений: admin, auth, contenttypes, sessions.Запустите python manage.py migrate, чтобы применить их.
27 октября, 2020 - 03:00:01
Django версии 3.1.2, используя настройки mytestsite.settings
Запуск сервера разработки по адресу http://127.0.0.1:8000/
Закройте сервер, нажав CONTROL-C.
  

Примечание: Приведенная выше команда показывает команду Linux / macOS. На этом этапе вы можете игнорировать предупреждения о «18 непримененных миграциях»!

После запуска сервера вы можете просмотреть сайт, перейдя по следующему URL-адресу в локальном веб-браузере: http: // 127.0.0.1: 8000/. Вы должны увидеть сайт, который выглядит так:

Теперь у вас есть среда разработки Django, работающая на вашем компьютере.

В разделе тестирования вы также вкратце увидели, как мы можем создать новый веб-сайт Django с помощью django-admin startproject и запустить его в своем браузере с помощью веб-сервера разработки ( python3 manage.py runserver ). В следующей статье мы подробно рассмотрим этот процесс, создав простое, но полное веб-приложение.

Установка Django — Python Django Tutorials

Прежде чем вы сможете начать изучение Django, вы должны установить на свой компьютер некоторое программное обеспечение. К счастью, это простой трехэтапный процесс:

  1. Установить Python
  2. Установить виртуальную среду Python; и
  3. Установить Django

Я написал эту главу в основном для тех из вас, кто работает с Windows, так как большинство новых пользователей работают с Windows. Я также включил раздел об установке Python 3 и Django на macOS.Если вы используете Linux, в Интернете есть множество ресурсов, и лучше всего начать с собственных инструкций по установке Django.

Для пользователей Windows на вашем компьютере может быть установлена ​​любая последняя версия Windows (7, 8.1 или 10). В этой главе также предполагается, что вы устанавливаете Django на настольный или портативный компьютер и будете использовать сервер разработки и SQLite для выполнения всего кода из этой книги. Это, безусловно, самый простой и лучший способ настроить Django при первом запуске.

Установка Python

Многие приложения Windows используют Python, поэтому он может быть уже установлен в вашей системе.Вы можете проверить это, открыв командную строку или запустив PowerShell и набрав python в командной строке.

Если Python не установлен, вы получите сообщение о том, что Windows не может найти Python. Если установлен Python, команда python откроет интерактивный интерпретатор Python:

  C: \ Users \ Nigel> Python
Python 3.6.0 (v3.6.0: 41df79263a11, 23 декабря 2016 г., 07:18:10) [MSC v.1900 32 бит (Intel)] на win32
Для получения дополнительной информации введите «помощь», «авторские права», «кредиты» или «лицензия».>>>  

В приведенном выше примере вы можете видеть, что мой компьютер работает под управлением Python 3.6.0. Django 2.2 совместим с Python версии 3.5 и новее. Django 3.0 совместим с Python версии 3.6 и новее. Если у вас более старая версия Python, вы должны установить Python 3.7 или 3.8, чтобы код из этой книги работал. Если у вас установлен Python 3.5 или 3.6, я все же рекомендую вам установить Python 3.8, чтобы убедиться, что на вашем компьютере установлена ​​последняя версия.

Предполагая, что Python 3 не установлен в вашей системе, вам сначала нужно получить установщик.Перейдите на https://www.python.org/downloads/ и нажмите большую желтую кнопку с надписью «Загрузить Python 3.8.x».

На момент написания последней версией Python является 3.8.3, но, возможно, она была обновлена ​​к тому моменту, когда вы это прочитаете, поэтому цифры могут немного отличаться. После загрузки установщика Python перейдите в папку загрузок и дважды щелкните файл python-3.x.x.msi , чтобы запустить установщик. Процесс установки такой же, как и для любой другой программы для Windows, поэтому, если вы уже устанавливали программное обеспечение раньше, проблем возникнуть не должно; однако необходимо выполнить одну важную настройку.

По умолчанию исполняемый файл Python не добавляется в ПУТЬ Windows. Для правильной работы Django Python должен быть указан в операторе PATH. К счастью, это легко исправить — когда откроется экран установщика Python, перед установкой убедитесь, что установлен флажок «Добавить Python 3.8 в PATH» (рис. 2-1).

Не забудьте этот шаг!

Он решит большинство проблем, возникающих из-за неправильного отображения пути pythonpath (важная переменная для установок Python) в Windows.

Рисунок 2.1: Установите флажок «Добавить Python 3.8 в PATH» перед установкой.

После установки Python перезапустите Windows и введите в командной строке python . Вы должны увидеть что-то вроде этого:

  C: \ Пользователи \ nigel> Python
Python 3.8.3 (теги / v3.8.3: 6f8c832, 13 мая 2020 г., 22:20:19) [MSC v.1925 32 бит (Intel)] на win32
Для получения дополнительной информации введите «помощь», «авторские права», «кредиты» или «лицензия».
>>>  

Установка Python на macOS

Если вы откроете терминал и наберете в командной строке python , вы увидите, что версия системы — Python 2 (рисунок 2-2).Django несовместим с Python 2, поэтому нам необходимо установить последнюю версию Python 3.

Рисунок 2-2: macOS использует Python 2, несовместимый с Django.

Загрузка копии Python 3 происходит так же, как и в Windows: перейдите по адресу https://www.python.org/downloads/ и нажмите большую желтую кнопку с надписью «Загрузить Python 3.x.x». Ваш браузер должен автоматически определить, что вы используете macOS, и перейти на нужную страницу загрузки.Если это не так, выберите нужную операционную систему по ссылкам под кнопкой.

Установщик Mac имеет формат .pkg , поэтому после его загрузки дважды щелкните файл, чтобы запустить установщик пакета (рис. 2-3). Снимок экрана предназначен для Python 3.7, но процесс идентичен для Python 3.8.

Рисунок 2-3: Следуйте инструкциям по установке Python 3 в macOS.

Следуйте инструкциям по установке и, когда Python 3 будет установлен, откройте новое окно терминала.Если установка прошла успешно, набрав в командной строке python3 , откроется интерактивная оболочка Python 3 (рис. 2-4). Обратите внимание, что macOS с радостью запускает несколько версий Python на одном компьютере, вам просто нужно убедиться, что вы выбрали правильную версию при запуске терминала.

Рисунок 2-4: После установки Python 3 запустите его с терминала с помощью команды python3 .

Создание виртуальной среды Python

Когда вы пишете новое программное обеспечение, можно (и часто!) Изменять зависимости и переменные среды, от которых зависит ваше другое программное обеспечение.Это может вызвать множество проблем, поэтому этого следует избегать. Виртуальная среда Python решает эту проблему, заключая все зависимости и переменные среды, необходимые вашему новому программному обеспечению, в файловую систему, отдельную от остального программного обеспечения на вашем компьютере.

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

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

Наша папка проекта будет содержать не только нашу виртуальную среду, но и весь код и носители для сайта нашего клуба Django.

Папка проекта может находиться где угодно на вашем компьютере, хотя настоятельно рекомендуется создать ее где-нибудь в своем пользовательском каталоге, чтобы в дальнейшем у вас не возникло проблем с разрешениями. Хорошее место для вашего проекта в Windows — это папка Мои документы . На Mac ваша папка Documents также является логичным выбором; однако он может находиться в любом месте вашего пользовательского каталога.

Создайте новую папку в вашей системе. Я назвал папку myclub_project , но вы можете дать папке любое имя, которое вам подходит.

Для следующего шага вам необходимо находиться в командном окне (терминал в Linux и macOS). Самый простой способ сделать это в Windows — открыть проводник Windows, удерживать клавишу SHIFT и щелкнуть правой кнопкой мыши папку, чтобы открыть контекстное меню, и выбрать Открыть командное окно здесь (рис. 2-5).

Рисунок 2.5: Удерживая клавишу Shift, щелкните папку правой кнопкой мыши, чтобы открыть окно команд.

Терминал в Windows 10

Если вы используете более новые версии Windows 10, командная строка была заменена на PowerShell.Для примеров в этой книге командная строка и PowerShell функционально одинаковы, и все команды будут выполняться в PowerShell без изменений.

Создание виртуальной среды Python

После того, как вы создали папку своего проекта, вам необходимо создать виртуальную среду для вашего проекта, набрав в только что открытой командной строке:

В Windows

  ... \ Documents \ myclub_project> python -m venv env_myclub  

На Mac

 ... $ python3 -m venv env_myclub  

Помните, вы должны находиться в папке проекта!

Функция этой команды проста — опция -m указывает Python запустить модуль venv как сценарий. venv , в свою очередь, требует один параметр: имя создаваемой виртуальной среды. Итак, эта команда говорит: «Создайте новую виртуальную среду Python и назовите ее env_myclub »

После того, как venv завершит настройку вашей новой виртуальной среды, он переключится на пустую командную строку.Когда все будет готово, откройте проводник Windows и посмотрите, что venv создал для вас. В папке проекта вы увидите папку с именем \ env_myclub (или любое другое имя, которое вы дали виртуальной среде). Если вы откроете папку в Windows, вы увидите следующее:

  \ Включить
\ Lib
\ Скрипты
pyvenv.cfg  

На Mac это:

  / бин
/Включают
/ Lib
pyvenv.cfg  

На любой платформе, если вы заглянете в папку \ Lib , вы увидите, что venv создал для вас полную установку Python, отдельно от другого вашего программного обеспечения, поэтому вы можете работать над своим проектом, не затрагивая другое программное обеспечение на вашем компьютере. система.

Чтобы использовать эту новую виртуальную среду Python, мы должны ее активировать, поэтому давайте вернемся в командную строку и введите следующее:

В Windows

  env_myclub \ scripts \ активировать  

На Mac

  исходный код env_myclub / bin / активировать  

Это запустит сценарий активации в папке \ scripts виртуальной среды. Вы заметите, что ваша командная строка теперь изменилась:

  (env_myclub)... \ Documents \ myclub_project>  

На Mac приглашение выглядит так:

  (env_myclub) ... <имя пользователя> $  

(env_myclub) в начале командной строки позволяет узнать, что вы работаете в виртуальной среде.

Ой! Ошибка сценария!

Если вы используете PowerShell и запускаете этот сценарий в первый раз, команда activate выдаст ошибку разрешения.

Если это произойдет с вами, откройте PowerShell от имени администратора и выполните команду:

  Set-ExecutionPolicy remoteSigned  

После того, как вы запустите эту команду, запустится сценарий активации.

Если вы хотите выйти из виртуальной среды, просто введите деактивировать в командной строке:

  (env_myclub) ... \ Documents \ myclub_project> деактивировать
... \ Documents \ myclub_project>  

Установка Django

Примечание для пользователей Mac

После установки Python 3 и виртуальной среды шаги установки Django идентичны как в Windows, так и в macOS.

При работе с macOS важно помнить, что система Python — это версия 2, а для Django требуется Python 3, поэтому для запуска любого кода из этой книги вы должны запустить виртуальную среду Python на macOS.

Теперь у нас установлен Python и запущена виртуальная среда, установить Django очень просто, просто введите команду:

  pip install "django> = 2.2, <3"  

Для Django 3 команда:

  pip install "django> = 3.0, <4 " 

Если вы не знакомы с командой pip , вкратце, это менеджер пакетов Python, который используется для установки пакетов Python. В соответствии с традициями программирования Python pip - это рекурсивное сокращение от «Pip Installs Packages».

Это даст указание pip установить последнюю версию Django 2 или Django 3 в вашу виртуальную среду. Вывод вашей команды должен выглядеть так (для Django 2.2):

  (env_myclub)... \ myclub_project> pip install "django> = 2.2, <3.0"
Сбор django <3.0,> = 2.2
Загрузка ... / Django-2.2.12-py3-none-any.whl (7,5 МБ)
    | ############################### | 7,5 МБ 2,2 МБ / с
Сбор pytz (из django <3.0,> = 2.2)
Загрузка ... / pytz-2020.1-py2.py3-none-any.whl (510 КБ)
    | ############################### | 512 КБ 3,3 МБ / с
Сбор sqlparse (из django <3.0,> = 2.2)
Загрузка ... / sqlparse-0.3.1-py2.py3-none-any.whl (40 КБ)
    | ############################### | 40кБ 2.6 МБ / с
Установка собранных пакетов: pytz, sqlparse, django
Успешно установлен django-2.2.12 pytz-2020.1 sqlparse-0.3.1  

Вывод установки Django 3 идентичен, за исключением номеров версий.

Чтобы проверить установку, перейдите в командную строку виртуальной среды, запустите интерактивный интерпретатор Python, набрав python и нажав Enter. Если установка прошла успешно, вы сможете импортировать модуль django :

  (env_myclub)... \ myclub_project> питон
Python 3.8.3 (теги / v3.8.3: 6f8c832, 13 мая 2020 г., 22:20:19) [MSC v.1925 32 бит (Intel)] на win32
Для получения дополнительной информации введите «помощь», «авторские права», «кредиты» или «лицензия».
>>> импортировать django
>>> django.get_version ()
'2.2.12' # Ваша версия может быть другой.
>>> выход ()  

Не забудьте выйти из интерпретатора Python, когда закончите (вы также можете использовать CTRL-Z).

Вы также можете проверить, установлен ли Django непосредственно из командной строки с помощью:

  (env_myclub)... \ myclub_project> python -m django --version
2.2.12 # Ваша версия может быть другой.  

Начало проекта

После того, как вы установили Python и Django, вы можете сделать первый шаг в разработке приложения Django, создав проект Django .

Проект Django - это набор настроек и файлов для одного веб-сайта Django. Чтобы создать новый проект Django, мы будем использовать специальную команду для автоматического создания папок, файлов и кода, составляющих проект Django.Это включает в себя набор настроек для экземпляра Django, конфигурацию базы данных, параметры, специфичные для Django, и настройки для конкретных приложений.

Я предполагаю, что вы все еще используете виртуальную среду с предыдущего шага установки. Если нет, запустите его снова с env_myclub \ scripts \ activate \ .

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

  (env_myclub) ... \ myclub_project> django-admin startproject myclub_site  

Эта команда автоматически создаст папку myclub_site в папке вашего проекта и все необходимые файлы для базового, но полностью работающего веб-сайта Django.Не стесняйтесь исследовать, что создал startproject сейчас, если хотите, однако мы более подробно рассмотрим структуру проекта Django в следующей главе.

Создание базы данных

Django по умолчанию включает в себя несколько приложений (например, программу администратора, управление пользователями и аутентификацию). Некоторые из этих приложений используют по крайней мере одну таблицу базы данных, поэтому нам нужно создать таблицы в базе данных проекта, прежде чем мы сможем их использовать. Для этого перейдите в папку myclub_site , созданную на последнем шаге (введите cd myclub_site в командной строке) и выполните следующую команду:

  управление питоном.py migrate  

Команда migrate создает новую базу данных SQLite и все необходимые таблицы базы данных в соответствии с файлом настроек, созданным командой startproject (подробнее о файле настроек позже). Если все пойдет по плану, вы увидите сообщение для каждой применяемой миграции:

  (env_myclub) ... \ myclub_site> python manage.py migrate
Выполняемые операции:
  Применить все миграции: admin, auth, contenttypes, sessions
Выполняемые миграции:
  Применение типов содержимого.0001_initial ... ОК
  Применение auth.0001_initial ... ОК
  Применяем admin.0001_initial ... ОК
  # еще несколько миграций (не показано)  

Сервер разработки

Давайте проверим, что ваш проект Django работает. Убедитесь, что вы находитесь во внешнем каталоге myclub_site и выполните следующую команду:

  python manage.py сервер запуска  

Это запустит сервер разработки Django - легкий веб-сервер, написанный на Python. Сервер разработки был создан, чтобы вы могли быстро разрабатывать вещи, не занимаясь настройкой рабочего сервера, пока вы не будете готовы к развертыванию.

При запуске сервера Django выдаст несколько сообщений, прежде чем сообщит вам, что сервер разработки запущен и работает по адресу http://127.0.0.1:8000/ . Если вам интересно, 127.0.0.1 - это IP-адрес для localhost или вашего локального компьютера. 8000 в конце сообщает вам, что Django прослушивает порт 8000 на вашем локальном хосте.

Вы можете изменить номер порта, если хотите, но я никогда не находил веской причины для его изменения, поэтому лучше не усложнять и оставить значение по умолчанию.

Теперь, когда сервер запущен, зайдите на http://127.0.0.1:8000/ в своем веб-браузере. Вы увидите страницу приветствия Django по умолчанию с классной анимированной ракетой (рис. 2-6).

Сработало!

Рисунок 2.6: Страница приветствия Django. Страница приветствия одинакова для Django 2 и 3.

СОВЕТ: запомните последовательность запуска

Это поможет записать эту последовательность, чтобы вы знали, как запускать свой проект Django каждый раз, когда вы возвращаетесь к примерам в этой книге:

В Windows:

  1. Shift Щелкните правой кнопкой мыши папку проекта, чтобы открыть командное окно.
  2. Введите env_myclub \ scripts \ activate , чтобы запустить виртуальную среду.
  3. Перейдите в каталог вашего сайта ( cd myclub_site ), чтобы запустить команды manage.py (например, runserver ).
  4. Введите , чтобы деактивировать , чтобы выйти из виртуальной среды.

В macOS:

  1. Удерживая CTRL щелкните папку проекта, чтобы открыть окно терминала.
  2. Введите source env_myclub / bin / activate , чтобы запустить виртуальную среду.
  3. Перейдите в каталог вашего сайта ( cd myclub_site ), чтобы запустить команды manage.py (например, runserver ).
  4. Введите , чтобы деактивировать , чтобы выйти из виртуальной среды.

Краткое содержание главы

В этой главе я показал вам, как установить Python 3 и Django как в Windows, так и в macOS. В следующей главе мы сделаем шаг назад и в целом рассмотрим структуру Django и то, как все части Django работают вместе для создания мощных масштабируемых веб-приложений.

Настройка проекта Django - Настоящий Python

Прежде чем вы сможете приступить к созданию отдельных функций нового веб-приложения Django, вам всегда нужно выполнить пару шагов по настройке. В этом руководстве вы найдете справочную информацию о необходимых шагах по настройке проекта Django.

В этом руководстве рассматриваются первые шаги, которые необходимо предпринять для запуска нового веб-приложения. Для его выполнения вам потребуется установить Python и понимать, как работать с виртуальными средами и менеджером пакетов Python, pip .Хотя для выполнения этой настройки вам не потребуются большие знания в области программирования, вам необходимо знать Python, чтобы делать что-нибудь интересное с получившимися каркасами проекта.

К концу этого руководства вы будете знать, как:

  • Настроить виртуальную среду
  • Установить Django
  • Закрепите свой проект зависимости
  • Настроить проект Django
  • Запустить приложение Django

Используйте это руководство как справочник, пока не создадите так много проектов, что необходимые команды станут вашей второй натурой.А пока следуйте инструкциям, описанным ниже. В руководстве также есть несколько упражнений, которые помогут закрепить то, что вы узнали.

Подготовьте среду обитания

Когда вы будете готовы запустить новое веб-приложение Django, создайте новую папку и перейдите в нее. В этой папке вы создадите новую виртуальную среду с помощью командной строки:

Эта команда устанавливает новую виртуальную среду с именем env в вашем текущем рабочем каталоге. После завершения процесса вам также необходимо активировать виртуальную среду:

  $ исходный env / bin / activate
  

Если активация прошла успешно, вы увидите имя вашей виртуальной среды (env) в начале командной строки.Это означает, что настройка вашей среды завершена.

Вы можете узнать больше о том, как работать с виртуальными средами в Python и как улучшить настройку разработки Python, но для вашей настройки Django у вас есть все, что вам нужно. Вы можете продолжить установку пакета django .

Установите Django и закрепите свои зависимости

После того, как вы создали и активировали виртуальную среду Python, вы можете установить Django в это специальное рабочее пространство для разработки:

  (env) $ python -m pip установить django
  

Эта команда извлекает пакет django из индекса пакетов Python (PyPI), используя pip .После завершения установки вы можете закрепить свои зависимости, чтобы убедиться, что вы отслеживаете, какую версию Django вы установили:

  (env) $ python -m pip freeze> requirements.txt
  

Эта команда записывает имена и версии всех внешних пакетов Python, которые в настоящее время находятся в вашей виртуальной среде, в файл с именем requirements.txt . Этот файл будет включать пакет django и все его зависимости.

Примечание: Существует много разных версий Django. Хотя обычно при запуске нового проекта лучше работать с самой последней версией, возможно, вам придется работать с определенной версией для одного конкретного проекта. Вы можете установить любую версию Django, добавив номер версии в команду установки:

  (env) $ python -m pip install django == 2.2.11
  

Эта команда устанавливает версию Django 2.2.11 в вашу среду вместо получения самой последней версии.Замените число после двойного знака равенства ( == ) конкретной версией Django, которую необходимо установить.

Вы всегда должны включать записи о версиях всех пакетов, которые вы использовали в коде вашего проекта, например, в файле requirements.txt . Файл requirements.txt позволяет вам и другим программистам воспроизвести точные условия сборки вашего проекта.

Откройте созданный вами файл requirements.txt и проверьте его содержимое.Вы можете увидеть имена всех установленных пакетов, а также их номера версий. Вы заметите другие пакеты, помимо django , перечисленных в файле, даже если вы установили только Django. Как вы думаете, почему?

Предположим, вы работаете над существующим проектом с его зависимостями, уже закрепленными в файле requirements.txt . В этом случае вы можете установить правильную версию Django, а также все другие необходимые пакеты с помощью одной команды:

  (env) $ python -m pip install -r требования.текст
  

Команда считывает все имена и версии закрепленных пакетов из файла requirements.txt и устанавливает указанную версию каждого пакета в вашей виртуальной среде.

Сохранение отдельной виртуальной среды для каждого проекта позволяет вам работать с разными версиями Django для разных проектов веб-приложений. Закрепление зависимостей с помощью pip freeze позволяет воспроизвести среду, необходимую для правильной работы проекта.

Настройка проекта Django

После успешной установки Django вы готовы создать основу для вашего нового веб-приложения. Фреймворк Django различает проектов и приложений :

  • Проект Django - это высокоуровневая единица организации, которая содержит логику, которая управляет всем вашим веб-приложением. Каждый проект может содержать несколько приложений.
  • Приложение Django - это элемент нижнего уровня вашего веб-приложения.В проекте может быть от нуля до многих приложений, и обычно у вас будет хотя бы одно приложение. Вы узнаете больше о приложениях в следующем разделе.

Теперь, когда ваша виртуальная среда настроена и активирована, а Django установлен, вы можете создать проект:

  (env) $ django-admin startproject <имя-проекта>
  

В этом руководстве используется установка в качестве примера имени проекта:

  (env) Настройка startproject $ django-admin
  

При выполнении этой команды создается структура папок по умолчанию, которая включает в себя некоторые файлы Python и ваше приложение управления, имя которого совпадает с именем вашего проекта:

  настройка /
│
├── настройка /
│ ├── __init__.ру
│ ├── asgi.py
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
│
└── manage.py
  

В блоке кода выше вы можете увидеть структуру папок, созданную для вас командой startproject :

  • setup / - это папка вашего проекта верхнего уровня.
  • setup / setup / - ваша папка нижнего уровня, представляющая ваше приложение для управления.
  • manage.py - это файл Python, который служит центром управления вашим проектом.Она делает то же самое, что и утилита командной строки django-admin .

Вложенная папка setup / setup / содержит еще пару файлов, которые вы будете редактировать при работе с веб-приложением.

Примечание: Если вы не хотите создавать дополнительную папку проекта верхнего уровня, вы можете добавить точку (, ) в конце команды django-admin startproject :

  (env) $ django-admin startproject <имя проекта>. 

Точка пропускает папку проекта верхнего уровня и создает приложение для управления и файл manage.py прямо внутри текущего рабочего каталога. Вы можете встретить этот синтаксис в некоторых онлайн-руководствах по Django. Все, что он делает, - это создание каркаса проекта без дополнительной папки проекта верхнего уровня.

Найдите минутку, чтобы изучить структуру проекта по умолчанию, созданную для вас утилитой командной строки django-admin . Каждый проект, который вы создадите с помощью команды startproject , будет иметь одинаковую структуру.

Когда вы будете готовы, вы можете перейти к созданию приложения Django в качестве элемента нижнего уровня вашего нового веб-приложения.

Запустить приложение Django

Каждый проект, созданный с помощью Django, может содержать несколько приложений Django. Выполнив команду startproject из предыдущего раздела, вы создали приложение для управления, которое вам понадобится для каждого проекта по умолчанию, который вы будете строить. Теперь вы создадите приложение Django, которое будет содержать определенные функции вашего веб-приложения.

Вам больше не нужно использовать утилиту командной строки django-admin , вместо этого вы можете выполнить команду startapp через файл manage.py :

  (env) $ python manage.py startapp <имя приложения>
  

Команда startapp генерирует структуру папок по умолчанию для приложения Django. В этом руководстве в качестве имени приложения используется , пример :

.

  (env) Пример $ python manage.py startapp
  

Не забудьте заменить example именем своего приложения при создании приложения Django для своего личного веб-приложения.

Примечание: Если вы создали свой проект без ярлыка с точкой, упомянутого выше, вам нужно будет изменить рабочий каталог на папку проекта верхнего уровня, прежде чем запускать команду, показанную выше.

Как только команда startapp завершит выполнение, вы увидите, что Django добавил еще одну папку в вашу структуру папок:

  настройка /
│
├── пример /
│ │
│ ├── миграции /
│ │ └── __init__.py
│ │
│ ├── __init__.py
│ ├── админ.ру
│ ├── apps.py
│ ├── models.py
│ ├── tests.py
│ └── views.py
│
├── настройка /
│ ├── __init__.py
│ ├── asgi.py
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
│
└── manage.py
  

Новая папка имеет имя, которое вы дали ей при запуске команды. В случае этого руководства это example / . Вы можете видеть, что папка содержит пару файлов Python.

В этой папке приложения Django вы будете проводить большую часть своего времени при создании веб-приложения.Вам также нужно будет внести некоторые изменения в приложение управления, setup / , но вы создадите большую часть своих функций внутри приложения Django, example / .

Перейдите в папку example / и откройте вновь созданные файлы Python. Не волнуйтесь, если вы еще не понимаете код, который сгенерировал для вас Django, и помните, что вам не нужно , чтобы понять все это для создания веб-приложения Django. Изучите комментарии к коду в каждом файле и посмотрите, могут ли они помочь прояснить вариант использования каждого файла.

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

  1. __init__.py : Python использует этот файл для объявления папки как пакета, что позволяет Django использовать код из разных приложений для создания общей функциональности вашего веб-приложения. Возможно, вам не придется трогать этот файл.
  2. моделей.py : вы объявляете модели своего приложения в этом файле, что позволяет Django взаимодействовать с базой данных вашего веб-приложения.
  3. views.py : в этом файле вы напишете большую часть логики кода вашего приложения.

На этом этапе вы закончили настройку каркаса для своего веб-приложения Django и можете приступить к реализации своих идей. С этого момента вам решать, что вы хотите создать, чтобы создать свой собственный уникальный проект.

Справочник команд

В таблице ниже представлен краткий справочник по командам, необходимым для запуска процесса разработки Django.Шаги в справочной таблице ссылаются на разделы этого руководства, где вы можете найти более подробные объяснения:

Шаг Описание Команда
1a Настроить виртуальную среду питон -m venv env
Активировать виртуальную среду исходный env / bin / активировать
2a Установить Django python -m pip install django
2b Закрепите зависимости python -m pip freeze> требования.txt
3 Настроить проект Django django-admin startproject <имя проекта>
4 Запустите приложение Django python manage.py startapp <имя приложения>

Используйте эту таблицу в качестве краткого справочника по запуску нового веб-приложения с Django внутри виртуальной среды Python.

Заключение

В этом руководстве вы прошли все шаги, необходимые для создания основы для нового веб-приложения Django.Вы познакомились с наиболее распространенными командами терминала, которые вы будете повторять снова и снова при использовании Django для веб-разработки.

Вы также прочитали о , почему вы хотите использовать каждую команду и что они производят, и вы узнали несколько советов и приемов, связанных с установкой с Django.

В этом руководстве вы узнали, как:

  • Настроить виртуальную среду
  • Установить Django
  • Закрепите свой проект зависимости
  • Настроить проект Django
  • Запустить приложение Django

После выполнения шагов, описанных в этом руководстве, вы готовы приступить к созданию собственного веб-приложения с помощью Django.Например, вы можете создать приложение-портфолио, чтобы продемонстрировать свои проекты кодирования. Для структурированного способа дальнейшего развития ваших навыков Django вы можете продолжить работу с помощью ресурсов, предоставленных в пути обучения Django.

Продолжайте настраивать фундаментальные каркасы для веб-приложений Django, пока эти шаги не станут для вас второй натурой. Если вам нужно что-то напомнить, вы всегда можете использовать это руководство в качестве краткого справочника.

настройка django на windows (32bit) · GitHub

установка django на windows (32bit) · GitHub

Мгновенно делитесь кодом, заметками и фрагментами.

настройка django на windows (32bit)
1. Установите последнюю версию python (2.6 или выше). Помните, что python 3.0 не поддерживает django.
http://www.python.org/download/
Добавьте ваш python c: \ Python2x в путь (Панель управления> Система> Дополнительно> Переменные среды)
например: если python 2.7 установлен, то путь будет выглядеть как c: \ Python27
Панель управления> Система> Дополнительно> Переменные среды
2. Установите инструменты настройки для вашей версии Windows от
http://pypi.python.org/pypi/setuptools#downloads
, если у вас возникли трудности с его установкой. запустите файл с помощью интерпретатора Python (IDLE)
3.Загрузите и установите pip из
http://pypi.python.org/pypi/pip#downloads
установочный патрубок
a) разархивируйте папку pip
b) перейдите в несжатый каталог pip и: python setup.py install
c) Добавьте свой python c: \ Python2x \ Scripts к пути
4.Теперь вы можете устанавливать любые пакеты python с помощью pip
pip install имя_пакета
мы можем установить и загрузить django с помощью этой команды
"pip install django"
, это загрузит и установит django.
5. вы можете установить зависимости mysql с помощью этой команды
pip установить mysql-python
или
http://sourceforge.net/projects/mysql-python/
6. Для локализации необходим xgettext
a) Пользователям Win32 необходимо загрузить 3 zip-файла с? Http: // sourceforge.сеть / проекты / gettext:
a1) gettext-runtime-X.bin.woe32.zip
a2) gettext-tools-X.bin.woe32.zip
a3) libiconv-X.bin.woe32.zip
b) извлеките 3 файла из одной папки (например, C: \ Program Files \ gettext-utils).
c) Обновите системный ПУТЬ:
Панель управления> Система> Дополнительно> Переменные среды
, то есть C: \ Program Files \ gettext-utils \ bin "в конце окна" Значение переменной "
Примечание:
Для 64-битных окон вы устанавливаете его с помощью cygwin
http: // cygwin.com

Вы не можете выполнить это действие в настоящее время.Вы вошли в систему с другой вкладкой или окном. Перезагрузите, чтобы обновить сеанс.
Вы вышли из системы на другой вкладке или в другом окне. Перезагрузите, чтобы обновить сеанс.

Глава 1: Начальная настройка

В этой главе рассказывается, как правильно настроить компьютер для работы с проектами Django. Начнем с обзора командной строки и того, как установить последнюю версию Django и Python. Затем мы обсудим виртуальные среды, git и работу с текстовым редактором.К концу этой главы вы будете готовы создавать и изменять новые проекты Django всего несколькими нажатиями клавиш.

Командная строка

Командная строка - это мощное текстовое представление вашего компьютера. Как разработчики, мы будем широко использовать его в этой книге для установки и настройки каждого проекта Django.

На Mac командная строка находится в программе под названием Terminal . Чтобы найти его, откройте новое окно Finder, откройте каталог Applications , прокрутите вниз, чтобы открыть каталог Utilities , и дважды щелкните приложение под названием Terminal.

На компьютерах с Windows фактически есть две встроенные командные оболочки: оболочка Command и PowerShell . Вам следует использовать PowerShell, который является более мощным из двух.

Забегая вперед, когда в книге упоминается «командная строка», это означает открытие новой консоли на вашем компьютере, используя либо Терминал, либо PowerShell.

Хотя есть много возможных команд, которые мы можем использовать, на практике в разработке Django наиболее часто используются шесть:

  • cd (перейти в каталог)
  • кд.. (перейти в каталог)
  • ls (список файлов в текущем каталоге на Mac)
  • dir (список файлов в текущем каталоге в Windows)
  • pwd (распечатать рабочий каталог)
  • mkdir (каталог создания)
  • сенсорный (создать новый файл на Mac)

Откройте командную строку и попробуйте их. Знак доллара ( $ ) - это приглашение командной строки: все команды в этой книге предназначены для ввода после приглашения $ .

Например, если вы работаете на Mac, давайте перейдем в каталог на рабочем столе.

Обратите внимание, что наше текущее местоположение, ~ / Desktop , автоматически добавляется перед нашей командной строкой. Чтобы убедиться, что мы находимся в правильном месте, мы можем использовать pwd , который распечатает путь к нашему текущему каталогу.

  ~ / Рабочий стол $ pwd
/ Пользователи / WSV / рабочий стол
  

На моем компьютере Mac это показывает, что я использую пользователя wsv , а на настольном компьютере для этой учетной записи.

Теперь давайте создадим новый каталог с mkdir , cd и добавим новый файл index.html с помощью команды touch . Обратите внимание, что машины с Windows, к сожалению, не поддерживают собственную команду touch . В будущих главах, когда вам будет предложено создать новый файл, сделайте это в любом текстовом редакторе.

  ~ / Рабочий стол $ mkdir new_folder
~ / Рабочий стол $ cd new_folder
~ / Рабочий стол / новая_папка $ touch index.html
  

Теперь используйте ls для вывода списка всех текущих файлов в нашем каталоге.Вы увидите только что созданный index.html .

  ~ / Рабочий стол / новая_папка $ ls
index.html
  

В качестве последнего шага вернитесь в каталог рабочего стола с помощью cd .. и используйте pwd для подтверждения местоположения.

  ~ / Рабочий стол / новая_папка $ cd ..
~ / Рабочий стол $ pwd
/ Пользователи / WSV / рабочий стол
  

Опытные разработчики могут использовать клавиатуру и командную строку для удобной навигации по компьютеру. На практике этот подход намного быстрее, чем использование мыши.

В этой книге я дам вам точные инструкции по запуску - вам не нужно быть экспертом в командной строке, - но со временем это станет хорошим навыком для любого профессионального разработчика программного обеспечения. Хорошим бесплатным ресурсом для дальнейшего изучения является ускоренный курс командной строки.

Установить Python 3

Требуется некоторая настройка для правильной установки Python 3 на компьютер Mac, Windows, Linux или Chromebook, и существует несколько подходов. Многие разработчики, особенно новички, следуют советам на официальном веб-сайте Python, чтобы загрузить различные версии Python прямо на свой компьютер, а затем соответствующим образом настроить переменную PATH.

Проблема с этим подходом заключается в том, что правильно обновить переменную PATH сложно, при загрузке напрямую обновлений Python сложнее поддерживать, и теперь есть гораздо более простые способы быстро установить и начать использовать Python.

У меня есть специальный веб-сайт InstallPython3.com с новейшими руководствами по установке Python 3 на компьютеры Mac, Windows или Linux. Пожалуйста, обратитесь туда, чтобы правильно установить Python на свой локальный компьютер.

Виртуальные среды

Виртуальные среды - неотъемлемая часть программирования на Python.Они представляют собой изолированный контейнер, содержащий все зависимости программного обеспечения для данного проекта. Это важно, потому что по умолчанию программное обеспечение, такое как Python и Django, установлено в том же каталоге . Это вызывает проблему, если вы хотите работать над несколькими проектами на одном компьютере. Что, если ProjectA использует Django 3.1, но ProjectB из прошлого года все еще находится на Django 2.2? Без виртуальных сред это становится очень сложно; с виртуальными средами это вообще не проблема.

Есть много областей разработки программного обеспечения, которые горячо обсуждаются, но использование виртуальных сред для разработки на Python - не одна из них. Вы должны использовать выделенную виртуальную среду для каждого нового проекта Python .

В этой книге мы будем использовать Pipenv для управления виртуальными средами. Pipenv похож на npm и yarn из экосистемы JavaScript / Node: он создает Pipfile , содержащий программные зависимости и Pipfile.Замок для обеспечения детерминированных сборок. «Детерминизм» означает, что каждый раз, когда вы загружаете программное обеспечение в новую виртуальную среду, у вас будет точно такая же конфигурация .

Себастьян Маккензи, создатель Yarn, который первым представил эту концепцию в упаковке JavaScript, опубликовал краткое сообщение в блоге, в котором объясняется, что такое детерминизм и почему он важен. Конечным результатом является то, что мы создадим новую виртуальную среду с Pipenv для каждого нового проекта Django.

Для установки Pipenv мы можем использовать pip3 , который Homebrew автоматически установил для нас вместе с Python 3.

Установить Django

Чтобы увидеть Pipenv в действии, давайте создадим новый каталог и установим Django. Сначала перейдите на Рабочий стол, создайте новый каталог django и войдите в него с cd .

  $ cd ~ / Рабочий стол
$ mkdir джанго
$ cd django
  

Теперь используйте Pipenv для установки Django.Обратите внимание на использование ~ = , которое обеспечит обновления безопасности для Django, такие как 3.1.1, 3.1.2 и т. Д.

  $ pipenv установить django ~ = 3.1.0
  

Если вы заглянете в наш каталог, то увидите два новых файла: Pipfile и Pipfile.lock . У нас есть информация, необходимая для новой виртуальной среды, но мы еще не активировали ее. Давайте сделаем это с помощью оболочки pipenv .

Если вы работаете на Mac, теперь вы должны увидеть круглые скобки вокруг имени вашего текущего каталога в командной строке, что означает, что виртуальная среда активирована.Поскольку мы находимся в каталоге django , это означает, что мы должны увидеть (django) в начале командной строки. Пользователи Windows не увидят приглашение оболочки. Если вы можете запустить django-admin startproject в следующем разделе, значит, вы знаете, что в вашей виртуальной среде правильно установлен Django.

Значит, работает! Создайте новый проект Django с именем config с помощью следующей команды. Не забывайте тот период года. в конце.

  (django) $ django-admin startproject config.
  

Здесь стоит сделать паузу, чтобы объяснить, почему вы должны добавить в команду точку (. ). Если вы просто запустите django-admin startproject config , то по умолчанию Django создаст такую ​​структуру каталогов:

  └── конфиг
    ├── конфиг
    │ ├── __init__.py
    │ ├── asgi.py
    │ ├── settings.py
    │ ├── urls.py
    │ └── wsgi.py
    └── manage.py
  

Посмотрите, как он создает новый каталог config , а затем в нем управляет .py файл и config каталог? Мне это кажется излишним, поскольку мы уже создали и перешли в каталог django на нашем рабочем столе. Запустив django-admin startproject config. с точкой в ​​конце - что означает установку в текущий каталог - вместо этого результат будет следующим:

  ├── конфиг
│ ├── __init__.py
│ ├── asgi.py
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
└── manage.py
  

Вывод состоит в том, что на самом деле не имеет значения, вы включаете точку или нет в конце команды, но я предпочитаю включать точку, и именно так мы сделаем это в этой книге.

По мере того, как вы продвигаетесь в своем путешествии по изучению Django, вы начнете все больше и больше сталкиваться с похожими ситуациями, когда в сообществе Django существуют разные мнения о правильных передовых методах. Django в высшей степени настраиваемый, что является большим преимуществом, однако недостатком является то, что эта гибкость достигается за счет кажущейся сложности. Вообще говоря, это хорошая идея - изучить любые возникающие проблемы, принять решение, а затем придерживаться его!

Теперь давайте подтвердим, что все работает, запустив локальный веб-сервер Django.

  (django) $ python manage.py runserver
Наблюдение за изменениями файлов с помощью StatReloader
Выполнение системных проверок ...

Проверка системы не выявила проблем (0 отключено).

У вас 18 непримененных миграций. Ваш проект может не работать должным образом, пока
вы применяете миграции для приложений: admin, auth, contenttypes, sessions.
Запустите python manage.py migrate, чтобы применить их.

3 августа 2020 года - 14:52:27
Django версии 3.1, используя настройки config.settings
Запуск сервера разработки по адресу http: // 127.0.0.1: 8000 /
Закройте сервер, нажав CONTROL-C.
  

Не беспокойтесь о красном тексте о «18 непримененных миграциях». Мы скоро к этому вернемся, но на данный момент важная часть - это посетить http://127.0.0.1:8000/ и убедиться, что видно следующее изображение:

Чтобы остановить наш локальный сервер, введите Control + c . Затем выйдите из нашей виртуальной среды, используя команду exit .

Мы всегда можем снова активировать виртуальную среду с помощью оболочки pipenv в любое время.

В этой книге мы получим много практических занятий с виртуальными средами, так что не беспокойтесь, если сейчас это немного запутывает. Базовый шаблон - установить новые пакеты с помощью pipenv , активировать их с помощью оболочки pipenv , а затем выйти из , когда закончите.

Стоит отметить, что на вкладке командной строки может быть активна только одна виртуальная среда. В следующих главах мы будем создавать новую виртуальную среду для каждого нового проекта, поэтому либо убедитесь, что выйдет из из вашей текущей среды, либо откройте новую вкладку для новых проектов.

Установить Git

Git - незаменимая часть современной разработки программного обеспечения. Это система контроля версий, которую можно рассматривать как чрезвычайно мощную версию отслеживания изменений в Microsoft Word или Google Docs. С помощью git вы можете сотрудничать с другими разработчиками, отслеживать всю свою работу с помощью коммитов и возвращаться к любой предыдущей версии вашего кода, даже если вы случайно удалили что-то важное!

На Mac, поскольку HomeBrew уже установлен, мы можем просто ввести brew install git в командной строке:

В Windows вы должны загрузить Git из Git для Windows.Нажмите кнопку «Загрузить» и следуйте инструкциям по установке.

После установки нам нужно выполнить однократную настройку системы для ее настройки, объявив имя и адрес электронной почты, которые вы хотите связать со всеми вашими коммитами Git. В консоли командной строки введите следующие две строки. Обязательно обновите им свое имя и адрес электронной почты.

  $ git config --global user.name "Ваше имя"
$ git config --global user.email "[email protected]"
  

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

Текстовые редакторы

Последний шаг - наш текстовый редактор. В то время как командная строка - это то место, где мы выполняем команды для наших программ, текстовый редактор - это то место, где пишется фактический код. Компьютеру все равно, какой текстовый редактор вы используете - конечный результат - всего лишь код, - но хороший текстовый редактор может дать вам полезные подсказки и отловить опечатки.

Опытные разработчики часто предпочитают использовать либо Vim, либо Emacs - текстовые редакторы десятилетней давности, у которых есть преданные последователи. Однако каждый из них требует сложного обучения и требует запоминания множества различных комбинаций клавиш.Новичкам их не рекомендую.

Современные текстовые редакторы сочетают в себе те же мощные функции с привлекательным визуальным интерфейсом. Сейчас мне больше всего нравится Visual Studio Code, который бесплатен, прост в установке и пользуется широкой популярностью. Если вы еще не используете текстовый редактор, загрузите и установите Visual Studio Code прямо сейчас.

Заключение

Уф! На самом деле никому не нравится настраивать локальную среду разработки, но, к счастью, это разовая боль. Теперь мы научились работать с виртуальными средами и установили последнюю версию Python и git.Все готово для нашего первого приложения Django.

Перейдите к главе 2: Приложение Hello World.

.

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

Ваш адрес email не будет опубликован.