Current File : //usr/local/lib64/perl5/Alien/Libxml2.pm
package Alien::Libxml2;
use strict;
use warnings;
use base qw( Alien::Base );
# ABSTRACT: Install the C libxml2 library on your system
our $VERSION = '0.19'; # VERSION
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
Alien::Libxml2 - Install the C libxml2 library on your system
=head1 VERSION
version 0.19
=head1 SYNOPSIS
In your Makefile.PL:
use ExtUtils::MakeMaker;
use Alien::Base::Wrapper ();
WriteMakefile(
Alien::Base::Wrapper->new('Alien::Libxml2')->mm_args2(
# MakeMaker args
NAME => 'My::XS',
...
),
);
In your Build.PL:
use Module::Build;
use Alien::Base::Wrapper qw( Alien::Libxml2 !export );
my $builder = Module::Build->new(
...
configure_requires => {
'Alien::Libxml2' => '0',
...
},
Alien::Base::Wrapper->mb_args,
...
);
$build->create_build_script;
In your L<FFI::Platypus> script or module:
use FFI::Platypus;
use Alien::Libxml2;
my $ffi = FFI::Platypus->new(
lib => [ Alien::Libxml2->dynamic_libs ],
);
=head1 DESCRIPTION
This module provides C<libxml2> for other modules to use.
=head1 CAVEATS
There was an older existing L<Alien::LibXML>, but it uses the older
L<Alien::Build::ModuleBuild> and the author prefers this version which
is based on the more robust L<alienfile> system.
C<libxml2> has some optional prereqs, including C<zlib> and C<iconv>.
For a C<share> install you will want to make sure that these are installed
prior to installing L<Alien::Libxml2> if you want to make use of features
relying on them.
For a system install, you want to make sure the development packages for
C<libxml2>, C<zlib> and C<iconv> are installed if C<libxml2> has been
configured to use them, otherwise L<XML::LibXML> will not install as
expected. If the tests for this module fail with a missing C<iconv.h>
or C<zlib.h>, then this is likely the reason.
=head1 SEE ALSO
=over 4
=item L<Alien::LibXML>
Older Alien for the same library.
=item L<XML::LibXML>
Perl interface to C<libxml2>, which uses this L<Alien>
=back
=head1 AUTHOR
Author: Graham Ollis E<lt>plicease@cpan.orgE<gt>
Contributors:
Shlomi Fish (shlomif)
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2013-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.
=cut