run

概要

繰り返す保守作業は .lil ファイルに保存し、run で順番に実行します。まず -n で確認してください。

自動化は lil-terminal の中に留まる

各文は通常の lil-terminal コマンドとして解決されます。依存関係は事前に導入し、ワークフロー内では @command を使いません。-n は展開後のコマンドを実行せずに表示し、php や ses など権限の強い非対話型コマンドには -x が必要です。

構文

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

リファレンス

実際の使い方

同じ保守作業を繰り返すなら、コマンドを .lil テキストファイルに保存し、run で順番に実行できます。OS のシェルではなく lil-terminal のコマンドを使います。

まず run sandbox/scripts/workflow.lil -n で、何も実行せずに内容を確認します。問題なければ -n を外してください。短い作業なら run [pwd | pwd] と書き、| でコマンドを区切れます。

ファイルは 1 行 1 命令です。set は値を保存し、capture は出力を取り込み、if/else は条件分岐を選び、run は子スクリプトを呼びます。例の if file ${source} はファイルの存在を確認します。

-v は各コマンドの出力を表示します。通常は最初の失敗で停止します。-k では後続も実行しますが、失敗があれば最終状態は Stopped のままです。プレビューが成功しても、本番実行の成功は保証されません。

先頭が #lil のファイルは Base Core が単純な連続コマンドとして直接処理できます。変数や条件、ネストが必要なら run を使います。Minimum は単一のファイル引数を想定しています。run [pwd] のように空白のない短い形式が動く場合もありますが、複数コマンドのインラインスクリプトや高度なオプションには Base が必要です。

lil.php と同じ場所の setup.lil は認証後に実行され、すべて成功した場合だけ削除されます。autoload.lil は認証済みセッションごとに 1 回動きます。-p は SHA-256 と DEFLATE で @LIL1 にまとめますが、**暗号化しません**。

スクリプトは PHP プロセスの権限で実行されます。対話操作と @install は禁止で、php/ses には -x が必要です。上限はテキスト 256 KiB、パック形式 384 KiB、1000 命令、ネスト 10 階層、60 秒です。実行済みのファイル変更は自動で取り消されません。

詳細

通常テキストは 256 KiB、パック入力は 384 KiB、スクリプトは 1000 文、10 階層、60 秒までです。SHA-256 と DEFLATE は整合性を守りますが暗号化ではありません。

セキュリティ

スクリプトは現在の PHP プロセス権限で動作します。対話コマンドは禁止され、php と ses には明示的な -x が必要です。未確認のスクリプトを実行しないでください。

自動インストール

@command の省略記法は対話コアの機能であり、自動化言語の機能ではありません。.lil スクリプト内で @ から始まるコマンドは拒否されます。実行中に利用可能なモジュール集合が暗黙に変化しないよう、スクリプトの依存関係は自動化を始める前に明示的にインストールしてください。

Core 線形スクリプトと Run

#lil で始まるファイルは、Run workflow より意図的に単純です。コメント以外の各行は通常の端末コマンドで、トップレベルの | は左から右へ実行され、最初の失敗で停止します。ファイルはパスを直接入力するか < file.lil で起動します。変数、条件、入れ子スクリプト、capture、dry-run などの workflow 機能が必要な場合は run を使用します。

入れ子の .lil を含むワークフロー全体でコメント以外の命令は最大 1000 件です。-n で検証が失敗した場合、Checked ではなく Stopped を表示し、コマンドは実行しません。

インストールと管理

現在の互換バージョンをインストールします。全機能は Base、縮小版は Minimum を選び、すでに導入済みのモジュール更新には upgrade を使います。

Base と Minimum は同じ現在のモジュールリリースの二つのパッケージです。

例

例はコピーできますが、サイトは実行しません。実プロジェクトではパス、権限、破壊的オプションを確認してください。

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

関連コマンド

紫のコマンドリンクは、その機能が別のモジュールを使うことを示します。リンク先のコマンドを開くと、役割とインストール方法を確認できます。

関連ドキュメント