Flask 'Hello World'

Installez Python 3.8 ou une version plus récente, puis confirmez avec :

python --version

Besoin de Python ? Téléchargez-le depuis python.org.

Isolez les dépendances avec un environnement virtuel.

python -m venv .venv

Activez-le :

# macOS/Linux
source .venv/bin/activate

# Windows (Invite de commandes)
.venv\Scripts\activate

Vous verrez (.venv) dans votre invite de commande lorsqu'il est actif.

Avec votre environnement virtuel actif, installez Flask.

pip install Flask

Confirmez l'installation :

pip list | grep -i flask

Créez un fichier nommé app.py avec ce contenu :

from flask import Flask

app = Flask(__name__)

@app.get("/")
def hello():
    return "Hello from Flask!"

@app.get("/hello/")
def hello_name(name: str):
    # Convertisseurs d'URL : string, int, float, path (par défaut c'est string)
    return f"Hello, {name}!"

if __name__ == "__main__":
    # Uniquement pour le développement local
    app.run(host="127.0.0.1", port=5000, debug=True)

Les décorateurs de route mappent les méthodes HTTP aux fonctions Python. Le segment entre chevrons capture un paramètre de chemin.

Démarrez le serveur de développement :

python app.py

Vous devriez voir une sortie indiquant http://127.0.0.1:5000. Le terminal sera bloqué ; arrêtez-le avec Ctrl+C.

Ouvrez votre navigateur :

• http://127.0.0.1:5000/ — “Hello from Flask!”
• http://127.0.0.1:5000/hello/Flask — “Hello, Flask!”

Vous pouvez également utiliser curl :

curl http://127.0.0.1:5000/
curl http://127.0.0.1:5000/hello/World

En développement, debug=True active le rechargement automatique du code et de meilleures traces d'erreurs – très utiles lors de l'itération.

Si vous ne l'avez pas activé plus tôt, modifiez les dernières lignes de app.py :

if __name__ == "__main__":
    app.run(host="127.0.0.1", port=5000, debug=True)

Note : n'utilisez pas le serveur intégré en production. Pour la production, exécutez derrière un véritable serveur WSGI (par exemple, Gunicorn) derrière un proxy inverse (par exemple, Nginx).

Au fur et à mesure que les projets grandissent, une disposition ordonnée aide :

hello-flask/
├─ app/
│  ├─ __init__.py
│  └─ routes.py
├─ requirements.txt
└─ run.py

Exemple app/__init__.py :

from flask import Flask

def create_app():
    app = Flask(__name__)
    from .routes import bp
    app.register_blueprint(bp, url_prefix="/")
    return app

Exemple app/routes.py :

from flask import Blueprint

bp = Blueprint("main", __name__)

@bp.get("/")
def hello():
    return "Hello from Flask!"

@bp.get("/hello/")
def hello_name(name: str):
    return f"Hello, {name}!"

Exemple run.py :

from app import create_app

app = create_app()

if __name__ == "__main__":
    app.run(host="127.0.0.1", port=5000, debug=True)

Geler les dépendances avec pip freeze > requirements.txt.

• Templates : utilisez render_template("index.html", name=name) avec des fichiers Jinja2.
• Fichiers statiques : servez CSS/JS à partir d'un dossier static/.
• Configuration : gardez les secrets hors du code ; utilisez des variables d'environnement.
• Production : exécutez derrière Gunicorn ou uWSGI, derrière un proxy inverse.
• Le serveur de débogage ne se rechargera pas sous Windows avec git-bash + virtualenv – utilisez l'invite de commande ou PowerShell pour y activer le venv.

Vous avez maintenant une application Flask fonctionnelle. À partir de là, vous pouvez ajouter des templates, des formulaires et une structure de projet réelle sans changer l'idée principale.