Как скачать django python
Перейти к содержимому

Как скачать django python

  • автор:

Как установить Django на Windows¶

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

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

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

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

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

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

. \> py --version

Для более подробной информации смотрите документацию Using Python on Windows .

О pip ¶

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

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

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

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

. \> py -m venv project-name
. \> project-name\Scripts\activate.bat

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

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

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

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

. \> py -m pip install Django

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

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

Информацию об установке базы данных в Django смотрите в Запустите свою базу данных .

Выход цветных клемм¶

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

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

. \> py -m pip install "colorama >= 0.4.6" 

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

Распространенные подводные камни¶

  • Если django-admin отображает только текст справки независимо от того, какие аргументы ему заданы, вероятно, существует проблема с ассоциацией файлов в Windows. Проверьте, не установлено ли более одной переменной окружения для запуска скриптов Python в PATH . Обычно это происходит, когда установлено более одной версии Python.
  • Если вы подключаетесь к Интернету через прокси-сервер, то могут возникнуть проблемы с выполнением команды py -m pip install Django . Установите переменные окружения для настройки прокси-сервера в командной строке следующим образом:
. \> set http_proxy=http://username:password@proxyserver:proxyport . \> set https_proxy=https://username:password@proxyserver:proxyport

Установка Django

Примечание: если ты используешь 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 в домашнем каталоге:

$ mkdir djangogirls $ cd djangogirls 

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

$ python3 -m venv myvenv 

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

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

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

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

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

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

$ 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.8 myvenv 

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

command-line

E: Unable to locate package python3-venv 

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

command-line

sudo apt install python3.8-venv 

Работаем с virtualenv

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

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

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

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

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

$ source myvenv/bin/activate 

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

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

command-line

$ . myvenv/bin/activate 

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

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

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

Установка Django

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

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

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

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

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

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

djangogirls └───requirements.txt 

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

Django~=3.2.10 

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

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

Установка 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-приложение!

Как скачать django python

Перед началом работы с Django нам естественно надо установить интерпретатор Python. Подоробнее об этом можно почитать здесь.

Существуют разные способы установки Django. Рассмотрим рекомендуемый способ.

Пакетный менеджер pip

Пакеты Django размещаются в центральном репозитории для большинства пакетов Python — Package Index (PyPI). И для установки из этого репозитория нам потребуется пакетный менеджер pip . Менеджер pip позволяет загружать пакеты и управлять ими. Обычно при установке python также устанавливается и менеджер pip. В этом случае мы можем проверить версию менеджера, выполнив в командной строке/терминале команду pip -V (V — с заглавной буквы):

C:\Users\eugen>pip -V pip 23.3.1 from C:\Users\eugen\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12) C:\Users\eugen>

Если pip не установлен, то мы увидим ошибку типа

"pip" не является внутренней или внешней командой, исполняемой программой или пакетным файлом

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

python -m ensurepip --upgrade

Если pip ранее уже был установлен, то можно его обновить с помощью команды

python -m pip install --upgrade pip

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

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

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

Для работы с виртуальной средой в python применяется встроенный модуль venv

Итак, создадим вируальную среду. Вначале определим каталог для проектов django. Например, пусть это будет каталог C:\django . Прежде всего перейдем в терминале/командной строке в этот каталог с помощью команды cd.

cd C:\django

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

python -m venv .venv

Модулю venv передается название среды, которая в данном случае будет называться «.venv». Для наименования виртуальных сред нет каких-то определенных условностей. Пример консольного вывода:

C:\Users\eugen>cd C:\djangoПереход к папке будущей виртуальной среды C:\django>python -m venv .venvСоздание виртуальной среды C:\django>

После этого в текущей папке (C:\django) будет создан подкаталог «.venv».

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

Для использования виртуальную среду надо активировать. И каждый раз, когда мы будем работать с проектом Django, связанную с ним виртуальную среду надо активировать . Например, активируем выше созданную среду, которая располагается в текущем каталоге в папке .venv. Процесс активации немного отличается в зависимости от операционной системы и от того, какие инструменты применяются. Так, в Windows можно использовать командную строку и PowerShell, но между ними есть отличия.

Активация в Windows в коммандной строке

Если наша ОС — Windows, то в папке .venv/Scripts/ мы можем найти файл activate.bat ), который активирует виртуальную среду. Так, в Windows активация виртуальной среды в коммандной строке будет выглядеть таким образом:

.venv\Scripts\activate.bat
Активация в Windows в PowerShell

Также при работе на Windows в папке .venv/Scripts/ мы можем найти файл activate.ps1 , который также активирует виртуальную среду, но применяется только в PowerShell. Но при работе с PowerShell следует учитывать, что по умолчанию в этой оболочке запрещено применять скрипты. Поэтому перед активацией среды необходимо установить разрешения для текущего пользователя. Поэтому для активации виртуальной среды в PowerShell необходимо выполнить две следующих команды:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser .venv\Scripts\Activate.ps1
Активация в Linux и MacOS

Для Linux и MacOS активация будет производиться с помощью следующей команды:

source .venv/bin/activate

Далее я буду приводить примеры на основе командной строки Windows, однако все остальные примеры не будут зависеть от того, что используется — PowerShell или командная строка, Windows, Linux или MacOS. В любом случае после успешной активации слева от текущего каталога мы увидим в скобках название виртуальной среды:

C:\Users\eugen>cd C:\django C:\django>python -m venv .venv C:\django>.venv\Scripts\activate.batАктивация виртуальной среды (.venv) C:\django> Виртуальная среда активирована 

Установка Django

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

python -m pip install Django

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

(.venv) C:\django>python -m pip install Django Collecting Django Using cached Django-4.1-py3-none-any.whl (8.1 MB) Collecting sqlparse>=0.2.2 Using cached sqlparse-0.4.2-py3-none-any.whl (42 kB) Collecting tzdata Using cached tzdata-2022.1-py2.py3-none-any.whl (339 kB) Collecting asgiref=3.5.2 Using cached asgiref-3.5.2-py3-none-any.whl (22 kB) Installing collected packages: tzdata, sqlparse, asgiref, Django Successfully installed Django-4.1 asgiref-3.5.2 sqlparse-0.4.2 tzdata-2022.1 (.venv) C:\django>

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

python -m pip install django~=4.0.0

Проверка установки

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

python

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

>>> import django >>> print(django.get_version())

Консольный вывод в моем случае:

(.venv) C:\django>python Python 3.10.1 (tags/v3.10.1:2cd268a, Dec 6 2021, 19:10:37) [MSC v.1929 64 bit (AMD64)] on win32 Type "help", "copyright", "credits" or "license" for more information. >>> import django >>> print(django.get_version()) 4.1 >>>

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

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

Как установить Django¶

Django — это веб-фреймворк на языке Python. Подробности см. в Какие версии Python можно использовать с Django? .

Скачайте последнюю версию Python по ссылке https://www.python.org/downloads/ или установите с помощью менеджера пакетов своей операционной системы.

Python в Windows

Если вы только начинаете работать с Django и используете Windows, вам может пригодиться Как установить Django на Windows .

Установите Apache и mod_wsgi ¶

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

Если вы хотите использовать Django на рабочем сайте, используйте Apache с mod_wsgi. mod_wsgi работает в одном из двух режимов: встроенный режим или режим демона. В режиме встраивания mod_wsgi похож на mod_perl — он встраивает Python в Apache и загружает Python-код в память при запуске сервера. Код остается в памяти на протяжении всей жизни процесса Apache, что приводит к значительному приросту производительности по сравнению с другими схемами организации сервера. В режиме демона mod_wsgi порождает независимый процесс демона, который обрабатывает запросы. Процесс демона может работать от имени пользователя, отличного от веб-сервера, что, возможно, повышает безопасность. Процесс демона может быть перезапущен без перезапуска всего веб-сервера Apache, что может сделать обновление вашей кодовой базы более плавным. Обратитесь к документации mod_wsgi, чтобы определить, какой режим подходит для вашей установки. Убедитесь, что у вас установлен Apache с активированным модулем mod_wsgi. Django будет работать с любой версией Apache, поддерживающей mod_wsgi.

Информацию о том, как настроить mod_wsgi после его установки, смотрите в How to use Django with mod_wsgi .

Если по каким-то причинам вы не можете использовать mod_wsgi, не бойтесь: Django поддерживает множество других вариантов развертывания. Один из них — uWSGI ; он очень хорошо работает с nginx. Кроме того, Django следует спецификации WSGI ( PEP 3333), что позволяет ему работать на различных серверных платформах.

Запустите свою базу данных¶

Если вы планируете использовать функциональность API базы данных Django, вам необходимо убедиться, что сервер базы данных запущен. Django поддерживает множество различных серверов баз данных и официально поддерживается с PostgreSQL, MariaDB, MySQL, Oracle и SQLite.

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

Помимо официально поддерживаемых баз данных, есть backends provided by 3rd parties , которые позволяют использовать другие базы данных с Django.

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

  • Если вы используете PostgreSQL, то вам потребуется пакет psycopg или psycopg2. Более подробную информацию см. в PostgreSQL notes .
  • Если вы используете MySQL или MariaDB, вам понадобится DB API driver , например mysqlclient . Подробнее см. в разделе notes for the MySQL backend .
  • Если вы используете SQLite, то, возможно, захотите прочитать SQLite backend notes .
  • Если вы используете Oracle, вам потребуется установить oracledb, но, пожалуйста, прочитайте notes for the Oracle backend для получения подробной информации о поддерживаемых версиях Oracle и oracledb .
  • Если вы используете неофициальный бэкенд стороннего производителя, пожалуйста, обратитесь к прилагаемой документации для получения информации о дополнительных требованиях.

Если вы планируете использовать команду Django manage.py migrate для автоматического создания таблиц базы данных для ваших моделей (после первой установки Django и создания проекта), вам необходимо убедиться, что Django имеет права на создание и изменение таблиц в используемой базе данных; если вы планируете создавать таблицы вручную, вы можете предоставить Django права SELECT , INSERT , UPDATE и DELETE . После создания пользователя базы данных с этими разрешениями, вы укажете детали в файле настроек вашего проекта, подробности см. в DATABASES .

Если вы используете Django testing framework для тестирования запросов к базе данных, Django потребуется разрешение на создание тестовой базы данных.

Установите код Django¶

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

Установка официального релиза с помощью pip ¶

Это рекомендуемый способ установки Django.

  1. Установите pip. Проще всего использовать standalone pip installer. Если в вашем дистрибутиве уже установлен pip , вам может понадобиться обновить его, если он устарел. Если он устарел, вы узнаете об этом, потому что установка не будет работать.
  2. Посмотрите на venv . Этот инструмент обеспечивает изолированное окружение Python, что более практично, чем установка пакетов по всей системе. Он также позволяет устанавливать пакеты без привилегий администратора. В contributing tutorial рассказывается о том, как создать виртуальную среду.
  3. После того как вы создали и активировали виртуальную среду, введите команду:

&#xf17c/&#xf179 &#xf17a

$ python -m pip install Django
. \> py -m pip install Django

Установка пакета, специфичного для дистрибутива¶

Проверьте distribution specific notes , чтобы узнать, предоставляет ли ваша платформа/дистрибутив официальные пакеты/установщики Django. Пакеты, предоставляемые дистрибутивом, обычно позволяют автоматически устанавливать зависимости и поддерживают пути обновления; однако, эти пакеты редко содержат последний выпуск Django.

Установка версии для разработки¶

Отслеживание разработки Django

Если вы решите использовать последнюю версию Django для разработки, вам стоит обратить пристальное внимание на the development timeline, а также следить за release notes for the upcoming release . Это поможет вам быть в курсе всех новых возможностей, которые вы захотите использовать, а также всех изменений, которые вам нужно будет внести в ваш код при обновлении вашей копии Django. (Для стабильных релизов все необходимые изменения документируются в примечаниях к релизу).

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

  1. Убедитесь, что у вас установлен Git и что вы можете выполнять его команды из оболочки. (Чтобы проверить это, введите git help в приглашении оболочки).
  2. Проверьте основную ветвь разработки Django следующим образом:

&#xf17c/&#xf179 &#xf17a

$ git clone https://github.com/django/django.git
. \> git clone https://github.com/django/django.git

&#xf17c/&#xf179 &#xf17a

$ python -m pip install -e django/
. \> py -m pip install -e django\

Когда вы захотите обновить свою копию исходного кода Django, выполните команду git pull из каталога django . Когда вы это сделаете, Git загрузит все изменения.

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

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