volta completions

أمر volta completions سينشئ معلومات إكمال الأوامر لـ shell الخاص بك. له الصيغة التالية:

إنشاء إكمال Volta

افتراضيًا، سيتم إنشاء الإكمال لقيمة shell الحالي الخاص بك،
أي قيمة `SHELL`. إذا حددت خيار `<shell>`، سيتم إنشاء الإكمال لذلك shell.

إذا حددت دليل، سيتم كتابة الإكمال في ملف هناك؛
وإلا، سيتم كتابتها في `stdout`.

الاستخدام:
    volta completions [FLAGS] [OPTIONS] <shell>

الأعلام:
    -f, --force      استبدال الملف الموجود (إن وجد).
        --verbose    تمكين التشخيص المفصل
        --quiet      منع المخرجات غير الضرورية
    -h, --help       طباعة معلومات المساعدة

الخيارات:
    -o, --output <out_file>    الملف لكتابة الإكمال المنشأ إليه

المعاملات:
    <shell>    Shell الذي سيتم إنشاء الإكمال له [القيم المحتملة: zsh, bash, fish, powershell, elvish]

أمثلة

إنشاء الإكمال لـ Shell الحالي الخاص بك

# إنشاء الإكمال وطباعته إلى stdout
volta completions

إنشاء الإكمال لـ Shell محدد

# إنشاء إكمال Bash
volta completions bash

# إنشاء إكمال Zsh
volta completions zsh

# إنشاء إكمال Fish
volta completions fish

# إنشاء إكمال PowerShell
volta completions powershell

# إنشاء إكمال Elvish
volta completions elvish

إخراج الإكمال إلى ملف

# حفظ إكمال bash في ملف
volta completions bash -o volta.bash

# حفظ إكمال zsh في ملف والاستبدال القسري
volta completions zsh -o _volta -f

تثبيت الإكمال

بعد إنشاء الإكمال، تحتاج لتثبيته لـ shell الخاص بك. إليك طرق التثبيت الشائعة لمختلف shells:

Bash

# إنشاء وحفظ إكمال bash
volta completions bash > ~/.volta-completions.bash

# إضافة إلى ~/.bashrc الخاص بك
echo 'source ~/.volta-completions.bash' >> ~/.bashrc

# تطبيق التغييرات على الجلسة الحالية
source ~/.bashrc

Zsh

# إنشاء دليل الإكمال إذا لم يكن موجودًا
mkdir -p ~/.zsh/completions

# إنشاء وحفظ إكمال zsh
volta completions zsh > ~/.zsh/completions/_volta

# إضافة إلى ~/.zshrc الخاص بك (إذا لم يكن مدرجًا بالفعل)
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc

# تطبيق التغييرات على الجلسة الحالية
source ~/.zshrc

Fish

# إنشاء وحفظ إكمال fish
volta completions fish > ~/.config/fish/completions/volta.fish

# سيقوم Fish بتحميل الإكمال تلقائيًا من هذا الدليل

PowerShell

# إنشاء إكمال PowerShell
volta completions powershell > volta-completions.ps1

# إضافة إلى ملف تكوين PowerShell الخاص بك
echo '. /path/to/volta-completions.ps1' >> $PROFILE

# تطبيق التغييرات على الجلسة الحالية
. $PROFILE

حالات الاستخدام

يجعل إكمال Shell استخدام Volta أكثر كفاءة من خلال:

1. اقتراح الأوامر الفرعية المتاحة عند كتابة volta
2. توفير أسماء الأدوات لأوامر مثل volta install أو volta uninstall
3. إكمال الأعلام والخيارات
4. تحسين الإنتاجية من خلال تقليل الإدخال والأخطاء