yml

yml は設定向けのコンパクトな YAML サブセットを扱います。入れ子のマッピング、スカラー値、単純なリストをドット区切りパスで読み取り、検索、変更できます。

データバージョン 1.1.5安定版
lil-terminal

概要

yml は一般的な YAML 設定をファイル上で直接扱う小さな操作系です。ドットパス、検索、1値の変更・削除、対応サブセットの検証、dump による全ソース確認をまとめます。

インデントをドット区切りパスとして扱う

パーサーは意図的に厳格です。タブと - item 形式のブロックリストは非対応です。見慣れない YAML はまず -c で検証し、複雑な文書には edit または code を使います。

構文

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

リファレンス

yml <file>

YAML データを表示する

yml <file> <key>

ドット区切りの完全一致パスを表示する

yml dump <file>

正規化した YAML ソースを表示する

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

キーまたは値を検索する。* と ? を含む場合はマスクとして扱う

-w <key> : <value>

値をファイルへ直接書き込む

-w <key> < <file>

別ファイルから読み取った値を書き込む

-d <key>

ドット区切りパスの値を削除する

-c

YAML ファイルを検証する

使い方

yml <file> [key|-f|-w|-d|-c] | yml dump <file>

アクティブファイル

現在の core では、正常に開いたファイルをすぐに $ で再利用できます。このモジュールがその拡張子に対するインストール済みハンドラーのうち最優先なら、ファイル名だけを入力してこのコマンドで開けます。これらは core の補助機能であり、明示的な形式は yml <file> のままです。

検索

-f はパスと値を検索します。キーだけなら -k、値だけなら -v を追加します。* または ? を含む検索語はマスクとして扱います。

直接編集

-w は変更を直ちにファイルへ書き込みます。: の後ろに値を直接指定し、< <file> では別ファイルから値を読みます。-d は 1 つのドット区切りパスを削除します。

形式の範囲

このモジュールは共有ホスティングで一般的な設定形式の範囲を意図的に実装します。高度な形式機能は暗黙に解釈せず、edit または code でテキストとして編集してください。

インタラクティブな sandbox プレビュー

用意された例をページ上でそのまま実行できます。結果は事前に生成されてブラウザに表示され、サーバーではターミナルコマンドを実行しません。

ファイルを開いて $ で再利用する

インストールと管理

現在の互換バージョンをインストールします。全機能は Base、縮小版は Minimum を選び、すでに導入済みのモジュール更新には upgrade を使います。

Base と Minimum は同じ現在のモジュールリリースの二つのパッケージです。

Base パッケージ

ローカル参照と公開済みの全モードを含む完全パッケージをインストールします。

install yml
Minimum パッケージ

縮小パッケージをインストールします。ローカルリファレンスは含まれず、help <cmd> -i で現在のサーバーリファレンスを開きます。

install yml -m
正確な公開版

この公開済みバージョンを正確に指定してインストールします。

install yml -v 1.1.5
確認または更新

upgrade が互換性を確認し、必要な場合だけブロックを置換します。

upgrade yml
モジュールを削除

コアや他のモジュールに触れず拡張ブロックを削除します。

install yml -u

例はコピーできますが、サイトは実行しません。実プロジェクトではパス、権限、破壊的オプションを確認してください。

ファイルを開いて $ で再利用する
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
YAML データを表示する
app.yml
application.name      lil-shop
application.debug     true
database.host         localhost
database.port         3306
database.options.0    utf8mb4
database.options.1    strict
ドット区切りの完全一致パスを表示する
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
正規化した YAML ソースを表示する
yml dump $
application:
  name: lil-shop
  debug: true
database:
  host: localhost
  port: 3306
存在しないファイルを扱う
yml \sandbox\config\missing.yml
ファイルが見つかりません

この例で使うファイル: sandbox/config/app.yml

例では、保護されたドキュメント用 /sandbox/ ワークスペースのファイルまたはディレクトリを使います。

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

関連ドキュメント

現在の公開版

v1.1.52026-08-13

構造化データの統一ヘルプ

表示、検索、書き込み、削除、検証を共通のオプション形式に整理しました。