package App::ModuleBuildTiny;
use 5.010;
use strict;
use warnings FATAL => 'all';
our $VERSION = '0.005';
use Exporter 5.57 'import';
our @EXPORT = qw/modulebuildtiny/;
use Carp qw/croak/;
use Config;
use CPAN::Meta;
use ExtUtils::Manifest qw/manifind maniskip maniread/;
use File::Basename qw/basename dirname/;
use File::Copy qw/copy/;
use File::Path qw/mkpath rmtree/;
use File::Spec::Functions qw/catfile rel2abs/;
use Getopt::Long 2.39;
sub write_file {
my ($filename, $content) = @_;
open my $fh, '>:raw', $filename or die "Could not open $filename: $!\n";
print $fh $content or croak "Couldn't write to $filename: $!";
close $fh or croak "Couldn't write to $filename: $!";
return;
}
sub prereqs_for {
my ($meta, $phase, $type, $module, $default) = @_;
return $meta->effective_prereqs->requirements_for($phase, $type)->requirements_for_module($module) || $default || 0;
}
sub get_files {
my %opts = @_;
my $files;
if (not $opts{regenerate}{MANIFEST} and -r 'MANIFEST') {
$files = maniread;
}
else {
my $maniskip = maniskip;
$files = manifind();
delete $files->{$_} for keys %{ $opts{regenerate} }, grep { $maniskip->($_) } keys %$files;
}
$files->{'Build.PL'} //= do {
my $minimum_mbt = prereqs_for($opts{meta}, qw/configure requires Module::Build::Tiny/);
my $minimum_perl = prereqs_for($opts{meta}, qw/runtime requires perl 5.006/);
"use $minimum_perl;\nuse Module::Build::Tiny $minimum_mbt;\nBuild_PL();\n";
};
$files->{'META.json'} //= $opts{meta}->as_string;
$files->{'META.yml'} //= $opts{meta}->as_string({ version => 1.4 });
$files->{MANIFEST} //= join "\n", sort keys %$files;
return $files;
}
sub get_meta {
my %opts = @_;
my $mergefile = $opts{mergefile} || (grep { -f } qw/metamerge.json metamerge.yml/)[0];
if (not $opts{regenerate}{'META.json'} and -e 'META.json' and -M 'META.json' < -M 'cpanfile' and (not $mergefile or -M 'META.json' < -M $mergefile)) {
return CPAN::Meta->load_file('META.json', { lazy_validation => 0 });
}
else {
my $distname = basename(rel2abs('.'));
$distname =~ s/(?:^(?:perl|p5)-|[\-\.]pm$)//x;
my $filename = catfile('lib', split /-/, $distname) . '.pm';
require Module::Metadata;
my $data = Module::Metadata->new_from_file($filename, collect_pod => 1);
my ($abstract) = $data->pod('NAME') =~ / \A \s+ \S+ \s? - \s? (.+?) \s* \z /x;
my $authors = [ map { / \A \s* (.+?) \s* \z /x } grep { /\S/ } split /\n/, $data->pod('AUTHOR') ];
my $version = $data->version($data->name)->stringify;
my $prereqs = -f 'cpanfile' ? do { require Module::CPANfile; Module::CPANfile->load('cpanfile')->prereq_specs } : {};
$prereqs->{configure}{requires}{'Module::Build::Tiny'} ||= Module::Metadata->new_from_module('Module::Build::Tiny')->version->stringify;
$prereqs->{develop}{requires}{'App::ModuleBuildTiny'} ||= $VERSION;
my $metahash = {
name => $distname,
version => $version,
author => $authors,
abstract => $abstract,
dynamic_config => 0,
license => ['perl_5'],
prereqs => $prereqs,
release_status => $version =~ /_|-TRIAL$/ ? 'testing' : 'stable',
generated_by => "App::ModuleBuildTiny version $VERSION",
'meta-spec' => {
version => '2',
url => 'http://search.cpan.org/perldoc?CPAN::Meta::Spec'
},
};
if ($mergefile && -r $mergefile) {
require Parse::CPAN::Meta;
my $extra = Parse::CPAN::Meta->load_file($mergefile);
require CPAN::Meta::Merge;
$metahash = CPAN::Meta::Merge->new(default_version => '2')->merge($metahash, $extra);
}
return CPAN::Meta->create($metahash, { lazy_validation => 0 });
}
}
my @generatable = qw/Build.PL META.json META.yml MANIFEST/;
my $parser = Getopt::Long::Parser->new(config => [qw/require_order pass_through gnu_compat/]);
my %actions = (
dist => sub {
my %opts = @_;
require Archive::Tar;
my $arch = Archive::Tar->new;
my $meta = get_meta();
my $name = $meta->name . '-' . $meta->version;
my $content = get_files(%opts, meta => $meta);
for my $filename (keys %{$content}) {
if ($content->{$filename}) {
$arch->add_data($filename, $content->{$filename});
}
else {
$arch->add_files($filename);
}
}
$_->mode($_->mode & ~oct 22) for $arch->get_files;
printf "tar czf $name.tar.gz %s\n", join ' ', keys %{$content} if ($opts{verbose} || 0) > 0;
$arch->write("$name.tar.gz", &Archive::Tar::COMPRESS_GZIP, $name);
},
distdir => sub {
my %opts = @_;
my $meta = get_meta();
my $dir = $opts{dir} || $meta->name . '-' . $meta->version;
mkpath($dir, $opts{verbose}, oct '755');
my $content = get_files(%opts, meta => $meta);
for my $filename (keys %{$content}) {
my $target = catfile($dir, $filename);
mkpath(dirname($target)) if not -d dirname($target);
if ($content->{$filename}) {
write_file($target, $content->{$filename});
}
else {
copy($filename, $target);
}
}
},
test => sub {
my %opts = (@_, author => 1);
require File::Temp;
my $dir = File::Temp::tempdir(CLEANUP => 1);
dispatch('distdir', %opts, dir => $dir);
$parser->getoptionsfromarray($opts{arguments}, \%opts, qw/release! author!/);
my $env = join ' ', map { $opts{$_} ? uc($_) . '_TESTING=1' : () } qw/release author automated/;
system "cd '$dir'; '$Config{perlpath}' Build.PL; ./Build; $env ./Build test";
},
run => sub {
my %opts = @_;
require File::Temp;
my $dir = File::Temp::tempdir(CLEANUP => 1);
dispatch('distdir', %opts, dir => $dir);
my $command = @{ $opts{arguments} } ? join ' ', @{ $opts{arguments} } : $ENV{SHELL};
system "cd '$dir'; '$Config{perlpath}' Build.PL; ./Build; $command";
},
listdeps => sub {
my %opts = @_;
$parser->getoptionsfromarray($opts{arguments}, \%opts, qw/json/);
my $meta = get_meta();
if (!$opts{json}) {
print "$_\n" for sort map { $meta->effective_prereqs->requirements_for($_, 'requires')->required_modules } qw/configure build test runtime/;
}
else {
my $hash = $meta->effective_prereqs->as_string_hash;
require JSON::PP;
print JSON::PP->new->ascii->pretty->encode($hash);
}
},
regenerate => sub {
my %opts = @_;
my %files = map { $_ => 1 } @{ $opts{arguments} } ? @{ $opts{arguments} } : qw/Build.PL META.json META.yml MANIFEST/;
my $meta = get_meta(regenerate => \%files);
my $content = get_files(%opts, meta => $meta, regenerate => \%files);
for my $filename (keys %files) {
mkpath(dirname($filename)) if not -d dirname($filename);
write_file($filename, $content->{$filename}) if $content->{$filename};
}
},
);
sub dispatch {
my ($action, %options) = @_;
my $call = $actions{$action};
croak "No such action '$action' known\n" if not $call;
return $call->(%options);
}
sub modulebuildtiny {
my ($action, @arguments) = @_;
$parser->getoptionsfromarray(\@arguments, \my %opts, 'verbose!');
croak 'No action given' unless defined $action;
return dispatch($action, %opts, arguments => \@arguments);
}
1;
=head1 NAME
App::ModuleBuildTiny - A standalone authoring tool for Module::Build::Tiny
=head1 VERSION
version 0.005
=head1 DESCRIPTION
App::ModuleBuildTiny contains the implementation of the L<mbtiny> tool.
=head1 FUNCTIONS
=over 4
=item * modulebuildtiny($action, @arguments)
This function runs a modulebuildtiny command. It expects at least one argument: the action. It may receive additional ARGV style options, the only one defined for all actions is C<verbose>.
The actions are documented in the L<mbtiny> documentation.
=back
=head1 SEE ALSO
=head2 Helpers
=over 4
=item * L<scan_prereqs_cpanfile|scan_prereqs_cpanfile>
=item * L<cpan-upload|cpan-upload>
=item * L<perl-reversion|perl-reversion>
=back
=head2 Similar programs
=over 4
=item * L<Dist::Zilla|Dist::Zilla>
=item * L<Minilla|Minilla>
=back
=head1 AUTHOR
Leon Timmermans <leont@cpan.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2011 by Leon Timmermans.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
=begin Pod::Coverage
write_file
get_meta
dispatch
get_files
prereqs_for
=end Pod::Coverage