properties

properties は Java 形式の .properties をキーと値として読み、行継続を理解し、ドットを含む名前を検索や部分編集に便利なパスとして扱います。

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

概要

properties は Java Properties ファイルを直接扱います。ドット形式のキーを読み、キーや値を検索し、1設定をアトミックに変更して検証し、正規化した全ソースを確認できます。

ドット区切りパスでもファイルはフラットなまま

database.host はパスとして便利ですが、ディスク上のファイルはフラットなままです。構造化書き込みでは key=value 行へ正規化されるため、コメントや厳密な配置を残す場合はテキストエディタを使います。

構文

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

リファレンス

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

Find and change Java-style key/value settings, while respecting the limits of the compact properties parser.

コマンド一覧

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

properties <file>

properties データを表示

properties <file> <key>

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

properties dump <file>

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

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

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

-w <key> : <value>

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

-w <key> < <file>

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

-d <key>

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

-c

properties ファイルを検証する

設定の確認・検索・変更

まず properties config/app.properties で設定の一覧を表示し、database.host で値を確認します。-f はキーと値、-k はキーのみ、-v は値のみを検索します。通常の文字列は大文字小文字を区別せず、* と ? はワイルドカードです。-c は構文の検査、dump は再生成したテキストの表示です。

-w <key> : <value> はすぐに保存し、-w <key> < <file> は別ファイルから値を読み込み、-d <key> は指定したパスを削除します。数値や true/false は型付きの値として解釈される場合があります。更新前にバックアップを作成してください。$ は Core で最後に開いたファイルを指し、ファイル名だけでも登録済みの処理を呼び出せます。

対応範囲と安全な編集

= または : による設定、#/! コメント、行の継続に対応し、ドット付きキーをパスとして扱います。読み込んだ値はすべて文字列です。Java Properties の完全実装ではないため、エスケープや Unicode 表記を保持できない場合があり、書き込みでコメントが消えます。Minimum は表示のみです。

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

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

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

インストールと管理

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

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

Base パッケージ

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

install properties
Minimum パッケージ

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

install properties -m
正確な公開版

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

install properties -v 1.1.6
確認または更新

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

upgrade properties
モジュールを削除

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

install properties -u

例

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

ファイルを開いて $ で再利用する
cd \sandbox\config | properties app.properties
application.name   lil-shop
application.debug  true
database.host      localhost
database.port      3306
Properties データを表示
properties config/app.properties
application.name   lil-shop
application.debug  true
database.host      localhost
database.port      3306
ドット区切りの完全一致パスを表示する
properties config/app.properties database.host
localhost
ドット区切りの完全一致パスを表示する
properties config/app.properties application.debug
true
キーまたは値を検索する。* と ? を含む場合はマスクとして扱う
properties config/app.properties -f "database.*" -k
database.host  localhost
database.port  3306
キーまたは値を検索する。* と ? を含む場合はマスクとして扱う
properties config/app.properties -f "localhost" -v
database.host  localhost
キーまたは値を検索する。* と ? を含む場合はマスクとして扱う
properties config/app.properties -f "debug"
application.debug  true
値をファイルへ直接書き込む
properties config/app.properties -w database.port : 3307
database.port  3307
別ファイルから読み取った値を書き込む
properties config/app.properties -w application.name < config/plain-value.txt
application.name  demo-site
存在しないファイルを扱う
properties config/app.properties -d application.debug
application.name  lil-shop
database.host     localhost
database.port     3306
Properties ファイルを検証する
properties config/app.properties -c
Valid properties
正規化した properties ソースを表示する
properties dump config/app.properties
application.name=lil-shop
application.debug=true
database.host=localhost
database.port=3306
ドット区切りの完全一致パスを表示する
properties config/app.properties unknown.key
Path not found
Properties ファイルを検証する
properties config/duplicate.properties -c
Duplicate properties key
Properties データを表示
properties config/missing.properties
File not found
値をファイルへ直接書き込む
properties config/app.properties -w database.port
Value required after : or

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

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

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

関連ドキュメント

モジュールをインストールするには？ →「command not found」と表示されるのはなぜですか？ →

現在の公開版

v1.1.62026-11-01

プロダクション向け調整

properties の現在の安定版。properties は Java 形式の `.

# バージョン履歴