====== Installation et Configuration ======

<code bash>
pip install flask-sqlalchemy
</code>

===== Configuration =====

Ajouter les valeurs suivantes à l'objet **config** de l'application :

^ SQLALCHEMY_DATABASE_URI | URL de la base de données (voir formats ci-dessous) |
^ SQLALCHEMY_TRACK_MODIFICATIONS | Mettre à False, sauf si on utilise les signaux |

==== SQLITE ====

Format pour l'**URL** de connexion :

^ SQLite (Linux, macOS) | <nowiki>sqlite:////absolute/path/to/database</nowiki>             |
^ SQLite (Windows)      | <nowiki>sqlite:///c:/absolute/path/to/database</nowiki>           |

Ajouter à **config.py** les lignes suivantes :

<code python config.py>
DB_PATH                        = os.path.join(DATA_PATH, 'db.sqlite')
SQLALCHEMY_DATABASE_URI        = 'sqlite:///' + DB_PATH
SQLALCHEMY_TRACK_MODIFICATIONS = False
</code>

==== MYSQL/MARIADB ====

Source: [[https://stackoverflow.com/questions/53024891/modulenotfounderror-no-module-named-mysqldb]]

Installer le connecteur :

<code bash>
pip install pymysql
</code>

Format pour l'**URL** de connexion :

^ MySQL | <nowiki>mysql+pymysql://username:password@hostname/database</nowiki>      |

Ajouter à **config.py** les lignes suivantes :

<code python config.py>
DB_HOST                 = 'localhost'
DB_NAME                 = 'exemple'
DB_USER                 = 'toto'
DB_PASSWORD             = 'my-password-is-beautiful'
SQLALCHEMY_DATABASE_URI = "mysql+pymysql://%s:%s@%s/%s" % (DB_USER, DB_PASSWORD, DB_HOST, DB_NAME)

SQLALCHEMY_TRACK_MODIFICATIONS = False
</code>

==== POSTGRESQL ====

Format pour l'**URL** de connexion :

^ Postgres              | <nowiki>postgresql://username:password@hostname/database</nowiki> |

//...(à suivre)...//