====== Setup Nouveau Projet ======

===== Création d'un projet =====

Créer un nouveau dossier pour le projet "**hello_world**" :

<code bash>
mkdir /home/marc/hello_world
cd /home/marc/hello_world
</code>

Création d'un Virtual Environment :

<code bash>
python3 -m venv venv
source venv/bin/activate
</code>

Mise à jour de PIP :

<code bash>
pip install --upgrade pip
</code>

Intallation des packages :

<code>
pip install flask
pip install python-dotenv
</code>

Vérifier la version :

<code>
flask --version

  Python 3.10.6
  Flask 2.2.2
  Werkzeug 2.2.2
</code>

===== Application de base =====

<code>
/home/marc/hello_world
├── app
│   ├── static
│   │   ├── css
│   │   ├── js
│   │   ├── img
│   │   └── ...
│   ├── templates
│   │   ├── index.html
│   │   └── ...
│   ├── __init__.py
│   └── ...
├── venv
│   └── ...
├── .env
├── .gitignore
└── requirements.txt
</code>

Définir les variables d'environnement (fichier **.env**) :

<code bash .env>
FLASK_APP   = app
FLASK_DEBUG = 1
</code>

Créer un fichier **.gitignore** selon la page [[divers:git:gitignore_python|]]

Y ajouter le fichier **config.py** et les dossiers de données à ne pas commiter :

<code text .gitignore>
...

data/
.vscode/
config.py
</code>

Générer le fichier **requirements.txt** de PIP :

<code bash>
pip freeze > requirements.txt
</code>

Créer un fichier **%%__init__.py%%** minimal :

<code python app/__init__.py>
from flask import Flask

app = Flask(__name__)

@app.route("/")
def home():
    return "<h1>Hello World !</h1>"
</code>

===== GIT =====

Initialiser le dépôt **git** local et faire un premier commit :

<code bash>
git init
git add --all
git commit -m "Initial commit"
</code>

Créer le dépôt distant selon la page [[divers:git:depots_sur_serveur_prive]]

===== Configuration de l'application =====

Exemple de fichier **config.py** :

<code python>
import os

SECRET_KEY    = "... clé secrète ... voir ci-dessous ..."

BASE_DIR      = os.path.abspath(os.path.dirname(__file__))

PATH_IMAGES   = os.path.join(BASE_DIR, 'images/')
PATH_DATABASE = os.path.join(BASE_DIR, 'data/')
</code>

Pour générer la clé secrète, voir la page [[python:generer_secret_key]]

Chargement des valeurs dans l'objet **app** :

<code python>
app = Flask(__name__)
app.config.from_object('config')
</code>

===== Lancement du serveur de développement =====

Activer l'environnement virtuel si ce n'est pas encore fait.

<code bash>
source venv/bin/activate
</code>

Lancement du serveur :

<code bash>
flask run
</code>

Visiter le site (sur le port défini dans **.env**) :

[[http://127.0.0.1:5000/]]

Pour qu'il soit accessible depuis une autre machine sur le réseau, ajouter :

<code bash>
flask run --host=0.0.0.0
</code>