Merge classe into main (#21)

Epithumia · FredZinelli · FredZin · web-flow · commit d9e4d21537ff · 2025-10-28T14:40:32.000+01:00
* Make a class for SQLIDE * Reformat * Convertir les sqlide en classes JS (#19) * Dev - Add /js and /css to mkdocs watch directories * FIX - Unsilence errors during `load(...)` (which was a pain...) * Update SQLIDE class (renaming to SqlIde on the way) * misc * CHANGE - make `base` and `init` arguments work together. * Reorganize `Counter.build_sql` so that the branches match the execution order in the JS layer. * Update docs with the new specs * Add dev tests (deactivated by default) * Suppress one `then` * FIX - CSS - Gutters kine numbers were going over the top menu header. * ADD - Light/dark themes for the docs * ADD - Hack to soften the background colors of sqlides in dark mode, without changing anything on CodeMirror side. * ADD - Result tables are now sortable (hidden buttons) --------- Co-authored-by: Frédéric Zinelli <frederic.zinelli@gmail.com> * Bump version, màj notes de version --------- Co-authored-by: FredZinelli <145555278+FredZinelli@users.noreply.github.com> Co-authored-by: Frédéric Zinelli <frederic.zinelli@gmail.com>
diff --git a/docs/essai/base_init.md b/docs/essai/base_init.md
@@ -0,0 +1,20 @@
+## Vérifie que l'utilisation des arguments base et init ensemble fonctionne
+
+le code de init ajoute 3 entrées aux 3 venant de tests.db :
+
+```sql
+{{ sqlide(
+    titre="base + init",
+    base="bases/test.db",
+    init="init_base.sql",
+    sql="sql/code.sql"
+)}}
+```
+
+
+{{ sqlide(
+    titre="base + init",
+    base="bases/test.db",
+    init="init_base.sql",
+    sql="sql/code.sql"
+)}}
diff --git a/docs/essai/init_base.sql b/docs/essai/init_base.sql
@@ -0,0 +1,5 @@
+-- Ajoute les 3 données suivantes à la base tests.db
+
+INSERT INTO employees VALUES (4,'HOOVER','SALES I',2,'1990-04-02',27000,NULL,3);
+INSERT INTO employees VALUES (5,'LINCOLN','TECH',6,'1994-06-23',22500,1400,4);
+INSERT INTO employees VALUES (6,'GARFIELD','MANAGER',9,'1993-05-01',54000,NULL,4);
diff --git a/docs/notes-de-version.md b/docs/notes-de-version.md
@@ -57,4 +57,52 @@
 
 ### 2.0.0
 
-- Support pour utilisation en tant que macro {{ sqlide(...) }}
+- ADD - Support pour utilisation en tant que macro {{ sqlide(...) }}
+- BREAKING: la syntaxe en cas de présence de mkdocs-macros-plugin change complètement. Cf. la documentation pour les changements à faire
+- FIX - Compatibilité accrue avec PMT (merci @FredZinelli)
+- CHANGE - Passage de SQL.js à la version 1.13.0
+
+### 2.0.1
+
+- FIX - les sqlides dans les admonitions repliées ??? n'étaient pas rendues correctement quand le sqlide était créés via les macros.
+- FIX - les pages mélangeant les deux types de syntaxes (macros + ancienne syntaxes) pouvaient se retrouver avec des IDE non fonctionnels car les worker des espaces communs étaient insérés lors de la première insertions d'un "espace" sql, mais l'ordre des générations de code pouvait ne pas suivre l'ordre de lecture dans la page : toutes les macros d'abord, puis une seconde passe est faite pour les anciennes syntaxes.
+
+- CHANGE - Changement de signature pour la macro, pour pouvoir utiliser qqes arguments positionnels, pour alléger les déclarations.
+- CHANGE - Les macros insèrent maintenant un token dans la page, qui sera remplacé par du code html durant on_page_content (évite les problèmes de conversion md -> html de mkdocs -> FIX 1)
+- CHANGE - Les workerinit sont ajoutés via on_page_context, juste sous les scripts et le css liés au sql du plugin, pour garantir qu'ils seront toujours dispo avant les sqlide de la page (FIX 2).
+- CHANGE - Ajout de quelques commentaires ici et là dans le code, car la logique devient plus complexe...
+
+- DOCS - Arguments de la macro
+- DOCS - Ajout d'explication pour hide et autoexec
+- DOCS - Exemple alternatif (arguments positionnels)
+
+### 2.0.2
+
+- FIX - MAJ automatique du rendu des IDE lors des changements d’onglets mkdocs/material.
+- ADD - support pour les chemins relatifs au fichier markdown en cours (noms de fichiers sql)
+- ADD - Ajouts de la logistique pour tester dans la doc
+- CHANGE - Discover and add css and js files automatically
+- CHANGE - Remove useless LIBS_PATH
+
+### 2.0.3
+
+- CHANGE - Mark as compatible with Python 3.9, update classifiers
+
+### 2.1.0
+
+- DEV - Add /js and /css to mkdocs watch directories
+
+- ADD - Light/dark themes for the docs
+- ADD - Hack to soften the background colors of sqlides in dark mode, without changing anything on CodeMirror side.
+- ADD - Result tables are now sortable (hidden buttons)
+
+- FIX - Unsilence errors during `load(...)` (which was a pain...)
+- FIX - CSS - Gutters kine numbers were going over the top menu header.
+
+- CHANGE - Update SQLIDE class (renaming to SqlIde on the way)
+- CHANGE - make `base` and `init` arguments work together.
+- CHANGE - Reorganize `Counter.build_sql` so that the branches match the execution order in the JS layer.
+
+- DOCS - Update docs with the new specs
+- DOCS - Add dev tests (deactivated by default)
+- DOCS - Suppress one `then`
diff --git a/docs/usage.md b/docs/usage.md
@@ -73,7 +73,7 @@ On peut afficher une console/IDE SQLite grâce à la commande `{{ sqlide paramè
     - le titre *doit* être entre guillemets
     - les chemins vers les fichiers sont relatifs à la racine du site, ou bien relatifs au dossier contenant la page markdown en cours (v2.0^+^).
     - les chemins ne peuvent pas contenir d'espace
-    - les options base et init sont mutuellement exclusives ; l'option base est prioritaire.
+    - si les arguments `base` et `init` sont tous les deux utilisés, la base est chargée avant que le code du fichier `init` ne soit exécuté.
 
     Voir le cas des [utilisations en tant que macro](#as-macros), où les syntaxes diffèrent légèrement.<!-- markdownlint-disable-line MD046 -->
 
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -8,6 +8,17 @@ theme:
     - navigation.tracking
     - navigation.tabs
     - navigation.tabs.sticky
+  palette:
+    # Palette toggle for light mode
+    - scheme: default
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    # Palette toggle for dark mode
+    - scheme: slate
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
 
 nav:
     - Home: 'index.md'
@@ -17,6 +28,7 @@ nav:
         - 'Historique des versions': 'notes-de-version.md'
 
     # - Bac à sable: 'essai/bac_a_sable.md'   # testing purpose
+    # - "Base+init": 'essai/base_init.md'     # testing purpose
 
 exclude_docs: |   # Désactiver tout le bloc pour activer dans la nav
     essai/**
@@ -36,6 +48,10 @@ extra_javascript:
   - https://unpkg.com/tablesort@5.3.0/dist/tablesort.min.js
   - extras/tablesort.js
 
+watch:
+  - mkdocs_sqlite_console/js
+  - mkdocs_sqlite_console/css
+
 markdown_extensions:
   - admonition
   - pymdownx.details
diff --git a/mkdocs_sqlite_console/__init__.py b/mkdocs_sqlite_console/__init__.py
@@ -1,3 +1,3 @@
 from .plugin import SQLiteConsole
 
-VERSION = "2.0.3"
+VERSION = "2.1.0"
diff --git a/mkdocs_sqlite_console/css/sqlite_ide.css b/mkdocs_sqlite_console/css/sqlite_ide.css
@@ -65,4 +65,17 @@ div.sqlhidden > label,
 div.sqlhidden > br,
 div.sqlhidden > button {
 	display: none;
+}
+
+/* FIX - Line numbers going over the header menu */
+.CodeMirror-gutter-wrapper { z-index: 3 }
+.CodeMirror-gutters { z-index: 2 }
+
+/* FIX - "Kinda" react to the palette color change (without going through CodeMirror maze) */
+.CodeMirror { background-color: rgba(255, 255, 255, 0.6) }
+.CodeMirror-gutters { opacity: 60%; }
+
+/* FIX - Hide column sorting buttons in result tables */
+.md-typeset table.sqltable th[role="columnheader"]::after {
+	display: none;
 }
diff --git a/mkdocs_sqlite_console/js/sqlite_ide.js b/mkdocs_sqlite_console/js/sqlite_ide.js
diff --git a/mkdocs_sqlite_console/plugin.py b/mkdocs_sqlite_console/plugin.py

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`from .plugin import SQLiteConsole`
`2`	`2`
`3`		`-VERSION = "2.0.3"`
	`3`	`+VERSION = "2.1.0"`