run

run executa fluxos .lil com variáveis, condições, resultados capturados, scripts aninhados, prévia e arquivos empacotados pelo mesmo caminho de comandos do terminal interativo. Ele não chama um shell do sistema operacional.

AutomaçãoVersão 1.2.3Estável
lil-terminal

Visão geral

Use run quando uma sequência precisar de lógica ou execução controlada. Uma lista fixa de comandos comuns pode ficar em um arquivo #lil; run acrescenta recursos de fluxo sem criar uma segunda linguagem de shell.

A automação permanece dentro do lil-terminal

Cada instrução é resolvida como um comando normal do lil-terminal. As dependências devem estar instaladas antes, @command não é usado nos fluxos, -n mostra os comandos expandidos sem executá-los e -x é obrigatório para comandos privilegiados não interativos como php ou ses.

Sintaxe

lil-terminal
run <file.lil|[script]> [options] · run -p <source.lil> [target.lil]

Referência

run task.lil

executar um script .lil normal ou empacotado

run [md backup | copy public backup/public]

executar um script embutido; um | sem aspas separa instruções

run -p <source.lil> [target.lil]

criar um script empacotado protegido por soma de verificação

-n

validar e mostrar os comandos expandidos sem executá-los

-v

mostrar toda a saída dos comandos

-k

continuar após falhas; o padrão para na primeira falha

-x

permitir comandos privilegiados não interativos como php e ses

plain .lil

texto UTF-8 com uma instrução por linha

packed .lil

cabeçalho @LIL1 com SHA-256 e dados DEFLATE

setup.lil

executar uma vez após a autorização e remover após sucesso

autoload.lil

executar uma vez por sessão autorizada

lil <script>

alias de run

@<command>

a instalação automática é exclusiva do modo interativo e é recusada em scripts

#lil file

script linear do core formado somente por comandos comuns; execute pelo caminho ou com <

run workflow

usar run quando forem necessárias variáveis, condições, aninhamento, capture ou outra lógica de fluxo

Detalhes

O texto simples é limitado a 256 KiB, a entrada empacotada a 384 KiB, os scripts a 1000 instruções, 10 níveis e 60 segundos. SHA-256 e DEFLATE protegem a integridade, mas não criptografam o conteúdo.

Segurança

Os scripts usam as permissões do processo PHP atual. Comandos interativos são bloqueados e php e ses exigem -x. Não execute scripts não revisados.

Instalação automática

O atalho @command pertence ao núcleo interativo, não à linguagem de automação. Um comando iniciado por @ dentro de um script .lil é recusado. Instale explicitamente as dependências do script antes da automação para que o fluxo nunca altere de forma implícita o conjunto de módulos executáveis.

Scripts lineares do core e Run

Um arquivo iniciado por #lil é propositalmente mais simples que um workflow Run: cada linha que não seja comentário é um comando comum do terminal, separadores | no nível principal são executados da esquerda para a direita e o processamento para na primeira falha. Execute o arquivo diretamente pelo caminho ou com < file.lil. Use run quando forem necessárias variáveis, condições, scripts aninhados, capture, dry-run ou outras funções de workflow.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Run · script

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install run
Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install run -m
Versão pública exata

Instalar exatamente esta versão publicada.

install run -v 1.2.3
Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade run
Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install run -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Run · script
run sandbox/task.lil -v
001 + cd sandbox
    config/
    data/
    db/
    images/
    logs/
    public/
    scripts/
    tmp/
    workspace/
002 + pwd
    /home/account/public_html/sandbox
Completed: 2
Executar um script .lil normal ou empacotado
run sandbox/task.lil
001 + cd sandbox
002 + pwd
Completed: 2
Run · inline
run sandbox/task.lil -n
001 · cd sandbox
002 · pwd
Checked: 2
Executar um script embutido; um | sem aspas separa instruções
run [md sandbox/backup | copy sandbox/data sandbox/backup/data]
001 + md sandbox/backup
002 + copy sandbox/data sandbox/backup/data
Completed: 2
Criar um script empacotado protegido por soma de verificação
run -p sandbox/task.lil sandbox/task.packed.lil
Packed task.lil > sandbox/task.packed.lil
15 B > 101 B
Executar um script .lil normal ou empacotado
run sandbox/task.packed.lil
001 + cd sandbox
002 + pwd
Completed: 2
Alias de run
lil sandbox/task.lil
001 + cd sandbox
002 + pwd
Completed: 2

lil é o alias curto de run; fluxos .lil salvos e automações coladas usam o mesmo caminho de execução de comandos.

Executar um script .lil normal ou empacotado
run sandbox/missing.lil
Arquivo de script não encontrado

Arquivo usado neste exemplo: sandbox/scripts/demo.lil

O exemplo usa um arquivo ou diretório do espaço protegido de documentação /sandbox/.

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

Documentação relacionada

Como manter a saída do terminal ao navegar entre páginas? →É seguro manter o lil-terminal em um site de produção? →

Versão pública atual

v1.2.32026-08-12

Sincronização linguística

Conclui a sincronização da ajuda local e do servidor e reforça a segurança de localização de run.

# Histórico de versões