Distribution EOLE » Commun » eole-flask

Développement à partir du squelette eoleflask:

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

Lancer l'application:¶

• créer un fichier 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

Développement de l'application:¶

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

  
          src/
          |-- monappli
          |   |-- __init__.py
          |   |-- static
          |   |   `-- index.html
          |   `-- views.py
          `-- monappli.conf
  
  

• 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/

Intégration dans une machine de test:¶

-- A revoir/Étoffer

• installer les paquets python-eoleflask et eole-flask-server
• installer votre application avec un make install
• activer votre application avec: /usr/share/eole/sbin/eflkctl enable monappli
• relancer le serveur avec /etc/init.d/eoleflask restart
• l'application est disponible à l'adresse http://[ip_machine_de_test]:7000/monappli

-- Fin de A revoir/Étoffer

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.