Работа с оболочкой

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

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

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

В целом рекомендуется сначала прочитать главу Контекст запроса документации.

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

Начиная с Flask 0.11, рекомендуемым способом работы с оболочкой является команда flask shell, которая выполняет многое из этого автоматически за вас. Например, оболочка автоматически инициализируется с загруженным контекстом приложения.

Дополнительную информацию см. в Командной строке.

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

Самый простой способ создать надлежащий контекст запроса из оболочки — использовать метод test_request_context, который создает нам RequestContext:

>>> ctx = app.test_request_context()

Обычно вы бы использовали инструкцию with, чтобы сделать этот объект запроса активным, но в оболочке проще использовать методы push() и pop() вручную:

>>> ctx.push()

С этого момента вы можете работать с объектом запроса, пока не вызовете pop:

>>> ctx.pop()

Запуск до/после запроса

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

Однако это можно легко сделать самостоятельно. Просто вызовите preprocess_request():

>>> ctx = app.test_request_context()
>>> ctx.push()
>>> app.preprocess_request()

Имейте в виду, что функция preprocess_request() может вернуть объект ответа, в этом случае просто игнорируйте его.

Чтобы завершить запрос, вам нужно немного обмануть перед тем, как функции после запроса (вызванные process_response()) будут работать с объектом ответа:

>>> app.process_response(app.response_class())
<Response 0 bytes [200 OK]>
>>> ctx.pop()

Функции, зарегистрированные как teardown_request(), автоматически вызываются при извлечении контекста. Поэтому это идеальное место для автоматического разбора ресурсов, которые потребовались для контекста запроса (таких как подключения к базе данных).

Дополнительное улучшение опыта работы с оболочкой

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

Просто поместите их в модуль (например, shelltools) и импортируйте оттуда:

>>> from shelltools import *