mprocs

Mprocs

تقوم MPROCS بتشغيل أوامر متعددة بالتوازي وتُظهر إخراج كل أمر بشكل منفصل.

عندما تعمل في مشروع ، فغالبًا ما تحتاج إلى تشغيل نفس قائمة الأوامر. على سبيل المثال: webpack serve ، jest --watch ، node src/server.js . مع MPROCs ، يمكنك سرد هذه الأوامر في mprocs.yaml وتشغيلها جميعها عن طريق تشغيل mprocs . ثم يمكنك التبديل بين مخرجات تشغيل الأوامر والتفاعل معها.

إنه مشابه بشكل متزامن ، لكن MPROCS يوضح إخراج كل أمر بشكل منفصل ويسمح بالتفاعل مع العمليات (يمكنك حتى العمل في VIM داخل MPROCS ).

• لقطات الشاشة
• تثبيت
  • قم بتنزيل Binary (Linux ، MacOS ، Windows)
  • NPM (Linux ، MacOS ، Windows)
  • Homebrew (MacOS)
  • البضائع (جميع المنصات)
  • سكوب (Windows)
  • AUR (قوس لينكس)
  • MPR (Debian/Ubuntu)
• الاستخدام
  • تكوين
    • keymap
    • $ SELECT Operator
    • تشغيل البرامج النصية من package.json
  • keymap الافتراضي
  • التحكم عن بعد
• التعليمات
  • MPROCS مقابل TMUX/الشاشة

لقطات الشاشة

تثبيت

قم بتنزيل Binary (Linux ، MacOS ، Windows)

قم بتنزيل التنفيذ لمنصة الخاصة بك ووضعه في دليل مدرج في PATH.

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 (قوس لينكس)

yay mprocs

yay mprocs-bin

MPR (Debian/Ubuntu)

git clone ' https://mpr.makedeb.org/mprocs '
cd mprocs/
makedeb -si

الاستخدام

1. Run mprocs cmd1 cmd2 … (مثال: mprocs "yarn test -w" "webpack serve" )

أو

1. إنشاء ملف mprocs.yaml
2. تشغيل أمر mprocs

مثال mprocs.yaml :

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

تكوين

مخطط تكوين JSON/YAML

هناك نوعان من التكوينات: العالمية والمحلية. يتم تحميل التكوين العالمي من ~/.config/mprocs/mprocs.yaml (أو ~AppDataRoamingmprocsmprocs.yaml على Windows). يتم تحميل التكوين المحلي من mprocs.yaml من الدليل الحالي (أو تعيين عبر الوسيطة CLI: mprocs --config ./cfg/mprocs.yaml ). الإعدادات في إعدادات التكوين المحلية تخطي الإعدادات العالمية .

• Procs : كائن - عمليات التشغيل. مسموح به فقط في التكوين المحلي.
  • Shell : String - shell command to Run (بالضبط يجب توفير واحدة من shell أو cmd ).
  • CMD : Array - Array of Command and Args to Run (بالضبط يجب توفير واحدة من shell أو cmd ).
  • CWD : سلسلة - تعيين دليل العمل لهذه العملية. سيتم استبدال البادئة <CONFIG_DIR> بمسار الدليل الذي يوجد فيه التكوين.
  • ENV : كائن <String ، String | NULL> - SET ENVELS. مفاتيح الكائنات هي أسماء متغيرة. تعيين متغير إلى NULL ، لمسح المتغيرات الموروثة من العملية الأصل.
  • add_path : سلسلة | صفيف - إضافة إدخالات إلى متغير بيئة المسار .
  • Autostart : Bool - START عملية عندما تبدأ MPROCS. الافتراضي: صحيح .
  • AutorStart : Bool - إعادة التشغيل عندما تخرج. الافتراضي: خطأ. ملاحظة: إذا خرجت العملية في غضون ثانية واحدة من البداية ، فلن يتم إعادة تشغيلها.
  • توقف : "sigint" | "sigterm" | "sigkill" | {send-keys: array} x
• Hide_keymap_window : Bool - إخفاء الجزء في الجزء السفلي من الشاشة يعرض روابط المفاتيح.
• mouse_scroll_speed : integer - عدد الخطوط لتمرير واحد للماوس.
• Scrollback : عدد صحيح - حجم التمرير. الافتراضي: 1000 .
• proc_list_width : integer - عرض نافذة قائمة العملية.
• keymap_procs : كائن - روابط مفاتيح لقائمة العملية. انظر Keymap.
• keymap_term : كائن - روابط مفاتيح للنافذة الطرفية. انظر Keymap.
• keymap_copy : كائن - روابط مفاتيح لوضع النسخ. انظر Keymap.

keymap

يمكن تجاوز روابط المفاتيح الافتراضية في التكوين باستخدام حقول keymap_procs أو keymap_term أو keymap_copy . يتم توثيق الأوامر المتاحة في قسم التحكم عن بُعد.

هناك ثلاثة مستويات Keymap:

• المفاتيح الافتراضية
• ~/.config/mprocs/mprocs.yaml (أو ~AppDataRoamingmprocsmprocs.yaml على Windows)
• ./mprocs.yaml​

يتجاوز الرافعات المنخفضة الارتباطات من المستويات السابقة. يمكن مسح روابط المفاتيح من المستويات السابقة عن طريق تحديد reset: true في نفس مستوى المفاتيح.

يتم تعريف روابط المفاتيح بين < و > ، على سبيل المثال ، <Enter> (إدخال المفتاح) ، <Down> (السهم لأسفل) ، <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 Operator

يمكنك تحديد قيم مختلفة اعتمادًا على نظام التشغيل الحالي. يمكن لف أي قيمة في التكوين بمشغل SELECT $ . لتوفير قيم مختلفة بناءً على نظام التشغيل الحالي ، حدد كائن ما يلي:

• الحقل الأول $select: os
• الحقول التي تحدد القيم لمختلف أنظمة: macos: value . يتم سرد القيم الممكنة هنا: https://doc.rust-lang.org/std/env/consts/constant.os.html.
• الحقل $else: default value إذا لم يتم تعريف أي قيمة لنظام التشغيل الحالي. إذا لم يكن نظام التشغيل الحالي متطابقًا مع الحقل $else ، فسيفشل MPROCs في تحميل التكوين.

مثال 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

إذا قمت بتشغيل MProcs مع وسيطة --npm ، فسيتم تحميل البرامج النصية من 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 - SCROLL OUTPUT UP
• Ce - SCROLL OUTPUT لأسفل بمقدار 3 أسطر
• Cy - SCROLL OUTPUT بمقدار 3 أسطر
• z - التكبير في النافذة الطرفية
• v - أدخل وضع النسخ

تركز إخراج العملية:

• Ca - جزء من عمليات التركيز

وضع النسخ:

• v - ابدأ في اختيار نقطة النهاية
• c - نسخ النص المحدد
• Esc - ترك وضع النسخ
• Ca - جزء من عمليات التركيز
• Cd أو page down - قم بالتمرير لأسفل
• Cu أو page up - SCROLL OUTPUT UP
• Ce - SCROLL OUTPUT لأسفل بمقدار 3 أسطر
• Cy - SCROLL OUTPUT بمقدار 3 أسطر
• h أو ↑ - حرك المؤشر لأعلى
• l أو → - حرك المؤشر اليمين
• j أو ↓ - نقل المؤشر لأسفل
• h أو ← - حرك المؤشر اليسار

التحكم عن بعد

اختياريا ، يمكن لـ MPROCs الاستماع على منفذ 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}, …]} - إرسال أوامر متعددة

التعليمات

MPROCS مقابل TMUX/الشاشة

يهدف MPROCS إلى تسهيل تشغيل أوامر محددة ينتهي بك الأمر مرارًا وتكرارًا ، مثل المترجمين والمتسابقين في الاختبار. هذا على النقيض من TMUX ، والذي يستخدم عادة لتشغيل عمليات طويلة العمر - عادة ما تكون قذيفة - في كل نافذة/جزء. هناك اختلاف آخر هو أن TMUX يقوم بتشغيل خادم وعميل ، مما يسمح للعميل بفصل و reattach لاحقًا ، مع الحفاظ على تشغيل العمليات. يهدف MPROCS إلى المزيد من عمليات الحياة المحدودة التي تستمر في إعادة تشغيلها ، ولكن عندما تنتهي MPROCs ، تقوم بالعمليات التي تعمل داخل نوافذها.

النسخ لا يعمل في TMUX

TMUX ليس لديه تسلسل الهروب لنسخ تمكين افتراضيا. لتمكينها إضافة ما يلي إلى ~/.tmux.conf :

 set -g set-clipboard on