Descargar mprocs - Descargar el código fuente mprocs

mprocs

Otro código fuente

v0.7.1

Descargar

MPROCS

MPROCS ejecuta múltiples comandos en paralelo y muestra la salida de cada comando por separado.

Cuando trabaja en un proyecto, a menudo necesita la misma lista de comandos para ejecutar. Por ejemplo: webpack serve , jest --watch , node src/server.js . Con MPROCS puede enumerar estos comando en mprocs.yaml y ejecutarlos todos ejecutando mprocs . Luego puede cambiar entre salidas de comandos en ejecución e interactuar con ellos.

Es similar al mismo tiempo, pero los MPROCS muestran la salida de cada comando por separado y permite interactuar con los procesos (incluso puede trabajar en VIM dentro de MPROCS ).

Capturas de pantalla
Instalación
- Descargar binario (Linux, macOS, Windows)
- NPM (Linux, MacOS, Windows)
- Homebrew (macOS)
- Cargo (todas las plataformas)
- SCOOP (Windows)
- Aur (Arch Linux)
- MPR (Debian/Ubuntu)
Uso
- Configuración
  - Kimap
  - $ seleccione operador
  - Ejecución de scripts desde paquete.json
- Keymap predeterminado
- Mando a distancia
Preguntas frecuentes
- mprocs vs tmux/pantalla

Capturas de pantalla

Instalación

Descargar binario (Linux, macOS, Windows)

Descargue ejecutable para su plataforma y póngalo en un directorio incluido en la ruta.

NPM (Linux, MacOS, Windows)

npm install -g mprocs

yarn global add mprocs

Homebrew (MacOS, Linux)

brew install mprocs

Cargo (todas las plataformas)

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

Uso

Ejecutar mprocs cmd1 cmd2 … (Ejemplo: mprocs "yarn test -w" "webpack serve" )

O

Crear archivo mprocs.yaml
Ejecutar el comando mprocs

Ejemplo mprocs.yaml :

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

Configuración

Esquema de configuración JSON/YAML

Hay dos tipos de configuraciones: global y local. La configuración global se carga desde ~/.config/mprocs/mprocs.yaml (o ~AppDataRoamingmprocsmprocs.yaml en Windows). La configuración local se carga desde mprocs.yaml desde el directorio actual (o establecido a través del argumento de CLI: mprocs --config ./cfg/mprocs.yaml ). Configuración en la configuración de configuración local Configuración Global .

Procs : Objeto : procesos para ejecutar. Solo permitido en la configuración local.
- shell : string - shell comando para ejecutar (se debe proporcionar exactamente uno de shell o cmd ).
- CMD : Array - Matriz of Command y Args para ejecutar (se debe proporcionar exactamente uno de shell o CMD ).
- CWD : String - Establecer directorio de trabajo para el proceso. El prefix <CONFIG_DIR> se reemplazará con la ruta del directorio donde se encuentra la configuración.
- Env : Object <String, String | Null> - Establecer variables Env. Las teclas de objeto son nombres variables. Asignar variable a nulo, para borrar variables heredadas del proceso principal.
- ADD_PATH : String | Array - Agregar entradas a la variable de entorno de ruta .
- AutoStart : BOOL - Inicie el proceso cuando se inicia MPROCS. Valor predeterminado: Verdadero .
- AutorStart : Bool - Reiniciar el proceso cuando sale. Predeterminado: falso. Nota: Si el proceso sale dentro de 1 segundo del inicio, no se reiniciará.
- Detener : "Sigint" | "Sigterm" | "Sigkill" | {Send-Keys: Array} | "Hard-Relling" -una forma de detener un proceso (usando la tecla x o al dejar de fumar MPROCS).
hide_keymap_window : bool : esconde el panel en la parte inferior de la pantalla que muestra enlaces de llave.
mouse_scroll_speed : entero - número de líneas para desplazar un desplazamiento del mouse.
Scrollback : Integer - Tamaño de scrollback. Valor predeterminado: 1000 .
PROC_LIST_WIDTH : Integer - Ancho de ventana de la lista de procesos.
kymap_procs : objeto - enlaces de teclas para la lista de procesos. Ver KEYMAP.
kymap_term : objeto - enlaces de clave para la ventana terminal. Ver KEYMAP.
kymap_copy : objeto - enlaces de teclas para el modo de copia. Ver KEYMAP.

Kimap

Los enlaces de teclas predeterminados se pueden anular en la configuración utilizando los campos KEYMAP_PROCS , KEYMAP_MTER o KEYMAP_COPY . Los comandos disponibles se documentan en la sección de control remoto.

Hay tres niveles de Keymap:

Keymaps predeterminado
~/.config/mprocs/mprocs.yaml (o ~AppDataRoamingmprocsmprocs.yaml en Windows)
./mprocs.yaml (puede ser anulado por el -c/-config cli arg)

Las palancas más bajas anulan las uniones de niveles anteriores. Los enlaces clave de los niveles anteriores se pueden borrar especificando el campo reset: true en el mismo nivel que las claves.

Los enlaces de claves se definen entre < , por ejemplo, <Enter> (Ingrese > tecla), <Down> (flecha hacia abajo), <Up> (Arrow 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` operador

Puede definir diferentes valores según el sistema operativo actual. Cualquier valor en config se puede envolver con un operador $ select . Para proporcionar diferentes valores basados en el sistema operativo actual, defina un objeto con:

Primer campo $select: os
Campos que definen valores para diferentes sistemas operativos: macos: value . Los valores posibles se enumeran aquí: https://doc.rust-lang.org/std/env/consts/constant.os.html.
Campo $else: default value coincidirá si no se definió ningún valor para el sistema operativo actual. Si el sistema operativo actual no coincide y el campo $else le faltan, entonces los mPROCS no cargarán la configuración.

Ejemplo 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

Ejecución de scripts desde paquete.json

Si ejecuta MPROCS con un argumento --npm , cargará scripts de package.json . Pero los scripts no se ejecutan de forma predeterminada, y puede iniciar scripts deseados manualmente.

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

Keymap predeterminado

Lista de procesos enfocado:

q - Salga (procesos de matar suaves y espere para salir)
Q - Force Quit (termine los procesos)
Ca - Panel de salida de enfoque
x - Proceso seleccionado de Kill Soft (enviar señal Sigterm, Hard Kill en Windows)
X - Proceso seleccionado para matar duro (envíe Sigkill)
s - Inicie el proceso seleccionado, si no se está ejecutando
r - proceso de matar suave seleccionado y reiniciarlo cuando se detenga
R - Hard Kill Selected Process y reiniciarlo cuando se detenga
a - Agregar nuevo proceso
C - proceso duplicado seleccionado
d - Eliminar el proceso seleccionado (el proceso debe detenerse primero)
e - Cambiar el nombre del proceso seleccionado
k o ↑ - Seleccione el proceso anterior
j o ↓ - seleccione el siguiente proceso
M-1 - M-8 -Seleccione Proceso 1-8
Cd o page down : desplazarse hacia abajo
Cu o page up - Salida de desplazamiento hacia arriba
Ce - Desplácese de salida por 3 líneas
Cy - desplazamiento de salida por 3 líneas
z - Zoom en la ventana de la terminal
v - Ingrese el modo de copia

Salida del proceso enfocado:

Ca - Panel de procesos de enfoque

Modo de copia:

v - Comience a seleccionar el punto final
c - Copiar texto seleccionado
Esc - Dejar el modo de copia
Ca - Panel de procesos de enfoque
Cd o page down : desplazarse hacia abajo
Cu o page up - Salida de desplazamiento hacia arriba
Ce - Desplácese de salida por 3 líneas
Cy - desplazamiento de salida por 3 líneas
h o ↑ - Mueve el cursor hacia arriba
l o → - mover el cursor correcto
j o ↓ - mueve el cursor hacia abajo
h o ← - Mueva el cursor a la izquierda

Mando a distancia

Opcionalmente, los MPROCS pueden escuchar en el puerto TCP para comandos remotos. Debe definir la dirección del servidor de control remoto en mprocs.yaml ( server: 127.0.0.1:4050 ) o a través del argumento CLI ( mprocs --server 127.0.0.1:4050 ). Para enviar un comando para ejecutar la instancia mproCS , use el argumento CTL : mprocs --ctl '{c: quit}' o mprocs --ctl '{c: send-key, key: <Cc>}' .

Los comandos están codificados como YAML. Comandos disponibles:

{c: quit-or-ask} -Detener los procesos y dejar de fumar. Si se están ejecutando algún proceso, muestre un diálogo de confirmación.
{c: quit} - Detener procesos y salir. No muestra el diálogo Confirmar.
{c: force-quit}
{c: toggle-focus} - Alternar el enfoque entre la lista de procesos y el terminal.
{c: focus-procs} - Lista de procesos de enfoque
{c: focus-term} - Ventana de terminal de procesos de enfoque
{c: zoom} - Zoom en la ventana Terminal
{c: next-proc}
{c: prev-proc}
{c: select-proc, index: <PROCESS INDEX>} - Seleccionar proceso por índice, el proceso superior tiene índice 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>"} - Cambiar el nombre del proceso actualmente seleccionado
{c: scroll-down}
{c: scroll-up}
{c: scroll-down-lines, n: <COUNT>}
{c: scroll-up-lines, n: <COUNT>}
{c: copy-mode-enter} -Ingrese el modo de copia
{c: copy-mode-leave} -Deja el modo de copia
{c: copy-mode-move, dir: <DIRECTION> } -Mueva la posición de inicio o finalización de la selección. Instrucciones disponibles: up/right/down/left .
{c: copy-mode-end} -Comience a seleccionar el punto final de la selección.
{c: copy-mode-copy} -Copie el texto seleccionado al portapapeles y deje el modo de copia.
{c: send-key, key: "<KEY>"} - Enviar la clave al proceso actual. Ejemplos clave: <Ca> , <Enter>
{c: batch, cmds: [{c: focus-procs}, …]} - Enviar múltiples comandos

Preguntas frecuentes

mprocs vs tmux/pantalla

MPROCS está destinado a facilitar la ejecución de comandos específicos que termina ejecutando repetidamente, como compiladores y corredores de prueba. Esto está en contraste con TMUX , que generalmente se usa para ejecutar procesos mucho más de larga vida, generalmente una carcasa, en cada ventana/panel. Otra diferencia es que TMUX ejecuta un servidor y un cliente, lo que permite que el cliente se separe y vuelva a colocar más tarde, manteniendo los procesos en funcionamiento. MPROCS se entiende más para procesos finitos de por vida que se mantiene en funcionamiento, pero cuando termina MPROCS , también lo hacen los procesos que se está ejecutando dentro de sus ventanas.