`json`

json lê, pesquisa e altera JSON aninhado por caminhos pontuados, preservando os tipos dos valores. Depois de uma gravação, o documento é validado e salvo como JSON normalizado.

DadosVersão 1.3.5Estável

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/app.jsonname lil-sandbox debug true features.0 files features.1 code features.2 archivesjson $ -cValid JSONjson $ -f "files" -vfeatures.0 files

Visão geral

json trabalha diretamente com JSON aninhado: acessa nós por caminhos pontuados, busca chaves ou valores, grava atomicamente um valor literal ou vindo de arquivo, valida o documento e mostra JSON normalizado sem buffer de sessão.

O caminho seleciona um nó e o tipo é preservado

O comando trabalha com a estrutura, não com um trecho de texto. limits.history aponta para um nó aninhado, -w altera esse caminho e valores JSON válidos após : continuam como número, booleano, null, array ou objeto.

Sintaxe

lil-terminal

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

Referência

json <file>

mostrar dados JSON

json <file> <key>

mostrar um caminho pontuado exato

json dump <file>

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

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; json <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 json

Pacote Minimum

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

install json -m

Versão pública exata

Instalar exatamente esta versão publicada.

install json -v 1.3.5

Verificar ou atualizar

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

upgrade json

Remover módulo

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

install json -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 | json app.json

name             lil-sandbox
debug            true
features.0       files
features.1       code
features.2       archives
limits.upload_mb 2
limits.history   25

Mostrar dados JSON

app.json

name             lil-sandbox
debug            true
features.0       files
features.1       code
features.2       archives
limits.upload_mb 2
limits.history   25

Mostrar um caminho pontuado exato

json $ limits.history

Json · find-key

json $ -f "upload" -k

limits.upload_mb  2

Json · find-value

json $ -f "files" -v

features.0  files

Json · write

json $ -w limits.password : "Ed1g!fs:13od"

limits.password  Ed1g!fs:13od

Json · file-value

json $ -w limits.policy < value.json

limits.policy.rotate    true
limits.policy.attempts  5

Json · delete

json $ -d limits.password

limits.upload_mb  2
limits.history    25

Json · validate

json $ -c

Valid JSON

Mostrar o texto-fonte JSON normalizado

json dump $ > json-review.json -r

{
  "name": "lil-sandbox",
  "debug": true,
  "features": ["files", "code", "archives"],
  "limits": {"upload_mb": 2, "history": 25}
}

Tratar um arquivo ausente

json \sandbox\config\missing.json

Arquivo não encontrado

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

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

{
  "name": "lil-sandbox",
  "debug": true,
  "features": ["files", "code", "archives"],
  "limits": {
    "upload_mb": 2,
    "history": 25
  }
}

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

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

json