Упражнение. Настройка среды разработки
Чтобы приступить к созданию приложения Flask на языке Python, сначала мы настроим среду разработки, установив для нее несколько элементов. К счастью, это будут довольно распространенные инструменты, так что они пригодятся вам не только в этом модуле. Возможно даже, что они у вас уже есть. Эти средства мы будем использовать для локальной разработки и тестирования приложения.
Из этого урока вы узнаете, как установить средства для Python и создать виртуальное окружение Python. Вы установите платформу Flask, на основе которой затем создадите веб-сайт.
Важно!
В этом модуле вы установите и настроите различные пакеты программного обеспечения и создадите виртуальное окружение Python. После активации виртуального окружения в окне командной строки или терминале не закрывайте окно или терминал. В противном случае следует перезапустить то же виртуальное окружение Python в новом окне или терминале. Очень важно выполнять всю работу в одном виртуальном окружении Python, созданном в начале этого модуля.
Говоря обобщенно, мы выполним следующие задачи:
- установка редактора кода Visual Studio Code (если он не установлен);
- установка Python (если он еще не установлен);
- создание каталога для кода;
- Создание виртуальной среды
- Установка Flask и других библиотек
Установка Visual Studio Code
Редактор кода Visual Studio Code с открытым кодом позволяет создавать приложения практически любого типа. Он подкреплен хорошо укомплектованным магазином расширений, где можно найти надстройки для упрощения разработки.
установите Python;
Для выполнения действий в этом уроке на компьютере должен быть установлен Python 3.6 или более поздней версии. Есть шанс, что Python у вас уже установлен, особенно если вы уже с ним работали. Чтобы проверить его наличие, выполните любую из следующих команд:
python --version
Если Python установлен, в выходных данных вы увидите номер версии. Если необходимо установить Python, выполните действия, описанные в документации по установке интерпретатора Python для Visual Studio Code. Вам также потребуется установить расширение Python Visual Studio Code.
Важно!
Если вы используете Windows, убедитесь, что расположение папки, которую вы установили Python, добавлено в переменную среды PATH. Если вы пропустите этот шаг, то даже после установки будете получать сообщение об ошибке "Python isn't found" (Python не найден). Чтобы устранить эту проблему, необходимо выполнить следующие действия, чтобы добавить Python в переменную среды PATH:
- Найдите каталог с файлом python.exe. Вы можете ввести Python, где в терминале командной строки найти файл python.exe
- Скопируйте значение пути "C:\<python path", вы добавите его в переменную Path> на шаге 6.
- Щелкните меню и введите "Изменить системные переменные среды", которая открывает системный окно свойств.
- На вкладке "Дополнительно" нажмите кнопку "Переменные среды".
- В разделе пользовательских переменных дважды щелкните переменную с именем Path, которая откроет окно со списком путей.
- Нажмите кнопку "Создать " и вставьте скопированный путь.
- После вставки нажмите кнопку "ОК" и "Python" теперь можно получить доступ из любого расположения на компьютере.
Примечание.
Чтобы убедиться, что конфигурация пути выполнена успешно, откройте новый терминал командной строки и введите python, чтобы просмотреть сведения о версии Python. Если не удается выполнить команду Python, перезапустите компьютер, чтобы изменения были внесены.
Создание каталога проекта
Создайте каталог в расположении на ваш выбор. Этот каталог будет каталогом проекта, и в нем разместится весь создаваемый код. Чтобы создать каталог, выполните в командной строке или в окне терминала любую из следующих команд:
# Windows, macOS or Linux
mkdir contoso
cd contoso
Важно!
Не закрывайте окно командной строки или терминала на протяжении всей работы с этим модулем.
Создание виртуального окружения Python
Не пугайтесь сложного выражения "Виртуальное окружение Python". Это не виртуальная машина или контейнер, а просто папка со всеми библиотеками для запуска приложения, в том числе со средой выполнения Python. Используя виртуальное окружение, мы можем сделать приложения модульными, а значит хранить их отдельно друг от друга, чтобы избежать проблем с управлением версиями. При работе с Python мы рекомендуем всегда использовать виртуальные окружения.
Чтобы применить виртуальное окружение, мы создадим его и активируем. Для этого нам потребуется модуль venv, который вы ранее установили, выполняя инструкции по установке Python. При активации мы сообщим нашей системе, что у нас есть папка со всем содержимым, которое нужно для Python.
# Windows, macOS or Linux
# Create the environment
python -m venv venv
Процесс создания виртуальной среды может занять несколько секунд. Дождитесь повторного появления запроса терминала перед активацией среды.
# Windows
# Activate the environment
./venv/scripts/activate
# macOS or Linux
# Activate the environment
source ./venv/bin/activate
Установка Flask и других библиотек
После создания и активации виртуального окружения мы можем установить библиотеку Flask, которая необходима для нашего веб-сайта. Для установки Flask, по стандартному соглашению, мы создадим файл requirements.txt. Файл requirements.txt не содержит ничего особенного, это просто текстовый файл со списком библиотек, необходимых для нашего приложения. Но это удобное и широко распространенное в среде разработчиков соглашение, которое упрощает управление приложениями с большим числом библиотек в качестве зависимостей.
Для предстоящих упражнений нам потребуется несколько дополнительных библиотек, включая requests (для вызова службы "Переводчик") и python-dotenv (для управления ключами). Прямо сейчас они нам не нужны, но для упрощения процесса мы установим их сразу.
В командной строке или в окне терминала выполните следующую команду, чтобы открыть наш каталог проекта в Visual Studio Code:
code .В Visual Studio Code в окне обозревателя щелкните Создать файл рядом с каталогом contoso.
Присвойте файлу имя requirements.txt и добавьте следующий текст.
flask python-dotenv requestsСохраните файл, нажав клавиши CTRL+S (или Cmd+S на компьютере Mac).
Вернитесь в окно командной строки или терминала и выполните установку с помощью следующей команды pip:
pip install -r requirements.txt
Эта команда скачивает необходимые библиотеки и все их зависимости.
Примечание.
Если ваша версия pip не является актуальной, может появиться сообщение об ошибке. Следуйте инструкциям из этого сообщения, чтобы выполнить обновление. Для этого модуля обновление не требуется.
Поздравляем! Вы успешно настроили среду для разработки.