NAME

Alien::Cowl - Find or build Cowl

SYNOPSIS

From ExtUtils::MakeMaker:

use ExtUtils::MakeMaker;
use Alien::Base::Wrapper ();

WriteMakefile(
  Alien::Base::Wrapper->new('Alien::Cowl')->mm_args2(
    NAME => 'FOO::XS',
    ...
  ),
);

From Module::Build:

use Module::Build;
use Alien::Base::Wrapper qw( Alien::Cowl !export );
use Alien::Cowl;

my $build = Module::Build->new(
  ...
  configure_requires => {
    'Alien::Base::Wrapper' => '0',
    'Alien::Cowl' => '0',
    ...
  },
  Alien::Base::Wrapper->mb_args,
  ...
);

$build->create_build_script;

From Inline::C / Inline::CPP script:

use Inline 0.56 with => 'Alien::Cowl';

From Dist::Zilla

[@Filter]
-bundle = @Basic
-remove = MakeMaker

[Prereqs / ConfigureRequires]
Alien::Cowl = 0

[MakeMaker::Awesome]
header = use Alien::Base::Wrapper qw( Alien::Cowl !export );
WriteMakefile_arg = Alien::Base::Wrapper->mm_args

From FFI::Platypus:

use FFI::Platypus;
use Alien::Cowl;

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

DESCRIPTION

This distribution provides Cowl 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 Cowl 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

Cowl documentation

Alien

Documentation on the Alien concept itself.

Alien::Base

The base class for this Alien.

Alien::Build::Manual::AlienUser

Detailed manual for users of Alien classes.