-
-
28 Oct 2021 01:56:41 UTC
- Distribution: FFI-Platypus
- Module version: 1.56
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues (14)
- Testers (1470 / 14 / 0)
- Kwalitee
Bus factor: 1- 71.39% Coverage
- License: perl_5
- Perl: v5.8.4
- Activity
24 month- Tools
- Download (378KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
and 19 contributors- Bakkiaraj Murugesan (bakkiaraj)
- Dylan Cali (calid)
- pipcet
- Zaki Mughal (zmughal)
- Fitz Elliott (felliott)
- Vickenty Fesunov (vyf)
- Gregor Herrmann (gregoa)
- Shlomi Fish (shlomif)
- Damyan Ivanov
- Ilya Pavlov (Ilya33)
- Petr PÃsaÅ™ (ppisar)
- Mohammad S Anwar (MANWAR)
- Håkon Hægland (hakonhagland, HAKONH)
- Meredith (merrilymeredith, MHOWARD)
- Diab Jerius (DJERIUS)
- Eric Brine (IKEGAMI)
- szTheory
- José JoaquÃn Atria (JJATRIA)
- Pete Houston (openstrike, HOUSTON)
- Dependencies
- Capture::Tiny
- ExtUtils::MakeMaker
- FFI::CheckLib
- IPC::Cmd
- JSON::PP
- List::Util
- constant
- parent
- and possibly others
- Reverse dependencies
- CPAN Testers List
- Dependency graph
NAME
FFI::Build::MM - FFI::Build installer code for ExtUtils::MakeMaker
VERSION
version 1.56
SYNOPSIS
In your Makefile.PL:
use ExtUtils::MakeMaker; use FFI::Build::MM; my $fbmm = FFI::Build::MM->new; WriteMakefile($fbmm->mm_args( ABSTRACT => 'My FFI extension', DISTNAME => 'Foo-Bar-Baz-FFI', NAME => 'Foo::Bar::Baz::FFI', VERSION_FROM => 'lib/Foo/Bar/Baz/FFI.pm', ... )); sub MY::postamble { $fbmm->mm_postamble; }
Then put the C, C++ or Fortran files in
./ffi
for your runtime library and./t/ffi
for your test time library.DESCRIPTION
This module provides a thin layer between FFI::Build and ExtUtils::MakeMaker. Its interface is influenced by the design of Alien::Build::MM. The idea is that for your distribution you throw some C, C++ or Fortran source files into a directory called
ffi
and these files will be compiled and linked into a library that can be used by your module. There is a control fileffi/*.fbx
which can be used to control the compiler and linker options. (options passed directly into FFI::Build). The interface for this file is still under development.CONSTRUCTOR
new
my $fbmm = FFI::Build::MM->new;
Create a new instance of FFI::Build::MM.
METHODS
mm_args
my %new_args = $fbmm->mm_args(%old_args);
This method does two things:
- reads the arguments to determine sensible defaults (library name, install location, etc).
- adjusts the arguments as necessary and returns an updated set of arguments.
mm_postamble
my $postamble = $fbmm->mm_postamble;
This returns the Makefile postamble used by ExtUtils::MakeMaker. The synopsis above for how to invoke it properly. It adds the following Make targets:
- fbx_build / ffi
-
build the main runtime library in
./ffi
. - fbx_test / ffi-test
-
Build the test library in
./t/ffi
. - fbx_clean / ffi-clean
-
Clean any runtime or test libraries already built.
Normally you do not need to build these targets manually, they will be built automatically at the appropriate stage.
AUTHOR
Author: Graham Ollis <plicease@cpan.org>
Contributors:
Bakkiaraj Murugesan (bakkiaraj)
Dylan Cali (calid)
pipcet
Zaki Mughal (zmughal)
Fitz Elliott (felliott)
Vickenty Fesunov (vyf)
Gregor Herrmann (gregoa)
Shlomi Fish (shlomif)
Damyan Ivanov
Ilya Pavlov (Ilya33)
Petr Písař (ppisar)
Mohammad S Anwar (MANWAR)
Håkon Hægland (hakonhagland, HAKONH)
Meredith (merrilymeredith, MHOWARD)
Diab Jerius (DJERIUS)
Eric Brine (IKEGAMI)
szTheory
José Joaquín Atria (JJATRIA)
Pete Houston (openstrike, HOUSTON)
COPYRIGHT AND LICENSE
This software is copyright (c) 2015,2016,2017,2018,2019,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.
Module Install Instructions
To install FFI::Platypus, copy and paste the appropriate command in to your terminal.
cpanm FFI::Platypus
perl -MCPAN -e shell install FFI::Platypus
For more information on module installation, please visit the detailed CPAN module installation guide.