Cahier des Charges · gtk3sermo

Projet : haplo-dialog | Cible : Debian testing et dérivées
GTK : GTK 3 | Dépôt : gitlab.com/haplo-dialog/sermo

Projet : gtk3sermo 1.1.4
Version : 1.1.4
Date : Mai 2026
Statut : En développement actif
Auteur original : László Pere, Thunor
Fork/Modernisation : haplo-dialog devel@haplo-dialog.fr

Table des matières

1. Contexte et historique
2. Périmètre du projet
3. Objectifs
4. Exigences fonctionnelles
5. Exigences non fonctionnelles
6. Contraintes techniques
7. Architecture cible
8. Livrables
9. Planification et jalons
10. Critères d'acceptation
11. Risques identifiés
12. Glossaire

1. Contexte et historique

1.1 Origine du projet

gtkdialog (aussi distribué sous le nom gtkd) est un utilitaire C open source permettant de construire des interfaces graphiques GTK à partir de descriptions XML embarquées dans des scripts shell ou d'autres langages interprétés. Initialement développé par László Pere (2003-2007) puis maintenu par Thunor (2011-2012), il a atteint la version 0.8.3 avant d'être abandonné.

Le paquet gtkd_0.8.3-parrot0_all.deb redistribué pour Parrot OS date de février 2016. Il dépend de GTK 2.0, déclaré en fin de vie depuis 2011 et définitivement retiré des distributions majeures en 2020.

1.2 Problème

En 2026, ce paquet ne peut plus être installé ni compilé sur aucun système moderne :

• GTK 2.0 n'est plus packagé (Ubuntu 22+, Debian 12+, Fedora 36+)
• libglade-2.0 est entièrement supprimé
• python-gtk2-dev n'existe plus
• Le code source contient des vulnérabilités de sécurité critiques (injection shell, buffer overflows)
• Le système de build Autotools n'est pas configuré pour les compilateurs modernes

1.3 Opportunité

gtkdialog reste conceptuellement unique : aucun outil équivalent en C n'offre la même simplicité pour créer des GUI GTK depuis un script. Le projet mérite une modernisation plutôt qu'un abandon.

2. Périmètre du projet

2.1 Inclus dans ce projet

• Migration complète de GTK 2 vers GTK 3 (>= 3.22)
• Correction de toutes les vulnérabilités de sécurité identifiées
• Mise à jour du système de build (configure.in / Makefile.am)
• Mise à jour de la dépendance VTE vers vte-2.91
• Remplacement de libglade par GtkBuilder (intégré GTK3)
• Rédaction de la documentation (cahier des charges, manuel utilisateur, manuel développeur)
• Conservation de 100% de la compatibilité descendante de la syntaxe XML gtkdialog

2.2 Hors périmètre (version 0.9.x)

• Réécriture du parser (Yacc/Lex actuel conservé)
• Ajout de nouveaux widgets non présents dans l'original
• Interface de configuration graphique
• Support Windows/macOS

3. Objectifs

3.1 Objectif principal

Produire un binaire gtkdialog fonctionnel sur tout système Linux moderne avec GTK 3, compilable sans erreur, sécurisé, et compatible avec tous les scripts écrits pour gtkdialog 0.8.3.

3.2 Objectifs secondaires

4. Exigences fonctionnelles

4.1 Widgets supportés (identiques à 0.8.3)

Le binaire doit créer et gérer les 30 widgets suivants, identiques en comportement à la version originale :

button, cancelbutton, helpbutton, nobutton, okbutton, yesbutton, togglebutton, checkbox, radiobutton, entry, edit (zone de texte multi-lignes), text (étiquette), spinbutton, hscale, vscale, progressbar, combobox, comboboxtext, comboboxentry, list, tree, pixmap, colorbutton, fontbutton, notebook, frame, hbox, vbox, menubar, statusbar, timer, eventbox, expander, terminal, window

4.2 Modes d'entrée du programme

• gtkdialog --stdin, lire la définition XML depuis l'entrée standard
• gtkdialog --program=VAR_ENV, lire depuis une variable d'environnement
• gtkdialog --file=chemin.xml, lire depuis un fichier
• gtkdialog --geometry=WxH+X+Y, positionner la fenêtre

4.3 Actions supportées

Le moteur d'actions doit traiter : EXIT, CLOSE, LAUNCH, REFRESH, SAVE, CLEAR, APPEND, FILESELECT, REMOVESELECTED, ENABLE, DISABLE, SHOW, HIDE, ACTIVATE, GRABFOCUS, PRESENTWINDOW

4.4 Sortie du programme

À la fermeture, le programme doit exporter sur stdout les paires NOM_VARIABLE=valeur pour tous les widgets nommés, conformément au comportement gtkdialog 0.8.3.

4.5 Gestion des commandes externes

Tous les attributs <input>, <action> et commandes shell associés aux widgets doivent être exécutés de manière sécurisée via safe_system() / safe_popen() sans invoquer /bin/sh -c directement.

5. Exigences non fonctionnelles

5.1 Sécurité

5.2 Performances

• Démarrage d'une fenêtre simple en moins de 200 ms
• Aucun gel de l'interface pendant l'exécution de commandes (cible versions futures)
• Empreinte mémoire inférieure à 50 Mo pour une fenêtre simple

5.3 Portabilité

• Compatible : Debian 12, Ubuntu 22.04 LTS, Ubuntu 24.04 LTS, Fedora 38+, Arch Linux
• Architecture : x86_64, ARM64 (Raspberry Pi OS)
• Compilateur : GCC >= 10 ou Clang >= 12

5.4 Maintenabilité

• Code conforme au standard C17 (-std=c17)
• Avertissements de compilation inférieurs à 20 avec -Wall -Wextra
• Chaque fichier source doit avoir un en-tête de licence GPL-2.0

5.5 Compatibilité descendante

Tous les scripts shell utilisant gtkdialog 0.8.3 doivent fonctionner sans modification avec gtk3sermo 1.0.0.

6. Contraintes techniques

6.1 Dépendances autorisées

6.2 Dépendances supprimées

6.3 Licence

Le projet reste sous GPL-2.0-or-later, conformément à l'original.

7. Architecture cible

gtk3sermo_1.1.4/
├── src/
│   ├── gtkdialog.c/.h          # Point d'entrée, parsing des arguments
│   ├── safe_exec.c/.h          # NOUVEAU: wrappers sécurisés system/popen
│   ├── automaton.c/.h          # Moteur d'exécution (AST → widgets GTK)
│   ├── gtkdialog_parser.y      # Parser Bison (syntaxe XML gtkdialog)
│   ├── gtkdialog_lexer.l       # Lexer Flex
│   ├── variables.c/.h          # Gestion des variables et de l'état
│   ├── signals.c/.h            # Système de signaux GTK
│   ├── actions.c/.h            # Traitement des actions (EXIT, REFRESH…)
│   ├── widgets.c/.h            # Dispatch et utilitaires widgets
│   ├── widget_*.c/.h           # Un fichier par widget (30 widgets)
│   ├── glade_support.c/.h      # Support GtkBuilder (ex-libglade)
│   ├── stringman.c/.h          # Manipulation de chaînes
│   ├── tag_attributes.c/.h     # Traitement des attributs XML
│   ├── printing.c/.h           # Support impression
│   └── Makefile.am
├── configure.in                # Autoconf, GTK3, VTE 2.91
├── doc/
│   ├── reference/              # Référence HTML par widget
│   └── gtkdialog.texi          # Documentation Texinfo
├── examples/                   # Exemples par widget
├── CAHIER_DES_CHARGES.md       # Ce document
├── MANUEL_UTILISATEUR.md
├── MANUEL_DEVELOPPEUR.md
└── COMPILE.md                  # Instructions de compilation rapide

7.1 Flux de traitement d'une requête

Script shell → variable d'environnement / stdin / fichier
    ↓
gtkdialog_lexer.l (Flex), tokenisation
    ↓
gtkdialog_parser.y (Bison), arbre syntaxique
    ↓
automaton.c, création des widgets GTK3
    ↓
gtk_main(), boucle événements GTK
    ↓
signals.c + actions.c, traitement des interactions
    ↓
[safe_system() / safe_popen()], exécution sécurisée
    ↓
variables.c, export des valeurs sur stdout

8. Livrables

9. Planification et jalons

10. Critères d'acceptation

Le projet sera considéré comme terminé (version 1.0.0 stable) lorsque :

1. Le binaire compile sans erreur sur Debian 12 et Ubuntu 22.04 avec gcc -Wall -Wextra
2. Les 30 widgets fonctionnent (tests manuels sur les exemples fournis dans examples/)
3. checksec --file=gtkdialog retourne : RELRO=Full, Stack=Canary, NX=Enabled, PIE=Enabled
4. Aucun appel direct à system() ou popen() dans le code source (grep de vérification = 0 résultat)
5. Aucun strcpy, strcat, sprintf non borné (grep de vérification = 0 résultat)
6. Le script d'exemple examples/button/button fonctionne sans modification
7. valgrind --leak-check=full ./gtkdialog --stdin < examples/button/button retourne 0 erreur mémoire

11. Risques identifiés

12. Glossaire