Dist::Mgr::FileData - Fetch pre-written contents for various distribution files.
This module returns arrays of pre-written file contents that can be used to insert into various files.
use Dist::Mgr::FileData qw(:all);
We export nothing by default. See the "FUNCTIONS" section for everything that can be imported individually, or with the :all tag.
:all
All functions are quasi-private and mainly used for development, but I've decided to advertise them anyway.
Returns an array of the lines of a default custom Changes file.
Changes
Return an array of the file contents of a custom Github Actions CI configuration file.
Send in the parameters within an array reference. Each entry signifies the OS of the system the build will run on. The three options mapped to how we handle them internally.
l => qq{ubuntu-latest}, w => qq{windows-latest}, m => qq{macos-latest},
Returns a hash reference containing the data that makes up a default configuration file.
Returns an array of the contents of a populated .gitignore file.
.gitignore
Returns an array of the lines required to add CI and coverage badges. $author is your Github username, and $repo should be self-explanitory.
$author
$repo
Returns an array of the file lines of our default module file. Parameters are the same as if you were running module-starter at the command line.
module-starter
Return an array of the skeleton contents of a Makefile.PL META_MERGE section. We put repository and bugtracer information in here.
Makefile.PL
META_MERGE
Returns an array of the contents that make up the bugtracker section of a Makefile.PL file.
Returns an array of the contents that make up the repository section of a Makefile.PL file.
Returns an array of the file lines that make up a default MANIFEST.SKIP file.
MANIFEST.SKIP
Returns an array of the file lines that make up our custom t/makefile.t test file.
t/makefile.t
Returns an array of files and directories we remove from the base, stock distribution after it's been initialized.
Read through the various functions to get an idea of how things hang together.
Manage any required variables.
The dev/quote_file_contents.pl script takes a file name as an argument, and will generate and print to STDOUT the quoted contents that can be dropped into an array and returned from your new function.
dev/quote_file_contents.pl
STDOUT
Change the quote type within the script if required.
Steve Bertrand, <steveb at cpan.org>
<steveb at cpan.org>
Copyright 2020-2021 Steve Bertrand.
This program is free software; you can redistribute it and/or modify it under the terms of the the Artistic License (2.0). You may obtain a copy of the full license at:
http://www.perlfoundation.org/artistic_license_2_0
To install Dist::Mgr, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Mgr
CPAN shell
perl -MCPAN -e shell install Dist::Mgr
For more information on module installation, please visit the detailed CPAN module installation guide.