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

אתם יכולים להפעיל השלמה של שורת פקודה (שנקראת גם 'השלמת כרטיסייה') ב-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