status - fish の実行時情報を照会する

概要

status
status is-login
status is-interactive
status is-interactive-read
status is-block
status is-breakpoint
status is-command-substitution
status is-no-job-control
status is-full-job-control
status is-interactive-job-control
status current-command
status current-commandline
status filename
status basename
status dirname
status fish-path
status function
status line-number
status stack-trace
status job-control CONTROL_TYPE
status features
status test-feature FEATURE
status build-info
status get-file FILE
status list-files [PATH ...]
status terminal
status test-terminal-feature FEATURE
status language [list-available|set [LANGUAGE ...]|unset]

説明

引数なしで実行すると、 status はシェルの現在のログインおよびジョブ制御ステータスの概要を表示します。

以下の操作(サブコマンド)が利用可能です:

is-command-substitution, -c 、 --is-command-substitution

fish が現在コマンド置換を実行している場合に 0 を返します。

is-block, -b 、 --is-block

fish が現在コードブロックを実行している場合に 0 を返します。

is-breakpoint

fish が現在 breakpoint コマンドのコンテキストでプロンプトを表示している場合に 0 を返します。 fish_breakpoint_prompt 関数も参照してください。

is-interactive, -i 、 --is-interactive

fish が対話モードである(つまり、キーボードに接続されている)場合に 0 を返します。

is-interactive-read 、 --is-interactive-read

fish がキーボードに接続された対話型の read 組み込みコマンドを実行している場合に 0 を返します。

is-login, -l 、 --is-login

fish がログインシェルである(つまり、 PATH の設定などのログインタスクを実行する必要がある)場合に 0 を返します。

is-full-job-control 、 --is-full-job-control

完全なジョブ制御が有効な場合に 0 を返します。

is-interactive-job-control 、 --is-interactive-job-control

対話型ジョブ制御が有効な場合に 0 を返します。

is-no-job-control 、 --is-no-job-control

ジョブ制御が無効な場合に 0 を返します。

current-command

非推奨 _ 変数のように、現在実行中の関数またはコマンドの名前を出力します。

current-commandline

現在実行中のコマンドライン全体(すべてのジョブと演算子を含む)を出力します。

filename, current-filename, -f 、 --current-filename

現在実行中のスクリプトのファイル名を出力します。現在のスクリプトがシンボリックリンク経由で呼び出された場合、シンボリックリンクを返します。現在のスクリプトが source へのパイプで渡された場合、 - を返します。

basename

実行中のスクリプトのファイル名のみを表示し、その前のパスコンポーネントは含めません。

dirname

実際のファイル名を含まず、実行中のスクリプトへのパスのみを表示します。スクリプトの呼び出し方によっては、 PWD からの相対パス(単なる "." を含む)になる場合があります。これは、ファイル名を dirname(3) に渡すのと同じです。現在のスクリプトと同じディレクトリにある他のファイルを使用したい場合などに便利です。

fish-path

現在実行中の fish インスタンスへの絶対パスを表示します。これはベストエフォート(最大限の努力)による試行であり、正確な出力はプラットフォームが fish に提供する情報に依存します。場合によっては、単に "fish" とだけ表示されることもあります。

function 、 current-function

可能であれば現在呼び出されている関数名を表示します。関数でない場合は "Not a function"(またはそれに対応する翻訳された文字列)を表示します。

line-number, current-line-number, -n 、 --current-line-number

現在実行中のスクリプトの行番号を表示します。

stack-trace, print-stack-trace, -t 、 --print-stack-trace

コールスタック上のすべての関数呼び出しのスタックトレースを表示します。

job-control, -j 、 --job-control CONTROL_TYPE

ジョブ制御のタイプを CONTROL_TYPE に設定します。指定できるのは none, full, interactive です。

features

利用可能なすべての 機能フラグ(feature flags) をリスト表示します。

test-feature FEATURE

FEATURE が有効な場合は 0、無効な場合は 1、認識されない場合は 2 を返します。

build-info

fish がどのようにビルドされたかに関する情報(アーキテクチャ、使用されたビルドシステムやプロファイルなど)を表示します。これは主にデバッグに役立ちます。

get-file FILE

注意: このサブコマンドは主に fish の内部利用を目的としています。他の用途で利用したい場合はお知らせください。

コンパイル時に fish バイナリに埋め込まれたファイルを表示します。これにはデフォルトの関数セットや補完、man ページ、テーマが含まれます。どのファイルが含まれるかはビルド設定に依存します。ファイルが含まれていた場合は 0 を、そうでない場合は 1 を返します。

list-files FILE...

注意: このサブコマンドは主に fish の内部利用を目的としています。他の用途で利用したい場合はお知らせください。

コンパイル時に fish バイナリに埋め込まれたファイルをリスト表示します。オプションの FILE 引数で始まるパスのファイルのみが表示されます。何らかの出力があった場合は 0 を、そうでない場合は 1 を返します。

terminal

fish が実行されているターミナルの名前とバージョンを表示します(例: XTVERSION を通じて報告される情報)。これは起動直後には利用できず、最初の対話型プロンプト(組み込みの read によるものを含む)が表示されてから利用可能になります。つまり、最初の fish_prompt 、 fish_read イベント 以前の状態では利用できません。

terminal-os

ターミナルが動作しているオペレーティングシステム(OS) の名前を表示します(XTGETTCAP query-os-name を通じて報告される情報)。 status terminal と同様、最初の対話型プロンプトが表示された後にのみ機能します。OS名が取得できない場合は 1 を返します。

test-terminal-feature FEATURE

ターミナルが指定された機能をサポートしていると 検出 された場合に 0 を返します。 status terminal と同様、最初の対話型プロンプトが表示された後にのみ機能します。

現在利用可能な FEATURE は scroll-content-up のみです。認識できない機能が渡された場合はエラーが表示されます。

language

メッセージのローカライズ設定を表示または変更します。引数なしで実行すると、現在の言語設定が表示されます。

利用可能なサブコマンド:

list-available は fish が翻訳データを持っている言語名を表示します。これらの名前は set サブコマンドで使用できます。

set は fish のメッセージの言語優先順位を設定します。 環境変数 を通じて構成された言語設定を上書きしますが、適用されるのは fish 自体のみで、子プロセスには適用されません。 list-available サブコマンドで表示される言語名のリストを受け取ります。一部の言語では、fish の翻訳カタログが不完全であり、すべてのメッセージを表示できない場合があります。そのため、ここではリストを指定することが可能で、メッセージごとに翻訳が存在する最初の言語が採用されます。例えば、 status language set pt_BR fr を実行すると、ブラジル・ポルトガル語の翻訳があるメッセージはすべてその言語で表示されます。それ以外のメッセージは、フランス語の翻訳があればフランス語で表示されます。指定されたどの言語にも翻訳がない場合は、英語で表示されます。

unset は set サブコマンドによる変更を取り消します。言語設定は再び環境変数から取得されるようになります。

注意

後方互換性のために、ほとんどのサブコマンドはロングまたはショートオプションとして指定することもできます。例えば、 status is-login の代わりに status --is-login と入力できます。ただし、フラグ形式は非推奨であり、将来のリリースで削除される可能性があります。

サブコマンドをフラグ形式で使用する場合でも、一度の実行につき指定できるサブコマンドは1つだけです。