Aller au contenu

CLI — Interface en ligne de commande

Syntaxe générale

galois <commande> [options] [arguments]

Commandes

build / b — Compiler vers un exécutable natif

galois build <fichier.gal> [-o sortie] [--release]
Option Description
-o, --output Nom du fichier de sortie
--release Compilation optimisée (O3)

Exemples :

# Compilation debug
galois build programme.gal

# Compilation optimisée
galois build programme.gal --release

# Nom de sortie personnalisé
galois build programme.gal -o mon_app

run / r — Compiler et exécuter

galois run <fichier.gal> [--release]

Compile le programme puis l'exécute immédiatement.

galois run programme.gal
galois run programme.gal --release

compiler / comp / c — Compiler vers LLVM IR

galois compiler <fichier.gal> [-o sortie.ll]

Génère un fichier LLVM IR (.ll) lisible.

galois compiler programme.gal
galois compiler programme.gal -o sortie.ll

lexer / lex — Afficher les tokens

galois lexer <fichier.gal>

Affiche la suite de tokens produite par l'analyse lexicale.

galois lexer programme.gal

Sortie exemple :

programme.gal:1:1: soit
programme.gal:1:6: x
programme.gal:1:8: =
programme.gal:1:10: 42

parser / parse / p — Afficher l'AST

galois parser <fichier.gal>

Affiche l'arbre syntaxique abstrait produit par l'analyse syntaxique.

vérifier / v — Vérifier les types

galois vérifier <fichier.gal>

Lance la vérification de types sans compilation.

galois vérifier programme.gal
# Sortie : Vérification réussie: aucune erreur de type détectée

ir — Afficher l'IR

galois ir <fichier.gal>

Affiche la représentation intermédiaire générée.

doc / documentation — Générer la documentation

galois doc <fichier.gal> [-o dossier]

Génère la documentation HTML à partir des commentaires ///.

galois doc programme.gal
galois doc programme.gal -o documentation

debug / débogue — Lancer le débogueur

galois debug <fichier.gal>

Compile avec les informations de débogage et prépare l'intégration gdb/lldb.

init / nouveau — Créer un projet

galois init <nom_du_projet>

Crée un nouveau projet avec la structure suivante :

mon_projet/
├── galois.toml
├── principal.gal
└── src/

add / ajouter — Ajouter une dépendance

galois add <nom_du_paquet> [version]

Ajoute une dépendance au fichier galois.toml.

galois add maths
galois add maths 1.2.0

aide / help — Afficher l'aide

galois aide

Pipeline de compilation

Source (.gal)
    ↓ Lexer
Tokens
    ↓ Parser
AST
    ↓ Vérificateur de types
AST vérifié
    ↓ Générateur IR
IR
    ↓ Générateur LLVM
LLVM IR (.ll)
    ↓ Clang
Code objet (.o)
    ↓ Éditeur de liens
Exécutable natif