+ Q(i"~Rt^RIt^RIt^RIHt^RIHt^RIHtH t ^RI H t RRlt RR lt R R ltR R ltR#)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)CallablePath) AnnotatedLiteral) Parameterc2V^8dQhR\R,/#)returnNr)formats"a/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/cyclopts/completion/install.py __annotate__r sTD[c\\PPR4pV'd+\V4pVP 4'd VR, #\PPR4pV'gR#\V4pVP 4'dVR, R, #R#)aYDetect 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 r _detect_omz_completions_dirrsZZ^^L1N.)      - -**..'K ;G~~!M11 rcJV^8dQhR\R,R\R\/#)r shell prog_namer zshbashfish)rstrr)r s"r r r +s)'8'8w/D'E'8RU'8Z^'8rc\P!4pVR8Xd]\4pVe VPRRR7VRV 2, #VR, R, pVPRRR7VRV 2, #VR8Xd:VR, R , R , R, pVPRRR7WQ, #VR 8Xd6VR , R , R, pVPRRR7Wa R 2, #\ RV 24h)aCGet 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. r!T)parentsexist_ok_z.zshrr"z.localsharezbash-completionr#z.configz.fishzUnsupported shell: )rhomermkdir ValueError)rrr*omz_completionszsh_completionsbash_completionsfish_completionss&& r get_default_completion_pathr1+s ( 99;D ~57  &  ! !$ ! >"q _4 4--7dT:1YK00 &(?W47HH=Xtd;++ &)+f4}Dtd;Ku"555.ug677rcVV^8dQhR\R\R\R,R\/#)r script_pathrrr )r"r!)rr$rbool)r s"r r r Us.::::W]=S:X\:rc:VR8Xd-\P!4R, pRV RV R2pRV R2pMTVR8XdH\4'dR #\P!4R , pVPpR V R 2pR V R2pM\hVP 4pVP 4'dDVP4pVR8Xd$\VP4V9d RV9dR #WG9dR #MRpVR8XdVPV RV RV 24R#T;'dVPR4'*pVPR4;_uu_4p V'dV PR4V PV RV R24RRR4R# +'giR#;i)aAdd 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 completionr!F.zshrczfpath=( $fpath)z# z completionszfpath= aNT) rr*rparentNotImplementedErrorresolveexists read_textr$ write_textendswithopenwrite) r3rrrc_file config_linecommentcompletion_dircontent needs_newlinefs &&& r add_to_rc_filerMUs( ))+ ){m:k]!D I;k2 % & ( ())+($++/x8 yk.!!ooG~~##% E>c+"4"45@XQXEX  #$ ~gYb RyAB   >>(8(8(>$> \\#  ! GGwir+b1 2    s 1F  F cJV^8dQhR\R\3,R\/#)r install_completion_fn.add_to_startup)rrr4)r s"r r r s)['['#CI.['['rc*aaRRRR/RVV3RlllpV#)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(). rNoutputc V^8dQhR\\R,R,\43,R\\R,\RR.R73,/#)r rNrRz-oz--output)namer )rrrr)r s"r r 7create_install_completion_command..__annotate__sQE&E&!67$> KLE&$+ytZ6H'IIJE&rc<^RIHpHpVf V!4pS !WSR7p\RV 24VR8Xd\4'd\R4\R 4R#S'dR\P!4R , pVPp\R V R V 24\R 4\R4R#VPp\RV R24\R4\RV R24\R4\R4R#VR8XdS'd8\P!4R, p\RV 24\R4R#\R4\R4\R4\R4\R4\R4\R 4\R!4R#VR"8Xd\R#4\R$4R#\h Td6\R\P R7\P !^4ELi;i)%aInstall 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. )ShellDetectionError detect_shellNz?Could not auto-detect shell. Please specify --shell explicitly.)file)rrRrPu#✓ Completion script installed to r!uC✓ Detected oh-my-zsh: completions directory is already in $fpath.z$ Restart your shell or run: exec zshr8u ✓ 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=(r9z% autoload -Uz compinit && compinitz) Then restart your shell or run: exec zshr"r6u✓ 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-completionr#z. Completions are automatically loaded in fish.z) rrRrWrX install_pathzshrcrIbashrcrPrOs $$ r _install_completion_commandFcreate_install_completion_command.._install_completion_commands$ Q = $-5Xfg  3L>BC E>*,,[\=> h.!-!4!4 >"2-wGHqr;BC f_y07x@AEFVW23HIABKLABFGDE f_ C D P Q% %]' U  sG8HH)rOrPrbsff r !create_install_completion_commandres.(E&OSE&NRE&E&N '&r)__doc__rr\collections.abcrpathlibrtypingrrcyclopts.parameterrrr1rMrerdrr rks5  $%(6'8T:z['r