NAME

App::PMUtils - Command line to manipulate Perl module files

VERSION

This document describes version 0.25 of App::PMUtils (from Perl distribution App-PMUtils), released on 2014-09-05.

SYNOPSIS

This distribution provides the following command-line utilities:

 pmbin
 pmcore
 pmcost
 pmdoc
 pmedit
 pminfo
 pmless
 pmlist
 pmman
 pmpath
 pmversion
 podpath

These utilities have tab completion capability. To activate it, put these lines to your bash startup file (e.g. /etc/bash.bashrc, ~/.bash_profile, or ~/.bashrc):

 for p in \
   pmbin pmcore pmcost pmdoc pmedit pminfo pmless pmlist pmman pmpath \
   pmversion podpath; do
     complete -C $p $p
 done

FAQ

What is the purpose of this distribution? Haven't other utilities existed?

For example, mpath in Module::Path distribution, mversion in Module::Version distribution, etc.

True. The main point of these utilities is shell tab completion, to save typing.

In shell completion, why do you use / (slash) instead of :: (double colon) as it should be?

If you type module name which doesn't contain any ::, / will be used as namespace separator. Otherwise if you already type ::, it will use ::.

Colon is problematic because by default it is a word breaking character in bash. This means, in this command:

 % pmpath Text:<tab>

bash is completing a new word (empty string), and in this:

 % pmpath Text::ANSITabl<tab>

bash is completing ANSITabl instead of what we want Text::ANSITabl.

The solution is to use quotes, e.g.

 % pmpath "Text:<tab>
 % pmpath 'Text:<tab>

or, use /.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/App-PMUtils.

SOURCE

Source repository is at https://github.com/sharyanto/perl-App-PMUtils.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=App-PMUtils

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by perlancar@cpan.org.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm App::PMUtils

perl -MCPAN -e shell
install App::PMUtils