Votre projet

Avez-vous bien suivi la partie Installation pour créer un environnement virtuel Python et installer Flask pour votre projet? Sinon, retournez-y!

Vérifiez que votre environnement est bien activé en lisant l'invite de commande. Si tout a bien fonctionné, elle devrait mentionner le nom de votre environnement virtuel, venv par défaut.

Ce tutoriel suppose que vous travaillez depuis un répertoire dénommé base-project. Les noms de fichiers spécifiés au-dessus de chaque bloc de code sont relatifs à ce répertoire.

Une application Flask peut être aussi petite qu’un seul fichier.

hello.py
from flask import Flask

app = Flask(__name__)


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

Cependant, lorsque le projet grandit, il devient plus difficile de garder l’ensemble du code dans un seul fichier. Les projets Python utilisent la notion de package pour organiser le code en différents modules qui peuvent être importés où ils sont nécessaires. Ce tutoriel fera de même. Néanmoins l'accent sera mis sur la simplicité pour faciliter la compréhension. L'architecture d'une application Flask "réel" est en pratique plus complexe.

Le répertoire du projet contiendra:

  • mobility/, un package Python contenant le code de votre application et les fichiers associés.

  • test/, un répertoire contenant les modules de test, qui seront vus plus tard.

  • venv/, un environnement virtuel Python où Flask et d’autres dépendances sont installés.

  • Des fichiers d’installation qui indiquent à Python comment installer votre projet (requirements.txt).

  • La configuration de votre système de contrôle de version tel que git. Vous devriez prendre l’habitude d’utiliser un système de contrôle de version pour tous vos projets, quelle que soit leur taille.

  • D’autres fichiers liés au projet que vous pourriez ajouter par après.

A la fin, votre répertoire de projet devrait ressembler à:

base-project-2025/
├── mobility
│   ├── airport.py
│   ├── db.py
│   ├── __init__.py
│   ├── models
│   │   ├── airport.py
│   │   └── __init__.py
│   ├── static
│   │   └── style.css
│   ├── templates
│   │   ├── about.html
│   │   ├── airport.html
│   │   └── base.html
│   └── tests
│       ├── __init__.py
│       ├── schema_test.sql
│       └── test_example.py
├── README.md
├── requirements.txt
└── venv

Pour le projet, vous devrez utiliser un outil de contrôle de version : git. Il existe des fichiers qui sont générés durant l’exécution de votre projet qui doivent être ignorés, voir l’exemple ci-dessous. Nous vous conseillons de ne pas les mettre sur votre git pour éviter les problèmes entre membres du groupe. Pour ce faire, vous allez créer un fichier .gitignore. Il peut y avoir d’autres fichiers en fonction de l’éditeur de textes que vous utilisez. En général, ignorez les fichiers que vous n’avez pas écrits vous-même. Par exemple, pour notre projet cela donne:

.gitignore

venv/

*.pyc
__pycache__/

instance/

.pytest_cache/
.coverage
htmlcov/

dist/
build/
*.egg-info/

Continuez en lisant le document configuration de l’application.