NAME

    Alien::libpcre - Find or download and install libpcre (The "Perl
    Compatible" Regular Expressions library)

VERSION

    version 0.01

SYNOPSIS

    In your Makefile.PL:

     use ExtUtils::MakeMaker;
     use Alien::Base::Wrapper ();
    
     WriteMakefile(
       Alien::Base::Wrapper->new('Alien::libpcre')->mm_args2(
         # MakeMaker args
         NAME => 'My::XS',
         ...
       ),
     );

    In your Build.PL:

     use Module::Build;
     use Alien::Base::Wrapper qw( Alien::libpcre !export );
    
     my $builder = Module::Build->new(
       ...
       configure_requires => {
         'Alien::libpcre' => '0',
         ...
       },
       Alien::Base::Wrapper->mb_args,
       ...
     );
    
     $build->create_build_script;

    In your FFI::Platypus script or module:

     use FFI::Platypus;
     use Alien::libpcre;
    
     my $ffi = FFI::Platypus->new(
       lib => [ Alien::libpcre->dynamic_libs ],
     );

DESCRIPTION

    This distribution provides pcre so that it can be used by other Perl
    distributions that are on CPAN. It does this by first trying to detect
    an existing install of pcre on your system. If found it will use that.
    If it cannot be found, the source code will be downloaded from the
    internet and it will be installed in a private share location for the
    use of other modules.

SEE ALSO

    Alien, Alien::Base, Alien::Build::Manual::AlienUser

CAVEATS

    The pcre, is not, as the name might suggest, actually compatible with
    modern Perl regular expressions.

AUTHOR

    Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

    This software is copyright (c) 2020 by Graham Ollis.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.

