| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| dev:python:flask:architecture_projet_flask [2025/08/07 07:54] – yoann | dev:python:flask:architecture_projet_flask [2026/04/05 08:09] (Version actuelle) – yoann |
|---|
| |
| |
| ====== Flask ====== | |
| |
| | ====== Flask ====== |
| |
| | :TODO_DOCUPDATE: |
| |
| Flask n'impose aucune arborescence, selon les besoins on peut opter pour une application monolithique ou le découpage en packages et modules. | Flask n'impose aucune arborescence, selon les besoins on peut opter pour une application monolithique ou modulaire. |
| |
| ===== Application monolithique ===== | ===== Application monolithique ===== |
| |
| Pour les petit projets, les tests ou les tutoriaux, on utilise généralement un simple module Python et l' instanciation d'un objet Flask. Cette approche monolithique permet de coder rapidement une preuve de concept, un prototype par exemple. | Pour les petit projets, les tests ou les tutoriaux, on utilise généralement un simple module Python qui se charge d' instancier directement l'objet Flask. Cette approche monolithique permet de coder rapidement une preuve de concept (PoC), un prototype par exemple. |
| |
| |
| |
| ===== Application distribuée ===== | ===== Application modulaire ===== |
| |
| Lorsque les projets grossissent ou pour pouvoir travailler en équipe, le découpage en packages et modules et l'utilisation des standards et des recommandations s'imposent. Un version monolithique deviendrait difficilement maintenable. | Lorsque les projets grossissent ou pour pouvoir travailler en équipe, le découpage en packages et modules Python et l'utilisation de standards et de recommandations s'imposent. Un version monolithique deviendrait difficilement maintenable. |
| | |
| | Le framework Flask propose le système de [[dev:python:flask:blueprints|Blueprint]] pour structurer le code en unités fonctionnelles selon ses besoins. |
| |
| <code> | <code> |
| |
| |
| ===== La fonction "Factory" ===== | ===== Démarrage de l'application Flask ===== |
| |
| Pour pouvoir lancer automatiquement une application Flask : | Pour pouvoir lancer automatiquement une application Flask : |
| * On place les fichiers de l'application dans un paquetage ; | * On place les fichiers de l'application dans un paquetage Python; |
| * Le fichier ''__init__.py'' contient soit l'instanciation d'un objet de type Flask, soit une fonction retournant cet objet. Cette fonction est désignée **factory** par défaut flask s'attend à ce qu'elle soit appelée ''create_app''. | * Le fichier dunder init ''%%__init__.py%%'' contient : |
| | * Soit l'instanciation d'un objet de type Flask ; |
| | * Soit une fonction retournant cet objet. Cette fonction est désignée **application factory**. Par défaut flask s'attend à ce qu'elle soit appelée ''create_app''. |
| |
| Dans ce cas on peut lancer l'application avec la commande : | Dans ce cas on peut lancer l'application avec la commande : |
| |
| # Si la fonction factory a un autre nom que create_app utiliser la syntaxe package:factory_function | # Si la fonction factory a un autre nom que create_app utiliser la syntaxe package:factory_function |
| flask --app aAppPackage:another_factory_name run --debug | flask --debug --app aAppPackage:another_factory_name run |
| | |
| | # On peut également spécifier des arguments |
| | flask --debug --app 'app:create_app(context="development")' run |
| </code> | </code> |
| |
| | Voir également la note [[dev:python:flask:demarrer_application|démarrer l'application Flask depuis la ligne de commande]]. |
| |
| ===== Références ===== | ===== Références ===== |
| |
| | * [[https://flask.palletsprojects.com/en/stable/patterns/packages/|Concevoir des applications en packages (Documentation Flask)]] |
| * https://stackoverflow.com/questions/53566832/access-app-decorator-in-flask-using-factory-pattern | * https://stackoverflow.com/questions/53566832/access-app-decorator-in-flask-using-factory-pattern |
| * https://realpython.com/flask-project/ | * https://realpython.com/flask-project/ |
| | * [[https://muneebdev.com/flask-project-structure-best-practices/|Bonnes pratiques de structuration des projets Flask (muneebdev.com)]] |
| |