Unduh mprocs - Unduh Kode Sumber mprocs

mprocs

Kode sumber lainnya

v0.7.1

Unduh

mProcs

MPROCS menjalankan beberapa perintah secara paralel dan menunjukkan output dari setiap perintah secara terpisah.

Saat Anda mengerjakan proyek, Anda sangat sering membutuhkan daftar perintah yang sama untuk dijalankan. Misalnya: webpack serve , jest --watch , node src/server.js . Dengan mProcs Anda dapat mencantumkan perintah ini di mprocs.yaml dan menjalankan semuanya dengan menjalankan mprocs . Kemudian Anda dapat beralih di antara output dari perintah yang berjalan dan berinteraksi dengannya.

Ini mirip dengan secara bersamaan tetapi MPROCS menunjukkan output dari setiap perintah secara terpisah dan memungkinkan untuk berinteraksi dengan proses (Anda bahkan dapat bekerja di VIM di dalam mProcs ).

Tangkapan layar
Instalasi
- Unduh Biner (Linux, MacOS, Windows)
- NPM (Linux, MacOS, Windows)
- Homebrew (MacOS)
- kargo (semua platform)
- sendok (windows)
- AUR (Arch Linux)
- MPR (Debian/Ubuntu)
Penggunaan
- Konfigurasi
  - Keymap
  - $ Pilih Operator
  - Menjalankan skrip dari package.json
- Keymap default
- Kendali jarak jauh
FAQ
- MPROCS vs TMUX/Layar

Tangkapan layar

Instalasi

Unduh Biner (Linux, MacOS, Windows)

Unduh dapat dieksekusi untuk platform Anda dan masukkan ke dalam direktori yang termasuk dalam jalur.

NPM (Linux, MacOS, Windows)

npm install -g mprocs

yarn global add mprocs

Homebrew (MacOS, Linux)

brew install mprocs

kargo (semua platform)

cargo install mprocs

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

Penggunaan

Jalankan mprocs cmd1 cmd2 … (Contoh: mprocs "yarn test -w" "webpack serve" )

ATAU

Buat file mprocs.yaml
Jalankan perintah mprocs

Contoh mprocs.yaml :

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

Konfigurasi

Skema Konfigurasi JSON/YAML

Ada dua jenis konfigurasi: global dan lokal. Global Config dimuat dari ~/.config/mprocs/mprocs.yaml (atau ~AppDataRoamingmprocsmprocs.yaml di windows). Konfigurasi lokal dimuat dari mprocs.yaml dari direktori saat ini (atau diatur melalui argumen CLI: mprocs --config ./cfg/mprocs.yaml ). Pengaturan di Pengaturan Konfigurasi Lokal Global .

Procs : Objek - Proses yang harus dijalankan. Hanya diizinkan di konfigurasi lokal.
- Shell : String - Perintah shell untuk dijalankan (persis salah satu shell atau cmd harus disediakan).
- CMD : Array - Array of Command dan ARGS untuk dijalankan (tepat salah satu shell atau CMD harus disediakan).
- CWD : String - Setel direktori kerja untuk prosesnya. Awalan <CONFIG_DIR> akan diganti dengan jalur direktori tempat konfigurasi berada.
- Env : Object <String, String | NULL> - Atur variabel Env. Kunci objek adalah nama variabel. Tetapkan variabel ke null, untuk menghapus variabel yang diwarisi dari proses induk.
- Add_path : String | Array - Tambahkan entri ke variabel lingkungan jalur .
- AUTOSTART : BOOL - MULAI PROSES Saat MPROCS dimulai. Default: Benar .
- AutorAstart : BOOL - Restart Proses saat keluar. Default: Salah. Catatan: Jika proses keluar dalam waktu 1 detik sejak awal, itu tidak akan dimulai kembali.
- Berhenti : "Sigint" | "Sigterm" | "Sigkill" | {Send-Keys: Array} | "Hard-Kill" -Cara untuk Menghentikan Suatu Proses (menggunakan Kunci x atau saat berhenti MPROCS).
hide_keymap_window : bool - Sembunyikan panel di bagian bawah layar yang menunjukkan binding kunci.
mouse_scroll_speed : Integer - Jumlah baris untuk menggulir satu gulir mouse.
Scrollback : Integer - Ukuran scrollback. Default: 1000 .
proc_list_width : Integer - Lebar jendela daftar proses.
KEYMAP_PROCS : Objek - Binding kunci untuk daftar proses. Lihat KeyMap.
KEYMAP_TERT : Objek - Binding kunci untuk jendela terminal. Lihat KeyMap.
KEYMAP_COPY : Objek - Binding kunci untuk mode salinan. Lihat KeyMap.

Keymap

Binding kunci default dapat ditimpa dalam konfigurasi menggunakan bidang KEYMAP_PROCS , KEYMAP_TERT , atau KEYMAP_COPY . Perintah yang tersedia didokumentasikan di bagian remote control.

Ada tiga level keymap:

Keymaps default
~/.config/mprocs/mprocs.yaml (atau ~AppDataRoamingmprocsmprocs.yaml di windows)
./mprocs.yaml (dapat ditimpa oleh -c/-config cli arg)

Tuas yang lebih rendah mengesampingkan binding dari level sebelumnya. Binding kunci dari level sebelumnya dapat dihapus dengan menentukan reset: true pada level yang sama dengan kunci.

Ikatan kunci didefinisikan antara < , misalnya, < > <Enter> (masukkan key), <Down> (panah bawah), <Up> (panah atas), <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` Operator

Anda dapat mendefinisikan nilai yang berbeda tergantung pada sistem operasi saat ini. Nilai apa pun dalam konfigurasi dapat dibungkus dengan operator $ pilih . Untuk memberikan nilai yang berbeda berdasarkan OS saat ini, tentukan suatu objek dengan:

Bidang Pertama $select: os
Bidang mendefinisikan nilai untuk OS yang berbeda: macos: value . Nilai-nilai yang mungkin tercantum di sini: https://doc.rust-lang.org/std/env/consts/constant.os.html.
Field $else: default value akan dicocokkan jika tidak ada nilai yang ditentukan untuk OS saat ini. Jika OS saat ini tidak cocok dan bidang $else tidak ada, maka MPROCS akan gagal memuat konfigurasi.

Contoh 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

Menjalankan skrip dari package.json

Jika Anda menjalankan MPRocs dengan argumen --npm , itu akan memuat skrip dari package.json . Tetapi skrip tidak dijalankan secara default, dan Anda dapat meluncurkan skrip yang diinginkan secara manual.

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

Keymap default

Daftar proses difokuskan:

q - Berhenti (proses pembunuhan lunak dan tunggu lalu keluar)
Q - Force QUIT (Proses Akhiri)
Ca - Panel Output Fokus
x - Proses Soft Kill yang Dipilih (Kirim Sinyal Sigterm, Hard Kill on Windows)
X - Hard Kill Proses yang Dipilih (Kirim Sigkill)
s - Mulailah proses yang dipilih, jika tidak berjalan
r - Soft Kill Proses yang dipilih dan restart saat berhenti
R - Hard Kill Proses yang Dipilih dan mulai ulang saat berhenti
a - Tambahkan proses baru
C - Duplikat Proses yang Dipilih
d - Hapus proses yang dipilih (proses harus dihentikan terlebih dahulu)
e - Ganti nama proses yang dipilih
k atau ↑ - Pilih proses sebelumnya
j atau ↓ - Pilih Proses Berikutnya
M-1 - M-8 -Pilih Proses 1-8
Cd atau page down - output gulir ke bawah
Cu atau page up - Output Gulir
Ce - Gulir output ke bawah oleh 3 baris
Cy - Gulir output ke atas dengan 3 baris
z - Perkecil ke jendela terminal
v - Masukkan mode salin

Fokus output proses:

Ca - Panel Proses Fokus

Mode Salin:

v - Mulai Memilih Titik Akhir
c - Salin teks yang dipilih
Esc - Tinggalkan Mode Salin
Ca - Panel Proses Fokus
Cd atau page down - output gulir ke bawah
Cu atau page up - Output Gulir
Ce - Gulir output ke bawah oleh 3 baris
Cy - Gulir output ke atas dengan 3 baris
h atau ↑ - Pindahkan kursor ke atas
l atau → - Pindahkan kursor dengan benar
j atau ↓ - Pindahkan kursor ke bawah
h atau ← - Pindahkan kursor ke kiri

Kendali jarak jauh

Secara opsional, MPROC dapat mendengarkan port TCP untuk perintah jarak jauh. Anda harus mendefinisikan alamat server kendali jarak jauh di mprocs.yaml ( server: 127.0.0.1:4050 ) atau melalui argumen CLI ( mprocs --server 127.0.0.1:4050 ). Untuk mengirim perintah untuk menjalankan instance MPROCS Gunakan argumen CTL : mprocs --ctl '{c: quit}' atau mprocs --ctl '{c: send-key, key: <Cc>}' .

Perintah dikodekan sebagai YAML. Perintah yang tersedia:

{c: quit-or-ask} -berhenti proses dan berhenti. Jika ada proses yang berjalan, tunjukkan dialog konfirmasi.
{c: quit} - berhenti proses dan berhenti. Tidak menunjukkan dialog konfirmasi.
{c: force-quit}
{c: toggle-focus} - sakelar fokus antara daftar proses dan terminal.
{c: focus-procs} - Daftar Proses Fokus
{c: focus-term} - Jendela Terminal Proses Fokus
{c: zoom} - zoom ke jendela terminal
{c: next-proc}
{c: prev-proc}
{c: select-proc, index: <PROCESS INDEX>} - Pilih Proses dengan Indeks, Proses Top memiliki Indeks 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>"} - Ganti nama proses yang dipilih saat ini
{c: scroll-down}
{c: scroll-up}
{c: scroll-down-lines, n: <COUNT>}
{c: scroll-up-lines, n: <COUNT>}
{c: copy-mode-enter} -masukkan mode salin
{c: copy-mode-leave} -Tinggalkan mode salin
{c: copy-mode-move, dir: <DIRECTION> } -Pindahkan posisi start atau ending dari seleksi. Petunjuk yang Tersedia: up/right/down/left .
{c: copy-mode-end} -Mulai pilih titik akhir pemilihan.
{c: copy-mode-copy} -Salin teks yang dipilih ke clipboard dan tinggalkan mode salin.
{c: send-key, key: "<KEY>"} - Kirim tombol ke proses saat ini. Contoh utama: <Ca> , <Enter>
{c: batch, cmds: [{c: focus-procs}, …]} - kirim beberapa perintah

FAQ

MPROCS vs TMUX/Layar

MPROCS dimaksudkan untuk membuatnya lebih mudah untuk menjalankan perintah spesifik yang akhirnya Anda jalankan berulang kali, seperti kompiler dan pelari uji. Ini berbeda dengan Tmux , yang biasanya digunakan untuk menjalankan proses yang jauh lebih panjang - biasanya shell - di setiap jendela/panel. Perbedaan lain adalah bahwa TMUX menjalankan server dan klien, yang memungkinkan klien untuk melepaskan dan memasang kembali nanti, menjaga proses tetap berjalan. MPROCS lebih dimaksudkan untuk proses seumur hidup yang terbatas yang terus Anda jalankan kembali, tetapi ketika MPROCS berakhir, begitu juga proses yang dijalankan di dalam jendelanya.