completion

يطبع نصًّا برمجيًّا لإكمال الصدفة (shell) المطلوبة إلى الخرج القياسي. تفعيل الإكمال اختياري: هذا الأمر يطبع النص البرمجي فحسب — وهو لا يحرّر أبدًا ملفات بدء تشغيل صدفتك. أنت من يُلحِق الخرج بملف الإكمال الخاص بالصدفة بنفسك.

الموجز

apothem completion bash|zsh|fish|powershell

يُفعِّل النص البرمجي المُصدَر إكمال <TAB> لأوامر apothem الفرعية والأعلام، و — بالنسبة للخيار --harness — لمُعرِّفات الـ harness المسجَّلة إضافةً إلى all.

الأصداف المدعومة

Shell	كيفية إنتاج النص البرمجي
`bash`	نص إكمال bash الأصلي من Click.
`zsh`	نص إكمال zsh الأصلي من Click.
`fish`	نص إكمال fish الأصلي من Click.
`powershell`	مقتطف `Register-ArgumentCompleter` يجسر إلى بروتوكول الإكمال الخاص بـ Click (لا يأتي Click بنصّ PowerShell أصلي، لذا يربط هذا المقتطف البروتوكول نفسه بـ PowerShell).

طلب أي صدفة أخرى يخرج بالرمز 2 مع قائمة الأصداف المدعومة.

تفعيل الإكمال لكل صدفة

يجب أولًا أن يكون الأمر apothem ضمن مسارك 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	تم إصدار نص الإكمال البرمجي
2	طُلِبت صدفة غير مدعومة

انظر أيضًا

apothem install — تثبيت تهيئة harness
apothem harnesses — مُعرِّفات الـ harness التي يقدّمها إكمال --harness
مرجع واجهة سطر الأوامر — جميع الأوامر الفرعية