Premiers pas avec Flask

Bonjour le monde #

Créez hello.py :

from flask import Flask

app = Flask(__name__)


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

Puis lancez-le avec :

export FLASK_APP=hello.py
flask run
 * Running on http://localhost:5000/

L’ajout du code ci-dessous permettra de l’exécuter directement avec python hello.py.

if __name__ == '__main__':
    app.run()

Installation - Écurie #

Utilisez pip pour installer Flask dans un virtualenv.

pip install flask

Instructions étape par étape pour créer un environnement virtuel pour votre projet :

mkdir project && cd project
python3 -m venv env
# or `virtualenv env` for Python 2
source env/bin/activate
pip install flask

N’utilisez jamais sudo pip install à moins que vous ne compreniez exactement ce que vous faites. Conservez votre projet dans un virtualenv local, n’installez pas Python sur le système à moins que vous n’utilisiez le gestionnaire de packages système.

Installation - Dernière #

Si vous souhaitez utiliser le dernier code, vous pouvez l’installer à partir du référentiel. Bien que vous obteniez potentiellement de nouvelles fonctionnalités et correctifs, seules les versions numérotées sont officiellement prises en charge.

pip install https://github.com/pallets/flask/tarball/master

Installation - Développement #

Si vous souhaitez développer et contribuer au projet Flask, clonez le référentiel et installez le code en mode développement.

git clone ssh://github.com/pallets/flask
cd flask
python3 -m venv env
source env/bin/activate
pip install -e .

Il existe également des dépendances et des outils supplémentaires à connaître.

sphinx

Utilisé pour construire la documentation.

pip install sphinx
cd docs
make html
firefox _build/html/index.html

py.test

Utilisé pour exécuter la suite de tests.

pip install pytest
py.test tests

toxique

Utilisé pour exécuter la suite de tests sur plusieurs versions de Python.

pip install tox
tox

_{Notez que tox n’utilise que des interpréteurs déjà installés, donc si vous n’avez pas installé Python 3.3 sur votre chemin, il ne sera pas testé.}