Téléchargement mprocs - Téléchargement du code source mprocs

mprocs

Autre code source

v0.7.1

Télécharger

MPROCS

MPROCS exécute plusieurs commandes en parallèle et affiche la sortie de chaque commande séparément.

Lorsque vous travaillez sur un projet, vous avez très souvent besoin de la même liste de commandes en cours d'exécution. Par exemple: webpack serve , jest --watch , node src/server.js . Avec MPROCS, vous pouvez répertorier ces commandes dans mprocs.yaml et les exécuter toutes en exécutant mprocs . Ensuite, vous pouvez basculer entre les sorties des commandes en cours d'exécution et interagir avec eux.

Il est similaire à simultanément, mais MPROCS affiche la sortie de chaque commande séparément et permet d'interagir avec les processus (vous pouvez même travailler dans VIM à l'intérieur des MProcs ).

Captures d'écran
Installation
- Télécharger le binaire (Linux, macOS, Windows)
- NPM (Linux, macOS, Windows)
- homebrew (macOS)
- Cargo (toutes les plates-formes)
- Scoop (Windows)
- Aur (Arch Linux)
- MPR (Debian / Ubuntu)
Usage
- Configurer
  - Keymap
  - $ SELECT OPÉRATEUR
  - Exécution de scripts à partir de package.json
- Keymap par défaut
- Télécommande
FAQ
- MPROCS vs tmux / écran

Captures d'écran

Installation

Télécharger le binaire (Linux, macOS, Windows)

Téléchargez l'exécutable pour votre plateforme et placez-le dans un répertoire inclus dans Path.

NPM (Linux, macOS, Windows)

npm install -g mprocs

yarn global add mprocs

Homebrew (macOS, Linux)

brew install mprocs

Cargo (toutes les plates-formes)

cargo install mprocs

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

Usage

Exécutez mprocs cmd1 cmd2 … (Exemple: mprocs "yarn test -w" "webpack serve" )

OU

Créer un fichier mprocs.yaml
Exécuter la commande mprocs

Exemple mprocs.yaml :

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

Configurer

Schéma de configuration JSON / YAML

Il existe deux types de configurations: globale et locale. La configuration globale est chargée à partir de ~/.config/mprocs/mprocs.yaml (ou ~AppDataRoamingmprocsmprocs.yaml sur Windows). La configuration locale est chargée à partir de mprocs.yaml à partir du répertoire actuel (ou défini via l'argument CLI: mprocs --config ./cfg/mprocs.yaml ). Paramètres dans les paramètres de remplacement de configuration locale du global .

Procs : objet - processus à exécuter. Autorisé uniquement dans la configuration locale.
- Shell : String - Commande de shell à exécuter (exactement un de Shell ou CMD doit être fourni).
- CMD : Array - Array of Command and Args to Exécuter (exactement un Shell ou CMD doit être fourni).
- CWD : String - Définissez le répertoire de travail pour le processus. Prefix <CONFIG_DIR> sera remplacé par le chemin d'accès du répertoire où se trouve la configuration.
- Env : Object <String, String | null> - Set Variables Env. Les touches d'objet sont des noms de variables. Attribuez une variable à NULL, pour effacer les variables héritées du processus parent.
- add_path : String | Array - Ajouter des entrées à la variable d'environnement de chemin .
- AutoStart : Bool - Démarrer le processus lorsque MPROCS démarre. Par défaut: true .
- Autorestart : Bool - Redémarrer le processus lorsqu'il sort. Par défaut: false. Remarque: Si le processus sort dans les 1 seconde suivant le démarrage, il ne sera pas redémarré.
- STOP : "Sigint" | "Sigterm" | "Sigkill" | {Send-Keys: Array} | "Hard-Kill" - un moyen d'arrêter un processus (en utilisant la clé x ou lors de la sortie des MProcs).
hide_keymap_window : bool - cachez le volet en bas de l'écran affichant les liaisons de touches.
souris_scroll_speed : entier - Nombre de lignes pour faire défiler un défilement de souris.
Recordback : entier - Taille de recul. Par défaut: 1000 .
proc_list_width : entier - la largeur de la fenêtre de liste de processus.
keymap_procs : objet - liaisons clés pour la liste de processus. Voir Keymap.
KeyMap_term : objet - liaisons de touches pour la fenêtre du terminal. Voir Keymap.
keymap_copy : objet - liaisons de touches pour le mode de copie. Voir Keymap.

Keymap

Les liaisons par défaut des clés peuvent être remplacées dans la configuration à l'aide de champs keymap_procs , keymap_term ou keymap_copy . Les commandes disponibles sont documentées dans la section télécommande.

Il y a trois niveaux de keymap:

Keymaps par défaut
~/.config/mprocs/mprocs.yaml (ou ~AppDataRoamingmprocsmprocs.yaml sur Windows)
./mprocs.yaml (peut être remplacé par le -c / - config cli arg)

Les leviers inférieurs remplacent les liaisons des niveaux précédents. Les liaisons de clés des niveaux précédents peuvent être effacées en spécifiant reset: true au même niveau que les clés.

Les liaisons de clés sont définies entre < , par exemple, <Enter> (Entrée Key), > (flèche vers le <Down> ), <Up> (UP Arrow), <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` OPÉRATEUR

Vous pouvez définir différentes valeurs en fonction du système d'exploitation actuel. Toute valeur de configuration peut être enveloppée d'un opérateur $ Select . Pour fournir différentes valeurs basées sur le système d'exploitation actuel, définissez un objet avec:

Premier champ $select: os
Champs définissant les valeurs pour différentes OSS: macos: value . Les valeurs possibles sont répertoriées ici: https://doc.rust-lang.org/std/env/consts/constant.os.html.
Champ $else: default value sera égalée si aucune valeur n'a été définie pour le système d'exploitation actuel. Si le système d'exploitation actuel n'est pas adapté et $else le champ est manquant, les MPROC ne parviendront pas à charger la configuration.

Exemple 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

Exécution de scripts à partir de package.json

Si vous exécutez des MProcs avec un argument --npm , il chargera les scripts de package.json . Mais les scripts ne sont pas exécutés par défaut, et vous pouvez lancer manuellement les scripts souhaités.

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

Keymap par défaut

Liste des processus axée:

q - Quitter (Soft Kill Process et attendre puis sortir)
Q - Force quitte (terminer les processus)
Ca - Panne de sortie de mise au point
x - Soft Kill Selected Process (Envoyer un signal SIGTERM, tuer dur sur Windows)
X - TRAITEMENT SÉLECTIONNEL DE KILL (Envoyer Sigkill)
s - Démarrez le processus sélectionné, s'il ne fonctionne pas
r - Soft Kill Sélectionné le processus et redémarrez-le quand il s'arrête
R - dur tuer le processus sélectionné et le redémarrer quand il s'arrête
a - Ajouter un nouveau processus
C - Processus sélectionné en double
d - supprimer le processus sélectionné (le processus doit être arrêté en premier)
e - Renommer le processus sélectionné
k ou ↑ - Sélectionnez le processus précédent
j ou ↓ - Sélectionnez le processus suivant
M-1 - M-8 - Sélectionnez le processus 1-8
Cd ou page down - Faites défiler la sortie vers le bas
Cu ou page up - Faites défiler la sortie vers le haut
Ce - Faites défiler la sortie vers le bas de 3 lignes
Cy - Faites défiler la sortie de 3 lignes
z - Zoom sur la fenêtre du terminal
v - Entrez le mode de copie

La sortie du processus axée sur la sortie:

Ca - Focus Process

Mode de copie:

v - Commencez à sélectionner le point final
c - Copier le texte sélectionné
Esc - Laisser le mode de copie
Ca - Focus Process
Cd ou page down - Faites défiler la sortie vers le bas
Cu ou page up - Faites défiler la sortie vers le haut
Ce - Faites défiler la sortie vers le bas de 3 lignes
Cy - Faites défiler la sortie de 3 lignes
h ou ↑ - Déplacer le curseur vers le haut
l ou → - Déplacer le curseur à droite
j ou ↓ - Déplacer le curseur vers le bas
h ou ← - Déplacer le curseur à gauche

Télécommande

Facultativement, les MPROC peuvent écouter sur le port TCP pour les commandes distantes. Vous devez définir l'adresse du serveur de télécommande dans mprocs.yaml ( server: 127.0.0.1:4050 ) ou via l'argument CLI ( mprocs --server 127.0.0.1:4050 ). Pour envoyer une commande à l'exécution de l'instance MProcs , utilisez l'argument CTL : mprocs --ctl '{c: quit}' ou mprocs --ctl '{c: send-key, key: <Cc>}' .

Les commandes sont codées sous forme de YAML. Commandes disponibles:

{c: quit-or-ask} - Arrêtez les processus et quittez. Si des processus sont en cours d'exécution, affichez une boîte de dialogue de confirmation.
{c: quit} - Arrêtez les processus et quittez. N'affiche pas la boîte de dialogue confirmer.
{c: force-quit}
{c: toggle-focus} - basculer la mise au point entre la liste des processus et le terminal.
{c: focus-procs} - Liste des processus de mise au point
{c: focus-term} - Focus Terminal Window
{c: zoom} - zoom sur la fenêtre du terminal
{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>"} - Renommer le processus actuellement sélectionné
{c: scroll-down}
{c: scroll-up}
{c: scroll-down-lines, n: <COUNT>}
{c: scroll-up-lines, n: <COUNT>}
{c: copy-mode-enter} - Entrez le mode de copie
{c: copy-mode-leave} - Laisser le mode de copie
{c: copy-mode-move, dir: <DIRECTION> } - Déplacer la position de démarrage ou de fin de la sélection. Directions disponibles: up/right/down/left .
{c: copy-mode-end} - Commencez à sélectionner le point final de la sélection.
{c: copy-mode-copy} - Copier le texte sélectionné dans le presse-papiers et laisser le mode de copie.
{c: send-key, key: "<KEY>"} - Envoyez la clé au processus actuel. Exemples de clés: <Ca> , <Enter>
{c: batch, cmds: [{c: focus-procs}, …]} - Envoyer plusieurs commandes

FAQ

MPROCS vs tmux / écran

MPROCS est destiné à faciliter l'exécution de commandes spécifiques que vous finissez par fonctionner à plusieurs reprises, telles que les compilateurs et les coureurs de test. Ceci contraste avec TMUX , qui est généralement utilisé pour exécuter des processus beaucoup plus longs - généralement une coque - dans chaque fenêtre / volet. Une autre différence est que TMUX exécute un serveur et un client, ce qui permet au client de se détacher et de rattacher plus tard, en gardant les processus en cours d'exécution. MPROCS est destiné davantage aux processus de durée de vie finis que vous continuez à réinstaller, mais à la fin des MPROC , il en va de même pour les processus qu'il fonctionne dans ses fenêtres.