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.6Está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

Ler, buscar e alterar configurações

Comece com toml config/app.toml para listar as configurações e depois leia database.host. -f busca caminhos e valores, -k apenas chaves e -v apenas valores. A busca simples ignora maiúsculas e minúsculas; * e ? criam máscaras. -c valida a sintaxe e dump mostra o conteúdo reconstruído.

-w <key> : <value> grava imediatamente, -w <key> < <file> lê outro arquivo e -d <key> remove um caminho. Números e true/false podem ser interpretados como tipos. Faça uma cópia antes de gravar. $ identifica o último arquivo aberto no Core; o nome isolado pode acionar o manipulador.

Limites e edição segura

Aceita seções, textos, números, booleanos e listas no estilo JSON. Datas TOML, arrays de tabelas e outros recursos avançados não são suportados; chaves e seções duplicadas são rejeitadas. Gravar recria o texto sem comentários nem formatação. Para TOML complexo, use edit ou code. Minimum só exibe o arquivo.

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.6
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
toml config/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 config/app.toml database.host
localhost
Mostrar um caminho pontuado exato
toml config/app.toml database.options.0
utf8mb4
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
toml config/app.toml -f "database.*" -k
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
toml config/app.toml -f "strict" -v
database.options.1  strict
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
toml config/app.toml -f "debug"
application.debug  true
Gravar um valor diretamente no arquivo
toml config/app.toml -w database.port : 3307
database.port  3307
Gravar um valor lido de outro arquivo
toml config/app.toml -w application.name < config/plain-value.txt
application.name  demo-site
Tratar um arquivo ausente
toml config/app.toml -d application.debug
application.name    lil-shop
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Validar o arquivo TOML
toml config/app.toml -c
Valid TOML
Mostrar o texto-fonte TOML normalizado
toml dump config/app.toml
[application]
name = "lil-shop"
debug = true

[database]
host = "localhost"
port = 3306
options = ["utf8mb4","strict"]
Mostrar um caminho pontuado exato
toml config/app.toml unknown.key
Path not found
Validar o arquivo TOML
toml config/invalid.toml -c
Duplicate TOML key
Mostrar dados TOML
toml config/missing.toml
File not found
Gravar um valor diretamente no arquivo
toml config/app.toml -w database.port
Value required after : or

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.62026-11-01

Refinamento de produção

Versão estável atual de toml. toml lê e altera o subconjunto TOML comum: tabelas, chaves pontuadas, valores escalares e listas simples.

# Histórico de versões