run

Überblick

Wiederkehrende Schritte gehören in eine .lil-Datei. run führt sie nacheinander aus; mit -n zuerst prüfen.

Automatisierung bleibt innerhalb von lil-terminal

Jede ausführbare Anweisung wird wie ein normaler lil-terminal-Befehl aufgelöst. Abhängigkeiten müssen vorher installiert sein, @command wird in Abläufen nicht verwendet, -n zeigt die expandierten Befehle ohne Ausführung und -x ist für privilegierte nichtinteraktive Befehle wie php oder ses erforderlich.

Syntax

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

Referenz

In der Praxis

Wiederholst du regelmäßig dieselben Wartungsschritte? Speichere sie in einer .lil-Textdatei und starte sie mit run. Die Anweisungen laufen nacheinander über lil-terminal, nicht über die Shell des Betriebssystems.

Prüfe zuerst mit run sandbox/scripts/workflow.lil -n, ohne etwas auszuführen. Entferne danach -n. Für kurze Aufgaben eignet sich run [pwd | pwd]; das | trennt hier die Anweisungen.

Eine Zeile enthält jeweils eine Anweisung. set speichert Werte, capture übernimmt die Befehlsausgabe, if/else wählen einen Zweig, und run startet weitere Skripte. if file ${source} prüft im Beispiel, ob die Datei existiert.

-v zeigt alle Ausgaben. Standardmäßig stoppt die Ausführung beim ersten Fehler. -k führt spätere Schritte dennoch aus, meldet das gesamte Skript aber weiterhin als Stopped. Eine Vorschau garantiert keinen späteren Erfolg.

Eine Datei mit #lil in der ersten Zeile kann Base Core als einfache Befehlsfolge ausführen. Für Variablen, Bedingungen und verschachtelte Abläufe benötigst du run. Minimum ist für ein einzelnes Dateiargument vorgesehen. Ein kurzer Ausdruck ohne Leerzeichen wie run [pwd] kann ebenfalls funktionieren; mehrere Inline-Anweisungen und erweiterte Optionen benötigen Base.

setup.lil neben lil.php läuft nach der Anmeldung und wird nur nach Erfolg gelöscht; autoload.lil läuft einmal pro autorisierter Sitzung. -p packt mit SHA-256 und DEFLATE in @LIL1, **verschlüsselt** aber nicht.

Skripte verwenden die Rechte des laufenden PHP-Prozesses. Interaktive Befehle und @install sind verboten; php/ses benötigen ausdrücklich -x. Grenzen: 256 KiB Klartext, 384 KiB gepackt, 1000 Anweisungen, 10 Ebenen, 60 Sekunden. Bereits ausgeführte Dateiänderungen werden nicht zurückgesetzt.

Details

Klartext ist auf 256 KiB, gepackte Eingaben auf 384 KiB, Skripte auf 1000 Anweisungen, 10 Verschachtelungsebenen und 60 Sekunden begrenzt. SHA-256 und DEFLATE schützen die Integrität, stellen aber keine Verschlüsselung dar.

Sicherheit

Skripte laufen mit den Rechten des aktuellen PHP-Prozesses. Interaktive Befehle sind gesperrt; php und ses erfordern ausdrücklich -x. Führen Sie keine ungeprüften Skripte aus.

Automatische Installation

Die Kurzform @command gehört zum interaktiven Core und nicht zur Automatisierungssprache. Beginnt ein Befehl in einem .lil-Skript mit @, wird er abgelehnt. Skriptabhängigkeiten sollten vor der Automatisierung ausdrücklich installiert werden, damit ein Workflow seinen ausführbaren Modulbestand nicht still verändert.

Lineare Core-Skripte und Run

Eine Datei mit #lil als erster Zeile ist absichtlich einfacher als ein Run-Workflow: Jede nicht kommentierte Zeile ist ein gewöhnlicher Terminalbefehl, | auf oberster Ebene wird von links nach rechts abgearbeitet, und beim ersten Fehler wird gestoppt. Die Datei wird direkt über den Pfad oder mit < file.lil gestartet. run ist die richtige Wahl für Variablen, Bedingungen, verschachtelte Skripte, Capture, Dry-Run oder andere Ablaufsteuerung.

Ein Workflow einschließlich verschachtelter Skripte darf insgesamt höchstens 1000 Anweisungen ohne Kommentare enthalten. -n meldet bei Fehlern Stopped statt Checked und führt keine Befehle aus.

Installieren und verwalten

Installieren Sie die aktuelle kompatible Version. Wählen Sie Base für den vollständigen Funktionsumfang oder Minimum für das reduzierte Paket; ein bereits installiertes Modul wird mit upgrade aktualisiert.

Base und Minimum sind zwei Pakete derselben aktuellen Modulversion.

Beispiele

Die Beispiele sind kopierbar, werden aber nicht von der Website ausgeführt. Prüfen Sie Pfade, Rechte und destruktive Optionen.

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

Verwandte Befehle

Ein violetter Befehlslink bedeutet, dass diese Funktion ein anderes Modul verwendet. Öffnen Sie den verknüpften Befehl, um dessen Aufgabe und Installation nachzusehen.

Verwandte Dokumentation