toml

toml lê e altera o subconjunto TOML comum: tabelas, chaves pontuadas, valores escalares e listas simples. Validação e gravação acontecem diretamente no arquivo escolhido.

DadosVersão 1.1.5Estável
lil-terminal

Visão geral

toml trabalha diretamente com configurações TOML comuns: lê caminhos pontuados, busca chaves ou valores, altera uma configuração de forma atômica, valida o subconjunto compatível e mostra a fonte normalizada completa.

Tabelas se transformam em caminhos pontuados

Uma tabela [database] com host é endereçada como database.host. O parser é voltado a configurações comuns de hospedagem; construções TOML complexas devem ser editadas como texto.

Sintaxe

lil-terminal
toml <file> [key|options] · toml dump <file>

Referência

toml <file>

mostrar dados TOML

toml <file> <key>

mostrar um caminho pontuado exato

toml dump <file>

mostrar o texto-fonte TOML normalizado

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

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

-w <key> : <value>

gravar um valor diretamente no arquivo

-w <key> < <file>

gravar um valor lido de outro arquivo

-d <key>

excluir um valor pelo caminho pontuado

-c

validar o arquivo TOML

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; toml <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.

Escopo do formato

O módulo implementa de propósito o subconjunto de configuração comum em hospedagem compartilhada. Recursos avançados do formato devem ser editados como texto com edit ou code.

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 toml
Pacote Minimum

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

install toml -m
Versão pública exata

Instalar exatamente esta versão publicada.

install toml -v 1.1.5
Verificar ou atualizar

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

upgrade toml
Remover módulo

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

install toml -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 | toml app.toml
application.name      lil-shop
application.debug     true
database.host         localhost
database.port         3306
database.options.0    utf8mb4
database.options.1    strict
Mostrar dados TOML
app.toml
application.name      lil-shop
application.debug     true
database.host         localhost
database.port         3306
database.options.0    utf8mb4
database.options.1    strict
Mostrar um caminho pontuado exato
toml $ database.host
localhost
Toml · find-key
toml $ -f "database*" -k
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Toml · find-value
toml $ -f "strict" -v
database.options.1  strict
Toml · write
toml $ -w database.port : 3307
database.port  3307
Toml · delete
toml $ -d database.port
database.host  localhost
Toml · validate
toml $ -c
Valid TOML
Mostrar o texto-fonte TOML normalizado
toml dump $
[application]
name = "lil-shop"
debug = true

[database]
host = "localhost"
port = 3306
Tratar um arquivo ausente
toml \sandbox\config\missing.toml
Arquivo não encontrado

Arquivo usado neste exemplo: sandbox/config/app.toml

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

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

[database]
host = "localhost"
port = 3306
options = ["utf8mb4", "strict"]

Documentação relacionada

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

Versão pública atual

v1.1.52026-08-14

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