makedist - make cpan distribution
makedist [OPTIONS]
makedist automates the process of creating a distribution to be uploaded to CPAN.
The MANIFEST file is inspected for files to be included.
We make an attempt to extract the package name from any perl module file found, and the package name must follow this convention:
package File::LsColor;
If extraction fails, we use the basename of the current working directory as a distribution name:
~/dev/makedist => App-makedist
Version number is extracted from a perl module file if it exists, else an App:: distribution is assumed and version is extracted from the bin/ directory.
makedist looks for a configuration file in the following locations, in order of precedence:
$XDG_CONFIG_HOME/makedist/makedist.conf $HOME/.makedist.conf
Various options can be set in the makedist.conf configuration file.
By default, two variables can be accessed and modified in the configuration file:
# the basename of the gzipped tarball, i.e File-LsColor-0.192.tar.gz $finished_product # code to execute on success. A few examples are provided in the # configuration file. $command_on_success
The author uses the $command_on_success coderef like this:
our $command_on_success = sub { copy(); # copy the dist to a local dir scp(); # scp the dist to a remote server upload(); # upload the dist to cpan }
An example configuration file is provided with this distribution.
--noconfig skip config file -v, --verbose explain what is being done -h, --help show this help and exit
Report bugs and/or feature requests on https://github.com/trapd00r/makedist, the repository issue tracker or directly to m@japh.se
Magnus Woldrich CPAN ID: WOLDRICH m@japh.se http://japh.se http://github.com/trapd00r
None required yet.
Copyright 2018 THIS APPLICATIONs "AUTHOR" and "CONTRIBUTORS" as listed above.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
~/
To install App::makedist, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::makedist
CPAN shell
perl -MCPAN -e shell install App::makedist
For more information on module installation, please visit the detailed CPAN module installation guide.