Flask: микрофреймворк для веб-разработки на Python

Генерация URL с помощью url_for

Функция url_for создаёт URL по имени функции-обработчика. Это удобно для рефакторинга маршрутов.

from flask import Flask, url_for

app = Flask(__name__)

@app.route('/profile/<int:user_id>')
def profile(user_id):
    return f'User {user_id}'

with app.test_request_context():
    print(url_for('profile', user_id=1))
    print(url_for('profile', user_id=42))

/profile/1
/profile/42

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

Использование g для хранения данных между запросами

Объект g (global) живёт только во время одного запроса. Подходит для загрузки текущего пользователя, соединения с БД и т.д.

from flask import Flask, g, session

app = Flask(__name__)
app.secret_key = 'mysecret'

@app.before_request
def load_user():
    g.user = None
    if 'user_id' in session:
        g.user = User.query.get(session['user_id'])  # гипотетическая модель

@app.route('/dashboard')
def dashboard():
    if g.user is None:
        return 'Необходима авторизация', 401
    return f'Добро пожаловать, {g.user.username}'

Важно: g не может храниться между разными запросами (в отличие от сессии). Не помещайте туда большие объекты.

При открытии /dashboard без сессии: "Необходима авторизация" с кодом 401.

Собственный декоратор для проверки прав (admin_required)

Декоратор позволяет защитить маршруты от неавторизованных пользователей, инкапсулируя логику проверки.

from functools import wraps
from flask import abort, g

def admin_required(f):
    @wraps(f)
    def decorated_function(*args, **kwargs):
        if not g.user or not g.user.is_admin:
            abort(403)
        return f(*args, **kwargs)
    return decorated_function

@app.route('/admin')
@admin_required
def admin_panel():
    return 'Административная панель'

При попытке доступа не-администратора будет возвращена страница 403 Forbidden. Можно настроить кастомный обработчик ошибок.

Для пользователя без прав: ответ с кодом 403.

Кастомный обработчик ошибок, возвращающий JSON (для API)

Если ваше приложение предоставляет REST API, удобно возвращать JSON вместо HTML при ошибках.

@app.errorhandler(404)
def not_found_json(e):
    return {'error': 'Not found', 'status': 404}, 404

@app.errorhandler(403)
def forbidden_json(e):
    return {'error': 'Forbidden', 'status': 403}, 403

Теперь при 404 или 403 возвращается JSON-объект. Не забудьте установить заголовок Content-Type: application/json (Flask делает это автоматически, если вернуть dict).

При запросе к несуществующему ресурсу:
{"error": "Not found", "status": 404}

Использование Flask-Migrate для миграций базы данных

Flask-Migrate интегрирует Alembic для управления изменениями схемы. Позволяет отслеживать изменения моделей и применять их без потери данных.

# Установка: pip install flask-migrate

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///app.db'
db = SQLAlchemy(app)
migrate = Migrate(app, db)

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(50))

Команды терминала:

export FLASK_APP=app.py  # или set FLASK_APP=app.py на Windows
flask db init
flask db migrate -m "Создание таблицы User"
flask db upgrade

После изменений в моделях снова выполните flask db migrate и flask db upgrade.

В результате появляется папка migrations с историей изменений. База данных обновляется до последней версии.