mprocs

mprocs

MPROCSは複数のコマンドを並行して実行し、各コマンドの出力を個別に表示します。

プロジェクトに取り組むときは、実行するために同じコマンドのリストが必要になることが非常によくあります。例： webpack serve 、 jest --watch 、 node src/server.js 。 MPROCSを使用すると、これらのコマンドをmprocs.yamlにリストし、 mprocsを実行してすべてを実行できます。次に、実行中のコマンドの出力を切り替えて、それらと対話できます。

同時に似ていますが、 MPROCSは各コマンドの出力を個別に表示し、プロセスと対話することができます（ MPROCS内のVIMでも作業できます）。

• スクリーンショット
• インストール
  • バイナリ（Linux、Macos、Windows）をダウンロードする
  • NPM（Linux、MacOS、Windows）
  • Homebrew（macos）
  • 貨物（すべてのプラットフォーム）
  • スクープ（Windows）
  • aur（arch linux）
  • MPR（Debian/Ubuntu）
• 使用法
  • config
    • キーマップ
    • $選択オペレーター
    • package.jsonからスクリプトを実行します
  • デフォルトのキーマップ
  • リモートコントロール
• よくある質問
  • MPROCS対TMUX/画面

スクリーンショット

インストール

バイナリ（Linux、Macos、Windows）をダウンロードする

プラットフォームの実行可能ファイルをダウンロードし、パスに含まれるディレクトリに入れます。

NPM（Linux、MacOS、Windows）

npm install -g mprocs

yarn global add mprocs

Homebrew（Macos、Linux）

brew install mprocs

貨物（すべてのプラットフォーム）

cargo install mprocs

スクープ（Windows）

scoop install mprocs

aur（arch linux）

yay mprocs

yay mprocs-bin

MPR（Debian/Ubuntu）

git clone ' https://mpr.makedeb.org/mprocs '
cd mprocs/
makedeb -si

使用法

1. mprocs cmd1 cmd2 … （例： mprocs "yarn test -w" "webpack serve" ））

または

1. mprocs.yamlファイルを作成します
2. mprocsコマンドを実行します

例mprocs.yaml ：

 procs :
  nvim :
    cmd : ["nvim"]
  server :
    shell : " nodemon server.js "
  webpack : " webpack serve "
  tests :
    shell : " jest -w "
    env :
      NODE_ENV : test

config

JSON/YAML構成スキーマ

グローバルとローカルの2種類の構成があります。グローバル構成は~/.config/mprocs/mprocs.yaml （または~AppDataRoamingmprocsmprocs.yaml ）からロードされます。ローカル構成は、 mprocs.yamlから現在のディレクトリからロードされます（またはCLI引数を介して設定されています： mprocs --config ./cfg/mprocs.yaml ）。ローカル構成の設定は、グローバルをオーバーライドします。

• procs ：オブジェクト- 実行するプロセス。ローカル構成でのみ許可されています。
  • シェル： string -shellコマンドを実行する（シェルまたはCMDの1つを提供する必要があります）。
  • CMD ：配列- 実行するコマンドとARGの配列（シェルまたはCMDの1つを提供する必要があります）。
  • CWD ：文字列- プロセスの作業ディレクトリを設定します。 prefix <CONFIG_DIR> 、構成が配置されているディレクトリのパスに置き換えられます。
  • env ： object <string、string | null> - env変数を設定します。オブジェクトキーは変数名です。変数をnullに割り当て、親プロセスから継承された変数をクリアします。
  • add_path ： string | array-パス環境変数にエントリを追加します。
  • AutoStart ： bool- MPROCSが起動したときにプロセスを開始します。デフォルト： true 。
  • Autorestart ： Bool -Exedを再起動します。デフォルト：false。注：プロセスが開始から1秒以内に終了した場合、再起動しません。
  • 停止： 「sigint」| "sigterm" | "sigkill" | {send-keys：array} | "hard-kill" - プロセスを停止する方法（ xキーを使用するか、mprocsを終了するとき）。
• hide_keymap_window ： bool-キーバインディングを示す画面の下部にあるペインを非表示にします。
• mouse_scroll_speed ： integer- 1つのマウススクロールをスクロールする線の数。
• スクロールバック：整数- スクロールバックサイズ。デフォルト： 1000 。
• proc_list_width ： integer-プロセスリストウィンドウ幅。
• keymap_procs ：オブジェクト- プロセスリストのキーバインディング。キーマップを参照してください。
• keymap_term ：オブジェクト- 端子ウィンドウのキーバインディング。キーマップを参照してください。
• keymap_copy ：オブジェクト- コピーモードのキーバインディング。キーマップを参照してください。

キーマップ

デフォルトのキーバインディングは、 keymap_procs 、 keymap_term 、またはkeymap_copyフィールドを使用して構成でオーバーライドできます。利用可能なコマンドは、リモートコントロールセクションに文書化されています。

3つのキーマップレベルがあります。

• デフォルトのキーマップ
• ~/.config/mprocs/mprocs.yaml （または~AppDataRoamingmprocsmprocs.yaml on windows）
• ./mprocs.yaml - configcli argによってオーバーライドできます）

低いレバーは、以前のレベルからバインディングをオーバーライドします。以前のレベルからのキーバインディングは、キーと同じレベルのreset: trueフィールドを指定することでクリアできます。

キーバインディングは、 < 、eg、 <Enter> （ >キー）、 <Down> （down矢印）、 <Up> （up矢印）、 <Cq> （ctrl + q）の間で定義されます。

 keymap_procs : # keymap when process list is focused
  <C-q> : { c: toggle-focus }
  <C-a> : null # unbind key
keymap_term : # keymap when terminal is focused
  reset : true
  <C-q> : { c: toggle-focus }
  <C-j> :
    c : batch
    cmds :
      - { c: focus-procs }
      - { c: next-proc } 

$selectオペレーター

現在のオペレーティングシステムに応じて、異なる値を定義できます。構成の任意の値は、$ selectオペレーターでラップできます。現在のOSに基づいて異なる値を提供するには、次のオブジェクトを定義します。

• 最初のフィールド$select: os
• 異なるOSの値を定義するフィールド： macos: value 。可能な値は、https：//doc.rustlang.org/std/env/consts/constant.os.htmlにリストされています。
• フィールド$else: default value一致します。現在のOSが一致しておらず、フィールド$elseが欠落している場合、MPROCSは構成のロードに失敗します。

例mprocs.yaml ：

 procs :
  my process :
    shell :
      $select : os
      windows : " echo %TEXT% "
      $else : " echo $TEXT "
    env :
      TEXT :
        $select : os
        windows : Windows
        linux : Linux
        macos : Macos
        freebsd : FreeBSD 

package.jsonからスクリプトを実行します

--npm引数でMPROCSを実行すると、 package.jsonからスクリプトをロードします。ただし、スクリプトはデフォルトで実行されるわけではなく、目的のスクリプトを手動で起動できます。

 # Run mprocs with scripts from package.json
mprocs --npm

デフォルトのキーマップ

プロセスリストの焦点：

• q -QUIT（ソフトキルプロセスと終了を待ちます）
• Q強制終了（プロセスを終了）
• Caフォーカス出力ペイン
• xソフトキル選択プロセス（Sigterm Signal、Windowsでハードキルを送信）
• Xハードキル選択プロセス（Sigkillを送信）
• s実行されていない場合、選択したプロセスを開始します
• r選択したプロセスをソフトキルして、停止したら再起動します
• R選択したプロセスをハードキルして、停止したときに再起動します
• a新しいプロセスを追加します
• C選択したプロセスを複製します
• d選択したプロセスを削除します（プロセスを最初に停止する必要があります）
• e選択したプロセスを変更します
• kまたは↑ - 以前のプロセスを選択します
• jまたは↓ - 次のプロセスを選択します
• M-1 - M-8プロセス1-8を選択します
• Cdまたはpage down - 下にスクロールします
• Cuまたはpage up - 出力をスクロールします
• Ce出力を3行下にスクロールします
• Cyスクロール出力は3行上になります
• z端子ウィンドウにズームします
• vコピーモードを入力します

プロセス出力に焦点を当てます：

• Caフォーカスプロセスペイン

コピーモード：

• vエンドポイントの選択を開始します
• c選択したテキストをコピーします
• Escコピーモードを残します
• Caフォーカスプロセスペイン
• Cdまたはpage down - 下にスクロールします
• Cuまたはpage up - 出力をスクロールします
• Ce出力を3行下にスクロールします
• Cyスクロール出力は3行上になります
• hまたは↑ - カーソルを上に移動します
• lまたは→ - カーソルを右に移動します
• jまたは↓ - カーソルを下に移動します
• hまたは← - カーソルを左に移動します

リモートコントロール

オプションで、 MPROCSはTCPポートでリモートコマンドをリッスンできます。 mprocs.yaml （ server: 127.0.0.1:4050 ）またはCLI引数（ mprocs --server 127.0.0.1:4050 ）でリモートコントロールサーバーアドレスを定義する必要があります。 MPROCSインスタンスの実行にコマンドを送信するには、 CTL引数を使用します。MPROCS mprocs --ctl '{c: quit}'またはmprocs --ctl '{c: send-key, key: <Cc>}' 。

コマンドはYAMLとしてエンコードされます。利用可能なコマンド：

• {c: quit-or-ask} - プロセスを停止して終了します。プロセスが実行されている場合は、確認ダイアログを表示します。
• {c: quit} - プロセスを停止して終了します。ダイアログの確認は表示されません。
• {c: force-quit}
• {c: toggle-focus} - プロセスリストと端末の間に焦点を合わせます。
• {c: focus-procs} - フォーカスプロセスリスト
• {c: focus-term} - フォーカスプロセス端子ウィンドウ
• {c: zoom} - 端子ウィンドウにズームします
• {c: next-proc}
• {c: prev-proc}
• {c: select-proc, index: <PROCESS INDEX>} - インデックスごとにプロセスを選択し、トッププロセスにはインデックス0があります
• {c: start-proc}
• {c: term-proc}
• {c: kill-proc}
• {c: restart-proc}
• {c: force-restart-proc}
• {c: show-add-proc}
• {c: add-proc, cmd: "<SHELL COMMAND>"}
• {c: duplicate-proc}
• {c: show-remove-proc}
• {c: remove-proc, id: "<PROCESS ID>"}
• {c: show-rename-proc}
• {c: rename-proc, name: "<NEW_NAME>"} - 現在選択されているプロセスを変更します
• {c: scroll-down}
• {c: scroll-up}
• {c: scroll-down-lines, n: <COUNT>}
• {c: scroll-up-lines, n: <COUNT>}
• {c: copy-mode-enter} - コピーモードを入力します
• {c: copy-mode-leave} - コピーモードを残します
• {c: copy-mode-move, dir: <DIRECTION> } - 選択の開始位置または終了位置を移動します。利用可能な方向： up/right/down/left 。
• {c: copy-mode-end} - 選択のエンドポイントの選択を開始します。
• {c: copy-mode-copy} - 選択したテキストをクリップボードにコピーしてコピーモードを残します。
• {c: send-key, key: "<KEY>"} - 現在のプロセスにキーを送信します。重要な例： <Ca> 、 <Enter>
• {c: batch, cmds: [{c: focus-procs}, …]} - 複数のコマンドを送信

よくある質問

MPROCS対TMUX/画面

MPROCSは、コンパイラやテストランナーなど、繰り返し実行する特定のコマンドを簡単に実行できるようにすることを目的としています。これは、通常、各ウィンドウ/ペインではるかに長寿命のプロセス（通常はシェル）を実行するために使用されるTMuxとは対照的です。もう1つの違いは、 TMUXがサーバーとクライアントを実行することです。これにより、クライアントは後でプロセスを実行し続けることができます。 MPROCSは、再ランニングを続ける有限の生涯プロセスの方が意図されていますが、 MPROCSが終了すると、プロセスがウィンドウ内で実行されています。

TMUXではコピーが機能しません

TMUXには、デフォルトで有効になっているコピーのエスケープシーケンスがありません。次のものを~/.tmux.confに追加できるようにするには：

 set -g set-clipboard on