completion
مرجع واجهة سطر الأوامر لأمر apothem completion.
يطبع سكربت إكمال للصدفة المطلوبة إلى stdout. تفعيل الإكمال اختياري: هذا الأمر لا يفعل سوى طباعة السكربت — ولا يحرّر أبدًا ملفات بدء تشغيل صدفتك. وأنت من يُلحق المخرجات بملف الإكمال الخاص بالصدفة بنفسك.
الموجز
apothem completion bash|zsh|fish|powershellيفعّل السكربت المُصدَر إكمال <TAB> للأوامر الفرعية لـ
apothem، وراياتها، و— للخيار --harness — لمعرّفات أُطُر
العمل المُسجَّلة إضافةً إلى all.
الأصداف المدعومة
| الصدفة | كيف يُنتَج السكربت |
|---|---|
bash | سكربت إكمال bash الأصلي في Click. |
zsh | سكربت إكمال zsh الأصلي في Click. |
fish | سكربت إكمال fish الأصلي في Click. |
powershell | سكربت Register-ArgumentCompleter يولّده صنف إكمال PowerShell الذي يسجّله Apothem لدى Click (إذ لا يشحن Click صنفًا كهذا أصليًا)، ويقود بروتوكول الإكمال نفسه الذي تستخدمه الأصداف الأخرى. |
طلب أي صدفة أخرى يُنهي الأمر بالرمز 64 مع قائمة الأصداف المدعومة.
تفعيل الإكمال لكل صدفة
يجب أولًا أن يكون الأمر apothem على PATH لديك. تكتب
المُثبِّتات ذات الخطوة الواحدة غلاف apothem في
$HOME/.local/bin (POSIX) أو
%LOCALAPPDATA%\Microsoft\WindowsApps (Windows) ولا تحرّر
PATH لديك أبدًا، لذا أضِف ذلك الدليل إن لم يكن مُدرَجًا فيه أصلًا. ثم
فعّل الإكمال بإلحاق السكربت بملف الإكمال الخاص بالصدفة وإعادة تشغيل الصدفة:
# bash — append to your bashrc
apothem completion bash >> ~/.bashrc
# zsh — append to your zshrc
apothem completion zsh >> ~/.zshrc
# fish — write to the fish completions directory
apothem completion fish > ~/.config/fish/completions/apothem.fish# PowerShell — append the completer registration to your profile
apothem completion powershell >> $PROFILEلتجربة الإكمال في الجلسة الحالية فقط دون تحرير أي ملف، حمّل السكربت مباشرةً عبر
source (bash/zsh): source <(apothem completion bash).
لماذا هو اختياري
لا يحرّر Apothem أبدًا ملفات بدء تشغيل صدفة المُشغِّل بصمت. تطبع المُثبِّتات تلميحًا من سطر واحد يشير إلى هذا الأمر؛ ويقرّر المُشغِّل ما إذا كان سيفعّل الإكمال وأيّ ملف سيُلحق به. وهذا يُبقي أثر التثبيت قابلًا للتنبّؤ وقابلًا للعكس — فإزالة الكتلة المُلحَقة تعطّل الإكمال.
الخيارات
| الخيار | الوصف |
|---|---|
SHELL | واحدة من bash، zsh، fish، powershell (وسيط موضعي مطلوب). |
-h, --help | يعرض المساعدة ويخرج. |
رموز الخروج
| الرمز | المعنى |
|---|---|
| 0 | أُصدِر سكربت الإكمال |
| 64 | طُلبت صدفة غير مدعومة، أو وقع خطأ استخدام آخر مثل خيار غير معروف. ليس لـ completion وضع --json: فهو يطبع سكربتًا، وتمرير --json هو في حدّ ذاته خطأ استخدام. |
انظر أيضًا
- apothem install — تثبيت إعداد إطار عمل
- apothem harnesses — معرّفات أُطُر العمل
التي يعرضها إكمال
--harness - مرجع واجهة سطر الأوامر — كل الأوامر الفرعية