Basic tab completion for dzil, the Perl distribution power-tool for CPAN distribution.
The completion implementation requires dzil
to be installed (of course), it uses dzil
built-in commands
command to extract what is available and makes this accessible for tab completion.
In addition installed Dist::Zilla command plugins are automatically exposed by dzil
meaning that tab completions are also automatically supported.
This is based on Dist::Zilla 6.009.
$ dzil <tab>
add build commands help listdeps nop run smoke authordeps clean install new release setup test
If you have additional Dist::Zilla::App::Command plugins installed this will be discovered by Dist::Zilla and hence listed by this utility automatically.
Example: Dist::Zilla::App::Command::cover
$ dzil <tab>
add build commands help listdeps nop run smoke authordeps clean install new release setup cover test
listdeps
offer the additional completions:
$ dzil listdeps <tab>
--missing --develop --author --missing --requires --no-requires --recommends --no-recommends --suggests --no-suggests --versions --cpanm-versions --json --omit-cores
authordeps
offer the additional completions:
$ dzil authordeps <tab>
--root --missing --versions
$ curl https://raw.githubusercontent.com/jonasbn/bash_completion_dzil/master/dzil > dzil
When downloaded you have to install the completion implementation. Where your completions are located might vary.
If you want to install them for your personal use, do the following.
Create the file: ~/.bash_completion
, containing the code below:
for bcfile in ~/.bash_completion.d/* ; do
. $bcfile
done
Ref: ServerFault.com: Standard place for user defined bash_completion.d scripts?
Create a directory for your completions:
mkdir ~/.bash_completion.d
Copy your completions into the newly created directory:
cp dzil ~/.bash_completion.d/
Start a new shell and you should be good to go.
Based on an introduction to bash
completions on Debian.
sudo cp dzil /etc/bash_completion.d/
This assumes you are using Homebrew
Do note that paths vary based on whether you are using bash
3 or 4
Formula: bash-completions
.
cp dzil /usr/local/etc/bash_completion.d/
And to activate right away:
source /usr/local/etc/bash_completion.d/dzil
Formula: bash-completions2
.
cp dzil /usr/local/share/bash-completion/completions/
And to activate right away:
source /usr/local/share/bash-completion/completions/dzil
dzil
is an important tool in my toolchain, so I wanted to have easy access to all the options available.
- 1.0.0
- Initial version working with
bash
version 4.
- Initial version working with
A more elaborate piece of documentation on bash
completions is available from The Linux Documentation Project in the Advanced Bash-Scripting Guide.
From the GNU Documentation.
Good two-part article, "An Introduction to Bash Completion": Part 1 and Part 2.
Please note that this experimental implementation has only been tested with bash
version 3 (see version 1.0.0).
Versions after version 1.0.0 have been tested with bash
version 4.
The most comprehensive collection of bash
completions I have come across is the one from the Debian Linux distribution. It is also the one offered for OSX via Homebrew.
This is made available under the MIT license, see separate license file.
©️ jonasbn 2017-2018