Langage GaspardTerminal¶
GaspardTerminal est un terminal graphique C++98 avec un petit langage de commandes
extensible. Saisir help pour afficher les commandes et la syntaxe. Les variables
et l’historique appartiennent à la session courante.
set APP /AHCIDISK0/apps/Gaspard3D.elf
echo "Lancement de ${APP}"
run "$APP"
cd /AHCIDISK0/documents
ls
cd ..
cd -
repeat 3 "echo bonjour"
history
!!
Variables¶
set VAR valeur crée ou remplace une variable. Plusieurs arguments de valeur sont
joints par un espace ; mettre la valeur entre guillemets pour préserver ses espaces.
set VAR affiche sa valeur, set liste les variables et unset VAR en supprime une.
Pour une valeur vide : set VAR "".
Les noms sont sensibles à la casse, limités à 64 caractères, selon
[A-Za-z_][A-Za-z0-9_]*. $VAR et ${VAR} insèrent une valeur ; une variable
inconnue provoque une erreur. L’expansion forme un seul argument et n’est pas
réinterprétée comme du code, même si elle contient des espaces ou des points-virgules.
$PWD indique le dossier du langage et $STATUS le résultat de la commande
précédente (0 = succès). Ces deux variables sont en lecture seule. Les variables
ne sont pas exportées dans l’environnement des programmes lancés.
Syntaxe¶
- Espaces et tabulations séparent les arguments.
- Les apostrophes préservent le texte littéralement ; les guillemets permettent
les variables :
echo '$VAR'affiche$VAR,echo "$VAR"affiche sa valeur. - Hors apostrophes, l’antislash protège le caractère suivant :
\$VARest littéral. Utiliser/comme séparateur dans les chemins GFS2. ;sépare les commandes hors citations. Les variables sont développées juste avant chaque commande :set X bonjour; echo $Xfonctionne.#commence un commentaire à une frontière d’argument, hors citations.- Une citation incomplète ou un antislash final refuse toute la ligne avant exécution. Une erreur de commande arrête le reste du lot ; les changements déjà effectués sont conservés.
Les noms de commandes ignorent la casse ASCII. Pas de pipes, redirections, jokers, calcul arithmétique, substitution de commande ou lancement implicite.
Commandes¶
| Commande | Utilisation |
|---|---|
help [commande] |
Aide produite depuis le registre des commandes. |
set [VAR [valeur ...]] |
Lister, lire ou affecter une variable. |
unset VAR |
Supprimer une variable utilisateur. |
echo [texte ...] |
Afficher les arguments séparés par un espace. |
pwd |
Afficher le dossier courant. |
cd chemin |
Entrer dans un dossier existant ; chemin relatif à $PWD. |
cd .. |
Revenir au parent, sans dépasser /. |
cd - |
Revenir au dossier précédent ; répéter pour alterner. |
cd |
Revenir à la racine virtuelle /. |
ls [chemin] |
Lister progressivement un dossier ; / liste les volumes montés. |
run fichier.elf [arguments ...] |
Charger puis lancer un programme ELF64 sans bloquer le terminal. |
history |
Afficher les 64 dernières lignes et leurs numéros. |
!! |
Réexécuter la dernière ligne de l’historique. |
!N |
Réexécuter la ligne de numéro N encore présente dans l’historique. |
repeat N "commande" |
Exécuter un lot entre 1 et 1000 fois. |
clear |
Effacer l’affichage et l’historique de sortie. |
exit |
Fermer GaspardTerminal. |
Répétition et historique¶
Les flèches haut/bas rappellent la saisie ; Entrée l’exécute. !! et !N
s’appliquent à une ligne complète et développent à nouveau ses variables.
L’historique est en mémoire uniquement.
repeat met le travail en attente sans appel récursif au parseur. Les variables
entre guillemets sont développées au moment de la commande repeat ; les
apostrophes reportent cette expansion à chaque commande répétée :
repeat 3 'echo $PWD'
repeat 2 'set X modifie; echo $X'
Une commande est traitée par tour de boucle graphique. Un lot possède un budget de 2048 commandes, avec au plus 16 travaux imbriqués. Une nouvelle saisie est refusée tant qu’un lot est encore en attente.
Lancer un programme¶
run résout le chemin relatif depuis $PWD, charge le fichier GFS2 et utilise
les syscalls noyau 150–152. Le terminal accepte un ELF de 4 Mio maximum et 20
arguments, chemin du programme compris : 1023 octets maximum par argument et
8192 octets au total avec les terminateurs. Le noyau vérifie l’ELF et copie ses
arguments avant de rendre un jeton de tâche positif.
cd /AHCIDISK0/apps
run programme.elf "argument avec espaces"
Le terminal reste interactif et récupère la sortie console des enfants dans un canal noyau privé. Une autre instance ne peut pas lire ce canal. Le compteur de la fenêtre indique les enfants non encore récupérés par le scheduler. Fermer le terminal ne tue pas les programmes lancés ; leurs sorties ultérieures sont ignorées.
$STATUS décrit l’acceptation de la commande, pas le futur code de sortie du
programme. Les erreurs de chargement/lancement sont affichées ensuite. Pas
d’attente de premier plan, d’entrée clavier des enfants, d’émulation ANSI ou d’API
de code de terminaison. cd change les chemins du langage, pas le dossier interne
de la newlib de l’enfant. Pour recevoir les arguments, le programme doit utiliser
un CRT qui décode GO64_StartInfo ; relier à nouveau les anciennes applications
avec le CRT mis à jour.
Interface et limites¶
Entrée exécute ; haut/bas rappelle l’historique ; PgUp/PgDn défile ; Echap efface la saisie ; Tab insère quatre espaces. La saisie UTF-8 utilise le composant de texte partagé. L’affichage conserve 512 lignes logiques de longueur bornée.
Une ligne contient au plus 4095 octets, 32 commandes et 32 arguments par commande. Il y a au plus 128 variables utilisateur, dont les valeurs totalisent 65536 octets.
Ajouter une commande¶
Le parseur, le registre, les modules et le backend sont séparés. Définir un handler dans un module C++, puis enregistrer son descripteur au démarrage :
#include "language.hpp"
static int bonjour(terminal::Engine& engine, const terminal::Arguments& arguments)
{
if (arguments.size() != 1)
return -22;
engine.line("Bonjour depuis un module");
return 0;
}
void registerExampleCommands(terminal::Engine& engine)
{
engine.registerCommand(terminal::Command("bonjour", "bonjour", "Afficher un message", bonjour));
}
Appeler registerExampleCommands(engine) à côté de registerDefaultCommands(engine).
help affiche alors automatiquement la nouvelle commande. Le handler reçoit les
arguments développés ; l’indice zéro contient le nom de la commande. Un retour
nul signifie succès ; une erreur arrête le lot. Vérifier le nombre d’arguments
avant de les consulter. Une opération longue doit devenir un travail de backend
avancé par tick, sans boucle bloquante dans le handler.
include/language.hpp documente le contrat du langage ; src/language.cpp
effectue l’analyse et l’ordonnancement ; src/commands.cpp enregistre les commandes
standard ; src/native.cpp réalise les travaux GFS2 et processus ; src/main.cpp
fournit l’interface et include/console.hpp borne l’historique de sortie.
Compiler¶
Depuis la racine du dépôt dans MSYS2 MINGW64 :
make -C GaspardTerminal -j4 check
make -C GaspardTerminal test
Résultat : GaspardTerminal/build/GaspardTerminal.elf, à exécuter sous GaspardOS.
Le lancement et la capture de sortie nécessitent le noyau reconstruit avec
les syscalls 150–152. Le langage est testable séparément sur l’hôte.
make -C GaspardTerminal integration exécute le vrai terminal sous QEMU avec
une image GFS2 temporaire contenant un ELF enfant. Il vérifie set, cd,
repeat, le chargement, les arguments du CRT, la sortie capturée et la fin de l’enfant.