Distribution EOLE » Commun » eole-flask

Développement à partir du squelette eoleflask:

h2. Préparation de l'application:

    * installer le paquet *python-eoleflask*

    * cloner le dépot *eole-skeletor*

    * lancer le script: ./bootstrap-eoleflask-app.sh [nom_de_l_appli]

>  Cela prépare les fichiers nécessaires à une application flask pour EOLE  dans le répertoire *src/monappli*:

>  le répertoire du module lui même: *src/monappli*

>  le fichier qui permettra d'activer l'application dans le serveur: *src/monappli.conf*

h2. Lancer l'application:

    * créer un répertoire src/monappli/static/index.html

    * lancer le script ./eoleflask-dev-server.py

    * ouvrir un navigateur à l'adresse http://localhost:8080/

*Attention* : en tant que developpeur, vous ne devez jamais installer le paquet (le .deb) de votre application sur votre machine de test. Si vous faites cela, le serveur de test ./eoleflask-dev-server.py vous présentera les fichiers du paquet et non plus les fichiers de développement. cf http://dev-eole.ac-dijon.fr/issues/5233

h2. Développement de l'application:

    * Tout les fichiers de l'application se trouvent dans le répertoire src/:

<pre>

        src/

        |-- monappli

        |   |-- __init__.py

        |   |-- static

        |   |   `-- index.html

        |   `-- views.py

        `-- monappli.conf

</pre>

* La logique de l'application se trouve dans le fichier *src/monappli/views.py*

* Tous les fichiers statiques se trouvent dans src/monappli/static

* La documentation Flask se trouve la: http://flask.pocoo.org/docs/

*-- A revoir/Étoffer* 

h2. Intégration dans une machine de test:

    * installer les paquets python-eoleflask et eole-flask-server

    * installer votre application avec un make install

    * copier le fichier src/monappli.conf vers /etc/eole/flask/available

    * faire un lien de /etc/eole/flask/available/monappli.conf /etc/eole/flask/enabled/

    * relancer le serveur avec /etc/init.d/eoleflask restart

    * l'application est disponible a l'adresse http://localhost/monappli

*-- Fin de A revoir/Étoffer*

h2. Note sur les fichiers statiques de l'application:

Les fichiers statiques de l'application (javascript, css, html brut) peuvent être rendus par le serveur web directement. Pour cela il faut créer de déplacer le répertoire src/monappli/static vers /usr/share/eole/flask/monappli/static.