makedist - make cpan distribution
USAGE
makedist [OPTIONS]
DESCRIPTION
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.
CONFIGURATION
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.
OPTIONS
--noconfig skip config file
-v, --verbose explain what is being done
-h, --help show this help and exit
REPORTING BUGS
Report bugs and/or feature requests on https://github.com/trapd00r/makedist, the repository issue tracker or directly to [email protected]
AUTHOR
Magnus Woldrich
CPAN ID: WOLDRICH
[email protected]
http://japh.se
http://github.com/trapd00r
CONTRIBUTORS
None required yet.
COPYRIGHT
Copyright 2018 THIS APPLICATIONs "AUTHOR" and "CONTRIBUTORS" as listed above.
LICENSE
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.