zsh-cpan-completion — Documentation

>_ZSH-CPAN-COMPLETION

Perl modules, completed from CPAN. Live remote CPAN package completion via perl -MCPAN -e 'CPAN::Shell->m("...")'. Full cpan / cpanm flag completion, intelligent cache, tarball completion (.tar.gz, .tgz, .tar.bz2, .zip), prefix-length guard to keep the shell responsive.

Install

# Zinit
zinit ice lucid nocompile
zinit load MenkeTechnologies/zsh-cpan-completion

# Oh My Zsh
git clone https://github.com/MenkeTechnologies/zsh-cpan-completion \
    "$HOME/.oh-my-zsh/custom/plugins/zsh-cpan-completion"
# then: plugins+=(zsh-cpan-completion)

# Manual
git clone https://github.com/MenkeTechnologies/zsh-cpan-completion
source zsh-cpan-completion/zsh-cpan-completion.plugin.zsh

Configuration

ZPWR_CPAN_MIN_PREFIX default 2 — minimum prefix length before querying remote CPAN. Lower = more data, higher latency / crash risk.

Examples

cpan install Mo<TAB>        # live remote completion: Moose, Mojo::*, Module::*
cpanm install DBI<TAB>      # same path via cpanm
cpan -j /path/to/config.pm  # full flag completion
cpan install ./Some-1.0.tar.gz  # tarball file completion

Sibling plugins

Part of the MenkeTechnologies zsh plugin family — the MenkeTechnologiesMeta umbrella:

zsh-better-npm-completion — cache-aware npm install completion
zsh-cargo-completion — live cargo add / cargo install completion
zsh-dotnet-completion — dotnet CLI completion
zsh-expand — spacebar expansion (11,683 tests)
zsh-gem-completion — ruby gem install remote completion
zsh-git-acp — 159 git aliases + add/commit/push keybindings
zsh-git-repo-cache — index every git repo on disk
zsh-learn — MySQL-backed learning collection / quiz
zsh-more-completions — 33,175-file mega completion corpus
zsh-nginx — nginx commands + service-wrapper aliases
zsh-pip-description-completion — pip remote completion with descriptions
zsh-sed-sub — in-place sed substitution on the command line
zsh-sudo — ESC ESC to prepend sudo
zsh-xcode-completions — xcodebuild / xcrun / swift completion