Сколько литров фляга: Фляга алюминиевая 40 л, 25 л, 20 л

Что-то непроверенное сломано.

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

Flask предоставляет возможность протестировать ваше приложение, выставив Werkzeug протестировать клиента и обработать контекстные локальные для вас. Затем вы можете использовать это с вашим любимым решением для тестирования.

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

Приложение

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

Скелет Испытания

Начнем с добавления каталога тестов в корень приложения. затем создайте файл Python для хранения наших тестов ( test_flaskr.py ). Когда мы отформатируйте имя файла как test _ *. py , оно будет автоматически обнаружено pytest.

Далее мы создаем приспособление pytest под названием client () , который настраивает приложение для тестирования и инициализации новой базы данных:

 импорт ос
импортировать временный файл

импортный тест

из колбы импортная колба


@pytest.приспособление
def client ():
    db_fd, flaskr.app.config ['DATABASE'] = tempfile.mkstemp ()
    flaskr.app.config ['TESTING'] = True

    с flaskr.app.test_client () в качестве клиента:
        с flaskr.app.app_context ():
            flaskr.init_db ()
        доходный клиент

    os.close (db_fd)
    os.unlink (flaskr.app.config [ 'БАЗА ДАННЫХ'])
 

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

Во время настройки активируется флаг конфигурации TESTING . какой это отключает перехват ошибок во время обработки запроса, так что вы получаете лучшие отчеты об ошибках при выполнении тестовых запросов против применение.

Поскольку SQLite3 основан на файловой системе, мы можем легко использовать Модуль tempfile для создания временной базы данных и ее инициализации. Функция mkstemp () делает для нас две вещи: она возвращает низкоуровневый дескриптор файла и случайное имя файла, последнее мы используем как имя базы данных.Нам просто нужно сохранить db_fd , чтобы мы могли использовать функция os.close () для закрытия файла.

Чтобы удалить базу данных после теста, прибор закрывает файл и удаляет это из файловой системы.

Если мы сейчас запустим набор тестов, мы должны увидеть следующий вывод:

 $ pytest

================ начинается тестовая сессия ================
rootdir: ./flask/examples/flaskr, inifile: setup.cfg
собрал 0 предметов

=========== Нет тестов, выполненных в 0.07 секунд ============
 

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

Первый тест

Теперь пришло время начать тестирование функциональности приложения. Давайте проверим, что приложение покажет «Здесь нет записей», если мы получить доступ к корню приложения (/). Для этого добавляем новый Тестовая функция до test_flaskr.пи , вот так:

 def test_empty_db (клиент):
    "" "Начните с пустой базы данных." ""

    rv = client.get ('/')
    утверждать, что пока нет записей в rv.data
 

Обратите внимание, что наши тестовые функции начинаются со слова test ; это позволяет pytest для автоматического определения функции в качестве теста для запуска.

Используя client.get , мы можем отправить HTTP GET запрос на приложение с указанным путем. Возвращаемое значение будет response_class объект.Теперь мы можем использовать данных атрибут для проверки возвращаемое значение (в виде строки) из приложения. В этом случае мы гарантируем, что «Здесь пока нет записей» является частью вывода.

Запустите его снова, и вы должны увидеть один проходной тест:

 $ pytest -v

================ начинается тестовая сессия ================
rootdir: ./flask/examples/flaskr, inifile: setup.cfg
собрал 1 предметов

tests / test_flaskr.py :: test_empty_db PASSED

============= 1 прошло за 0,10 секунды ==============
 

Вход и выход

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

Добавьте следующие две функции в файл test_flaskr.py :

 def login (клиент, имя пользователя, пароль):
    return client.post ('/ login', data = dict (
        имя пользователя = имя пользователя,
        пароль = пароль
    ), follow_redirects = True)


выход из системы (клиент):
    вернуть клиента.get ('/ logout', follow_redirects = True)
 

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

 def test_login_logout (клиент):
    "" "Убедитесь, что вход и выход из системы работают." ""

    rv = логин (клиент, flaskr.app.config ['ИМЯ ПОЛЬЗОВАТЕЛЯ'], flaskr.app.config ['ПАРОЛЬ'])
    assert b'You вошли 'в rv.data

    rv = выход из системы (клиент)
    Assert B'You вышли из системы в rv.data

    rv = логин (клиент, flaskr.app.config ['USERNAME'] + 'x', flaskr.app.config ['PASSWORD'])
    assert b'Invalid username 'в rv.data

    рв = 

Мега-учебник Flask, часть I: Привет, мир!

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

Для справки ниже приведен список статей этой серии.

Примечание 1. Если вы ищете унаследованную версию этого учебника, она здесь.

Примечание 2. Если вы хотите поддержать мою работу над этим блогом или просто не терпите ждать еженедельных статей, я предлагаю полную версию этого учебника, упакованную в виде электронной книги или набора видеороликов. Для получения дополнительной информации посетите курсы.miguelgrinberg.com.

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

В начале каждой главы я собираюсь дать вам три ссылки на GitHub, которые могут быть полезны при работе с этой главой. Ссылка Обзор откроет GitHub-репозиторий для Microblog в том месте, где были добавлены изменения для главы, которую вы читаете, без учета каких-либо изменений, внесенных в будущие главы.Ссылка Zip — это ссылка для скачивания zip-файла, включающая все приложение, включая изменения в этой главе. Ссылка Diff откроет графическое представление всех изменений, которые были сделаны в главе, которую вы собираетесь прочитать.

Ссылки на GitHub для этой главы: Browse, Zip, Diff.

Установка Python

Если у вас не установлен Python на вашем компьютере, продолжайте и установите его сейчас. Если ваша операционная система не предоставляет вам пакет Python, вы можете загрузить установщик с официального сайта Python.Если вы используете Microsoft Windows вместе с WSL или Cygwin, обратите внимание, что вы будете использовать не собственную версию Python для Windows, а дружественную для Unix версию, которую вам нужно получить из Ubuntu (если вы используете WSL) или из Cygwin.

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

  $ python3
Python 3.5.2 (по умолчанию, 17 ноября 2016 г., 17:05:23)
[GCC 5.4.0 20160609] на Linux
Введите «помощь», «авторское право», «кредиты» или «лицензия» для получения дополнительной информации.
>>> _
  

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

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

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

В Python такие пакеты, как Flask, доступны в общедоступном репозитории, откуда каждый может их скачать и установить. Официальный репозиторий пакетов Python называется PyPI, что означает индекс пакетов Python (некоторые люди также называют этот репозиторий «магазином сыра»).Установить пакет из PyPI очень просто, потому что Python поставляется с инструментом под названием pip , который выполняет эту работу (в Python 2.7 pip не поставляется в комплекте с Python и должен быть установлен отдельно).

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

  $ pip install <имя-пакета>
  

Интересно, что этот метод установки пакетов не будет работать в большинстве случаев. Если ваш интерпретатор Python был установлен глобально для всех пользователей вашего компьютера, скорее всего, ваша обычная учетная запись не будет иметь разрешения на ее изменение, поэтому единственный способ заставить вышеуказанную команду работать — это запустить ее у администратора учетная запись.Но даже без этого, подумайте, что происходит при установке пакета, как описано выше. Инструмент pip собирается загрузить пакет из PyPI, а затем добавить его в установку Python. С этого момента каждый скрипт Python, который у вас есть в вашей системе, будет иметь доступ к этому пакету. Представьте себе ситуацию, когда вы завершили веб-приложение, используя версию Flask 0.11, которая была самой последней версией Flask при запуске, но теперь была заменена версией 0.12. Теперь вы хотите запустить второе приложение, для которого вы хотите использовать версию 0.12, но если вы замените установленную версию 0.11, вы рискуете сломать старое приложение. Ты видишь проблему? Было бы идеально, если бы можно было установить Flask 0.11 для использования в вашем старом приложении, а также установить Flask 0.12 для вашего нового.

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

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

  $ микроблог mkdir
$ cd микроблог
  

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

  $ python3 -m venv venv
  

С помощью этой команды я прошу Python запустить пакет venv , который создает виртуальную среду с именем venv .Первый venv в команде — это имя пакета виртуальной среды Python, а второе — имя виртуальной среды, которое я собираюсь использовать для этой конкретной среды. Если вас это смущает, вы можете заменить второй venv другим именем, которое вы хотите присвоить своей виртуальной среде. В общем, я создаю свои виртуальные среды с именем venv в каталоге проекта, поэтому, когда я вхожу в проект cd , я нахожу соответствующую виртуальную среду.

Обратите внимание, что в некоторых операционных системах вам может потребоваться использовать python вместо python3 в приведенной выше команде. Некоторые установки используют python для выпусков Python 2.x и python3 для выпусков 3.x, в то время как другие отображают python на выпуски 3.x.

После завершения команды у вас будет каталог с именем venv , в котором хранятся файлы виртуальной среды.

Если вы используете любую версию Python старше 3.4 (включая выпуск 2.7), виртуальные среды изначально не поддерживаются. Для этих версий Python вам нужно скачать и установить сторонний инструмент под названием virtualenv, прежде чем вы сможете создавать виртуальные среды. После установки virtualenv вы можете создать виртуальную среду с помощью следующей команды:

  $ virtualenv venv
  

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

  $ источник venv / bin / activ
(venv) $ _
  

Если вы используете окно командной строки Microsoft Windows, команда активации немного отличается:

  $ venv \ Скрипты \ активировать
(venv) $ _
  

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

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

  (venv) $ pip установить колбу
  

Если вы хотите подтвердить, что в вашей виртуальной среде уже установлен Flask, вы можете запустить интерпретатор Python и импортировать в него Flask:

  >>> колба импортная
>>> _
  

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

Приложение для флаконов «Hello, World»

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

Приложение будет существовать в пакете . В Python подкаталог, содержащий файл __init__.py , считается пакетом и может быть импортирован.Когда вы импортируете пакет, __init__.py выполняется и определяет, какие символы пакет предоставляет внешнему миру.

Давайте создадим пакет app , в котором будет размещено приложение. Убедитесь, что вы находитесь в каталоге microblog , а затем выполните следующую команду:

  (venv) $ mkdir app
  

__init__.py для пакета app будет содержать следующий код:

app / __ init__.py : экземпляр приложения Flask

  из колбы импортной Колба

app = Flask (__name__)

из маршрутов импорта приложений
  

Приведенный выше скрипт просто создает объект приложения в качестве экземпляра класса Flask , импортированного из пакета фляги. Переменная __name__ , переданная в класс Flask , является предопределенной переменной Python, для которой задано имя модуля, в котором она используется. Flask использует местоположение модуля, переданного здесь, в качестве отправной точки, когда ему нужно загрузить связанные ресурсы, такие как файлы шаблонов, о которых я расскажу в главе 2.Для практических целей передача __name__ почти всегда собирается правильно настроить Flask. Затем приложение импортирует модуль маршруты , который еще не существует.

Поначалу один аспект может показаться запутанным: существуют две сущности с именем и приложение . Пакет app определен каталогом приложения и сценарием __init__.py , и на него ссылается из оператора маршрутов импорта приложения .Переменная app определена как экземпляр класса Flask в сценарии __init__.py , что делает ее членом пакета app .

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

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

Вот ваша первая функция просмотра, которую вам нужно написать в новом модуле с именем app / rout.py :

приложение / маршруты.py : домашняя страница маршрута

  из приложения импорта приложений

@ App.route ( '/')
@ App.route ( '/ индекс')
def index ():
    вернуть "Привет, мир!"
  

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

Чтобы завершить приложение, вам необходим скрипт Python на верхнем уровне, который определяет экземпляр приложения Flask. Давайте назовем этот скрипт microblog.py и определим его как одну строку, которая импортирует экземпляр приложения:

microblog.py : основной прикладной модуль

  из приложения импорта приложений
  

Помните два приложения сущностей? Здесь вы можете увидеть оба вместе в одном предложении. Экземпляр приложения Flask называется app и входит в пакет app .Оператор из приложения app app импортирует переменную приложения , которая является членом пакета app . Если вас это смущает, вы можете переименовать пакет или переменную в другое.

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

  микроблогов /
  venv /
  приложение/
    __init__.py
    routes.py
  microblog.py
  

Хотите верьте, хотите нет, но первая версия приложения готова! Однако перед запуском Flask необходимо указать, как его импортировать, установив переменную среды FLASK_APP :

  (venv) $ export FLASK_APP = микроблог.ру
  

Если вы используете Microsoft Windows, используйте set вместо export в приведенной выше команде.

Готовы ли вы сдуться? Вы можете запустить свое первое веб-приложение с помощью следующей команды:

  (venv) $ пробег колбы
 * Сервировочная колба с приложением "Микроблог"
 * Работает на http://127.0.0.1:5000/ (нажмите CTRL + C, чтобы выйти)
  

После инициализации сервера он будет ожидать клиентских подключений. Выходные данные от пробного фляги указывают, что сервер работает на IP-адресе 127.0.0.1, который всегда является адресом вашего собственного компьютера. Этот адрес настолько распространен, что также имеет более простое имя, которое вы, возможно, видели раньше: localhost . Сетевые серверы прослушивают соединения по определенному номеру порта. Приложения, развернутые на рабочих веб-серверах, обычно прослушивают порт 443 или иногда 80, если они не поддерживают шифрование, но для доступа к этим портам требуются права администратора. Поскольку это приложение работает в среде разработки, Flask использует свободно доступный порт 5000.Теперь откройте веб-браузер и введите следующий адрес в поле адреса:

  http: // localhost: 5000 /
  

В качестве альтернативы вы можете использовать этот другой URL:

  http: // localhost: 5000 / index
  

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

Когда вы закончите играть с сервером, вы можете просто нажать Ctrl-C, чтобы остановить его.

Поздравляем, вы сделали первый большой шаг, чтобы стать веб-разработчиком!

Прежде чем закончить эту главу, я хочу упомянуть еще одну вещь. Поскольку переменные окружения не запоминаются во время сеансов терминала, вам может показаться утомительным постоянно устанавливать переменную окружения FLASK_APP при открытии нового окна терминала.Начиная с версии 1.0, Flask позволяет регистрировать переменные среды, которые вы хотите автоматически импортировать при запуске команды flask . Чтобы использовать эту опцию, вы должны установить пакет python-dotenv :

  (venv) $ pip install python-dotenv
  

Затем вы можете просто написать имя и значение переменной среды в файле .flaskenv в каталоге верхнего уровня проекта:

.flaskenv : переменные среды для команды

  FLASK_APP = микроблог.ру
  

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