use strict;
use warnings;
package Dist::Zilla::Plugin::CheckLib;
BEGIN {
$Dist::Zilla::Plugin::CheckLib::AUTHORITY = 'cpan:ETHER';
}
# git description: c9935dc
$Dist::Zilla::Plugin::CheckLib::VERSION = '0.001';
# ABSTRACT: Require that our distribution has a particular library available
# vim: set ts=8 sw=4 tw=78 et :
use Moose;
with 'Dist::Zilla::Role::InstallTool',
'Dist::Zilla::Role::PrereqSource',
;
use namespace::autoclean;
my @list_options = qw(header incpath lib libpath);
sub mvp_multivalue_args { @list_options }
foreach my $option (@list_options)
{
has $option => (
isa => 'ArrayRef[Str]',
lazy => 1,
default => sub { [] },
traits => ['Array'],
handles => { $option => 'elements' },
);
}
my @string_options = qw(INC LIBS debug);
has \@string_options => (
is => 'ro', isa => 'Str',
);
sub register_prereqs {
my $self = shift;
$self->zilla->register_prereqs(
{
phase => 'configure',
type => 'requires',
},
'Devel::CheckLib' => '0',
);
}
# XXX - this should really be a separate phase that runs after InstallTool -
# until then, all we can do is die if we are run too soon
sub setup_installer {
my $self = shift;
my @mfpl = grep { $_->name eq 'Makefile.PL' or $_->name eq 'Build.PL' } @{ $self->zilla->files };
$self->log_fatal('No Makefile.PL or Build.PL was found. [CheckLib] should appear in dist.ini after [MakeMaker] or variant!') unless @mfpl;
for my $mfpl (@mfpl)
{
# build a list of tuples: field name => string
my @options = (
(map {
my @stuff = map { '\'' . $_ . '\'' } $self->$_;
@stuff
? [ $_ => @stuff > 1 ? ('[ ' . join(', ', @stuff) . ' ]') : $stuff[0] ]
: ()
} @list_options),
(map {
$self->$_
? [ $_ => '\'' . $self->$_ . '\'' ]
: ()
} @string_options),
);
my $content = "use Devel::CheckLib;\n"
. "check_lib_or_exit(\n"
. join('',
map { ' ' . $_->[0] . ' => ' . $_->[1] . ",\n" } @options
)
. ");\n\n";
$mfpl->content($content . $mfpl->content);
}
return;
}
__PACKAGE__->meta->make_immutable;
__END__
=pod
=encoding UTF-8
=for :stopwords Karen Etheridge incpaths irc
=head1 NAME
Dist::Zilla::Plugin::CheckLib - Require that our distribution has a particular library available
=head1 VERSION
version 0.001
=head1 SYNOPSIS
In your F<dist.ini>:
[CheckLib]
lib = jpeg
header = jpeglib.h
=head1 DESCRIPTION
This is a L<Dist::Zilla> plugin that modifies the F<Makefile.PL> or
F<Build.PL> in your distribution to contain a L<Devel::CheckLib> call, that
asserts that a particular library and/or header is available. If it is not
available, the program exits with a status of zero, which on a
L<CPAN Testers|cpantesters.org> machine will result in a NA result.
=for Pod::Coverage mvp_multivalue_args register_prereqs setup_installer
=head1 CONFIGURATION OPTIONS
All options are as documented in L<Devel::CheckLib>:
=head2 C<lib>
A string with the name of a single library name. Can be used more than once.
Depending on the compiler found, library names will be fed to the compiler
either as C<-l> arguments or as C<.lib> file names. (e.g. C<-ljpeg> or
C<jpeg.lib>)
=head2 C<libpath>
Additional path to search for libraries. Can be used more than once.
=head2 C<LIBS>
A L<ExtUtils::MakeMaker>-style space-separated list of libraries (each preceded by C<-l>) and directories (preceded by C<-L>).
=head2 C<debug>
If true, emit information during processing that can be used for debugging.
=head2 C<header>
The name of a single header file name. Can be used more than once.
=head2 C<incpath>
An additional path to search for headers. Can be used more than once.
=head2 C<INC>
A L<ExtUtils::MakeMaker>-style space-separated list of incpaths, each preceded by C<-I>.
=head1 SUPPORT
Bugs may be submitted through L<the RT bug tracker|https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-CheckLib>
(or L<bug-Dist-Zilla-Plugin-CheckLib@rt.cpan.org|mailto:bug-Dist-Zilla-Plugin-CheckLib@rt.cpan.org>).
I am also usually active on irc, as 'ether' at C<irc.perl.org>.
=head1 SEE ALSO
=over 4
=item *
L<Devel::CheckLib>
=item *
L<Devel::AssertOS> and L<Dist::Zilla::Plugin::AssertOS>
=item *
L<Devel::CheckBin> and L<Dist::Zilla::Plugin::CheckBin>
=back
=head1 AUTHOR
Karen Etheridge <ether@cpan.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by Karen Etheridge.
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