properties

properties reads Java-style .properties files as keys and values, understands continued lines, and exposes dotted names as convenient paths for search and focused edits.

DataVersion 1.1.5Stable
lil-terminal

Overview

properties works directly with Java-style properties files: inspect dotted keys, search keys or values, update one setting atomically, validate the file, and dump normalized source when you need the whole document.

A dotted path still belongs to a flat file

database.host is convenient to address as a path, but the file on disk remains a flat properties file. Structural writes normalize it back to key=value lines, so use a text editor when comments or exact layout must be preserved.

Syntax

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

Reference

properties <file>

show properties data

properties <file> <key>

show one exact dotted path

properties dump <file>

show normalized properties source text

-f <text|mask> [-k|-v]

find matching keys or values; * and ? enable a mask

-w <key> : <value>

write a value directly to the file

-w <key> < <file>

write a value read from another file

-d <key>

delete a value by dotted path

-c

validate the properties file

Interactive sandbox preview

Run the prepared examples directly on the page. Their results are prebuilt and shown in the browser; no terminal command is executed on the server.

Open the file and reuse it with $

Install and manage

Install the current compatible version. Choose Base for the complete feature set or Minimum for the reduced package; use upgrade to update a module that is already installed.

Base and Minimum are two packages of the same current module release, not separate command versions.

Base package

Install the complete package with local command reference and every published mode.

install properties
Minimum package

Install the reduced package. Local reference is omitted; help <cmd> -i opens the current server reference.

install properties -m
Exact public version

Install exactly this published version.

install properties -v 1.1.5
Check or update

Ask upgrade to check compatibility and replace the installed block only when needed.

upgrade properties
Remove module

Remove the extension block while leaving the core and unrelated modules intact.

install properties -u

Examples

Examples are copyable command lines, not actions executed by this website. Review paths, permissions and destructive flags before running them on a real project.

Open the file and reuse it with $
cd \sandbox\config | properties app.properties
application.name   lil-shop
application.debug  true
database.host      localhost
database.port      3306
Show properties data
app.properties
application.name   lil-shop
application.debug  true
database.host      localhost
database.port      3306
Show one exact dotted path
properties $ database.host
localhost
Properties · find-key
properties $ -f "application*" -k
application.name  lil-shop
application.debug  true
Properties · find-value
properties $ -f "localhost" -v
database.host  localhost
Properties · write
properties $ -w database.password : "Ed1g!fs:13od"
database.password  Ed1g!fs:13od
Properties · delete
properties $ -d database.password
database.host  localhost
database.port  3306
Properties · validate
properties $ -c
Valid properties
Show normalized properties source text
properties dump $
application.name=lil-shop
application.debug=true
database.host=localhost
database.port=3306
Handle a missing file
properties \sandbox\config\missing.properties
File not found

File used in this example: sandbox/config/app.properties

The example uses a file or directory from the protected /sandbox/ documentation workspace.

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

Related documentation

How do I install a module? →Why does a command say “command not found”? →

Current public release

v1.1.52026-08-14

Unified properties reference

properties now follows the same compact structured-data reference as the other format handlers.

# Version history