first commit

db/__init__.py

@@ -0,0 +1,64 @@
+"""
+db — toute la logique base de données du moteur Forge, organisée en un
+sous-module par responsabilité (un fichier = une fonction, un dossier = un
+domaine) plutôt qu'un seul gros fichier. Ce fichier réexporte l'intégralité
+de l'API publique historique : le reste du moteur continue simplement
+d'écrire `import db` puis `db.ma_fonction(...)`, sans rien savoir de cette
+organisation interne.
+
+Chaque JEU créé a SA PROPRE base SQLite (fichier .db dans son dossier de
+projet). Cette base contient :
+  - des tables "méta" (_definitions, _fields) qui décrivent les objets que
+    l'utilisateur a définis via l'interface (l'équivalent d'un schéma de
+    base de données, mais construit à la souris plutôt qu'en SQL) ;
+  - une VRAIE table SQL par objet défini (obj_<nom>), avec des colonnes du
+    bon type SQLite selon le type choisi pour chaque champ, y compris des
+    colonnes de clé étrangère pour les champs de type "relation".
+
+Rien n'est une simulation : créer une "définition d'objet" avec des champs
+exécute un vrai CREATE TABLE, et remplir le formulaire généré exécute un
+vrai INSERT dans cette table.
+"""
+
+from .constants import PROJECTS_DIR, FIELD_TYPES
+from .slugify import slugify
+from .table_name_for import table_name_for
+from .game_dir import game_dir
+from .db_path import db_path
+from .connection import connect
+
+from .games.list_games import list_games
+from .games.game_meta import game_meta
+from .games.create_game import create_game
+from .games.update_game_name import update_game_name
+from .games.delete_game import delete_game
+
+from .definitions.list_definitions import list_definitions
+from .definitions.get_definition import get_definition
+from .definitions.create_definition import create_definition
+from .definitions.rename_definition import rename_definition
+from .definitions.definitions_referencing import definitions_referencing
+from .definitions.add_field_to_definition import add_field_to_definition
+from .definitions.update_field import update_field
+from .definitions.delete_field import delete_field
+from .definitions.delete_definition import delete_definition
+
+from .rows.list_rows import list_rows
+from .rows.relation_options import relation_options
+from .rows.insert_row import insert_row
+from .rows.get_row import get_row
+from .rows.update_row import update_row
+from .rows.update_row_field import update_row_field
+from .rows.delete_row import delete_row
+from .rows.rows_referencing import rows_referencing
+
+__all__ = [
+    "PROJECTS_DIR", "FIELD_TYPES",
+    "slugify", "table_name_for", "game_dir", "db_path", "connect",
+    "list_games", "game_meta", "create_game", "update_game_name", "delete_game",
+    "list_definitions", "get_definition", "create_definition", "rename_definition",
+    "definitions_referencing", "add_field_to_definition", "update_field", "delete_field",
+    "delete_definition",
+    "list_rows", "relation_options", "insert_row", "get_row", "update_row",
+    "update_row_field", "delete_row", "rows_referencing",
+]