Приложения большой сложности как пакеты

Простые пакеты

Чтобы преобразовать его в более крупный, просто создайте новую папку yourapplication внутри существующей и перенесите все в неё. Затем переименуйте yourapplication.py в __init__.py. (Убедитесь, что сначала удалены все .pyc файлы, иначе, скорее всего, возникнут проблемы)

В результате у вас должно получиться что-то вроде этого:

/yourapplication
    /yourapplication
        __init__.py
        /static
            style.css
        /templates
            layout.html
            index.html
            login.html
            ...

Но как теперь запустить ваше приложение? Примитивное python yourapplication/__init__.py не сработает. Скажем, Python не хочет, чтобы модули в пакетах были файлом запуска. Но это не большая проблема, просто добавьте новый файл, названный setup.py рядом с внутренней папкой yourapplication со следующим содержимым:

from setuptools import setup

setup(
    name='yourapplication',
    packages=['yourapplication'],
    include_package_data=True,
    install_requires=[
        'flask',
    ],
)

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

$ export FLASK_APP=yourapplication

$ set -x FLASK_APP yourapplication

> set FLASK_APP=yourapplication

> $env:FLASK_APP = "yourapplication"

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

$ export FLASK_ENV=development

$ set -x FLASK_ENV development

> set FLASK_ENV=development

> $env:FLASK_ENV = "development"

Для установки и запуска приложения необходимо выполнить следующие команды:

$ pip install -e .
$ flask run

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

1. Создание объекта приложения Flask должно выполняться в файле __init__.py. Таким образом, каждый модуль может безопасно его импортировать, и переменная __name__ будет соответствовать правильному пакету.
2. Все функции представления (те, которые имеют декоратор route() вверху) должны импортироваться в файле __init__.py. Не сам объект, а модуль, в котором он находится. Импортируйте модуль представлений после создания объекта приложения.

Вот пример __init__.py:

from flask import Flask
app = Flask(__name__)

import yourapplication.views

И вот как views.py будет выглядеть:

from yourapplication import app

@app.route('/')
def index():
    return 'Hello World!'

В итоге у вас должно получиться что-то вроде этого:

/yourapplication
    setup.py
    /yourapplication
        __init__.py
        views.py
        /static
            style.css
        /templates
            layout.html
            index.html
            login.html
            ...

Работа с Blueprints

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