mprocs

Mprocs

MPROCS führt parallel mehrere Befehle aus und zeigt die Ausgabe jedes Befehls separat an.

Wenn Sie an einem Projekt arbeiten, benötigen Sie sehr oft die gleiche Liste von Befehlen, um ausgeführt zu werden. Zum Beispiel: webpack serve , jest --watch , node src/server.js . Mit MPROCs können Sie diesen Befehl in mprocs.yaml auflisten und alle durch Ausführen mprocs ausführen. Dann können Sie zwischen Ausgängen der laufenden Befehle wechseln und mit ihnen interagieren.

Es ähnelt gleichzeitig, aber MPROCs zeigt die Ausgabe jedes Befehls getrennt und ermöglicht es, mit Prozessen zu interagieren (Sie können sogar in VIM in MPROCs arbeiten).

• Screenshots
• Installation
  • Download Binary (Linux, MacOS, Windows)
  • NPM (Linux, macOS, Windows)
  • Homebrew (macOS)
  • Fracht (alle Plattformen)
  • Schaufel (Windows)
  • AUR (Arch Linux)
  • MPR (Debian/Ubuntu)
• Verwendung
  • Konfiguration
    • Keymap
    • $ select operator
    • Ausführen von Skripten von package.json
  • Standard Keymap
  • Fernbedienung
• FAQ
  • MPROCS vs TMUX/Bildschirm

Screenshots

Installation

Download Binary (Linux, MacOS, Windows)

Laden Sie die ausführbare Datei für Ihre Plattform herunter und stellen Sie sie in ein in Path enthaltenes Verzeichnis.

NPM (Linux, macOS, Windows)

npm install -g mprocs

yarn global add mprocs

Homebrew (macOS, Linux)

brew install mprocs

Fracht (alle Plattformen)

cargo install mprocs

Schaufel (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

Verwendung

1. Führen Sie mprocs cmd1 cmd2 … (Beispiel: mprocs "yarn test -w" "webpack serve" )

ODER

1. Erstellen Sie die Datei mprocs.yaml
2. mprocs -Befehl ausführen

Beispiel mprocs.yaml :

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

Konfiguration

JSON/YAML -Konfigurationsschema

Es gibt zwei Arten von Konfigurationen: global und lokal. Die globale Konfiguration wird von ~/.config/mprocs/mprocs.yaml ( ~AppDataRoamingmprocsmprocs.yaml unter Windows) geladen. Die lokale Konfiguration wird aus mprocs.yaml aus dem aktuellen Verzeichnis geladen (oder über CLI -Argument festgelegt: mprocs --config ./cfg/mprocs.yaml ). Einstellungen in den lokalen Konfigurationsüberschreibungen Einstellungen der globalen Einstellungen.

• Procs : Objekt - Prozesse zum Ausführen. Nur in lokaler Konfiguration erlaubt.
  • Shell : String - Shell -Befehl zum Ausführen (genau eines von Shell oder CMD muss bereitgestellt werden).
  • CMD : Array - Array von Befehl und Args zum Ausführen (genau eines von Shell oder CMD muss bereitgestellt werden).
  • CWD : String - Setzen Sie das Arbeitsverzeichnis für den Prozess. Präfix <CONFIG_DIR> wird durch den Pfad des Verzeichnisses ersetzt, in dem sich die Konfiguration befindet.
  • Env : Object <String, String | NULL> - Setzen Sie Env Variablen. Objektschlüssel sind variable Namen. Weisen Sie NULL Variable zu, um Variablen zu löschen, die aus dem Elternprozess geerbt wurden.
  • Add_Path : String | Array - Fügen Sie der Pfadumgebungsvariable Einträge hinzu.
  • AutoStart : Bool - Startprozess Wenn MPROCS startet. Standard: wahr .
  • Autorestart : Bool - Prozess neu starten, wenn es beendet ist. Standard: Falsch. HINWEIS: Wenn der Prozess innerhalb von 1 Sekunde nach dem Start beendet wird, wird er nicht neu gestartet.
  • STOP : "Sigint" | "sigterm" | "sigkill" | {send-keys: array} | "hard-kill" -eine Möglichkeit, einen Prozess zu stoppen (mit x Schlüssel oder beim Beenden von MPROCs).
• hide_keyMap_window : bool - verstecken Sie den Bereich am unteren Bildschirmrand mit Schlüsselbindungen.
• MOUSE_SCROLL_SPEED : Ganzzahl - Anzahl der Zeilen, um eine Maus -Schriftrolle zu scrollen.
• Scrollback : Ganzzahl - Scrollback -Größe. Standard: 1000 .
• proc_list_width : Ganzzahl - Prozessliste Fensterbreite.
• Keymap_Procs : Objekt - Schlüsselbindungen für die Prozessliste. Siehe Keymap.
• Keymap_ter : Objekt - Schlüsselbindungen für das Terminalfenster. Siehe Keymap.
• Keymap_copy : Objekt - Schlüsselbindungen für den Kopiermodus. Siehe Keymap.

Keymap

Standardschlüsselbindungen können in der Konfiguration unter Verwendung von Keymap_Procs , Keymap_term oder Keymap_Copy -Feldern überschrieben werden. Die verfügbaren Befehle sind im Abschnitt Fernbedienungsabschnitt dokumentiert.

Es gibt drei Keymap -Werte:

• Standard Keymaps
• ~/.config/mprocs/mprocs.yaml (oder ~AppDataRoamingmprocsmprocs.yaml unter Windows)
• ./mprocs.yaml (kann durch die -c/-config cli arg überschrieben werden)

Niedrigere Hebel überschreiben die Bindungen aus früheren Ebenen. Schlüsselbindungen aus früheren Ebenen können gelöscht werden, indem reset: true -Feld auf dem gleichen Niveau wie Schlüssel angegeben wird.

Schlüsselbindungen werden zwischen < , z > B. <Enter> (Eingabetaste), <Down> (Down -Pfeil), <Up> (UP -Pfeil), <Cq> (Strg + q) definiert.

 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 operator

Sie können unterschiedliche Werte in Abhängigkeit vom aktuellen Betriebssystem definieren. Jeder Wert in der Konfiguration kann mit einem $ select -Operator verpackt werden. So definieren Sie unterschiedliche Werte basierend auf dem aktuellen Betriebssystem ein Objekt mit:

• Erstes Feld $select: os
• Felder, die Werte für verschiedene OSS definieren: macos: value . Mögliche Werte sind hier aufgeführt: https://doc.rust-lang.org/std/env/consts/constant.os.html.
• Feld $else: default value wird übereinstimmt, wenn für das aktuelle Betriebssystem kein Wert definiert wurde. Wenn das aktuelle Betriebssystem nicht übereinstimmt und das Feld $else fehlt, fehlt MPROCS nicht die Konfiguration.

Beispiel 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 

Ausführen von Skripten von package.json

Wenn Sie MPROCs mit einem --npm -Argument ausführen, werden Skripte von package.json geladen. Die Skripte werden jedoch standardmäßig nicht ausgeführt, und Sie können die gewünschten Skripte manuell starten.

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

Standard Keymap

Prozessliste fokussiert:

• q - Hören Sie auf (Soft Kill -Prozesse und warten Sie, um zu beenden)
• Q - Force -Kündigung (Beendigung von Prozessen)
• Ca - Fokusabgabebereich
• x - Soft Kill ausgewählter Prozess (Sigterm Signal senden, Hard Kill auf Windows)
• X - Hard Kill ausgewählter Prozess (Sigkill senden)
• s - den ausgewählten Prozess starten, wenn er nicht ausgeführt wird
• r - Soft Kill ausgewählter Prozess und starten Sie ihn neu, wenn es stoppt
• R - Hard Kill ausgewählter Prozess und starten Sie ihn neu, wenn es stoppt
• a - Neuen Prozess hinzufügen
• C - ausgewählter Prozess doppelte Prozesse
• d - Ausgewählter Prozess entfernen (der Prozess muss zuerst gestoppt werden)
• e - Ausgewählter Prozess umbenennen
• k oder ↑ - Wählen Sie den vorherigen Prozess aus
• j oder ↓ - Wählen Sie den nächsten Prozess aus
• M-1 - M-8 -Wählen Sie den Prozess 1-8 aus
• Cd oder page down - Scrollenausgabe nach unten
• Cu oder page up - Scrollenausgabe nach oben
• Ce - Scrollenausgabe um 3 Zeilen herunter
• Cy - Scrollenausgabe um 3 Zeilen nach oben
• z - Zoomen in ein Terminalfenster
• v - Kopiermodus eingeben

Prozessausgabe fokussiert:

• Ca - Fokus Prozesse Scheiben Sie

Kopiermodus:

• v - Die Auswahl des Endpunkts beginnen
• c - Ausgewählter Text kopieren
• Esc - Kopiermodus verlassen
• Ca - Fokus Prozesse Scheiben Sie
• Cd oder page down - Scrollenausgabe nach unten
• Cu oder page up - Scrollenausgabe nach oben
• Ce - Scrollenausgabe um 3 Zeilen herunter
• Cy - Scrollenausgabe um 3 Zeilen nach oben
• h oder ↑ - Cursor nach oben bewegen
• l oder → - Cursor rechts bewegen
• j oder ↓ - Cursor nach unten bewegen
• h oder ← - Cursor links bewegen

Fernbedienung

Optional können MPROCs den TCP -Port für Remote -Befehle anhören. Sie müssen die Adresse des Fernbedienungsservers in mprocs.yaml ( server: 127.0.0.1:4050 ) oder über CLI -Argument ( mprocs --server 127.0.0.1:4050 ) definieren. So senden Sie einen Befehl an das Ausführen von MPROCS- Instanz. Verwenden Sie das CTL- Argument: mprocs --ctl '{c: quit}' oder mprocs --ctl '{c: send-key, key: <Cc>}' .

Befehle werden als yaml codiert. Verfügbare Befehle:

• {c: quit-or-ask} -Stoppen Sie Prozesse an und beenden Sie. Wenn Prozesse ausgeführt werden, zeigen Sie einen Bestätigungsdialog an.
• {c: quit} - Stoppen Sie Prozesse und beenden Sie. Zeigt kein Dialog zur Bestätigung an.
• {c: force-quit}
• {c: toggle-focus} - Fokus zwischen Prozessliste und Terminal.
• {c: focus-procs} - Fokusprozessliste
• {c: focus-term} - Fokus -Prozess -Terminalfenster
• {c: zoom} - Zoom in das Terminalfenster
• {c: next-proc}
• {c: prev-proc}
• {c: select-proc, index: <PROCESS INDEX>}
• {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>"} - Umbenennen Sie den aktuell ausgewählten Prozess um
• {c: scroll-down}
• {c: scroll-up}
• {c: scroll-down-lines, n: <COUNT>}
• {c: scroll-up-lines, n: <COUNT>}
• {c: copy-mode-enter} -Geben
• {c: copy-mode-leave} -Kopiermodus verlassen
• {c: copy-mode-move, dir: <DIRECTION> } -Start- oder Endposition der Auswahl bewegen. Verfügbare Anweisungen: up/right/down/left .
• {c: copy-mode-end}
• {c: copy-mode-copy} -Kopieren Sie den ausgewählten Text in die Zwischenablage und lassen Sie den Kopiermodus.
• {c: send-key, key: "<KEY>"} - Senden Sie den Schlüssel an den aktuellen Prozess. Schlüsselbeispiele: <Ca> , <Enter>
• {c: batch, cmds: [{c: focus-procs}, …]} - Senden Sie mehrere Befehle

FAQ

MPROCS vs TMUX/Bildschirm

MPROCS soll es einfacher machen, bestimmte Befehle auszuführen, die Sie am Ende wiederholt ausführen, z. B. Compiler und Testläufer. Dies steht im Gegensatz zu TMUX , das normalerweise verwendet wird, um viel mehr langlebige Prozesse - normalerweise eine Hülle - in jedem Fenster/Bereich auszuführen. Ein weiterer Unterschied besteht darin, dass TMUX einen Server und einen Client ausführt, wodurch der Client es später trennen und wieder aufnehmen kann, wodurch die Prozesse ausgeführt werden. MPROCS ist mehr für endliche Lebensdauerprozesse gemeint, die Sie immer wieder aufliegen, aber wenn MPROCs endet, werden auch die Prozesse, die sie in seinen Fenstern ausgeführt werden.

Kopieren funktioniert in TMUX nicht

TMUX hat keine Escape -Sequenzen, um standardmäßig aktiviert zu werden. So fügen Sie ~/.tmux.conf Folgendes hinzu:

 set -g set-clipboard on