NAME
Dist::Zilla::Plugin::FFI::Build - Add FFI::Build to your Makefile.PL
VERSION
version 1.07
SYNOPSIS
[FFI::Build]
DESCRIPTION
This plugin makes the appropriate modifications to your dist to allow you to bundle code with FFI::Platypus::Bundle. It works with FFI::Build::MM, and only works with ExtUtils::MakeMaker, so don't try to use it with Module::Build.
It specifically:
- Updates
Makefile.PL
-
To call FFI::Build::MM to add the necessary hooks to build and install your bundled code.
- Sets configure-time prereqs
-
For FFI::Build::MM. It also makes the prereqs for your distribution dynamic, which is required for FFI::Build::MM.
- Prunes any build files
-
Removes any files in
ffi/_build
which may be created when developing an FFI module using the bundle interface.
This plugin adds the appropriate hooks for FFI::Build::MM into your Makefile.PL
. It does not work with Module::Build.
PROPERTIES
lang
If you are using a language plugin then you can specify it here. It will add it as a prereq. This should be the "short" name of the plugin, without the FFI::Platypus::Lang
prefix. So for example for FFI::Platypus::Lang::Rust you would just set this to Rust
.
In addition setting these lang
to these languages will have the following additional affects:
Rust
-
The paths
ffi/target
andt/ffi/target
will be pruned when building the dist. This is usually what you want.
build
If you need a language specific builder this is where you specify it. These are classes that live in the FFI::Build::File::
namespace. For example for Rust you would specify Cargo and for Go you would specify GoMod.
Setting this property will add the appropriate module as a configure time prereq.
You do not usually need this for the C programming language.
AUTHOR
Author: Graham Ollis <plicease@cpan.org>
Contributors:
Zaki Mughal (zmughal)
COPYRIGHT AND LICENSE
This software is copyright (c) 2018-2022 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.