Ki"dZddlZddlZddlmZddlmZddlmZm Z ddl m Z dedzfdZ d e d d e defd Zd ed e d e ddefdZdedefdefdZy)zShell completion installation utilities. This module handles the installation of completion scripts to shell-specific locations and the updating of shell RC files to load completions. N)Callable)Path) AnnotatedLiteral) Parameterreturnctjjd}|r t|}|j r|dz Stjjd}|syt|}|j r|dz dz Sy)a}Detect oh-my-zsh custom completions directory. Uses ``$ZSH_CUSTOM/completions`` (the recommended location for user completions in oh-my-zsh). Falls back to ``$ZSH/custom/completions`` when ``$ZSH_CUSTOM`` is not set. Returns ------- Path | None Path to the oh-my-zsh custom completions directory, or None if oh-my-zsh is not detected. ZSH_CUSTOM completionsZSHNcustom)osenvirongetris_dir)zsh_custom_str zsh_custom zsh_dir_strzsh_dirs g/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/cyclopts/completion/install.py_detect_omz_completions_dirrsyZZ^^L1N.)     - -**..'K ;G~~!M11 shellzshbashfish prog_namectj}|dk(rJt}||jdd|d|z S|dz dz }|jdd|d|z S|dk(r&|dz d z d z dz }|jdd||z S|d k(r&|d z d z dz }|jdd||d z St d|)aGet the default completion script path for a given shell. Parameters ---------- shell : Literal["zsh", "bash", "fish"] Shell type. prog_name : str Program name for the completion script. Returns ------- Path Default installation path for the shell. Raises ------ ValueError If shell type is unsupported. rT)parentsexist_ok_z.zshr rz.localsharezbash-completionrz.configz.fishzUnsupported shell: )rhomermkdir ValueError)rrr$omz_completionszsh_completionsbash_completionsfish_completionss rget_default_completion_pathr++s ( 99;D ~57  &  ! !$ ! >"q _4 4--7dT:1YK00 &(?W47HH=Xtd;)++ &)+f4}Dtd;YKu"555.ug677r script_path)rrc|dk(r'tjdz }d|d|d}d|d}nF|dk(r;try tjd z }|j}d |d }d |d}nt|j }|j r6|j}|dk(rt|j|vrd|vry ||vry d}|dk(r|j|d|d|y|xr|jd }|jd5} |r| jd| j|d|ddddy#1swYyxYw)a Add completion configuration to shell RC file. For bash, adds a source line to load the completion script. For zsh, adds the completion directory to fpath so compinit can find it. Parameters ---------- script_path : Path Path to the completion script. prog_name : str Program name for display in comments. shell : Literal["bash", "zsh"] Shell type. Returns ------- bool True if configuration was added, False if it already existed or on error. r.bashrcz[ -f "z " ] && . ""z# Load z completionrF.zshrczfpath=( $fpath)z# z completionszfpath= aNT) rr$rparentNotImplementedErrorresolveexists read_textstr write_textendswithopenwrite) r,rrrc_file config_linecommentcompletion_dircontent needs_newlinefs radd_to_rc_filerFUsy( ))+ ){m:k]!D I;k2 % & ())+($++/x8 yk.!!ooG~~##% E>c+"4"45@XQXEX G # ~gYb RyAB   >(8(8(>$> \\#  3! GGwir+b1 2 3   3 s +EEinstall_completion_fn.add_to_startupc ddddttddztfdttdztddgfffd }|S) aCreate a command function for installing shell completion. Parameters ---------- install_completion_fn : Callable Function that performs the actual installation (typically App.install_completion). Should accept (shell, output, add_to_startup) and return the installation path. add_to_startup : bool Whether to add source line to shell RC file. Returns ------- Callable Command function that can be registered with App.command(). N)routputrrrJz-oz--output)namecddlm}m}| |} ||}td||d k(rtrtd td yrKtjd z }|j}td |d|tdtdy|j}td|dtdtd|dtdtdy|dk(rr1tjdz }td|tdytdtdtdtdtd td!td"td#y|d$k(rtd%td&yt#|$r4tdtj t j dYwxYw)'aRInstall shell completion for this application. This command generates and installs the completion script to the appropriate location for your shell. After installation, you may need to restart your shell or source your shell configuration file. Parameters ---------- shell : Literal["zsh", "bash", "fish"] | None Shell type for completion. If not specified, attempts to auto-detect current shell. output : Path | None Output path for the completion script. If not specified, uses shell-specific default. r)ShellDetectionError detect_shellNz?Could not auto-detect shell. Please specify --shell explicitly.)file)rrJrHu#✓ Completion script installed to ruC✓ Detected oh-my-zsh: completions directory is already in $fpath.z$ Restart your shell or run: exec zshr0u ✓ Added z to fpath in zX Note: Ensure compinit is configured in your .zshrc (most zsh setups already have this).z#Restart your shell or run: exec zshz To enable completions, ensure z is in your $fpath.z@Add this to your ~/.zshrc or ~/.zprofile if not already present:z fpath=(r1z% autoload -Uz compinit && compinitz) Then restart your shell or run: exec zshrr.u✓ Added completion loader to z, Restart your shell or run: source ~/.bashrcz= Completions will be automatically loaded by bash-completion.zIf completions don't work:z0 1. Ensure bash-completion is installed (v2.8+)z) 2. Restart your shell or run: exec bashz2 Note: bash-completion is typically installed via:z) - macOS: brew install bash-completion@2z. - Debian/Ubuntu: apt install bash-completionz, - Fedora/RHEL: dnf install bash-completionrz. Completions are automatically loaded in fish.z._install_completion_commands$ Q = $-5Xfg  3L>BC E>*,[\=> h.!-!4!4 >"2-wGHqr;BC f_y07x@AEFVW23HIABKLABFGDE f_ C D P Q% %]' U  sF5GG)rrrr)rGrHrYs`` r!create_install_completion_commandrZs_,PTMQE&!67$> KLE&$+ytZ6H'IIJE&N '&r)__doc__rrScollections.abcrpathlibrtypingrrcyclopts.parameterrrr:r+boolrFrZrrrbs  $%(TD[6'8w/D'E'8RU'8Z^'8T:::W]=S:X\:z['#CI.['['r