run

Vue d’ensemble

Placez les tâches répétitives dans un fichier .lil. run les exécute dans l’ordre ; vérifiez d’abord avec -n.

L’automatisation reste dans lil-terminal

Chaque instruction est résolue comme une commande lil-terminal normale. Les dépendances doivent être installées à l’avance, @command n’est pas utilisé dans les workflows, -n affiche les commandes développées sans les exécuter et -x est requis pour les commandes privilégiées non interactives comme php ou ses.

Syntaxe

run <file.lil|[script]> [-n|-v|-k|-x] · run -p <source.lil> [target.lil]

Référence

En pratique

Vous répétez les mêmes opérations de maintenance ? Placez-les dans un fichier texte .lil, puis lancez run. Les étapes suivent le fonctionnement du terminal, sans appeler le shell du système.

Commencez par run sandbox/scripts/workflow.lil -n pour vérifier les étapes sans les exécuter. Retirez ensuite -n. Pour quelques instructions, utilisez run [pwd | pwd] : | sépare les commandes du scénario.

Une ligne contient une instruction. set mémorise une valeur, capture enregistre la sortie, if et else choisissent une branche, et run appelle un autre script. Dans l’exemple, if file ${source} vérifie la présence du fichier.

-v affiche chaque sortie. Sans option, le premier échec arrête le script ; -k permet de poursuivre, mais le bilan reste Stopped en cas d’échec. La prévisualisation ne garantit pas le résultat de l’exécution réelle.

Un fichier commençant par #lil peut s’exécuter directement dans Base Core comme une simple suite de commandes. Pour les variables, conditions ou appels imbriqués, utilisez run. Minimum est prévu pour un seul argument de fichier. Une courte forme sans espace comme run [pwd] peut aussi fonctionner ; les scripts en ligne à plusieurs commandes et les options avancées exigent Base.

setup.lil, placé près de lil.php, s’exécute après authentification et n’est supprimé qu’après réussite ; autoload.lil s’exécute une fois par session autorisée. -p prépare un fichier @LIL1 avec SHA-256 et DEFLATE, mais **ne le chiffre pas**.

Les scripts disposent des droits du processus PHP. Les commandes interactives et @install sont interdites ; php et ses exigent -x. Limites : 256 Kio en texte, 384 Kio empaquetés, 1 000 instructions, 10 niveaux et 60 secondes. Les changements déjà effectués ne sont pas annulés automatiquement.

Détails

Le texte simple est limité à 256 Kio, l’entrée empaquetée à 384 Kio, les scripts à 1000 instructions, 10 niveaux et 60 secondes. SHA-256 et DEFLATE protègent l’intégrité mais ne chiffrent pas le contenu.

Sécurité

Les scripts utilisent les droits du processus PHP courant. Les commandes interactives sont bloquées et php ainsi que ses exigent -x. N’exécutez pas de scripts non vérifiés.

Installation automatique

Le raccourci @command appartient au cœur interactif, pas au langage d’automatisation. Toute commande commençant par @ dans un script .lil est refusée. Installez explicitement les dépendances du script avant l’automatisation afin qu’un workflow ne modifie jamais implicitement l’ensemble de ses modules exécutables.

Scripts linéaires du core et Run

Un fichier commençant par #lil est volontairement plus simple qu’un workflow Run : chaque ligne non commentée est une commande ordinaire du terminal, les séparateurs | de premier niveau sont traités de gauche à droite et l’exécution s’arrête au premier échec. Le fichier se lance directement par son chemin ou avec < file.lil. Utilisez run pour les variables, conditions, scripts imbriqués, capture, dry-run et autres fonctions de workflow.

Un workflow, scripts imbriqués compris, est limité à 1000 instructions hors commentaires. Avec -n, une erreur affiche Stopped et non Checked ; aucun ordre n’est exécuté.

Installer et gérer

Installez la version compatible actuelle. Choisissez Base pour l’ensemble complet des fonctions ou Minimum pour le paquet réduit ; utilisez upgrade pour mettre à jour un module déjà installé.

Base et Minimum sont deux paquets de la même version actuelle du module.

Exemples

Les exemples sont copiables mais ne sont pas exécutés par le site. Vérifiez chemins, droits et options destructrices.

001 + pwd
002 + pwd
Completed: 2

001 + pwd
    sandbox
002 + pwd
    sandbox
Completed: 2

001 · pwd
002 · pwd
Checked: 2

001 · pwd
002 · pwd
Checked: 2

001 + pwd
002 + pwd
Completed: 2

001 + pwd
002 + pwd
Completed: 2

001 + pwd
Completed: 1

001 + pwd
Completed: 1

001 + pwd
Completed: 1

001 + pwd
    sandbox
002 + pwd
    sandbox
Completed: 2

001 + pwd
    sandbox
002 + pwd
    sandbox
Completed: 2

001 – upload
    Command is not allowed in scripts
Stopped: 1

001 – upload
    Command is not allowed in scripts
002 + pwd
Stopped: 2

Line 001 – maintenance
Stopped: 0

001 + pwd
002 – php -v
    Command is not allowed in scripts
Stopped: 2

001 + pwd
    sandbox
002 + php -v
    PHP 8.4.24
Completed: 2

001 – php -v
    Command is not allowed in scripts
Stopped: 1

001 + php -v
    PHP 8.4.24
Completed: 1

001 · pwd
Line 003 – Missing end
Stopped: 1

Recursive script detected
Stopped: 0

001 – @install find
    Automatic installation is not allowed in scripts
Stopped: 1

001 – upload
    Command is not allowed in scripts
002 + pwd
Stopped: 2

Packed workflow.lil > sandbox/scripts/workflow.export.lil
182 B > 256 B

001 + pwd
002 + pwd
Completed: 2

001 · pwd
002 · pwd
Checked: 2

001 – @install find
    Automatic installation is not allowed in scripts
Stopped: 1

001 – upload
    Command is not allowed in scripts
Stopped: 1

Script file not found

Script must use the .lil extension

Unknown run option: -z

Inline script is missing ]

?

# lil-sandbox workflow
pwd
dir 1 sandbox
echo sandbox/data/sample.txt

Commandes associées

Un lien de commande violet indique que cette fonction utilise un autre module. Ouvrez la commande liée pour voir ce qu’elle apporte et comment l’installer.

Documentation associée