`yml`

yml handles a compact YAML subset for configuration files: nested mappings, scalar values and simple lists can be read, searched and changed through dotted paths.

DataVersion 1.1.5Stable

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

Overview

yml provides a compact file-first workflow for common YAML configuration: inspect dotted paths, search, update or remove one value, validate the supported subset, and keep the full source available with dump.

Indentation becomes a dotted path

The parser is deliberately strict: tabs and block-list rows such as - item are not supported. Validate unfamiliar YAML with -c; complex YAML is better edited with edit or code.

Syntax

lil-terminal

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

Reference

yml <file>

show YAML data

yml <file> <key>

show one exact path or value

yml dump <file>

show normalized source text

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

find matching keys, paths or values

-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 or path

-c

validate the file

Active file

With the current core, a successfully opened file is immediately available as $. If this module is the highest-priority installed handler for the file extension, typing the filename by itself opens it through this command. These are core conveniences; yml <file> remains the explicit form.

Search

-f searches paths and values. Add -k for keys only or -v for values only. Queries containing * or ? are treated as masks.

Direct editing

-w writes immediately to the file. Use : for an inline value or < <file> to read a value from another file. -d deletes one dotted path.

Format scope

This module intentionally implements the common configuration subset used on shared hosting. Advanced format features should be edited textually with edit or code rather than silently reinterpreted.

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 yml

Minimum package

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

install yml -m

Exact public version

Install exactly this published version.

install yml -v 1.1.5

Check or update

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

upgrade yml

Remove module

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

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

application.name      lil-shop
application.debug     true
database.host         localhost
database.port         3306
database.options.0    utf8mb4
database.options.1    strict

Show YAML data

app.yml

application.name      lil-shop
application.debug     true
database.host         localhost
database.port         3306
database.options.0    utf8mb4
database.options.1    strict

Show one exact path or value

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

Show normalized source text

yml dump $

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

Handle a missing file

yml \sandbox\config\missing.yml

File not found

File used in this example: `sandbox/config/app.yml`

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

application:
  name: lil-shop
  debug: true
database:
  host: localhost
  port: 3306
  options: ["utf8mb4", "strict"]

Current public release

v1.1.52026-08-13

Standardized structured-data help

Simplifies YAML help and groups search, write, delete and validation operations as flags.

# Version history

yml