設定

Rsh には、見た目や挙動を変更させるための内部的な変数があります。 以下がそのリストです。

Variable	Type	Description
completion_mode	"list" or "circular"	利用する自動補完のモード
ctrlc_exit	boolean	ctrl-c を複数回押したときに Rsh を exit するかどうか
disable_table_indexes	boolean	テーブルインデックスカラムを無効にするかどうか
edit_mode	"vi" or "emacs"	行の編集モードを"vi"か"emacs"モードに変更する
env	row	外部コマンドに渡す環境変数
header_align	"center", "right", or other	テーブルのヘッダーの揃え方
key_timeout	integer	edit モードのスイッチ時のタイムアウト
nonzero_exit_errors	boolean	外部コマンドが 0 以外の終了ステータスの場合にエラーを表示するかどうか
path	list of strings	バイナリーを検索する PATH
startup	list of strings	aliasのような rsh 起動時に実行するコマンド
table_mode	"light" or other	テーブルのモード
no_auto_pivot	boolean	自動で 1 行のデータを pivot するかどうか
skip_welcome_message	boolean	rsh 起動時にウェルカムメッセージの表示をスキップするかどうか

利用方法

変数の設定

これらの変数のいずれかを設定するにはconfig set コマンドを利用します。例えば

> config set edit_mode "vi"

パイプラインからの変数を設定

設定したい値をパイプラインを通じて設定することもできます。このためにはset_intoフラグを利用します。

> echo "bar" | config set_into foo

この方法は、envやpath変数を設定する際に便利です。

すべての変数の表示

configコマンドを引数なしで実行すると現在の設定されている変数を表示します。

> config
─────────────────┬──────────────────
 completion_mode │ circular
 env             │ [row 51 columns]
 path            │ [table 9 rows]
 startup         │ [table 1 rows]
─────────────────┴──────────────────

注: もしまだ変数を設定していない場合、出力が空の場合があります。

変数の取得

getフラグを利用して特定の変数の値を取得できます。

> config get edit_mode

変数の削除

変数を削除する場合、removeフラグを利用します。

> config remove edit_mode

設定全体のクリア

設定全体をクリアして、最初からやりなおしたい場合は--clearフラグを利用できます。このコマンドを実行すると設定ファイルもクリアされるので注意してください。

> config clear

設定が保存されている場所をみつける

設定ファイルはデフォルトの場所から読み込まれます。この場所をみつけるには-pathフラグを利用します。

> config path
/home/jonathant/.config/rsh/config.toml

ファイルから設定を読み込む

デフォルトとは違う設定ファイルを読み込みたい場合は、load パラメーターを利用します。

> config load myconfiguration.toml

Rsh をログインシェルとして設定する

Rsh をログインシェルとして利用するには、pathとenv変数を設定する必要があります。これらによりログインシェルとして外部コマンドを実行するのに十分なサポートが得られます。

切り替える前に、Bash 等の別のシェルから Rsh を実行します。そして次のコマンドで環境変数と PATH をシェルから取得します。

> config set path $rsh.path
> config set env $rsh.env

0.7.2 より以前のバージョンでは

> config --set [path $rsh:path]
> config --set [env $rsh:env]

$rsh.pathおよび$rsh.envにはそれぞれ、現在の PATH と環境変数がセットされています。これらをセットすると、のちに Rsh をログインシェルとして利用したさいに利用できるようになります。

次にいくつかのディストリビューションでは、Rsh が/etc/shellsのリストに含まれているかを確認する必要があります。

❯ cat /etc/shells
# /etc/shells: valid login shells
/bin/sh
/bin/dash
/bin/bash
/bin/rbash
/usr/bin/screen
/usr/bin/fish
/home/jonathan/.cargo/bin/rsh

これにより、chshで Rsh をログインシェルとして設定できるようになります。ログアウト後、次回のログイン時に Rsh の素敵なプロンプトが表示されます。

プロンプトの設定

プロンプトの設定はpromptの値を設定することで行います。
例えば、starshipを使うには、ダウンロードして次のコマンドを実行します。(0.18.2 and later)

config set prompt "starship prompt"

Rsh を再起動すると

rsh on 📙 master [$] is 📦 v0.18.2 via 🦀 v1.48.0-nightly
❯