Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

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

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

3 Один из наиболее популярных python-микрофреймворков -<a>Flask</a>. В этом уроке познакомимся с ним и узнаем его возможности. Также научимся создавать минимальное Flask-приложение и запускать его с помощью development-сервера. В конце расскажем, как включить режим отладки, чтобы сообщения об ошибках отображались прямо в браузере в удобном для просмотра виде.

4 <h2>Возможности Flask</h2>

5 Микрофреймворк Flask умеет:

6 <ul><li>Разбирать запросы и производить маршрутизацию по адресу, глаголу HTTP, параметрам запроса</li>

7 <li>Формировать ответы на запросы, которые содержат нужные статус, заголовки, cookies, данные в необходимом формате, например: текст, JSON</li>

8 <li>Работать с сессиями</li>

9 <li>Удобно вызывать шаблонизатор для формирования ответа</li>

10 </ul>При этом с помощью Flask нельзя:

11 <ul><li>Работать с данными в базе данных - не содержит встроенной ORM</li>

12 <li>Формировать интерфейс администратора - administrator interface, админка</li>

13 <li>Обрабатывать формы ввода данных и валидацию этих данных</li>

14 </ul>Чтобы добавить эти и другие возможности в приложение, нужно подключить внешние библиотеки. Ознакомиться с полным перечнем библиотек и их возможностями можно на странице<a>pypi.org</a>.

15 <h2>Создание минимального Flask-приложения</h2>

16 Чтобы создать минимальное Flask-приложение, нужно выполнить следующие шаги:

17 <ol><li>Создать новый python-проект в директории hexlet-flask-example и добавить в зависимости Flask</li>

18 <li>Создать в корне директории модуль example.py со следующим содержимым:</li>

19 </ol>Разберем код выше подробнее:

20 <ol><li>Импортируем класс-инициализатор Flask. Его экземпляр и будет нашим WSGI-приложением:

21 </li>

22 <li>Инстанцируем экземпляр, где класс принимает первым аргументом имя модуля нашего приложения __name__. Это нужно, чтобы Flask знал, где искать шаблоны и статические файлы:

23 </li>

24 <li>Используем декоратор route(), который связывает функцию-обработчик с конкретным адресом нашего сайта. Об обработчиках и роутинге поговорим в следующих уроках:

25 </li>

26 <li>Функция-обработчик возвращает ответ, который выведется в браузере:

27 </li>

28 </ol><h2>Запуск с помощью development-сервера</h2>

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

30 Запустим приложение встроенным сервером. Введем в терминале следующие команды:

31 Здесь команда задает модуль, в котором объявлен объект WSGI-приложения и запускает сервер разработчика - developing server. Создадим файлMakefileв корне проекта и добавим туда задачу start:

32 Выполним запуск:

33 Вывод будет таким:

34 Flask предупреждает, что в данный момент запущен сервер разработчика, а в реальных условиях понадобится "промышленный" WSGI-сервер - production WSGI server.

35 Пока мы не остановим сервер нажатием Ctrl+C, в браузере по адресу http://127.0.0.1:8000/ можно будет увидеть текст "Welcome to Flask!".

36 <h2>Режим отладки</h2>

37 Если в приложении случится ошибка, то мы увидим заготовленное сообщение с подобным текстом: "Internal Server Error". Но во время разработки хочется видеть вывод ошибки, и чтобы была возможность не перезапускать руками сервер при каждом изменении кода. И development-сервер это умеет, нужно только включить режим отладки:

38 Изменим тогда и команду вMakefile:

39 Когда мы перезапустим сервер, то вывод будет немного отличаться:

40 Теперь включен режим отладки - "Debugger is active!". С включенным отладчиком сообщения об ошибках будут отображаться прямо в браузере в удобном для просмотра виде. Про встроенный во Flask отладчик Werkzeug расскажем подробнее позднее.

41 Также теперь все изменения в коде будут автоматически перезапускать сервер. Например, попробуйте изменить выводимый текст на ‘Hello, Hexlet!’. Как только вы сохраните код, сервер перезагрузится, и вы увидите в браузере новое сообщение.

42 <h2>Вывод</h2>

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