yml

yml trabalha com um subconjunto YAML compacto para configuração: mappings aninhados, escalares e listas simples podem ser lidos, pesquisados e alterados por caminhos pontuados.

DadosVersão 1.1.6Estável
lil-terminal

Visão geral

yml oferece um fluxo compacto e direto para configurações YAML comuns: caminhos pontuados, busca, alteração ou remoção de um valor, validação do subconjunto compatível e fonte completa com dump.

A indentação se transforma em caminho pontuado

O parser é deliberadamente estrito: tabs e listas em bloco como - item não são suportados. Valide YAML desconhecido com -c; para documentos complexos, use edit ou code.

Sintaxe

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

Referência

yml <file>

mostrar dados YAML

yml <file> <key>

mostrar um caminho pontuado exato

yml dump <file>

mostrar o texto-fonte YAML 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 YAML

Ler, buscar e alterar configurações

Comece com yml config/app.yml 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 mapas indentados e listas no estilo JSON, mas não listas em bloco - item, tabulações, âncoras, aliases, tags ou blocos multilinha. Chaves duplicadas são rejeitadas. A gravação remove comentários e espaçamento original. Para YAML avançado, use edit ou code. Minimum só exibe o arquivo inteiro.

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

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

install yml -m
Versão pública exata

Instalar exatamente esta versão publicada.

install yml -v 1.1.6
Verificar ou atualizar

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

upgrade yml
Remover módulo

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

install yml -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 | yml app.yml
application.name    lil-shop
application.debug   true
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Mostrar dados YAML
yml config/app.yml
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
yml config/app.yml database.host
localhost
Mostrar um caminho pontuado exato
yml config/app.yml database.options.1
strict
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
yml config/app.yml -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
yml config/app.yml -f "strict" -v
database.options.1  strict
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
yml config/app.yml -f "debug"
application.debug  true
Gravar um valor diretamente no arquivo
yml config/app.yml -w application.debug : false
application.debug  false
Gravar um valor lido de outro arquivo
yml config/app.yml -w application.name < config/plain-value.txt
application.name  demo-site
Tratar um arquivo ausente
yml config/app.yml -d database.options.0
application.name    lil-shop
application.debug   true
database.host       localhost
database.port       3306
database.options.0  strict
Validar o arquivo YAML
yml config/app.yml -c
Valid YAML
Mostrar o texto-fonte YAML normalizado
yml dump config/app.yml
application:
  name: lil-shop
  debug: true
database:
  host: localhost
  port: 3306
  options: ["utf8mb4","strict"]
Mostrar um caminho pontuado exato
yml config/app.yml unknown.key
Path not found
Validar o arquivo YAML
yml config/invalid.yml -c
YAML block lists are not supported; use inline JSON-style lists
Mostrar dados YAML
yml config/missing.yml
File not found
Gravar um valor diretamente no arquivo
yml config/app.yml -w database.port
Value required after : or

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

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 yml. yml trabalha com um subconjunto YAML compacto para configuração: mappings aninhados, escalares e listas simples podem ser lidos, pesquisados e alterados por caminhos pontuados.

# Histórico de versões