השלמת שורת פקודה

אתם יכולים להפעיל השלמה של שורת פקודה (שנקראת גם 'השלמת כרטיסייה') ב-Bash ו-Zsh. כך תוכלו להשלים שמות של פקודות, שמות של סימונים וערכי סימונים, וכן שמות של יעדים.

בש

Bazel מגיע עם סקריפט של השלמת הדמיה.

אם התקנת Bazel:

• ממאגר ה-APT, אז אתם מסיימים — סקריפט ההשלמה של Bash כבר מותקן ב-/etc/bash_completion.d.

• מ-Homebrew, אז סיימת&#39. סקריפט ההשלמה של Bash כבר מותקן ב-$(brew --prefix)/etc/bash_completion.d.

• מהמנהל שהורד מ-GitHub:

  1. מאתרים את הנתיב המוחלט של קובץ ההשלמה. מנהל ההתקנה העתיק אותה לספרייה של bin.

     לדוגמה: אם הפעלת את מנהל ההתקנה עם --user, הערך יהיה $HOME/.bazel/bin. אם הפעלתם את מנהל ההתקנה לרמה הבסיסית, הוא יהיה /usr/local/lib/bazel/bin.

  2. מבצעים את אחת מהפעולות הבאות:

     • יש להעתיק את הקובץ הזה לספריית ההשלמה (אם יש לכם כזה).

       דוגמה: ב-Ubuntu זו הספרייה /etc/bash_completion.d.

     • אפשר גם ליצור את קובץ ההשלמה מתוך קובץ ה-RC של Bash&39.

       מוסיפים שורה הדומה לשורה הבאה ל-~/.bashrc (ב-Ubuntu) או ל-~/.bash_profile (ב-macOS), ומשתמשים בנתיב המוחלט של קובץ ההשלמה'

       source /path/to/bazel-complete.bash
       

• באמצעות מגפיים ואז:

  1. לבנות את סקריפט ההשלמה:

     bazel build //scripts:bazel-complete.bash
     

  2. קובץ ההשלמה מיועד לתוכנית bazel-bin/scripts/bazel-complete.bash.

     מבצעים את אחת מהפעולות הבאות:

     • העתיקו את הקובץ לספריית ההשלמה.

       דוגמה: ב-Ubuntu זו הספרייה /etc/bash_completion.d

     • העתיקו אותו ממקום כלשהו בדיסק המקומי, למשל ל-$HOME, והקפידו ליצור את קובץ ההשלמה מתוך קובץ ה-RC של Bash&33.

       מוסיפים שורה הדומה לשורה הבאה ל-~/.bashrc (ב-Ubuntu) או ל-~/.bash_profile (ב-macOS), ומשתמשים בנתיב המוחלט של קובץ ההשלמה'

       source /path/to/bazel-complete.bash
       

Zsh

Bazel מגיע עם סקריפט של השלמת Zsh.

אם התקנת Bazel:

• ממאגר ה-APT, אז אתם'סיום – סקריפט ההשלמה של Zsh כבר מותקן ב-/usr/share/zsh/vendor-completions.

  אם הגדרתם .zshrc בהתאמה אישית מלאה וההשלמה האוטומטית לא פועלת, נסו את אחד מהפתרונות הבאים:

  יש להוסיף את הפרטים הבאים ל-.zshrc:

      zstyle :compinstall filename '/home/tradical/.zshrc'
  
      autoload -Uz compinit
      compinit
  

  או

  יש לפעול לפי ההוראות המפורטות כאן.

  אם אתם משתמשים ב-oh-my-zsh, מומלץ להתקין ולהפעיל את הפלאגין zsh-autocomplete. אם אתם מעדיפים לא להשתמש, השתמשו באחד מהפתרונות המתוארים למעלה.

• מ-Homebrew, אז סיימת&#39. סקריפט ההשלמה של Zsh כבר מותקן ב-$(brew --prefix)/share/zsh/site-functions.

• מהמנהל שהורד מ-GitHub:

  1. מאתרים את הנתיב המוחלט של קובץ ההשלמה. מנהל ההתקנה העתיק אותה לספרייה של bin.

     לדוגמה: אם הפעלת את מנהל ההתקנה עם --user, הערך יהיה $HOME/.bazel/bin. אם הפעלתם את מנהל ההתקנה לרמה הבסיסית, הוא יהיה /usr/local/lib/bazel/bin.

  2. יש להוסיף את הסקריפט לספרייה ב-$fpath שלך:

     fpath[1,0]=~/.zsh/completion/
     mkdir -p ~/.zsh/completion/
     cp /path/from/above/step/_bazel ~/.zsh/completion
     

     אולי יהיה צורך להתקשר אל rm -f ~/.zcompdump; compinit בפעם הראשונה כדי להפעיל את התכונה.

  3. ניתן להוסיף את הפרטים האלה לקובץ .zshrc

     # This way the completion script does not have to parse Bazel's options
     # repeatedly.  The directory in cache-path must be created manually.
     zstyle ':completion:*' use-cache on
     zstyle ':completion:*' cache-path ~/.zsh/cache