`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.5Estável

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/app.ymlapplication.name lil-shop application.debug true database.host localhost database.port 3306 database.options.0 utf8mb4yml $ -cValid YAMLyml dump $application: name: lil-shop debug: true database: host: localhost

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

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; yml <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 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.5

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

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 $ database.host

localhost

Yml · find-key

yml $ -f "database*" -k

database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict

Yml · find-value

yml $ -f "strict" -v

database.options.1  strict

Yml · write

yml $ -w database.password : "Ed1g!fs:13od"

database.password  Ed1g!fs:13od

Yml · delete

yml $ -d database.password

database.host  localhost
database.port  3306

Yml · validate

yml $ -c

Valid YAML

Mostrar o texto-fonte YAML normalizado

yml dump $

application:
  name: lil-shop
  debug: true
database:
  host: localhost
  port: 3306

Tratar um arquivo ausente

yml \sandbox\config\missing.yml

Arquivo não encontrado

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

yml