properties

properties lê arquivos .properties no estilo Java como chaves e valores, entende continuação de linha e expõe nomes pontuados como caminhos práticos para busca e edição.

DadosVersão 1.1.6Estável
lil-terminal

Visão geral

properties trabalha diretamente com arquivos Java Properties: lê chaves pontuadas, busca chaves ou valores, altera uma opção de forma atômica, valida o arquivo e mostra a fonte normalizada completa.

O caminho pontuado ainda pertence a um arquivo plano

database.host é prático como caminho, mas o arquivo no disco continua plano. Uma gravação estruturada o normaliza em linhas key=value; use um editor de texto quando comentários e layout exato precisarem ser preservados.

Sintaxe

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

Referência

properties <file>

mostrar os dados properties

properties <file> <key>

mostrar um caminho pontuado exato

properties dump <file>

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

Ler, buscar e alterar configurações

Comece com properties config/app.properties 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 pares com = ou :, comentários #/! e continuação de linhas; pontos formam caminhos. Na leitura, os valores são texto, inclusive true ou 3306. Não é uma implementação completa de Java Properties: escapes e Unicode podem mudar na gravação, e comentários são removidos. 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 properties
Pacote Minimum

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

install properties -m
Versão pública exata

Instalar exatamente esta versão publicada.

install properties -v 1.1.6
Verificar ou atualizar

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

upgrade properties
Remover módulo

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

install properties -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 | properties app.properties
application.name   lil-shop
application.debug  true
database.host      localhost
database.port      3306
Mostrar os dados properties
properties config/app.properties
application.name   lil-shop
application.debug  true
database.host      localhost
database.port      3306
Mostrar um caminho pontuado exato
properties config/app.properties database.host
localhost
Mostrar um caminho pontuado exato
properties config/app.properties application.debug
true
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
properties config/app.properties -f "database.*" -k
database.host  localhost
database.port  3306
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
properties config/app.properties -f "localhost" -v
database.host  localhost
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
properties config/app.properties -f "debug"
application.debug  true
Gravar um valor diretamente no arquivo
properties config/app.properties -w database.port : 3307
database.port  3307
Gravar um valor lido de outro arquivo
properties config/app.properties -w application.name < config/plain-value.txt
application.name  demo-site
Tratar um arquivo ausente
properties config/app.properties -d application.debug
application.name  lil-shop
database.host     localhost
database.port     3306
Validar o arquivo properties
properties config/app.properties -c
Valid properties
Mostrar o texto-fonte properties normalizado
properties dump config/app.properties
application.name=lil-shop
application.debug=true
database.host=localhost
database.port=3306
Mostrar um caminho pontuado exato
properties config/app.properties unknown.key
Path not found
Validar o arquivo properties
properties config/duplicate.properties -c
Duplicate properties key
Mostrar os dados properties
properties config/missing.properties
File not found
Gravar um valor diretamente no arquivo
properties config/app.properties -w database.port
Value required after : or

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

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

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

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 properties. properties lê arquivos `.

# Histórico de versões