Учебное пособие по Flask: Привет, мир из фляги

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

Установка Python

Как вы уже догадались, в этой серии статей мы будем писать код на python. Если на вашем компьютере еще не установлен Python, просто установите его. Если в вашей операционной системе нет пакета Python, вы можете загрузить и установить его с официального сайта Python.

Чтобы проверить, установлен ли Python на вашем компьютере, просто откройте терминал и введите команду python3 или просто python. Вот что вы должны увидеть

Интерпретатор Python теперь ожидает интерактивной подсказки, это интерфейс, в котором вы можете вводить операторы Python. В следующих главах мы вместе увидим, для чего используется это интерактивное приглашение. Но на данный момент вы убедились, что Python правильно установлен в вашей системе. Чтобы выйти из интерактивной подсказки, вы можете ввести exit() и нажать Enter. в Windows или нажав Ctrl-D в macOs или Linux.

Что такое Фласк?

Flask — это фреймворк Python, который позволяет быстро и легко создавать веб-приложения. Он разработан, чтобы быть легким, гибким и простым в использовании.
Flask основан на модели запрос-ответ, поэтому на каждый запрос, отправленный на сервер, ответ отправляется обратно клиенту. Flask использует маршруты для связывания URL с функциями, называемыми представлениями, которые будут обрабатывать HTTP-запросы и возвращать соответствующий ответ клиенту.
Flask предлагает большую гибкость с точки зрения настройки и может использоваться с большим количеством библиотек и самых разнообразных баз данных.

Установка колбы

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

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

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

Для начала давайте создадим папку, в которой будет располагаться наш бэкэнд, я назову ее flask_api.

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

С помощью этой команды я прошу python запустить пакет venv, который создаст виртуальную среду с именем venv. Первый venv в команде — это имя пакета, а второй — имя, которое я хочу дать мою виртуальную среду, так что вы можете назвать ее как хотите. Также обратите внимание, что в некоторых операционных системах вам придется использовать команду python3 вместо python.

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

если вы находитесь в Windows, вам просто нужно ввести команду

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

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

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

если вы не получаете никаких ошибок, это означает, что фляга была установлена ​​​​правильно, поздравляем

Привет, мир

Вот как выглядит минимальное фляжное приложение:

. Сначала мы импортируем класс Flask из flask. Экземпляром этого класса будет наше приложение WSGI.

. Затем мы создаем экземпляр класса Flask, который сохраняем в переменной с именем app. Обратите внимание, что аргумент __name__ — это имя модуля или пакета приложения. __name__ — это предопределенная переменная, которая позволяет Flask знать, где искать ресурсы, такие как шаблоны или статические файлы, включая папку шаблона, для возврата html-страниц

. Затем мы используем декоратор @app.route(), чтобы сообщить flask, какой URL-адрес должен активировать нашу функцию, чтобы, когда пользователь делает запрос на этот адрес, функция hello( ) будет выполнен

. Затем у нас есть функция hello(), которая отображает в браузере сообщение «hello world». Обратите внимание, что возвращаемый тип содержимого по умолчанию — HTML, поэтому HTML в строке будет отображаться браузером.

Теперь все, что нам нужно сделать, это запустить наш сервер. Есть два способа запустить сервер flask:
1 либо с помощью команд терминала
2, либо с помощью функции app.run()

1 Для запуска flask с помощью командной строки нам достаточно набрать команду
flask run эта команда запускает наш сервер который доступен по адресу http://127.0.0.1:5000

2 Другой способ — запустить сервер с помощью метода app.run(), как показано в этом коде.

`if __name__ == “__main__”:` – это идиома Python, которая используется для проверки того, выполняется ли скрипт напрямую или импортируется как модуль в другой скрипт. Если скрипт выполняется напрямую, для __name__ будет установлено значение "__main__", и будет выполнен блок кода, следующий за оператором if. В этом случае вызывается app.run(), которая запускает приложение. Если скрипт импортируется как модуль, в качестве имени модуля будет установлено __name__, а блок кода, следующий за оператором if, выполняться не будет.
и для запуска сервера I просто нужно выполнить `python app.py`, но перед этим я выключу сервер с помощью `CTRL+C`.

Теперь откройте свой любимый браузер и перейдите на http://localhost:5000/hello-world, и вы увидите это

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

. Мы вместе увидели, как установить Python

. Почему важно настроить виртуальную среду перед запуском проекта на Python и как ее настроить

. Мы увидели, что такое flask, для чего он используется и как его установить с помощью команды pip install, а также увидели, как настроить сервер flask всего за 5 строк кода.

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