Vue d'ensemble

Flask-Migrate 3.0, publie le 1er avril 2021, ameliore l'integration avec Alembic et ajoute le support des operations asynchrones.

Fonctionnalites principales

Ameliorations Alembic

Flask-Migrate 3.0 s'aligne sur les dernieres versions d'Alembic avec un meilleur support de l'auto-detection des changements de schema et des migrations par lots.

python 
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 Utilisateur(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    nom = db.Column(db.String(100), nullable=False)
    email = db.Column(db.String(120), unique=True)

# flask db init
# flask db migrate -m 'Ajout table utilisateur'
# flask db upgrade

Support async

Flask-Migrate 3.0 supporte les moteurs de base de donnees asynchrones via SQLAlchemy 1.4+, permettant les migrations sur des bases connectees en async.

python 
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)

# Migration avec render_as_batch pour SQLite
migrate = Migrate(app, db, render_as_batch=True)

# Les migrations par lot permettent de modifier
# les colonnes sur SQLite (qui ne supporte pas ALTER)
# flask db migrate -m 'Modifier colonne'
# flask db upgrade

Sources