mprocs下載mprocs源代碼下載

mprocs

其他源碼

v0.7.1

下載

mprocs

MPROC並行運行多個命令，並分別顯示每個命令的輸出。

當您從事項目時，您通常需要運行相同的命令列表。例如： webpack serve ， jest --watch ， node src/server.js 。使用MPROC，您可以在mprocs.yaml中列出這些命令，並通過運行mprocs運行所有命令。然後，您可以在運行命令的輸出之間切換並與它們進行交互。

它類似於並發，但MPROCS分別顯示每個命令的輸出，並允許與進程進行交互（您甚至可以在MPROC內部的VIM中工作）。

屏幕截圖
安裝
- 下載二進制（Linux，MacOS，Windows）
- NPM（Linux，MacOS，Windows）
- 自製（MacOS）
- 貨物（所有平台）
- 勺（Windows）
- AUR（Arch Linux）
- MPR（Debian/Ubuntu）
用法
- config
  - keymap
  - $選擇操作員
  - 從package.json運行腳本
- 默認的keymap
- 遙控
常問問題
- MPROC與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

用法

運行mprocs cmd1 cmd2 … （示例： mprocs "yarn test -w" "webpack serve" ）

或者

創建mprocs.yaml文件
運行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配置模式

有兩種配置：全球和本地。全局配置是從~/.config/mprocs/mprocs.yaml （or〜 ~AppDataRoamingmprocsmprocs.yaml ）加載的。本地配置是從mprocs.yaml加載的（或通過CLI參數設置： mprocs --config ./cfg/mprocs.yaml ）。本地配置中的設置覆蓋設置全局。

PROCS ：對象- 運行的過程。僅在本地配置中允許。
- shell ：字符串- 要運行的shell命令（必須提供Shell或CMD之一）。
- CMD ：數組- 運行的命令和args數組（必須提供Shell或CMD之一）。
- CWD ：字符串- 為該過程設置工作目錄。前綴<CONFIG_DIR>將被替換為配置所在的目錄的路徑。
- env ：對象<字符串，字符串| null> - 設置env變量。對象鍵是可變名稱。將變量分配給null，以清除從父進程繼承的變量。
- add_path ：字符串|數組- 將條目添加到路徑環境變量。
- AutoStart ： Bool- MPROC啟動時開始過程。默認值： true 。
- Autorestart ： Bool-退出時重新啟動過程。默認值：false。注意：如果過程在啟動後1秒內退出，則不會重新啟動。
- 停止： “ sigint” |“ sigterm” |“ sigkill” | {send-keys：array} |“ hard-kill” - 一種停止進程的方法（使用x鍵或退出Mprocs時）。
hide_keymap_window ： bool-將窗格隱藏在屏幕底部顯示鑰匙綁定。
Mouse_scroll_speed ：整數- 滾動器一條鼠標滾動的行數。
滾動：整數- 滾動尺寸。默認值： 1000 。
proc_list_width ：整數- 過程列表窗口寬度。
KEYMAP_PROCS ：對象- 過程列表的鍵綁定。參見Keymap。
keymap_term ：對象- 終端窗口的鍵綁定。參見Keymap。
keymap_copy ：對象- 複製模式的鍵綁定。參見Keymap。

keymap

默認的鍵綁定可以在使用KeyMap_procs ， KeyMap_term或KeyMap_Copy字段中覆蓋。可用命令記錄在遠程控制部分。

有三個Keymap級別：

默認的keymaps
~/.config/mprocs/mprocs.yaml （or〜 ~AppDataRoamingmprocsmprocs.yaml在Windows上）
./mprocs.yaml （可以被-c/ - config cli arg覆蓋）

較低的槓桿從以前的水平覆蓋綁定。可以通過指定reset: true字段來清除以前級別的鑰匙綁定。

密鑰綁定是在<和>之間定義的，例如，例如， <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`操作員

您可以根據當前操作系統定義不同的值。配置中的任何值都可以用$選擇的操作員包裝。基於當前OS提供不同的值，用以下方式定義一個對象：

第一個字段$select: os
定義不同OS值的字段： macos: value 。可能的值在此處列出：https：//doc.rust-lang.org/std/env/consts/constant.os.html。
字段$else: default value 。如果當前的操作系統不匹配並且缺少字段$else ，則MPROC將無法加載配置。

示例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參數運行MPROC ，它將從package.json加載腳本。但是這些腳本默認不在運行，您可以手動啟動所需的腳本。

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

默認的keymap

集中流程列表：

q - 退出（軟殺死過程，然後等待退出）
Q - 戒菸（終止過程）
Ca聚焦輸出窗格
x軟殺死選定的過程（發送sigterm信號，窗戶上的硬殺）
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或← - 向左移動光標

遙控

可選， MPROC可以在TCP端口上偵聽遠程命令。您必須在mprocs.yaml中定義遠程控制服務器地址（ server: 127.0.0.1:4050 ）或通過CLI參數（ mprocs --server 127.0.0.1:4050 ）。要發送一個命令運行MPROCS實例，請使用CTL參數： 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}, …]} - 發送多個命令

常問問題

MPROC與TMUX/屏幕

MPROC旨在使運行您最終反復運行的特定命令（例如編譯器和測試跑者）更容易。這與TMUX相反，TMUX通常用於在每個窗口/窗格中運行更長壽的過程（通常是外殼）。另一個區別是TMUX運行服務器和客戶端，該服務器允許客戶端稍後分離和reattach，從而保持流程運行。 MPROC的意義更大，用於您繼續重新運行的有限壽命過程，但是當Mprocs結束時，其在其窗口中運行的過程也是如此。