`json`

json はドット区切りパスで入れ子の JSON を読み取り、検索、変更し、値の型を保ちます。書き込み後は文書を検証し、正規化した JSON として保存します。

データバージョン 1.3.5安定版

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/app.jsonname lil-sandbox debug true features.0 files features.1 code features.2 archivesjson $ -cValid JSONjson $ -f "files" -vfeatures.0 files

概要

json はネストした JSON を直接扱います。ドットパスでノードを指定し、キーや値を検索し、文字列または別ファイルの値をアトミックに書き込み、検証して正規化 JSON を確認できます。セッションバッファーは使いません。

パスはノードを選び、型は型のまま残る

テキスト断片ではなく構造を操作します。limits.history は入れ子のノードを選び、-w はそのパスを変更します。: の後が有効な JSON なら数値、真偽値、null、配列、オブジェクトの型を保ちます。

構文

lil-terminal

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

リファレンス

json <file>

JSON データを表示する

json <file> <key>

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

json dump <file>

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

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

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

-w <key> : <value>

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

-w <key> < <file>

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

-d <key>

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

-c

JSON ファイルを検証する

使い方

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

アクティブファイル

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

検索

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

直接編集

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

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

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

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

インストールと管理

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

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

Base パッケージ

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

install json

Minimum パッケージ

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

install json -m

正確な公開版

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

install json -v 1.3.5

確認または更新

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

upgrade json

モジュールを削除

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

install json -u

例

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

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

cd \sandbox\config | json app.json

name             lil-sandbox
debug            true
features.0       files
features.1       code
features.2       archives
limits.upload_mb 2
limits.history   25

JSON データを表示する

app.json

name             lil-sandbox
debug            true
features.0       files
features.1       code
features.2       archives
limits.upload_mb 2
limits.history   25

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

json $ limits.history

Json · find-key

json $ -f "upload" -k

limits.upload_mb  2

Json · find-value

json $ -f "files" -v

features.0  files

Json · write

json $ -w limits.password : "Ed1g!fs:13od"

limits.password  Ed1g!fs:13od

Json · file-value

json $ -w limits.policy < value.json

limits.policy.rotate    true
limits.policy.attempts  5

Json · delete

json $ -d limits.password

limits.upload_mb  2
limits.history    25

Json · validate

json $ -c

Valid JSON

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

json dump $ > json-review.json -r

{
  "name": "lil-sandbox",
  "debug": true,
  "features": ["files", "code", "archives"],
  "limits": {"upload_mb": 2, "history": 25}
}

存在しないファイルを扱う

json \sandbox\config\missing.json

ファイルが見つかりません

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

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

{
  "name": "lil-sandbox",
  "debug": true,
  "features": ["files", "code", "archives"],
  "limits": {
    "upload_mb": 2,
    "history": 25
  }
}

現在の公開版

v1.3.52026-08-11

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

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

# バージョン履歴

json

概要