attr

移植可能なファイルメタデータと拡張属性を読み取り、利用可能な xattr は書き込みや削除もできます。

ファイルバージョン 1.3.1安定版
lil-terminal

概要

attr は環境が違ってもメタデータを扱いやすくします。ローカライズされたラベルは読みやすいまま、安定した英語キーを直接参照でき、実際の xattr キーは別の書き込み可能領域として扱います。

ファイルと一緒に残るメタデータ

ホスティング環境をまたいで予測可能なメタデータが必要なら、まずポータブルキーを使い、拡張属性はサーバーが実際に xattr を提供する場合だけ使います。

構文

lil-terminal
attr [path [key]] [-x|-d|-s <value>]

リファレンス

attr

現在のディレクトリの移植可能メタデータを表示

attr <path>

拡張属性キーまたは移植可能メタデータを表示

attr <path> <key>

移植可能フィールドまたは拡張属性値を表示

attr <path> <key> : <value>

拡張属性に生テキストを設定

-x

選択した値を16進数で表示

-s <value>

拡張属性にテキスト値を設定

-d

拡張属性を削除

使い方

attr [path [key]] [-x|-d|-s <value>]

移植可能フィールド

安定したキーは path、type、permissions、access、size、mime、dimensions、modified です。これらは読み取り専用で、すべての表示言語で英語のマシン名を維持します。size、mime、dimensions は選択したパスに適用できる場合だけ表示されます。同じ単純名の拡張属性より移植可能キーを優先し、user.note のような名前空間付き xattr キーは曖昧になりません。

拡張属性

xattr がサポートされている場合、attr <path> は実際のファイルシステムキーを一覧表示します。読み取り、16進数表示、書き込み、削除は引き続きそれらの実キーを使います。移植可能メタデータは、xattr のないホスティングで書き込み機能があるようには見せません。

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

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

ファイルのメタデータを確認

.xml 拡張子はファイルシステム検査の内容を変えません。MIME 情報は PHP が正しく判定できた場合だけ追加されます。

インストールと管理

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

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

Base パッケージ

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

install attr
Minimum パッケージ

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

install attr -m
正確な公開版

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

install attr -v 1.3.1
確認または更新

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

upgrade attr
モジュールを削除

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

install attr -u

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

ファイルのメタデータを確認
cd \sandbox | attr feed.xml | attr feed.xml permissions
feed.xml
path         feed.xml
type         file
permissions  0644
size         1.3 KB
mime         application/xml

permissions  0644

.xml 拡張子はファイルシステム検査の内容を変えません。MIME 情報は PHP が正しく判定できた場合だけ追加されます。

1つのメタデータ項目を読む
attr sandbox/feed.xml permissions
0644

画像として認識された場合、同じポータブルなファイルメタデータにピクセル寸法が追加されます。

独自メタデータ項目を書き込む
attr sandbox/feed.xml user.note : reviewed
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes

ディレクトリは独自のファイルシステム種別を保持し、ファイル専用のサイズ、MIME、画像情報は表示しません。

独自メタデータ項目を読む
attr sandbox/feed.xml user.note
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes
メタデータをファイルへ保存
attr sandbox/feed.xml > attr.log
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes
存在しないパスを処理
attr \sandbox\missing.txt
パスが見つかりません

この例で使うファイル: sandbox/feed.xml

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

<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <title>lil-sandbox</title>
  <entry id="1">Example XML content</entry>
</feed>

関連ドキュメント

現在の公開版

v1.3.12026-08-14

明確な属性値構文

拡張属性の値設定を : に変更し、可搬メタデータ項目は読み取り専用のまま維持します。これにより > はシステム全体で一つの意味だけを持ちます。