Le framework Flask§

1

Premiers pas en Flask§

2

Hello world§

from flask import Flask

app = Flask(__name__)

@app.route("/")
def root():
    return "Hello world"
3

Explications§

4

Serveur de développement§

5

Serveur de développement§

6

Routes§

Note

Il est possible d'avoir plusieurs paramètres, par exemple /hello/<a>/<b>.

Il est également possible d'imposer un type aux paramètres, par exemple /user/<int:ident>.

Plus d'information dans la documentation.

7

Génération d'URL§

8

Génération d'URL§

9

Génération d'URL§

Exemple d'utilisation :

@app.route("/about")
def about():
    return """<a href="%s">Retour à la page d'accueil</a>""" % \
        url_for('root')

Indice

url_for rend le code plus facile à maintenir : si on décide de changer l'URL d'une vue, il suffit de changer le paramètre de app.route, et toutes les autres vues contenant des liens vers elle s'adapteront automatiquement.

10

Ressources statiques§

11

Où est ma requête ?§

cf. https://flask.palletsprojects.com/en/1.1.x/api/?highlight=request#flask.Request

12

Templates Jinja2§

13

Qu'est-ce qu'un template?§

14

Templates en Flask§

15

Substitution§

16

Structures de contrôle§

{% if elements %}
  <ul>
  {% for e in elements %}
    <li><a href="{{e.link}}">{{e.name}}</li>
  {% endfor %}
  </ul>
{% else %}
  <p>Aucun élément</p>
{% endif %}
17

Héritage§

layout.html:

<!DOCTYPE html><html>
<head><title>Le titre du site</title></head>
<body>
  <h1>Le titre du site</h1>
  {% block content %}{% endblock %}
  <footer>©2017 Université Lyon 1</footer>
</body></html>

hello.html:

{% extends "layout.html" %}
{% block content %}
  <p>Hello {{name}}</p>
{% endblock %}

Note

  • La directive extends permet à un template d'hériter d'un autre.
  • La directive block permet
    • au template parent de définir des zones personalisables, et
    • au template enfant de donner un contenu aux blocs définis par son parent.
18

Formulaires§

19

Routes et méthodes§

20

Récupération des paramètres§

21

Réponses personalisées§

22

Erreur§

Pour déclencher une réponse d'erreur (code HTTP 4xx), on peut utiliser la fonction flask.abort en lui passant le code de statut à retourner (et éventuellement, un message personnalisé).

Exemple :

abort(403, "Cette operation n'est pas autorisee")

Indice

La fonction abort lève une exception (ce qui explique qu'elle ne nécessite pas de return). Cette exception est interceptée par l'application Flask, qui la transforme en réponse HTTP avec le code d'erreur associé.

23

Redirecton§

Pour rediriger le client vers une autre URL (code HTTP 3xx), on peut utiliser la fonction flask.redirect.

Exemple :

return redirect(url_for("root"))
24

Pour aller plus loin§

Lorsqu'une vue retourne une chaîne de caractères (ce que nous avons vu jusqu'à maintenant), l'application Flask génère automatiquement une réponse standard (statut 200, contenu de type HTML).

Il est également possible pour une vue de retourner directement un objet Response, dont on peut alors personnaliser les méta-données. Cet objet peut être produit grâce à la fonction flask.make_response.

Exemple :

resp = make_response(render_template("hello.html", name=n))
resp.headers["Cache-control"] = "max-age=3600"
return resp

Note

La fonction redirect vue ci-avant retourne un objet Response.

25