package Alien::Expat;

use strict;
use warnings;
use 5.008001;
use base qw( Alien::Base );

# ABSTRACT: Find or install the Expat stream-oriented XML parser
our $VERSION = '0.02'; # VERSION


1;

__END__

=pod

=encoding UTF-8

=head1 NAME

Alien::Expat - Find or install the Expat stream-oriented XML parser

=head1 VERSION

version 0.02

=head1 SYNOPSIS

in your Makefile.PL:

 use ExtUtils::MakeMaker;
 use Alien::Base::Wrapper qw( Alien::Expat !export );
 
 WriteMakefile(
   ...
   CONFIGURE_REQUIRES => {
     'Alien::Base::Wrapper' => 0,
     'Alien::Expat'         => 0,
   },
   Alien::Base::Wrapper->mm_args,
   ...
 );

or your Build.PL:

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

or your dist.ini:

 [@Filter]
 -bundle = @Basic
 -remove = MakeMaker
 
 [Prereqs / ConfigureRequires]
 Alien::Expat = 0
 
 [MakeMaker::Awesome]
 header = use Alien::Base::Wrapper qw( Alien::Expat !export );
 WriteMakefile_arg = Alien::Base::Wrapper->mm_args

or L<FFI::Platypus>:

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

or for xmlwf from your Perl script / module

 use Alien::Expat;
 use Env qw( @PATH );
 
 unshift @PATH, Alien::Expat->bin_dir;
 system 'xmlwf', '-v';

=head1 DESCRIPTION

This module can be used as a prereq for XS or FFI modules that need expat or the
command-line tool that it comes from: xmlwf.  For more detail on how to use this
module you can see the L<Alien::Build> user documentation at
L<Alien::Build::Manual::AlienUser>.

=head1 SEE ALSO

=over 4

=item L<Alien::Build::Manual::AlienUser>

=back

=head1 AUTHOR

Graham Ollis <plicease@cpan.org>

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2019 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
