`ini`

ini trabalha com arquivos INI reais: lê seções e valores tipados, pesquisa configurações, valida a sintaxe e altera uma chave de forma atômica. O caminho é key ou section.key.

DadosVersão 1.3.5Estável

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/app.iniapplication.name lil-sandbox application.debug true paths.source ../src paths.public ../publicini $ -cValid INIini $ -f "path*" -kpaths.public ../public paths.source ../src

Visão geral

ini trabalha diretamente com arquivos INI: lê chaves por caminhos pontuados, busca chaves ou valores, altera uma configuração de forma atômica, valida o resultado e mostra a fonte normalizada sem buffer de sessão.

Uma seção e uma chave formam dois níveis

application.name seleciona name dentro de [application]. Um caminho mais profundo como a.b.c é rejeitado de propósito; JSON, TOML ou YAML são melhores quando a configuração precisa de mais níveis.

Sintaxe

lil-terminal

ini <file> [key|options] · ini dump <file>

Referência

ini <file>

mostrar dados INI

ini <file> <key>

mostrar o valor exato de uma chave ou seção

ini dump <file>

mostrar o texto-fonte INI normalizado

-f <text|mask> [-k|-v]

procurar correspondências em chaves ou valores; * e ? ativam uma máscara

-w <key> : <value>

gravar um escalar ou lista no estilo JSON diretamente no arquivo

-w <key> < <file>

gravar um valor lido de outro arquivo

-d <key>

excluir uma chave ou seção

-c

validar o arquivo INI

Arquivo ativo

Com o core atual, um arquivo aberto com sucesso passa a ficar disponível imediatamente como $. Se este módulo for o manipulador instalado de maior prioridade para a extensão, basta digitar o nome do arquivo para abri-lo por este comando. Esses são atalhos do core; ini <file> continua sendo a forma explícita.

Pesquisa

-f pesquisa caminhos e valores. Use -k somente para chaves ou -v somente para valores. Consultas com * ou ? são tratadas como máscaras.

Edição direta

-w grava imediatamente no arquivo. Depois de : vem um valor em linha; < <file> lê o valor de outro arquivo. -d exclui um caminho pontuado.

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.

Abrir o arquivo e reutilizá-lo com $

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 ini

Pacote Minimum

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

install ini -m

Versão pública exata

Instalar exatamente esta versão publicada.

install ini -v 1.3.5

Verificar ou atualizar

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

upgrade ini

Remover módulo

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

install ini -u

Exemplos

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

Abrir o arquivo e reutilizá-lo com $

cd \sandbox\config | ini app.ini

application.name   lil-sandbox
application.debug  true
paths.source        ../src
paths.public        ../public

Mostrar dados INI

app.ini

application.name   lil-sandbox
application.debug  true
paths.source        ../src
paths.public        ../public

Mostrar o valor exato de uma chave ou seção

ini $ application.name

lil-sandbox

Ini · find-key

ini $ -f "path*" -k

paths.public  ../public
paths.source  ../src

Ini · find-value

ini $ -f "../public" -v

paths.public  ../public

Ini · write

ini $ -w application.password : "Ed1g!fs:13od"

application.password  Ed1g!fs:13od

Ini · delete

ini $ -d application.password

application.name   lil-sandbox
application.debug  true

Ini · validate

ini $ -c

Valid INI

Mostrar o texto-fonte INI normalizado

ini dump $ > ini-review.txt -r

[application]
name = "lil-sandbox"
debug = true

[paths]
source = "../src"
public = "../public"

Tratar um arquivo ausente

ini \sandbox\config\missing.ini

Arquivo não encontrado

Arquivo usado neste exemplo: `sandbox/config/app.ini`

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

[application]
name = "lil-sandbox"
debug = true

[paths]
source = "../src"
public = "../public"

Documentação relacionada

Como instalar um módulo? →Por que um comando responde “command not found”? →

Versão pública atual

v1.3.52026-08-13

Ajuda uniforme para dados estruturados

Leitura, busca, gravação, remoção e validação seguem agora o mesmo padrão de opções.

# Histórico de versões

ini