[Bps-public-commit] Parse-ACNS branch, master, created. e966694747235df6d87581a6892067410800f66d
Ruslan Zakirov
ruz at bestpractical.com
Wed Jan 26 07:40:59 EST 2011
The branch, master has been created
at e966694747235df6d87581a6892067410800f66d (commit)
- Log -----------------------------------------------------------------
commit d8cc55a26c7cac22359fd75879486eb8d2dc4e1f
Author: Ruslan Zakirov <ruz at bestpractical.com>
Date: Wed Jan 26 13:58:42 2011 +0300
initial commit
diff --git a/META.yml b/META.yml
new file mode 100644
index 0000000..011395b
--- /dev/null
+++ b/META.yml
@@ -0,0 +1,32 @@
+---
+abstract: 'parser for Automated Copyright Notice System (ACNS) XML'
+author:
+ - 'Ruslan Zakirov <ruz at bestpractical.com>'
+build_requires:
+ ExtUtils::MakeMaker: 6.42
+configure_requires:
+ ExtUtils::MakeMaker: 6.42
+distribution_type: module
+generated_by: 'Module::Install version 1.00'
+license: perl
+meta-spec:
+ url: http://module-build.sourceforge.net/META-spec-v1.4.html
+ version: 1.4
+module_name: Parse::ACNS
+name: Parse-ACNS
+no_index:
+ directory:
+ - inc
+ - share
+ - t
+requires:
+ Carp: 0
+ File::ShareDir: 0
+ File::Spec: 0
+ Scalar::Util: 0
+ XML::Compile::Schema: 0
+ XML::LibXML: 0
+ perl: 5.8.0
+resources:
+ license: http://dev.perl.org/licenses/
+version: 0.01
diff --git a/Makefile.PL b/Makefile.PL
new file mode 100644
index 0000000..cea23c8
--- /dev/null
+++ b/Makefile.PL
@@ -0,0 +1,16 @@
+use inc::Module::Install;
+all_from 'lib/Parse/ACNS.pm';
+readme_from 'lib/Parse/ACNS.pm';
+
+install_share;
+
+requires 'XML::Compile::Schema';
+requires 'XML::LibXML';
+
+requires 'Carp';
+requires 'File::Spec';
+requires 'Scalar::Util';
+requires 'File::ShareDir';
+requires 'File::Spec';
+
+WriteAll;
diff --git a/README b/README
new file mode 100644
index 0000000..5e796a9
--- /dev/null
+++ b/README
@@ -0,0 +1,17 @@
+NAME
+ Parse::ACNS - parser for Automated Copyright Notice System (ACNS) XML
+
+SYNOPSIS
+ use Parse::ACNS;
+ my $parser = Parse::ACNS->new(
+ version => 'compat',
+ );
+ $parser->parse( );
+
+DESCRIPTION
+AUTHOR
+ Ruslan Zakirov <ruz at bestpractical.com>
+
+LICENSE
+ Under the same terms as perl itself.
+
diff --git a/inc/Module/Install.pm b/inc/Module/Install.pm
new file mode 100644
index 0000000..8ee839d
--- /dev/null
+++ b/inc/Module/Install.pm
@@ -0,0 +1,470 @@
+#line 1
+package Module::Install;
+
+# For any maintainers:
+# The load order for Module::Install is a bit magic.
+# It goes something like this...
+#
+# IF ( host has Module::Install installed, creating author mode ) {
+# 1. Makefile.PL calls "use inc::Module::Install"
+# 2. $INC{inc/Module/Install.pm} set to installed version of inc::Module::Install
+# 3. The installed version of inc::Module::Install loads
+# 4. inc::Module::Install calls "require Module::Install"
+# 5. The ./inc/ version of Module::Install loads
+# } ELSE {
+# 1. Makefile.PL calls "use inc::Module::Install"
+# 2. $INC{inc/Module/Install.pm} set to ./inc/ version of Module::Install
+# 3. The ./inc/ version of Module::Install loads
+# }
+
+use 5.005;
+use strict 'vars';
+use Cwd ();
+use File::Find ();
+use File::Path ();
+
+use vars qw{$VERSION $MAIN};
+BEGIN {
+ # All Module::Install core packages now require synchronised versions.
+ # This will be used to ensure we don't accidentally load old or
+ # different versions of modules.
+ # This is not enforced yet, but will be some time in the next few
+ # releases once we can make sure it won't clash with custom
+ # Module::Install extensions.
+ $VERSION = '1.00';
+
+ # Storage for the pseudo-singleton
+ $MAIN = undef;
+
+ *inc::Module::Install::VERSION = *VERSION;
+ @inc::Module::Install::ISA = __PACKAGE__;
+
+}
+
+sub import {
+ my $class = shift;
+ my $self = $class->new(@_);
+ my $who = $self->_caller;
+
+ #-------------------------------------------------------------
+ # all of the following checks should be included in import(),
+ # to allow "eval 'require Module::Install; 1' to test
+ # installation of Module::Install. (RT #51267)
+ #-------------------------------------------------------------
+
+ # Whether or not inc::Module::Install is actually loaded, the
+ # $INC{inc/Module/Install.pm} is what will still get set as long as
+ # the caller loaded module this in the documented manner.
+ # If not set, the caller may NOT have loaded the bundled version, and thus
+ # they may not have a MI version that works with the Makefile.PL. This would
+ # result in false errors or unexpected behaviour. And we don't want that.
+ my $file = join( '/', 'inc', split /::/, __PACKAGE__ ) . '.pm';
+ unless ( $INC{$file} ) { die <<"END_DIE" }
+
+Please invoke ${\__PACKAGE__} with:
+
+ use inc::${\__PACKAGE__};
+
+not:
+
+ use ${\__PACKAGE__};
+
+END_DIE
+
+ # This reportedly fixes a rare Win32 UTC file time issue, but
+ # as this is a non-cross-platform XS module not in the core,
+ # we shouldn't really depend on it. See RT #24194 for detail.
+ # (Also, this module only supports Perl 5.6 and above).
+ eval "use Win32::UTCFileTime" if $^O eq 'MSWin32' && $] >= 5.006;
+
+ # If the script that is loading Module::Install is from the future,
+ # then make will detect this and cause it to re-run over and over
+ # again. This is bad. Rather than taking action to touch it (which
+ # is unreliable on some platforms and requires write permissions)
+ # for now we should catch this and refuse to run.
+ if ( -f $0 ) {
+ my $s = (stat($0))[9];
+
+ # If the modification time is only slightly in the future,
+ # sleep briefly to remove the problem.
+ my $a = $s - time;
+ if ( $a > 0 and $a < 5 ) { sleep 5 }
+
+ # Too far in the future, throw an error.
+ my $t = time;
+ if ( $s > $t ) { die <<"END_DIE" }
+
+Your installer $0 has a modification time in the future ($s > $t).
+
+This is known to create infinite loops in make.
+
+Please correct this, then run $0 again.
+
+END_DIE
+ }
+
+
+ # Build.PL was formerly supported, but no longer is due to excessive
+ # difficulty in implementing every single feature twice.
+ if ( $0 =~ /Build.PL$/i ) { die <<"END_DIE" }
+
+Module::Install no longer supports Build.PL.
+
+It was impossible to maintain duel backends, and has been deprecated.
+
+Please remove all Build.PL files and only use the Makefile.PL installer.
+
+END_DIE
+
+ #-------------------------------------------------------------
+
+ # To save some more typing in Module::Install installers, every...
+ # use inc::Module::Install
+ # ...also acts as an implicit use strict.
+ $^H |= strict::bits(qw(refs subs vars));
+
+ #-------------------------------------------------------------
+
+ unless ( -f $self->{file} ) {
+ foreach my $key (keys %INC) {
+ delete $INC{$key} if $key =~ /Module\/Install/;
+ }
+
+ local $^W;
+ require "$self->{path}/$self->{dispatch}.pm";
+ File::Path::mkpath("$self->{prefix}/$self->{author}");
+ $self->{admin} = "$self->{name}::$self->{dispatch}"->new( _top => $self );
+ $self->{admin}->init;
+ @_ = ($class, _self => $self);
+ goto &{"$self->{name}::import"};
+ }
+
+ local $^W;
+ *{"${who}::AUTOLOAD"} = $self->autoload;
+ $self->preload;
+
+ # Unregister loader and worker packages so subdirs can use them again
+ delete $INC{'inc/Module/Install.pm'};
+ delete $INC{'Module/Install.pm'};
+
+ # Save to the singleton
+ $MAIN = $self;
+
+ return 1;
+}
+
+sub autoload {
+ my $self = shift;
+ my $who = $self->_caller;
+ my $cwd = Cwd::cwd();
+ my $sym = "${who}::AUTOLOAD";
+ $sym->{$cwd} = sub {
+ my $pwd = Cwd::cwd();
+ if ( my $code = $sym->{$pwd} ) {
+ # Delegate back to parent dirs
+ goto &$code unless $cwd eq $pwd;
+ }
+ unless ($$sym =~ s/([^:]+)$//) {
+ # XXX: it looks like we can't retrieve the missing function
+ # via $$sym (usually $main::AUTOLOAD) in this case.
+ # I'm still wondering if we should slurp Makefile.PL to
+ # get some context or not ...
+ my ($package, $file, $line) = caller;
+ die <<"EOT";
+Unknown function is found at $file line $line.
+Execution of $file aborted due to runtime errors.
+
+If you're a contributor to a project, you may need to install
+some Module::Install extensions from CPAN (or other repository).
+If you're a user of a module, please contact the author.
+EOT
+ }
+ my $method = $1;
+ if ( uc($method) eq $method ) {
+ # Do nothing
+ return;
+ } elsif ( $method =~ /^_/ and $self->can($method) ) {
+ # Dispatch to the root M:I class
+ return $self->$method(@_);
+ }
+
+ # Dispatch to the appropriate plugin
+ unshift @_, ( $self, $1 );
+ goto &{$self->can('call')};
+ };
+}
+
+sub preload {
+ my $self = shift;
+ unless ( $self->{extensions} ) {
+ $self->load_extensions(
+ "$self->{prefix}/$self->{path}", $self
+ );
+ }
+
+ my @exts = @{$self->{extensions}};
+ unless ( @exts ) {
+ @exts = $self->{admin}->load_all_extensions;
+ }
+
+ my %seen;
+ foreach my $obj ( @exts ) {
+ while (my ($method, $glob) = each %{ref($obj) . '::'}) {
+ next unless $obj->can($method);
+ next if $method =~ /^_/;
+ next if $method eq uc($method);
+ $seen{$method}++;
+ }
+ }
+
+ my $who = $self->_caller;
+ foreach my $name ( sort keys %seen ) {
+ local $^W;
+ *{"${who}::$name"} = sub {
+ ${"${who}::AUTOLOAD"} = "${who}::$name";
+ goto &{"${who}::AUTOLOAD"};
+ };
+ }
+}
+
+sub new {
+ my ($class, %args) = @_;
+
+ delete $INC{'FindBin.pm'};
+ {
+ # to suppress the redefine warning
+ local $SIG{__WARN__} = sub {};
+ require FindBin;
+ }
+
+ # ignore the prefix on extension modules built from top level.
+ my $base_path = Cwd::abs_path($FindBin::Bin);
+ unless ( Cwd::abs_path(Cwd::cwd()) eq $base_path ) {
+ delete $args{prefix};
+ }
+ return $args{_self} if $args{_self};
+
+ $args{dispatch} ||= 'Admin';
+ $args{prefix} ||= 'inc';
+ $args{author} ||= ($^O eq 'VMS' ? '_author' : '.author');
+ $args{bundle} ||= 'inc/BUNDLES';
+ $args{base} ||= $base_path;
+ $class =~ s/^\Q$args{prefix}\E:://;
+ $args{name} ||= $class;
+ $args{version} ||= $class->VERSION;
+ unless ( $args{path} ) {
+ $args{path} = $args{name};
+ $args{path} =~ s!::!/!g;
+ }
+ $args{file} ||= "$args{base}/$args{prefix}/$args{path}.pm";
+ $args{wrote} = 0;
+
+ bless( \%args, $class );
+}
+
+sub call {
+ my ($self, $method) = @_;
+ my $obj = $self->load($method) or return;
+ splice(@_, 0, 2, $obj);
+ goto &{$obj->can($method)};
+}
+
+sub load {
+ my ($self, $method) = @_;
+
+ $self->load_extensions(
+ "$self->{prefix}/$self->{path}", $self
+ ) unless $self->{extensions};
+
+ foreach my $obj (@{$self->{extensions}}) {
+ return $obj if $obj->can($method);
+ }
+
+ my $admin = $self->{admin} or die <<"END_DIE";
+The '$method' method does not exist in the '$self->{prefix}' path!
+Please remove the '$self->{prefix}' directory and run $0 again to load it.
+END_DIE
+
+ my $obj = $admin->load($method, 1);
+ push @{$self->{extensions}}, $obj;
+
+ $obj;
+}
+
+sub load_extensions {
+ my ($self, $path, $top) = @_;
+
+ my $should_reload = 0;
+ unless ( grep { ! ref $_ and lc $_ eq lc $self->{prefix} } @INC ) {
+ unshift @INC, $self->{prefix};
+ $should_reload = 1;
+ }
+
+ foreach my $rv ( $self->find_extensions($path) ) {
+ my ($file, $pkg) = @{$rv};
+ next if $self->{pathnames}{$pkg};
+
+ local $@;
+ my $new = eval { local $^W; require $file; $pkg->can('new') };
+ unless ( $new ) {
+ warn $@ if $@;
+ next;
+ }
+ $self->{pathnames}{$pkg} =
+ $should_reload ? delete $INC{$file} : $INC{$file};
+ push @{$self->{extensions}}, &{$new}($pkg, _top => $top );
+ }
+
+ $self->{extensions} ||= [];
+}
+
+sub find_extensions {
+ my ($self, $path) = @_;
+
+ my @found;
+ File::Find::find( sub {
+ my $file = $File::Find::name;
+ return unless $file =~ m!^\Q$path\E/(.+)\.pm\Z!is;
+ my $subpath = $1;
+ return if lc($subpath) eq lc($self->{dispatch});
+
+ $file = "$self->{path}/$subpath.pm";
+ my $pkg = "$self->{name}::$subpath";
+ $pkg =~ s!/!::!g;
+
+ # If we have a mixed-case package name, assume case has been preserved
+ # correctly. Otherwise, root through the file to locate the case-preserved
+ # version of the package name.
+ if ( $subpath eq lc($subpath) || $subpath eq uc($subpath) ) {
+ my $content = Module::Install::_read($subpath . '.pm');
+ my $in_pod = 0;
+ foreach ( split //, $content ) {
+ $in_pod = 1 if /^=\w/;
+ $in_pod = 0 if /^=cut/;
+ next if ($in_pod || /^=cut/); # skip pod text
+ next if /^\s*#/; # and comments
+ if ( m/^\s*package\s+($pkg)\s*;/i ) {
+ $pkg = $1;
+ last;
+ }
+ }
+ }
+
+ push @found, [ $file, $pkg ];
+ }, $path ) if -d $path;
+
+ @found;
+}
+
+
+
+
+
+#####################################################################
+# Common Utility Functions
+
+sub _caller {
+ my $depth = 0;
+ my $call = caller($depth);
+ while ( $call eq __PACKAGE__ ) {
+ $depth++;
+ $call = caller($depth);
+ }
+ return $call;
+}
+
+# Done in evals to avoid confusing Perl::MinimumVersion
+eval( $] >= 5.006 ? <<'END_NEW' : <<'END_OLD' ); die $@ if $@;
+sub _read {
+ local *FH;
+ open( FH, '<', $_[0] ) or die "open($_[0]): $!";
+ my $string = do { local $/; <FH> };
+ close FH or die "close($_[0]): $!";
+ return $string;
+}
+END_NEW
+sub _read {
+ local *FH;
+ open( FH, "< $_[0]" ) or die "open($_[0]): $!";
+ my $string = do { local $/; <FH> };
+ close FH or die "close($_[0]): $!";
+ return $string;
+}
+END_OLD
+
+sub _readperl {
+ my $string = Module::Install::_read($_[0]);
+ $string =~ s/(?:\015{1,2}\012|\015|\012)/\n/sg;
+ $string =~ s/(\n)\n*__(?:DATA|END)__\b.*\z/$1/s;
+ $string =~ s/\n\n=\w+.+?\n\n=cut\b.+?\n+/\n\n/sg;
+ return $string;
+}
+
+sub _readpod {
+ my $string = Module::Install::_read($_[0]);
+ $string =~ s/(?:\015{1,2}\012|\015|\012)/\n/sg;
+ return $string if $_[0] =~ /\.pod\z/;
+ $string =~ s/(^|\n=cut\b.+?\n+)[^=\s].+?\n(\n=\w+|\z)/$1$2/sg;
+ $string =~ s/\n*=pod\b[^\n]*\n+/\n\n/sg;
+ $string =~ s/\n*=cut\b[^\n]*\n+/\n\n/sg;
+ $string =~ s/^\n+//s;
+ return $string;
+}
+
+# Done in evals to avoid confusing Perl::MinimumVersion
+eval( $] >= 5.006 ? <<'END_NEW' : <<'END_OLD' ); die $@ if $@;
+sub _write {
+ local *FH;
+ open( FH, '>', $_[0] ) or die "open($_[0]): $!";
+ foreach ( 1 .. $#_ ) {
+ print FH $_[$_] or die "print($_[0]): $!";
+ }
+ close FH or die "close($_[0]): $!";
+}
+END_NEW
+sub _write {
+ local *FH;
+ open( FH, "> $_[0]" ) or die "open($_[0]): $!";
+ foreach ( 1 .. $#_ ) {
+ print FH $_[$_] or die "print($_[0]): $!";
+ }
+ close FH or die "close($_[0]): $!";
+}
+END_OLD
+
+# _version is for processing module versions (eg, 1.03_05) not
+# Perl versions (eg, 5.8.1).
+sub _version ($) {
+ my $s = shift || 0;
+ my $d =()= $s =~ /(\.)/g;
+ if ( $d >= 2 ) {
+ # Normalise multipart versions
+ $s =~ s/(\.)(\d{1,3})/sprintf("$1%03d",$2)/eg;
+ }
+ $s =~ s/^(\d+)\.?//;
+ my $l = $1 || 0;
+ my @v = map {
+ $_ . '0' x (3 - length $_)
+ } $s =~ /(\d{1,3})\D?/g;
+ $l = $l . '.' . join '', @v if @v;
+ return $l + 0;
+}
+
+sub _cmp ($$) {
+ _version($_[0]) <=> _version($_[1]);
+}
+
+# Cloned from Params::Util::_CLASS
+sub _CLASS ($) {
+ (
+ defined $_[0]
+ and
+ ! ref $_[0]
+ and
+ $_[0] =~ m/^[^\W\d]\w*(?:::\w+)*\z/s
+ ) ? $_[0] : undef;
+}
+
+1;
+
+# Copyright 2008 - 2010 Adam Kennedy.
diff --git a/inc/Module/Install/Base.pm b/inc/Module/Install/Base.pm
new file mode 100644
index 0000000..b55bda3
--- /dev/null
+++ b/inc/Module/Install/Base.pm
@@ -0,0 +1,83 @@
+#line 1
+package Module::Install::Base;
+
+use strict 'vars';
+use vars qw{$VERSION};
+BEGIN {
+ $VERSION = '1.00';
+}
+
+# Suspend handler for "redefined" warnings
+BEGIN {
+ my $w = $SIG{__WARN__};
+ $SIG{__WARN__} = sub { $w };
+}
+
+#line 42
+
+sub new {
+ my $class = shift;
+ unless ( defined &{"${class}::call"} ) {
+ *{"${class}::call"} = sub { shift->_top->call(@_) };
+ }
+ unless ( defined &{"${class}::load"} ) {
+ *{"${class}::load"} = sub { shift->_top->load(@_) };
+ }
+ bless { @_ }, $class;
+}
+
+#line 61
+
+sub AUTOLOAD {
+ local $@;
+ my $func = eval { shift->_top->autoload } or return;
+ goto &$func;
+}
+
+#line 75
+
+sub _top {
+ $_[0]->{_top};
+}
+
+#line 90
+
+sub admin {
+ $_[0]->_top->{admin}
+ or
+ Module::Install::Base::FakeAdmin->new;
+}
+
+#line 106
+
+sub is_admin {
+ ! $_[0]->admin->isa('Module::Install::Base::FakeAdmin');
+}
+
+sub DESTROY {}
+
+package Module::Install::Base::FakeAdmin;
+
+use vars qw{$VERSION};
+BEGIN {
+ $VERSION = $Module::Install::Base::VERSION;
+}
+
+my $fake;
+
+sub new {
+ $fake ||= bless(\@_, $_[0]);
+}
+
+sub AUTOLOAD {}
+
+sub DESTROY {}
+
+# Restore warning handler
+BEGIN {
+ $SIG{__WARN__} = $SIG{__WARN__}->();
+}
+
+1;
+
+#line 159
diff --git a/inc/Module/Install/Can.pm b/inc/Module/Install/Can.pm
new file mode 100644
index 0000000..71ccc27
--- /dev/null
+++ b/inc/Module/Install/Can.pm
@@ -0,0 +1,81 @@
+#line 1
+package Module::Install::Can;
+
+use strict;
+use Config ();
+use File::Spec ();
+use ExtUtils::MakeMaker ();
+use Module::Install::Base ();
+
+use vars qw{$VERSION @ISA $ISCORE};
+BEGIN {
+ $VERSION = '1.00';
+ @ISA = 'Module::Install::Base';
+ $ISCORE = 1;
+}
+
+# check if we can load some module
+### Upgrade this to not have to load the module if possible
+sub can_use {
+ my ($self, $mod, $ver) = @_;
+ $mod =~ s{::|\\}{/}g;
+ $mod .= '.pm' unless $mod =~ /\.pm$/i;
+
+ my $pkg = $mod;
+ $pkg =~ s{/}{::}g;
+ $pkg =~ s{\.pm$}{}i;
+
+ local $@;
+ eval { require $mod; $pkg->VERSION($ver || 0); 1 };
+}
+
+# check if we can run some command
+sub can_run {
+ my ($self, $cmd) = @_;
+
+ my $_cmd = $cmd;
+ return $_cmd if (-x $_cmd or $_cmd = MM->maybe_command($_cmd));
+
+ for my $dir ((split /$Config::Config{path_sep}/, $ENV{PATH}), '.') {
+ next if $dir eq '';
+ my $abs = File::Spec->catfile($dir, $_[1]);
+ return $abs if (-x $abs or $abs = MM->maybe_command($abs));
+ }
+
+ return;
+}
+
+# can we locate a (the) C compiler
+sub can_cc {
+ my $self = shift;
+ my @chunks = split(/ /, $Config::Config{cc}) or return;
+
+ # $Config{cc} may contain args; try to find out the program part
+ while (@chunks) {
+ return $self->can_run("@chunks") || (pop(@chunks), next);
+ }
+
+ return;
+}
+
+# Fix Cygwin bug on maybe_command();
+if ( $^O eq 'cygwin' ) {
+ require ExtUtils::MM_Cygwin;
+ require ExtUtils::MM_Win32;
+ if ( ! defined(&ExtUtils::MM_Cygwin::maybe_command) ) {
+ *ExtUtils::MM_Cygwin::maybe_command = sub {
+ my ($self, $file) = @_;
+ if ($file =~ m{^/cygdrive/}i and ExtUtils::MM_Win32->can('maybe_command')) {
+ ExtUtils::MM_Win32->maybe_command($file);
+ } else {
+ ExtUtils::MM_Unix->maybe_command($file);
+ }
+ }
+ }
+}
+
+1;
+
+__END__
+
+#line 156
diff --git a/inc/Module/Install/Fetch.pm b/inc/Module/Install/Fetch.pm
new file mode 100644
index 0000000..ec1f106
--- /dev/null
+++ b/inc/Module/Install/Fetch.pm
@@ -0,0 +1,93 @@
+#line 1
+package Module::Install::Fetch;
+
+use strict;
+use Module::Install::Base ();
+
+use vars qw{$VERSION @ISA $ISCORE};
+BEGIN {
+ $VERSION = '1.00';
+ @ISA = 'Module::Install::Base';
+ $ISCORE = 1;
+}
+
+sub get_file {
+ my ($self, %args) = @_;
+ my ($scheme, $host, $path, $file) =
+ $args{url} =~ m|^(\w+)://([^/]+)(.+)/(.+)| or return;
+
+ if ( $scheme eq 'http' and ! eval { require LWP::Simple; 1 } ) {
+ $args{url} = $args{ftp_url}
+ or (warn("LWP support unavailable!\n"), return);
+ ($scheme, $host, $path, $file) =
+ $args{url} =~ m|^(\w+)://([^/]+)(.+)/(.+)| or return;
+ }
+
+ $|++;
+ print "Fetching '$file' from $host... ";
+
+ unless (eval { require Socket; Socket::inet_aton($host) }) {
+ warn "'$host' resolve failed!\n";
+ return;
+ }
+
+ return unless $scheme eq 'ftp' or $scheme eq 'http';
+
+ require Cwd;
+ my $dir = Cwd::getcwd();
+ chdir $args{local_dir} or return if exists $args{local_dir};
+
+ if (eval { require LWP::Simple; 1 }) {
+ LWP::Simple::mirror($args{url}, $file);
+ }
+ elsif (eval { require Net::FTP; 1 }) { eval {
+ # use Net::FTP to get past firewall
+ my $ftp = Net::FTP->new($host, Passive => 1, Timeout => 600);
+ $ftp->login("anonymous", 'anonymous at example.com');
+ $ftp->cwd($path);
+ $ftp->binary;
+ $ftp->get($file) or (warn("$!\n"), return);
+ $ftp->quit;
+ } }
+ elsif (my $ftp = $self->can_run('ftp')) { eval {
+ # no Net::FTP, fallback to ftp.exe
+ require FileHandle;
+ my $fh = FileHandle->new;
+
+ local $SIG{CHLD} = 'IGNORE';
+ unless ($fh->open("|$ftp -n")) {
+ warn "Couldn't open ftp: $!\n";
+ chdir $dir; return;
+ }
+
+ my @dialog = split(/\n/, <<"END_FTP");
+open $host
+user anonymous anonymous\@example.com
+cd $path
+binary
+get $file $file
+quit
+END_FTP
+ foreach (@dialog) { $fh->print("$_\n") }
+ $fh->close;
+ } }
+ else {
+ warn "No working 'ftp' program available!\n";
+ chdir $dir; return;
+ }
+
+ unless (-f $file) {
+ warn "Fetching failed: $@\n";
+ chdir $dir; return;
+ }
+
+ return if exists $args{size} and -s $file != $args{size};
+ system($args{run}) if exists $args{run};
+ unlink($file) if $args{remove};
+
+ print(((!exists $args{check_for} or -e $args{check_for})
+ ? "done!" : "failed! ($!)"), "\n");
+ chdir $dir; return !$?;
+}
+
+1;
diff --git a/inc/Module/Install/Makefile.pm b/inc/Module/Install/Makefile.pm
new file mode 100644
index 0000000..5dfd0e9
--- /dev/null
+++ b/inc/Module/Install/Makefile.pm
@@ -0,0 +1,415 @@
+#line 1
+package Module::Install::Makefile;
+
+use strict 'vars';
+use ExtUtils::MakeMaker ();
+use Module::Install::Base ();
+use Fcntl qw/:flock :seek/;
+
+use vars qw{$VERSION @ISA $ISCORE};
+BEGIN {
+ $VERSION = '1.00';
+ @ISA = 'Module::Install::Base';
+ $ISCORE = 1;
+}
+
+sub Makefile { $_[0] }
+
+my %seen = ();
+
+sub prompt {
+ shift;
+
+ # Infinite loop protection
+ my @c = caller();
+ if ( ++$seen{"$c[1]|$c[2]|$_[0]"} > 3 ) {
+ die "Caught an potential prompt infinite loop ($c[1]|$c[2]|$_[0])";
+ }
+
+ # In automated testing or non-interactive session, always use defaults
+ if ( ($ENV{AUTOMATED_TESTING} or -! -t STDIN) and ! $ENV{PERL_MM_USE_DEFAULT} ) {
+ local $ENV{PERL_MM_USE_DEFAULT} = 1;
+ goto &ExtUtils::MakeMaker::prompt;
+ } else {
+ goto &ExtUtils::MakeMaker::prompt;
+ }
+}
+
+# Store a cleaned up version of the MakeMaker version,
+# since we need to behave differently in a variety of
+# ways based on the MM version.
+my $makemaker = eval $ExtUtils::MakeMaker::VERSION;
+
+# If we are passed a param, do a "newer than" comparison.
+# Otherwise, just return the MakeMaker version.
+sub makemaker {
+ ( @_ < 2 or $makemaker >= eval($_[1]) ) ? $makemaker : 0
+}
+
+# Ripped from ExtUtils::MakeMaker 6.56, and slightly modified
+# as we only need to know here whether the attribute is an array
+# or a hash or something else (which may or may not be appendable).
+my %makemaker_argtype = (
+ C => 'ARRAY',
+ CONFIG => 'ARRAY',
+# CONFIGURE => 'CODE', # ignore
+ DIR => 'ARRAY',
+ DL_FUNCS => 'HASH',
+ DL_VARS => 'ARRAY',
+ EXCLUDE_EXT => 'ARRAY',
+ EXE_FILES => 'ARRAY',
+ FUNCLIST => 'ARRAY',
+ H => 'ARRAY',
+ IMPORTS => 'HASH',
+ INCLUDE_EXT => 'ARRAY',
+ LIBS => 'ARRAY', # ignore ''
+ MAN1PODS => 'HASH',
+ MAN3PODS => 'HASH',
+ META_ADD => 'HASH',
+ META_MERGE => 'HASH',
+ PL_FILES => 'HASH',
+ PM => 'HASH',
+ PMLIBDIRS => 'ARRAY',
+ PMLIBPARENTDIRS => 'ARRAY',
+ PREREQ_PM => 'HASH',
+ CONFIGURE_REQUIRES => 'HASH',
+ SKIP => 'ARRAY',
+ TYPEMAPS => 'ARRAY',
+ XS => 'HASH',
+# VERSION => ['version',''], # ignore
+# _KEEP_AFTER_FLUSH => '',
+
+ clean => 'HASH',
+ depend => 'HASH',
+ dist => 'HASH',
+ dynamic_lib=> 'HASH',
+ linkext => 'HASH',
+ macro => 'HASH',
+ postamble => 'HASH',
+ realclean => 'HASH',
+ test => 'HASH',
+ tool_autosplit => 'HASH',
+
+ # special cases where you can use makemaker_append
+ CCFLAGS => 'APPENDABLE',
+ DEFINE => 'APPENDABLE',
+ INC => 'APPENDABLE',
+ LDDLFLAGS => 'APPENDABLE',
+ LDFROM => 'APPENDABLE',
+);
+
+sub makemaker_args {
+ my ($self, %new_args) = @_;
+ my $args = ( $self->{makemaker_args} ||= {} );
+ foreach my $key (keys %new_args) {
+ if ($makemaker_argtype{$key}) {
+ if ($makemaker_argtype{$key} eq 'ARRAY') {
+ $args->{$key} = [] unless defined $args->{$key};
+ unless (ref $args->{$key} eq 'ARRAY') {
+ $args->{$key} = [$args->{$key}]
+ }
+ push @{$args->{$key}},
+ ref $new_args{$key} eq 'ARRAY'
+ ? @{$new_args{$key}}
+ : $new_args{$key};
+ }
+ elsif ($makemaker_argtype{$key} eq 'HASH') {
+ $args->{$key} = {} unless defined $args->{$key};
+ foreach my $skey (keys %{ $new_args{$key} }) {
+ $args->{$key}{$skey} = $new_args{$key}{$skey};
+ }
+ }
+ elsif ($makemaker_argtype{$key} eq 'APPENDABLE') {
+ $self->makemaker_append($key => $new_args{$key});
+ }
+ }
+ else {
+ if (defined $args->{$key}) {
+ warn qq{MakeMaker attribute "$key" is overriden; use "makemaker_append" to append values\n};
+ }
+ $args->{$key} = $new_args{$key};
+ }
+ }
+ return $args;
+}
+
+# For mm args that take multiple space-seperated args,
+# append an argument to the current list.
+sub makemaker_append {
+ my $self = shift;
+ my $name = shift;
+ my $args = $self->makemaker_args;
+ $args->{$name} = defined $args->{$name}
+ ? join( ' ', $args->{$name}, @_ )
+ : join( ' ', @_ );
+}
+
+sub build_subdirs {
+ my $self = shift;
+ my $subdirs = $self->makemaker_args->{DIR} ||= [];
+ for my $subdir (@_) {
+ push @$subdirs, $subdir;
+ }
+}
+
+sub clean_files {
+ my $self = shift;
+ my $clean = $self->makemaker_args->{clean} ||= {};
+ %$clean = (
+ %$clean,
+ FILES => join ' ', grep { length $_ } ($clean->{FILES} || (), @_),
+ );
+}
+
+sub realclean_files {
+ my $self = shift;
+ my $realclean = $self->makemaker_args->{realclean} ||= {};
+ %$realclean = (
+ %$realclean,
+ FILES => join ' ', grep { length $_ } ($realclean->{FILES} || (), @_),
+ );
+}
+
+sub libs {
+ my $self = shift;
+ my $libs = ref $_[0] ? shift : [ shift ];
+ $self->makemaker_args( LIBS => $libs );
+}
+
+sub inc {
+ my $self = shift;
+ $self->makemaker_args( INC => shift );
+}
+
+sub _wanted_t {
+}
+
+sub tests_recursive {
+ my $self = shift;
+ my $dir = shift || 't';
+ unless ( -d $dir ) {
+ die "tests_recursive dir '$dir' does not exist";
+ }
+ my %tests = map { $_ => 1 } split / /, ($self->tests || '');
+ require File::Find;
+ File::Find::find(
+ sub { /\.t$/ and -f $_ and $tests{"$File::Find::dir/*.t"} = 1 },
+ $dir
+ );
+ $self->tests( join ' ', sort keys %tests );
+}
+
+sub write {
+ my $self = shift;
+ die "&Makefile->write() takes no arguments\n" if @_;
+
+ # Check the current Perl version
+ my $perl_version = $self->perl_version;
+ if ( $perl_version ) {
+ eval "use $perl_version; 1"
+ or die "ERROR: perl: Version $] is installed, "
+ . "but we need version >= $perl_version";
+ }
+
+ # Make sure we have a new enough MakeMaker
+ require ExtUtils::MakeMaker;
+
+ if ( $perl_version and $self->_cmp($perl_version, '5.006') >= 0 ) {
+ # MakeMaker can complain about module versions that include
+ # an underscore, even though its own version may contain one!
+ # Hence the funny regexp to get rid of it. See RT #35800
+ # for details.
+ my $v = $ExtUtils::MakeMaker::VERSION =~ /^(\d+\.\d+)/;
+ $self->build_requires( 'ExtUtils::MakeMaker' => $v );
+ $self->configure_requires( 'ExtUtils::MakeMaker' => $v );
+ } else {
+ # Allow legacy-compatibility with 5.005 by depending on the
+ # most recent EU:MM that supported 5.005.
+ $self->build_requires( 'ExtUtils::MakeMaker' => 6.42 );
+ $self->configure_requires( 'ExtUtils::MakeMaker' => 6.42 );
+ }
+
+ # Generate the MakeMaker params
+ my $args = $self->makemaker_args;
+ $args->{DISTNAME} = $self->name;
+ $args->{NAME} = $self->module_name || $self->name;
+ $args->{NAME} =~ s/-/::/g;
+ $args->{VERSION} = $self->version or die <<'EOT';
+ERROR: Can't determine distribution version. Please specify it
+explicitly via 'version' in Makefile.PL, or set a valid $VERSION
+in a module, and provide its file path via 'version_from' (or
+'all_from' if you prefer) in Makefile.PL.
+EOT
+
+ $DB::single = 1;
+ if ( $self->tests ) {
+ my @tests = split ' ', $self->tests;
+ my %seen;
+ $args->{test} = {
+ TESTS => (join ' ', grep {!$seen{$_}++} @tests),
+ };
+ } elsif ( $Module::Install::ExtraTests::use_extratests ) {
+ # Module::Install::ExtraTests doesn't set $self->tests and does its own tests via harness.
+ # So, just ignore our xt tests here.
+ } elsif ( -d 'xt' and ($Module::Install::AUTHOR or $ENV{RELEASE_TESTING}) ) {
+ $args->{test} = {
+ TESTS => join( ' ', map { "$_/*.t" } grep { -d $_ } qw{ t xt } ),
+ };
+ }
+ if ( $] >= 5.005 ) {
+ $args->{ABSTRACT} = $self->abstract;
+ $args->{AUTHOR} = join ', ', @{$self->author || []};
+ }
+ if ( $self->makemaker(6.10) ) {
+ $args->{NO_META} = 1;
+ #$args->{NO_MYMETA} = 1;
+ }
+ if ( $self->makemaker(6.17) and $self->sign ) {
+ $args->{SIGN} = 1;
+ }
+ unless ( $self->is_admin ) {
+ delete $args->{SIGN};
+ }
+ if ( $self->makemaker(6.31) and $self->license ) {
+ $args->{LICENSE} = $self->license;
+ }
+
+ my $prereq = ($args->{PREREQ_PM} ||= {});
+ %$prereq = ( %$prereq,
+ map { @$_ } # flatten [module => version]
+ map { @$_ }
+ grep $_,
+ ($self->requires)
+ );
+
+ # Remove any reference to perl, PREREQ_PM doesn't support it
+ delete $args->{PREREQ_PM}->{perl};
+
+ # Merge both kinds of requires into BUILD_REQUIRES
+ my $build_prereq = ($args->{BUILD_REQUIRES} ||= {});
+ %$build_prereq = ( %$build_prereq,
+ map { @$_ } # flatten [module => version]
+ map { @$_ }
+ grep $_,
+ ($self->configure_requires, $self->build_requires)
+ );
+
+ # Remove any reference to perl, BUILD_REQUIRES doesn't support it
+ delete $args->{BUILD_REQUIRES}->{perl};
+
+ # Delete bundled dists from prereq_pm, add it to Makefile DIR
+ my $subdirs = ($args->{DIR} || []);
+ if ($self->bundles) {
+ my %processed;
+ foreach my $bundle (@{ $self->bundles }) {
+ my ($mod_name, $dist_dir) = @$bundle;
+ delete $prereq->{$mod_name};
+ $dist_dir = File::Basename::basename($dist_dir); # dir for building this module
+ if (not exists $processed{$dist_dir}) {
+ if (-d $dist_dir) {
+ # List as sub-directory to be processed by make
+ push @$subdirs, $dist_dir;
+ }
+ # Else do nothing: the module is already present on the system
+ $processed{$dist_dir} = undef;
+ }
+ }
+ }
+
+ unless ( $self->makemaker('6.55_03') ) {
+ %$prereq = (%$prereq,%$build_prereq);
+ delete $args->{BUILD_REQUIRES};
+ }
+
+ if ( my $perl_version = $self->perl_version ) {
+ eval "use $perl_version; 1"
+ or die "ERROR: perl: Version $] is installed, "
+ . "but we need version >= $perl_version";
+
+ if ( $self->makemaker(6.48) ) {
+ $args->{MIN_PERL_VERSION} = $perl_version;
+ }
+ }
+
+ if ($self->installdirs) {
+ warn qq{old INSTALLDIRS (probably set by makemaker_args) is overriden by installdirs\n} if $args->{INSTALLDIRS};
+ $args->{INSTALLDIRS} = $self->installdirs;
+ }
+
+ my %args = map {
+ ( $_ => $args->{$_} ) } grep {defined($args->{$_} )
+ } keys %$args;
+
+ my $user_preop = delete $args{dist}->{PREOP};
+ if ( my $preop = $self->admin->preop($user_preop) ) {
+ foreach my $key ( keys %$preop ) {
+ $args{dist}->{$key} = $preop->{$key};
+ }
+ }
+
+ my $mm = ExtUtils::MakeMaker::WriteMakefile(%args);
+ $self->fix_up_makefile($mm->{FIRST_MAKEFILE} || 'Makefile');
+}
+
+sub fix_up_makefile {
+ my $self = shift;
+ my $makefile_name = shift;
+ my $top_class = ref($self->_top) || '';
+ my $top_version = $self->_top->VERSION || '';
+
+ my $preamble = $self->preamble
+ ? "# Preamble by $top_class $top_version\n"
+ . $self->preamble
+ : '';
+ my $postamble = "# Postamble by $top_class $top_version\n"
+ . ($self->postamble || '');
+
+ local *MAKEFILE;
+ open MAKEFILE, "+< $makefile_name" or die "fix_up_makefile: Couldn't open $makefile_name: $!";
+ eval { flock MAKEFILE, LOCK_EX };
+ my $makefile = do { local $/; <MAKEFILE> };
+
+ $makefile =~ s/\b(test_harness\(\$\(TEST_VERBOSE\), )/$1'inc', /;
+ $makefile =~ s/( -I\$\(INST_ARCHLIB\))/ -Iinc$1/g;
+ $makefile =~ s/( "-I\$\(INST_LIB\)")/ "-Iinc"$1/g;
+ $makefile =~ s/^(FULLPERL = .*)/$1 "-Iinc"/m;
+ $makefile =~ s/^(PERL = .*)/$1 "-Iinc"/m;
+
+ # Module::Install will never be used to build the Core Perl
+ # Sometimes PERL_LIB and PERL_ARCHLIB get written anyway, which breaks
+ # PREFIX/PERL5LIB, and thus, install_share. Blank them if they exist
+ $makefile =~ s/^PERL_LIB = .+/PERL_LIB =/m;
+ #$makefile =~ s/^PERL_ARCHLIB = .+/PERL_ARCHLIB =/m;
+
+ # Perl 5.005 mentions PERL_LIB explicitly, so we have to remove that as well.
+ $makefile =~ s/(\"?)-I\$\(PERL_LIB\)\1//g;
+
+ # XXX - This is currently unused; not sure if it breaks other MM-users
+ # $makefile =~ s/^pm_to_blib\s+:\s+/pm_to_blib :: /mg;
+
+ seek MAKEFILE, 0, SEEK_SET;
+ truncate MAKEFILE, 0;
+ print MAKEFILE "$preamble$makefile$postamble" or die $!;
+ close MAKEFILE or die $!;
+
+ 1;
+}
+
+sub preamble {
+ my ($self, $text) = @_;
+ $self->{preamble} = $text . $self->{preamble} if defined $text;
+ $self->{preamble};
+}
+
+sub postamble {
+ my ($self, $text) = @_;
+ $self->{postamble} ||= $self->admin->postamble;
+ $self->{postamble} .= $text if defined $text;
+ $self->{postamble}
+}
+
+1;
+
+__END__
+
+#line 541
diff --git a/inc/Module/Install/Metadata.pm b/inc/Module/Install/Metadata.pm
new file mode 100644
index 0000000..cfe45b3
--- /dev/null
+++ b/inc/Module/Install/Metadata.pm
@@ -0,0 +1,715 @@
+#line 1
+package Module::Install::Metadata;
+
+use strict 'vars';
+use Module::Install::Base ();
+
+use vars qw{$VERSION @ISA $ISCORE};
+BEGIN {
+ $VERSION = '1.00';
+ @ISA = 'Module::Install::Base';
+ $ISCORE = 1;
+}
+
+my @boolean_keys = qw{
+ sign
+};
+
+my @scalar_keys = qw{
+ name
+ module_name
+ abstract
+ version
+ distribution_type
+ tests
+ installdirs
+};
+
+my @tuple_keys = qw{
+ configure_requires
+ build_requires
+ requires
+ recommends
+ bundles
+ resources
+};
+
+my @resource_keys = qw{
+ homepage
+ bugtracker
+ repository
+};
+
+my @array_keys = qw{
+ keywords
+ author
+};
+
+*authors = \&author;
+
+sub Meta { shift }
+sub Meta_BooleanKeys { @boolean_keys }
+sub Meta_ScalarKeys { @scalar_keys }
+sub Meta_TupleKeys { @tuple_keys }
+sub Meta_ResourceKeys { @resource_keys }
+sub Meta_ArrayKeys { @array_keys }
+
+foreach my $key ( @boolean_keys ) {
+ *$key = sub {
+ my $self = shift;
+ if ( defined wantarray and not @_ ) {
+ return $self->{values}->{$key};
+ }
+ $self->{values}->{$key} = ( @_ ? $_[0] : 1 );
+ return $self;
+ };
+}
+
+foreach my $key ( @scalar_keys ) {
+ *$key = sub {
+ my $self = shift;
+ return $self->{values}->{$key} if defined wantarray and !@_;
+ $self->{values}->{$key} = shift;
+ return $self;
+ };
+}
+
+foreach my $key ( @array_keys ) {
+ *$key = sub {
+ my $self = shift;
+ return $self->{values}->{$key} if defined wantarray and !@_;
+ $self->{values}->{$key} ||= [];
+ push @{$self->{values}->{$key}}, @_;
+ return $self;
+ };
+}
+
+foreach my $key ( @resource_keys ) {
+ *$key = sub {
+ my $self = shift;
+ unless ( @_ ) {
+ return () unless $self->{values}->{resources};
+ return map { $_->[1] }
+ grep { $_->[0] eq $key }
+ @{ $self->{values}->{resources} };
+ }
+ return $self->{values}->{resources}->{$key} unless @_;
+ my $uri = shift or die(
+ "Did not provide a value to $key()"
+ );
+ $self->resources( $key => $uri );
+ return 1;
+ };
+}
+
+foreach my $key ( grep { $_ ne "resources" } @tuple_keys) {
+ *$key = sub {
+ my $self = shift;
+ return $self->{values}->{$key} unless @_;
+ my @added;
+ while ( @_ ) {
+ my $module = shift or last;
+ my $version = shift || 0;
+ push @added, [ $module, $version ];
+ }
+ push @{ $self->{values}->{$key} }, @added;
+ return map {@$_} @added;
+ };
+}
+
+# Resource handling
+my %lc_resource = map { $_ => 1 } qw{
+ homepage
+ license
+ bugtracker
+ repository
+};
+
+sub resources {
+ my $self = shift;
+ while ( @_ ) {
+ my $name = shift or last;
+ my $value = shift or next;
+ if ( $name eq lc $name and ! $lc_resource{$name} ) {
+ die("Unsupported reserved lowercase resource '$name'");
+ }
+ $self->{values}->{resources} ||= [];
+ push @{ $self->{values}->{resources} }, [ $name, $value ];
+ }
+ $self->{values}->{resources};
+}
+
+# Aliases for build_requires that will have alternative
+# meanings in some future version of META.yml.
+sub test_requires { shift->build_requires(@_) }
+sub install_requires { shift->build_requires(@_) }
+
+# Aliases for installdirs options
+sub install_as_core { $_[0]->installdirs('perl') }
+sub install_as_cpan { $_[0]->installdirs('site') }
+sub install_as_site { $_[0]->installdirs('site') }
+sub install_as_vendor { $_[0]->installdirs('vendor') }
+
+sub dynamic_config {
+ my $self = shift;
+ unless ( @_ ) {
+ warn "You MUST provide an explicit true/false value to dynamic_config\n";
+ return $self;
+ }
+ $self->{values}->{dynamic_config} = $_[0] ? 1 : 0;
+ return 1;
+}
+
+sub perl_version {
+ my $self = shift;
+ return $self->{values}->{perl_version} unless @_;
+ my $version = shift or die(
+ "Did not provide a value to perl_version()"
+ );
+
+ # Normalize the version
+ $version = $self->_perl_version($version);
+
+ # We don't support the reall old versions
+ unless ( $version >= 5.005 ) {
+ die "Module::Install only supports 5.005 or newer (use ExtUtils::MakeMaker)\n";
+ }
+
+ $self->{values}->{perl_version} = $version;
+}
+
+sub all_from {
+ my ( $self, $file ) = @_;
+
+ unless ( defined($file) ) {
+ my $name = $self->name or die(
+ "all_from called with no args without setting name() first"
+ );
+ $file = join('/', 'lib', split(/-/, $name)) . '.pm';
+ $file =~ s{.*/}{} unless -e $file;
+ unless ( -e $file ) {
+ die("all_from cannot find $file from $name");
+ }
+ }
+ unless ( -f $file ) {
+ die("The path '$file' does not exist, or is not a file");
+ }
+
+ $self->{values}{all_from} = $file;
+
+ # Some methods pull from POD instead of code.
+ # If there is a matching .pod, use that instead
+ my $pod = $file;
+ $pod =~ s/\.pm$/.pod/i;
+ $pod = $file unless -e $pod;
+
+ # Pull the different values
+ $self->name_from($file) unless $self->name;
+ $self->version_from($file) unless $self->version;
+ $self->perl_version_from($file) unless $self->perl_version;
+ $self->author_from($pod) unless @{$self->author || []};
+ $self->license_from($pod) unless $self->license;
+ $self->abstract_from($pod) unless $self->abstract;
+
+ return 1;
+}
+
+sub provides {
+ my $self = shift;
+ my $provides = ( $self->{values}->{provides} ||= {} );
+ %$provides = (%$provides, @_) if @_;
+ return $provides;
+}
+
+sub auto_provides {
+ my $self = shift;
+ return $self unless $self->is_admin;
+ unless (-e 'MANIFEST') {
+ warn "Cannot deduce auto_provides without a MANIFEST, skipping\n";
+ return $self;
+ }
+ # Avoid spurious warnings as we are not checking manifest here.
+ local $SIG{__WARN__} = sub {1};
+ require ExtUtils::Manifest;
+ local *ExtUtils::Manifest::manicheck = sub { return };
+
+ require Module::Build;
+ my $build = Module::Build->new(
+ dist_name => $self->name,
+ dist_version => $self->version,
+ license => $self->license,
+ );
+ $self->provides( %{ $build->find_dist_packages || {} } );
+}
+
+sub feature {
+ my $self = shift;
+ my $name = shift;
+ my $features = ( $self->{values}->{features} ||= [] );
+ my $mods;
+
+ if ( @_ == 1 and ref( $_[0] ) ) {
+ # The user used ->feature like ->features by passing in the second
+ # argument as a reference. Accomodate for that.
+ $mods = $_[0];
+ } else {
+ $mods = \@_;
+ }
+
+ my $count = 0;
+ push @$features, (
+ $name => [
+ map {
+ ref($_) ? ( ref($_) eq 'HASH' ) ? %$_ : @$_ : $_
+ } @$mods
+ ]
+ );
+
+ return @$features;
+}
+
+sub features {
+ my $self = shift;
+ while ( my ( $name, $mods ) = splice( @_, 0, 2 ) ) {
+ $self->feature( $name, @$mods );
+ }
+ return $self->{values}->{features}
+ ? @{ $self->{values}->{features} }
+ : ();
+}
+
+sub no_index {
+ my $self = shift;
+ my $type = shift;
+ push @{ $self->{values}->{no_index}->{$type} }, @_ if $type;
+ return $self->{values}->{no_index};
+}
+
+sub read {
+ my $self = shift;
+ $self->include_deps( 'YAML::Tiny', 0 );
+
+ require YAML::Tiny;
+ my $data = YAML::Tiny::LoadFile('META.yml');
+
+ # Call methods explicitly in case user has already set some values.
+ while ( my ( $key, $value ) = each %$data ) {
+ next unless $self->can($key);
+ if ( ref $value eq 'HASH' ) {
+ while ( my ( $module, $version ) = each %$value ) {
+ $self->can($key)->($self, $module => $version );
+ }
+ } else {
+ $self->can($key)->($self, $value);
+ }
+ }
+ return $self;
+}
+
+sub write {
+ my $self = shift;
+ return $self unless $self->is_admin;
+ $self->admin->write_meta;
+ return $self;
+}
+
+sub version_from {
+ require ExtUtils::MM_Unix;
+ my ( $self, $file ) = @_;
+ $self->version( ExtUtils::MM_Unix->parse_version($file) );
+
+ # for version integrity check
+ $self->makemaker_args( VERSION_FROM => $file );
+}
+
+sub abstract_from {
+ require ExtUtils::MM_Unix;
+ my ( $self, $file ) = @_;
+ $self->abstract(
+ bless(
+ { DISTNAME => $self->name },
+ 'ExtUtils::MM_Unix'
+ )->parse_abstract($file)
+ );
+}
+
+# Add both distribution and module name
+sub name_from {
+ my ($self, $file) = @_;
+ if (
+ Module::Install::_read($file) =~ m/
+ ^ \s*
+ package \s*
+ ([\w:]+)
+ \s* ;
+ /ixms
+ ) {
+ my ($name, $module_name) = ($1, $1);
+ $name =~ s{::}{-}g;
+ $self->name($name);
+ unless ( $self->module_name ) {
+ $self->module_name($module_name);
+ }
+ } else {
+ die("Cannot determine name from $file\n");
+ }
+}
+
+sub _extract_perl_version {
+ if (
+ $_[0] =~ m/
+ ^\s*
+ (?:use|require) \s*
+ v?
+ ([\d_\.]+)
+ \s* ;
+ /ixms
+ ) {
+ my $perl_version = $1;
+ $perl_version =~ s{_}{}g;
+ return $perl_version;
+ } else {
+ return;
+ }
+}
+
+sub perl_version_from {
+ my $self = shift;
+ my $perl_version=_extract_perl_version(Module::Install::_read($_[0]));
+ if ($perl_version) {
+ $self->perl_version($perl_version);
+ } else {
+ warn "Cannot determine perl version info from $_[0]\n";
+ return;
+ }
+}
+
+sub author_from {
+ my $self = shift;
+ my $content = Module::Install::_read($_[0]);
+ if ($content =~ m/
+ =head \d \s+ (?:authors?)\b \s*
+ ([^\n]*)
+ |
+ =head \d \s+ (?:licen[cs]e|licensing|copyright|legal)\b \s*
+ .*? copyright .*? \d\d\d[\d.]+ \s* (?:\bby\b)? \s*
+ ([^\n]*)
+ /ixms) {
+ my $author = $1 || $2;
+
+ # XXX: ugly but should work anyway...
+ if (eval "require Pod::Escapes; 1") {
+ # Pod::Escapes has a mapping table.
+ # It's in core of perl >= 5.9.3, and should be installed
+ # as one of the Pod::Simple's prereqs, which is a prereq
+ # of Pod::Text 3.x (see also below).
+ $author =~ s{ E<( (\d+) | ([A-Za-z]+) )> }
+ {
+ defined $2
+ ? chr($2)
+ : defined $Pod::Escapes::Name2character_number{$1}
+ ? chr($Pod::Escapes::Name2character_number{$1})
+ : do {
+ warn "Unknown escape: E<$1>";
+ "E<$1>";
+ };
+ }gex;
+ }
+ elsif (eval "require Pod::Text; 1" && $Pod::Text::VERSION < 3) {
+ # Pod::Text < 3.0 has yet another mapping table,
+ # though the table name of 2.x and 1.x are different.
+ # (1.x is in core of Perl < 5.6, 2.x is in core of
+ # Perl < 5.9.3)
+ my $mapping = ($Pod::Text::VERSION < 2)
+ ? \%Pod::Text::HTML_Escapes
+ : \%Pod::Text::ESCAPES;
+ $author =~ s{ E<( (\d+) | ([A-Za-z]+) )> }
+ {
+ defined $2
+ ? chr($2)
+ : defined $mapping->{$1}
+ ? $mapping->{$1}
+ : do {
+ warn "Unknown escape: E<$1>";
+ "E<$1>";
+ };
+ }gex;
+ }
+ else {
+ $author =~ s{E<lt>}{<}g;
+ $author =~ s{E<gt>}{>}g;
+ }
+ $self->author($author);
+ } else {
+ warn "Cannot determine author info from $_[0]\n";
+ }
+}
+
+#Stolen from M::B
+my %license_urls = (
+ perl => 'http://dev.perl.org/licenses/',
+ apache => 'http://apache.org/licenses/LICENSE-2.0',
+ apache_1_1 => 'http://apache.org/licenses/LICENSE-1.1',
+ artistic => 'http://opensource.org/licenses/artistic-license.php',
+ artistic_2 => 'http://opensource.org/licenses/artistic-license-2.0.php',
+ lgpl => 'http://opensource.org/licenses/lgpl-license.php',
+ lgpl2 => 'http://opensource.org/licenses/lgpl-2.1.php',
+ lgpl3 => 'http://opensource.org/licenses/lgpl-3.0.html',
+ bsd => 'http://opensource.org/licenses/bsd-license.php',
+ gpl => 'http://opensource.org/licenses/gpl-license.php',
+ gpl2 => 'http://opensource.org/licenses/gpl-2.0.php',
+ gpl3 => 'http://opensource.org/licenses/gpl-3.0.html',
+ mit => 'http://opensource.org/licenses/mit-license.php',
+ mozilla => 'http://opensource.org/licenses/mozilla1.1.php',
+ open_source => undef,
+ unrestricted => undef,
+ restrictive => undef,
+ unknown => undef,
+);
+
+sub license {
+ my $self = shift;
+ return $self->{values}->{license} unless @_;
+ my $license = shift or die(
+ 'Did not provide a value to license()'
+ );
+ $license = __extract_license($license) || lc $license;
+ $self->{values}->{license} = $license;
+
+ # Automatically fill in license URLs
+ if ( $license_urls{$license} ) {
+ $self->resources( license => $license_urls{$license} );
+ }
+
+ return 1;
+}
+
+sub _extract_license {
+ my $pod = shift;
+ my $matched;
+ return __extract_license(
+ ($matched) = $pod =~ m/
+ (=head \d \s+ L(?i:ICEN[CS]E|ICENSING)\b.*?)
+ (=head \d.*|=cut.*|)\z
+ /xms
+ ) || __extract_license(
+ ($matched) = $pod =~ m/
+ (=head \d \s+ (?:C(?i:OPYRIGHTS?)|L(?i:EGAL))\b.*?)
+ (=head \d.*|=cut.*|)\z
+ /xms
+ );
+}
+
+sub __extract_license {
+ my $license_text = shift or return;
+ my @phrases = (
+ '(?:under )?the same (?:terms|license) as (?:perl|the perl (?:\d )?programming language)' => 'perl', 1,
+ '(?:under )?the terms of (?:perl|the perl programming language) itself' => 'perl', 1,
+ 'Artistic and GPL' => 'perl', 1,
+ 'GNU general public license' => 'gpl', 1,
+ 'GNU public license' => 'gpl', 1,
+ 'GNU lesser general public license' => 'lgpl', 1,
+ 'GNU lesser public license' => 'lgpl', 1,
+ 'GNU library general public license' => 'lgpl', 1,
+ 'GNU library public license' => 'lgpl', 1,
+ 'GNU Free Documentation license' => 'unrestricted', 1,
+ 'GNU Affero General Public License' => 'open_source', 1,
+ '(?:Free)?BSD license' => 'bsd', 1,
+ 'Artistic license' => 'artistic', 1,
+ 'Apache (?:Software )?license' => 'apache', 1,
+ 'GPL' => 'gpl', 1,
+ 'LGPL' => 'lgpl', 1,
+ 'BSD' => 'bsd', 1,
+ 'Artistic' => 'artistic', 1,
+ 'MIT' => 'mit', 1,
+ 'Mozilla Public License' => 'mozilla', 1,
+ 'Q Public License' => 'open_source', 1,
+ 'OpenSSL License' => 'unrestricted', 1,
+ 'SSLeay License' => 'unrestricted', 1,
+ 'zlib License' => 'open_source', 1,
+ 'proprietary' => 'proprietary', 0,
+ );
+ while ( my ($pattern, $license, $osi) = splice(@phrases, 0, 3) ) {
+ $pattern =~ s#\s+#\\s+#gs;
+ if ( $license_text =~ /\b$pattern\b/i ) {
+ return $license;
+ }
+ }
+ return '';
+}
+
+sub license_from {
+ my $self = shift;
+ if (my $license=_extract_license(Module::Install::_read($_[0]))) {
+ $self->license($license);
+ } else {
+ warn "Cannot determine license info from $_[0]\n";
+ return 'unknown';
+ }
+}
+
+sub _extract_bugtracker {
+ my @links = $_[0] =~ m#L<(
+ \Qhttp://rt.cpan.org/\E[^>]+|
+ \Qhttp://github.com/\E[\w_]+/[\w_]+/issues|
+ \Qhttp://code.google.com/p/\E[\w_\-]+/issues/list
+ )>#gx;
+ my %links;
+ @links{@links}=();
+ @links=keys %links;
+ return @links;
+}
+
+sub bugtracker_from {
+ my $self = shift;
+ my $content = Module::Install::_read($_[0]);
+ my @links = _extract_bugtracker($content);
+ unless ( @links ) {
+ warn "Cannot determine bugtracker info from $_[0]\n";
+ return 0;
+ }
+ if ( @links > 1 ) {
+ warn "Found more than one bugtracker link in $_[0]\n";
+ return 0;
+ }
+
+ # Set the bugtracker
+ bugtracker( $links[0] );
+ return 1;
+}
+
+sub requires_from {
+ my $self = shift;
+ my $content = Module::Install::_readperl($_[0]);
+ my @requires = $content =~ m/^use\s+([^\W\d]\w*(?:::\w+)*)\s+([\d\.]+)/mg;
+ while ( @requires ) {
+ my $module = shift @requires;
+ my $version = shift @requires;
+ $self->requires( $module => $version );
+ }
+}
+
+sub test_requires_from {
+ my $self = shift;
+ my $content = Module::Install::_readperl($_[0]);
+ my @requires = $content =~ m/^use\s+([^\W\d]\w*(?:::\w+)*)\s+([\d\.]+)/mg;
+ while ( @requires ) {
+ my $module = shift @requires;
+ my $version = shift @requires;
+ $self->test_requires( $module => $version );
+ }
+}
+
+# Convert triple-part versions (eg, 5.6.1 or 5.8.9) to
+# numbers (eg, 5.006001 or 5.008009).
+# Also, convert double-part versions (eg, 5.8)
+sub _perl_version {
+ my $v = $_[-1];
+ $v =~ s/^([1-9])\.([1-9]\d?\d?)$/sprintf("%d.%03d",$1,$2)/e;
+ $v =~ s/^([1-9])\.([1-9]\d?\d?)\.(0|[1-9]\d?\d?)$/sprintf("%d.%03d%03d",$1,$2,$3 || 0)/e;
+ $v =~ s/(\.\d\d\d)000$/$1/;
+ $v =~ s/_.+$//;
+ if ( ref($v) ) {
+ # Numify
+ $v = $v + 0;
+ }
+ return $v;
+}
+
+sub add_metadata {
+ my $self = shift;
+ my %hash = @_;
+ for my $key (keys %hash) {
+ warn "add_metadata: $key is not prefixed with 'x_'.\n" .
+ "Use appopriate function to add non-private metadata.\n" unless $key =~ /^x_/;
+ $self->{values}->{$key} = $hash{$key};
+ }
+}
+
+
+######################################################################
+# MYMETA Support
+
+sub WriteMyMeta {
+ die "WriteMyMeta has been deprecated";
+}
+
+sub write_mymeta_yaml {
+ my $self = shift;
+
+ # We need YAML::Tiny to write the MYMETA.yml file
+ unless ( eval { require YAML::Tiny; 1; } ) {
+ return 1;
+ }
+
+ # Generate the data
+ my $meta = $self->_write_mymeta_data or return 1;
+
+ # Save as the MYMETA.yml file
+ print "Writing MYMETA.yml\n";
+ YAML::Tiny::DumpFile('MYMETA.yml', $meta);
+}
+
+sub write_mymeta_json {
+ my $self = shift;
+
+ # We need JSON to write the MYMETA.json file
+ unless ( eval { require JSON; 1; } ) {
+ return 1;
+ }
+
+ # Generate the data
+ my $meta = $self->_write_mymeta_data or return 1;
+
+ # Save as the MYMETA.yml file
+ print "Writing MYMETA.json\n";
+ Module::Install::_write(
+ 'MYMETA.json',
+ JSON->new->pretty(1)->canonical->encode($meta),
+ );
+}
+
+sub _write_mymeta_data {
+ my $self = shift;
+
+ # If there's no existing META.yml there is nothing we can do
+ return undef unless -f 'META.yml';
+
+ # We need Parse::CPAN::Meta to load the file
+ unless ( eval { require Parse::CPAN::Meta; 1; } ) {
+ return undef;
+ }
+
+ # Merge the perl version into the dependencies
+ my $val = $self->Meta->{values};
+ my $perl = delete $val->{perl_version};
+ if ( $perl ) {
+ $val->{requires} ||= [];
+ my $requires = $val->{requires};
+
+ # Canonize to three-dot version after Perl 5.6
+ if ( $perl >= 5.006 ) {
+ $perl =~ s{^(\d+)\.(\d\d\d)(\d*)}{join('.', $1, int($2||0), int($3||0))}e
+ }
+ unshift @$requires, [ perl => $perl ];
+ }
+
+ # Load the advisory META.yml file
+ my @yaml = Parse::CPAN::Meta::LoadFile('META.yml');
+ my $meta = $yaml[0];
+
+ # Overwrite the non-configure dependency hashs
+ delete $meta->{requires};
+ delete $meta->{build_requires};
+ delete $meta->{recommends};
+ if ( exists $val->{requires} ) {
+ $meta->{requires} = { map { @$_ } @{ $val->{requires} } };
+ }
+ if ( exists $val->{build_requires} ) {
+ $meta->{build_requires} = { map { @$_ } @{ $val->{build_requires} } };
+ }
+
+ return $meta;
+}
+
+1;
diff --git a/inc/Module/Install/ReadmeFromPod.pm b/inc/Module/Install/ReadmeFromPod.pm
new file mode 100644
index 0000000..348531e
--- /dev/null
+++ b/inc/Module/Install/ReadmeFromPod.pm
@@ -0,0 +1,48 @@
+#line 1
+package Module::Install::ReadmeFromPod;
+
+use 5.006;
+use strict;
+use warnings;
+use base qw(Module::Install::Base);
+use vars qw($VERSION);
+
+$VERSION = '0.12';
+
+sub readme_from {
+ my $self = shift;
+ return unless $self->is_admin;
+
+ my $file = shift || $self->_all_from
+ or die "Can't determine file to make readme_from";
+ my $clean = shift;
+
+ print "Writing README from $file\n";
+
+ require Pod::Text;
+ my $parser = Pod::Text->new();
+ open README, '> README' or die "$!\n";
+ $parser->output_fh( *README );
+ $parser->parse_file( $file );
+ if ($clean) {
+ $self->clean_files('README');
+ }
+ return 1;
+}
+
+sub _all_from {
+ my $self = shift;
+ return unless $self->admin->{extensions};
+ my ($metadata) = grep {
+ ref($_) eq 'Module::Install::Metadata';
+ } @{$self->admin->{extensions}};
+ return unless $metadata;
+ return $metadata->{values}{all_from} || '';
+}
+
+'Readme!';
+
+__END__
+
+#line 112
+
diff --git a/inc/Module/Install/Share.pm b/inc/Module/Install/Share.pm
new file mode 100644
index 0000000..f1e3bdd
--- /dev/null
+++ b/inc/Module/Install/Share.pm
@@ -0,0 +1,96 @@
+#line 1
+package Module::Install::Share;
+
+use strict;
+use Module::Install::Base ();
+use File::Find ();
+use ExtUtils::Manifest ();
+
+use vars qw{$VERSION @ISA $ISCORE};
+BEGIN {
+ $VERSION = '1.00';
+ @ISA = 'Module::Install::Base';
+ $ISCORE = 1;
+}
+
+sub install_share {
+ my $self = shift;
+ my $dir = @_ ? pop : 'share';
+ my $type = @_ ? shift : 'dist';
+ unless ( defined $type and $type eq 'module' or $type eq 'dist' ) {
+ die "Illegal or invalid share dir type '$type'";
+ }
+ unless ( defined $dir and -d $dir ) {
+ require Carp;
+ Carp::croak("Illegal or missing directory install_share param");
+ }
+
+ # Split by type
+ my $S = ($^O eq 'MSWin32') ? "\\" : "\/";
+
+ my $root;
+ if ( $type eq 'dist' ) {
+ die "Too many parameters to install_share" if @_;
+
+ # Set up the install
+ $root = "\$(INST_LIB)${S}auto${S}share${S}dist${S}\$(DISTNAME)";
+ } else {
+ my $module = Module::Install::_CLASS($_[0]);
+ unless ( defined $module ) {
+ die "Missing or invalid module name '$_[0]'";
+ }
+ $module =~ s/::/-/g;
+
+ $root = "\$(INST_LIB)${S}auto${S}share${S}module${S}$module";
+ }
+
+ my $manifest = -r 'MANIFEST' ? ExtUtils::Manifest::maniread() : undef;
+ my $skip_checker = $ExtUtils::Manifest::VERSION >= 1.54
+ ? ExtUtils::Manifest::maniskip()
+ : ExtUtils::Manifest::_maniskip();
+ my $postamble = '';
+ my $perm_dir = eval($ExtUtils::MakeMaker::VERSION) >= 6.52 ? '$(PERM_DIR)' : 755;
+ File::Find::find({
+ no_chdir => 1,
+ wanted => sub {
+ my $path = File::Spec->abs2rel($_, $dir);
+ if (-d $_) {
+ return if $skip_checker->($File::Find::name);
+ $postamble .=<<"END";
+\t\$(NOECHO) \$(MKPATH) "$root${S}$path"
+\t\$(NOECHO) \$(CHMOD) $perm_dir "$root${S}$path"
+END
+ }
+ else {
+ return if ref $manifest
+ && !exists $manifest->{$File::Find::name};
+ return if $skip_checker->($File::Find::name);
+ $postamble .=<<"END";
+\t\$(NOECHO) \$(CP) "$dir${S}$path" "$root${S}$path"
+END
+ }
+ },
+ }, $dir);
+
+ # Set up the install
+ $self->postamble(<<"END_MAKEFILE");
+config ::
+$postamble
+
+END_MAKEFILE
+
+ # The above appears to behave incorrectly when used with old versions
+ # of ExtUtils::Install (known-bad on RHEL 3, with 5.8.0)
+ # So when we need to install a share directory, make sure we add a
+ # dependency on a moderately new version of ExtUtils::MakeMaker.
+ $self->build_requires( 'ExtUtils::MakeMaker' => '6.11' );
+
+ # 99% of the time we don't want to index a shared dir
+ $self->no_index( directory => $dir );
+}
+
+1;
+
+__END__
+
+#line 154
diff --git a/inc/Module/Install/Win32.pm b/inc/Module/Install/Win32.pm
new file mode 100644
index 0000000..edc18b4
--- /dev/null
+++ b/inc/Module/Install/Win32.pm
@@ -0,0 +1,64 @@
+#line 1
+package Module::Install::Win32;
+
+use strict;
+use Module::Install::Base ();
+
+use vars qw{$VERSION @ISA $ISCORE};
+BEGIN {
+ $VERSION = '1.00';
+ @ISA = 'Module::Install::Base';
+ $ISCORE = 1;
+}
+
+# determine if the user needs nmake, and download it if needed
+sub check_nmake {
+ my $self = shift;
+ $self->load('can_run');
+ $self->load('get_file');
+
+ require Config;
+ return unless (
+ $^O eq 'MSWin32' and
+ $Config::Config{make} and
+ $Config::Config{make} =~ /^nmake\b/i and
+ ! $self->can_run('nmake')
+ );
+
+ print "The required 'nmake' executable not found, fetching it...\n";
+
+ require File::Basename;
+ my $rv = $self->get_file(
+ url => 'http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe',
+ ftp_url => 'ftp://ftp.microsoft.com/Softlib/MSLFILES/Nmake15.exe',
+ local_dir => File::Basename::dirname($^X),
+ size => 51928,
+ run => 'Nmake15.exe /o > nul',
+ check_for => 'Nmake.exe',
+ remove => 1,
+ );
+
+ die <<'END_MESSAGE' unless $rv;
+
+-------------------------------------------------------------------------------
+
+Since you are using Microsoft Windows, you will need the 'nmake' utility
+before installation. It's available at:
+
+ http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe
+ or
+ ftp://ftp.microsoft.com/Softlib/MSLFILES/Nmake15.exe
+
+Please download the file manually, save it to a directory in %PATH% (e.g.
+C:\WINDOWS\COMMAND\), then launch the MS-DOS command line shell, "cd" to
+that directory, and run "Nmake15.exe" from there; that will create the
+'nmake.exe' file needed by this module.
+
+You may then resume the installation process described in README.
+
+-------------------------------------------------------------------------------
+END_MESSAGE
+
+}
+
+1;
diff --git a/inc/Module/Install/WriteAll.pm b/inc/Module/Install/WriteAll.pm
new file mode 100644
index 0000000..d0f6599
--- /dev/null
+++ b/inc/Module/Install/WriteAll.pm
@@ -0,0 +1,63 @@
+#line 1
+package Module::Install::WriteAll;
+
+use strict;
+use Module::Install::Base ();
+
+use vars qw{$VERSION @ISA $ISCORE};
+BEGIN {
+ $VERSION = '1.00';
+ @ISA = qw{Module::Install::Base};
+ $ISCORE = 1;
+}
+
+sub WriteAll {
+ my $self = shift;
+ my %args = (
+ meta => 1,
+ sign => 0,
+ inline => 0,
+ check_nmake => 1,
+ @_,
+ );
+
+ $self->sign(1) if $args{sign};
+ $self->admin->WriteAll(%args) if $self->is_admin;
+
+ $self->check_nmake if $args{check_nmake};
+ unless ( $self->makemaker_args->{PL_FILES} ) {
+ # XXX: This still may be a bit over-defensive...
+ unless ($self->makemaker(6.25)) {
+ $self->makemaker_args( PL_FILES => {} ) if -f 'Build.PL';
+ }
+ }
+
+ # Until ExtUtils::MakeMaker support MYMETA.yml, make sure
+ # we clean it up properly ourself.
+ $self->realclean_files('MYMETA.yml');
+
+ if ( $args{inline} ) {
+ $self->Inline->write;
+ } else {
+ $self->Makefile->write;
+ }
+
+ # The Makefile write process adds a couple of dependencies,
+ # so write the META.yml files after the Makefile.
+ if ( $args{meta} ) {
+ $self->Meta->write;
+ }
+
+ # Experimental support for MYMETA
+ if ( $ENV{X_MYMETA} ) {
+ if ( $ENV{X_MYMETA} eq 'JSON' ) {
+ $self->Meta->write_mymeta_json;
+ } else {
+ $self->Meta->write_mymeta_yaml;
+ }
+ }
+
+ return 1;
+}
+
+1;
diff --git a/lib/Parse/ACNS.pm b/lib/Parse/ACNS.pm
new file mode 100644
index 0000000..dca7bb8
--- /dev/null
+++ b/lib/Parse/ACNS.pm
@@ -0,0 +1,118 @@
+use 5.008;
+use strict;
+use warnings;
+
+
+package Parse::ACNS;
+our $VERSION = '0.01';
+
+use File::ShareDir ();
+use File::Spec ();
+use Scalar::Util qw(blessed);
+use XML::LibXML;
+use XML::Compile::Schema;
+
+=head1 NAME
+
+Parse::ACNS - parser for Automated Copyright Notice System (ACNS) XML
+
+=head1 SYNOPSIS
+
+ use Parse::ACNS;
+ my $parser = Parse::ACNS->new(
+ version => 'compat',
+ );
+ $parser->parse( );
+
+=head1 DESCRIPTION
+
+=cut
+
+our %CACHE = (
+);
+
+sub new {
+ my $proto = shift;
+ return (bless { @_ }, ref($proto) || $proto)->init;
+}
+
+sub init {
+ my $self = shift;
+
+ $self->{'version'} ||= 'compat';
+ unless ( $self->{'version'} =~ /^(compat|0\.[67])$/ ) {
+ require Carp;
+ Carp::croak(
+ "Only compat, 0.7 and 0.6 versions are supported"
+ .", not '". $self->{'version'} ."'"
+ );
+ }
+
+ my $path = File::ShareDir::class_file(
+ File::Spec->catfile( 'schema', $self->{'version'}, 'infringement.xsd' )
+ );
+
+ $self->{'reader'} = $CACHE{$path}{'reader'};
+ unless ( $self->{'reader'} ) {
+ my $schema = XML::Compile::Schema( [$path] );
+ $self->{'reader'} = $schema->compile( READER => 'Infringement' );
+ }
+ return $self;
+}
+
+sub parse {
+ my $self = shift;
+ return $self->{'reader'}->( shift );
+}
+
+sub parse_any {
+ my $self = shift;
+ my $source = shift;
+ if ( blessed($source) ) {
+ if ( $source->isa('XML::LibXML') ) {
+ return $self->parse( $source );
+ }
+ else {
+ require Carp;
+ Carp::croak('Parsing from object of type '. ref($source) . ' is not supported');
+ }
+ }
+ elsif ( ref $source ) {
+ return $self->parse_fh( $source );
+ }
+ else {
+ if ( -e $source ) {
+ return $self->parse_file( $source );
+ }
+ else {
+ return $self->parse_string( $source );
+ }
+ }
+}
+
+sub parse_string {
+ my $self = shift;
+ return $self->parse( XML::LibXML->new->parse_string(shift) );
+}
+
+sub parse_file {
+ my $self = shift;
+ return $self->parse( XML::LibXML->new->parse_file(shift) );
+}
+
+sub parse_fh {
+ my $self = shift;
+ return $self->parse( XML::LibXML->new->parse_fh(shift) );
+}
+
+=head1 AUTHOR
+
+Ruslan Zakirov E<lt>ruz at bestpractical.comE<gt>
+
+=head1 LICENSE
+
+Under the same terms as perl itself.
+
+=cut
+
+1;
diff --git a/share/schema/0.6/infringement.xsd b/share/schema/0.6/infringement.xsd
new file mode 100644
index 0000000..b7b5e8e
--- /dev/null
+++ b/share/schema/0.6/infringement.xsd
@@ -0,0 +1,147 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
+ <xs:complexType name="Contact">
+ <xs:sequence>
+ <xs:element name="Entity" type="xs:string"/>
+ <xs:element name="Contact" type="xs:string" minOccurs="0"/>
+ <xs:element name="Address" type="xs:string" minOccurs="0"/>
+ <xs:element name="Phone" type="xs:string" minOccurs="0"/>
+ <xs:element name="Email" type="xs:string"/>
+ </xs:sequence>
+ </xs:complexType>
+ <xs:element name="Infringement">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="Case">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="ID" type="xs:string"/>
+ <xs:element name="Ref_URL" type="xs:anyURI" minOccurs="0"/>
+ <xs:element name="Status" type="xs:string" minOccurs="0"/>
+ <xs:element name="Severity" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:enumeration value="Normal"/>
+ <xs:enumeration value="Low"/>
+ <xs:enumeration value="High"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Complainant" type="Contact"/>
+ <xs:element name="Service_Provider" type="Contact"/>
+ <xs:element name="Source">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="TimeStamp" type="xs:dateTime"/>
+ <xs:element name="IP_Address">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:whiteSpace value="collapse"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="Port" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:int">
+ <xs:minInclusive value="0"/>
+ <xs:maxInclusive value="65535"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="DNS_Name" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:whiteSpace value="collapse"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="MAC_Address" type="xs:string" minOccurs="0"/>
+ <xs:element name="IP_Block" type="xs:string" minOccurs="0"/>
+ <xs:element name="Type" type="xs:string"/>
+ <xs:element name="URL_Base" type="xs:anyURI" minOccurs="0"/>
+ <xs:element name="UserName" type="xs:string" minOccurs="0"/>
+ <xs:element name="Login" minOccurs="0">
+ <xs:complexType>
+ <xs:attribute name="Username" type="xs:string" use="required"/>
+ <xs:attribute name="Password" type="xs:string" use="required"/>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Number_Files" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:int">
+ <xs:minInclusive value="0"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="Deja_Vu" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:enumeration value="Yes"/>
+ <xs:enumeration value="No"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Content">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="Item" maxOccurs="unbounded">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="Title" type="xs:string" minOccurs="0"/>
+ <xs:element name="Artist" type="xs:string" minOccurs="0"/>
+ <xs:element name="FileName">
+ <xs:simpleType>
+ <xs:restriction base="xs:string"/>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="FileSize" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:int">
+ <xs:minInclusive value="0"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="URL" type="xs:anyURI" minOccurs="0"/>
+ <xs:element name="Type" type="xs:string" minOccurs="0"/>
+ <xs:element name="Hash" minOccurs="0">
+ <xs:complexType>
+ <xs:simpleContent>
+ <xs:extension base="xs:string">
+ <xs:attribute name="Type" type="xs:string" use="required"/>
+ </xs:extension>
+ </xs:simpleContent>
+ </xs:complexType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="History" minOccurs="0">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="Notice" minOccurs="0" maxOccurs="unbounded">
+ <xs:complexType>
+ <xs:simpleContent>
+ <xs:extension base="xs:string">
+ <xs:attribute name="ID" type="xs:anySimpleType" use="optional"/>
+ <xs:attribute name="TimeStamp" type="xs:anySimpleType" use="optional"/>
+ </xs:extension>
+ </xs:simpleContent>
+ </xs:complexType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Notes" type="xs:string" minOccurs="0"/>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+</xs:schema>
diff --git a/share/schema/0.7/infringement.xsd b/share/schema/0.7/infringement.xsd
new file mode 100644
index 0000000..e24c000
--- /dev/null
+++ b/share/schema/0.7/infringement.xsd
@@ -0,0 +1,149 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- edited with XMLSPY v2004 rel. 4 U (http://www.xmlspy.com) by Aaron Markham (Universal) -->
+<xs:schema elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
+ <xs:complexType name="Contact">
+ <xs:sequence>
+ <xs:element name="Entity" type="xs:string"/>
+ <xs:element name="Contact" type="xs:string" minOccurs="0"/>
+ <xs:element name="Address" type="xs:string" minOccurs="0"/>
+ <xs:element name="Phone" type="xs:string" minOccurs="0"/>
+ <xs:element name="Email" type="xs:string"/>
+ </xs:sequence>
+ </xs:complexType>
+ <xs:element name="Infringement" id="0.7">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="Case">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="ID" type="xs:string"/>
+ <xs:element name="Ref_URL" type="xs:anyURI" minOccurs="0"/>
+ <xs:element name="Status" type="xs:string" minOccurs="0"/>
+ <xs:element name="Severity" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:enumeration value="Normal"/>
+ <xs:enumeration value="Low"/>
+ <xs:enumeration value="High"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Complainant" type="Contact"/>
+ <xs:element name="Service_Provider" type="Contact"/>
+ <xs:element name="Source">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="TimeStamp" type="xs:dateTime"/>
+ <xs:element name="IP_Address">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:whiteSpace value="collapse"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="Port" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:int">
+ <xs:minInclusive value="0"/>
+ <xs:maxInclusive value="65535"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="DNS_Name" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:whiteSpace value="collapse"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="MAC_Address" type="xs:string" minOccurs="0"/>
+ <xs:element name="IP_Block" type="xs:string" minOccurs="0"/>
+ <xs:element name="Type" type="xs:string"/>
+ <xs:element name="URL_Base" type="xs:anyURI" minOccurs="0"/>
+ <xs:element name="UserName" type="xs:string" minOccurs="0"/>
+ <xs:element name="Login" minOccurs="0">
+ <xs:complexType>
+ <xs:attribute name="Username" type="xs:string" use="required"/>
+ <xs:attribute name="Password" type="xs:string" use="required"/>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Number_Files" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:int">
+ <xs:minInclusive value="0"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="Deja_Vu" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:enumeration value="Yes"/>
+ <xs:enumeration value="No"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Content">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="Item" maxOccurs="unbounded">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="TimeStamp" type="xs:dateTime"/>
+ <xs:element name="Title" type="xs:string" minOccurs="0"/>
+ <xs:element name="Artist" type="xs:string" minOccurs="0"/>
+ <xs:element name="FileName">
+ <xs:simpleType>
+ <xs:restriction base="xs:string"/>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="FileSize" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:int">
+ <xs:minInclusive value="0"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="URL" type="xs:anyURI" minOccurs="0"/>
+ <xs:element name="Type" type="xs:string" minOccurs="0"/>
+ <xs:element name="Hash" minOccurs="0">
+ <xs:complexType>
+ <xs:simpleContent>
+ <xs:extension base="xs:string">
+ <xs:attribute name="Type" type="xs:string" use="required"/>
+ </xs:extension>
+ </xs:simpleContent>
+ </xs:complexType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="History" minOccurs="0">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="Notice" minOccurs="0" maxOccurs="unbounded">
+ <xs:complexType>
+ <xs:simpleContent>
+ <xs:extension base="xs:string">
+ <xs:attribute name="ID" type="xs:anySimpleType" use="optional"/>
+ <xs:attribute name="TimeStamp" type="xs:anySimpleType" use="optional"/>
+ </xs:extension>
+ </xs:simpleContent>
+ </xs:complexType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Notes" type="xs:string" minOccurs="0"/>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+</xs:schema>
diff --git a/share/schema/compat/infringement.xsd b/share/schema/compat/infringement.xsd
new file mode 100644
index 0000000..f3853b0
--- /dev/null
+++ b/share/schema/compat/infringement.xsd
@@ -0,0 +1,149 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- edited with XMLSPY v2004 rel. 4 U (http://www.xmlspy.com) by Aaron Markham (Universal) -->
+<xs:schema elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
+ <xs:complexType name="Contact">
+ <xs:sequence>
+ <xs:element name="Entity" type="xs:string"/>
+ <xs:element name="Contact" type="xs:string" minOccurs="0"/>
+ <xs:element name="Address" type="xs:string" minOccurs="0"/>
+ <xs:element name="Phone" type="xs:string" minOccurs="0"/>
+ <xs:element name="Email" type="xs:string"/>
+ </xs:sequence>
+ </xs:complexType>
+ <xs:element name="Infringement" id="compat">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="Case">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="ID" type="xs:string"/>
+ <xs:element name="Ref_URL" type="xs:anyURI" minOccurs="0"/>
+ <xs:element name="Status" type="xs:string" minOccurs="0"/>
+ <xs:element name="Severity" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:enumeration value="Normal"/>
+ <xs:enumeration value="Low"/>
+ <xs:enumeration value="High"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Complainant" type="Contact"/>
+ <xs:element name="Service_Provider" type="Contact"/>
+ <xs:element name="Source">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="TimeStamp" type="xs:dateTime"/>
+ <xs:element name="IP_Address">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:whiteSpace value="collapse"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="Port" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:int">
+ <xs:minInclusive value="0"/>
+ <xs:maxInclusive value="65535"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="DNS_Name" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:whiteSpace value="collapse"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="MAC_Address" type="xs:string" minOccurs="0"/>
+ <xs:element name="IP_Block" type="xs:string" minOccurs="0"/>
+ <xs:element name="Type" type="xs:string"/>
+ <xs:element name="URL_Base" type="xs:anyURI" minOccurs="0"/>
+ <xs:element name="UserName" type="xs:string" minOccurs="0"/>
+ <xs:element name="Login" minOccurs="0">
+ <xs:complexType>
+ <xs:attribute name="Username" type="xs:string" use="required"/>
+ <xs:attribute name="Password" type="xs:string" use="required"/>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Number_Files" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:int">
+ <xs:minInclusive value="0"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="Deja_Vu" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:string">
+ <xs:enumeration value="Yes"/>
+ <xs:enumeration value="No"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Content">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="Item" maxOccurs="unbounded">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="TimeStamp" type="xs:dateTime" minOccurs="0"/>
+ <xs:element name="Title" type="xs:string" minOccurs="0"/>
+ <xs:element name="Artist" type="xs:string" minOccurs="0"/>
+ <xs:element name="FileName">
+ <xs:simpleType>
+ <xs:restriction base="xs:string"/>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="FileSize" minOccurs="0">
+ <xs:simpleType>
+ <xs:restriction base="xs:int">
+ <xs:minInclusive value="0"/>
+ </xs:restriction>
+ </xs:simpleType>
+ </xs:element>
+ <xs:element name="URL" type="xs:anyURI" minOccurs="0"/>
+ <xs:element name="Type" type="xs:string" minOccurs="0"/>
+ <xs:element name="Hash" minOccurs="0">
+ <xs:complexType>
+ <xs:simpleContent>
+ <xs:extension base="xs:string">
+ <xs:attribute name="Type" type="xs:string" use="required"/>
+ </xs:extension>
+ </xs:simpleContent>
+ </xs:complexType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="History" minOccurs="0">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element name="Notice" minOccurs="0" maxOccurs="unbounded">
+ <xs:complexType>
+ <xs:simpleContent>
+ <xs:extension base="xs:string">
+ <xs:attribute name="ID" type="xs:anySimpleType" use="optional"/>
+ <xs:attribute name="TimeStamp" type="xs:anySimpleType" use="optional"/>
+ </xs:extension>
+ </xs:simpleContent>
+ </xs:complexType>
+ </xs:element>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ <xs:element name="Notes" type="xs:string" minOccurs="0"/>
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+</xs:schema>
diff --git a/t/basics.t b/t/basics.t
new file mode 100644
index 0000000..d026eab
--- /dev/null
+++ b/t/basics.t
@@ -0,0 +1,7 @@
+use strict;
+use warnings;
+
+use Test::More tests => 1;
+
+use_ok('Parse::ACNS');
+
commit b6f7ef1c4778397819203edb3b79cda04d3f8053
Author: Ruslan Zakirov <ruz at bestpractical.com>
Date: Wed Jan 26 14:00:00 2011 +0300
gitignore
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..7704213
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,5 @@
+Makefile
+pm_to_blib
+blib/
+*.old
+*.bak
commit 100bb39f285fa510d8b809a6cf6816f33bb02c9d
Author: Ruslan Zakirov <ruz at bestpractical.com>
Date: Wed Jan 26 15:00:13 2011 +0300
tests
diff --git a/t/basics.t b/t/basics.t
index d026eab..28aa899 100644
--- a/t/basics.t
+++ b/t/basics.t
@@ -1,7 +1,13 @@
use strict;
use warnings;
-use Test::More tests => 1;
+use Test::More tests => 7;
use_ok('Parse::ACNS');
+foreach my $v (qw(compat 0.6 0.7)) {
+ my $p = Parse::ACNS->new( version => $v );
+ ok($p, 'created a new parser instance');
+ isa_ok($p, 'Parse::ACNS');
+}
+
diff --git a/t/data/0.6/full.xml b/t/data/0.6/full.xml
new file mode 100644
index 0000000..45ab50b
--- /dev/null
+++ b/t/data/0.6/full.xml
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<Infringement xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://mpto.unistudios.com/xml/Infringement_schema.xsd">
+ <Case>
+ <ID>A1234567</ID>
+ <Ref_URL>http://www.contentowner.com/trackingid.asp?A1234567</Ref_URL>
+ <Status>First Notice, Open</Status>
+ <Severity>Normal</Severity>
+ </Case>
+ <Complainant>
+ <Entity>Content Owner Inc.</Entity>
+ <Contact>John Doe</Contact>
+ <Address>100 Anywhere Street, Anywhere, CA 90000</Address>
+ <Phone>555-555-1212</Phone>
+ <Email>antipiracy at contentowner.com</Email>
+ </Complainant>
+ <Service_Provider>
+ <Entity>ISP Broadband Inc.</Entity>
+ <Contact>John Doe</Contact>
+ <Address>100 Anywhere Street, Anywhere, CA 90000</Address>
+ <Phone>555-555-1212</Phone>
+ <Email>dmca_agent at ispbroadband.net</Email>
+ </Service_Provider>
+ <Source>
+ <TimeStamp>2003-08-30T12:34:53Z</TimeStamp>
+ <IP_Address>168.1.1.145</IP_Address>
+ <Port>21</Port>
+ <DNS_Name>pcp574.nshville.tn.ispbroadband.net</DNS_Name>
+ <MAC_Address>00-00-39-B6-00-A4</MAC_Address>
+ <IP_Block>?????</IP_Block>
+ <Type>FTP</Type>
+ <URL_Base>ftp://guest:freepwd@168.1.1.145/media/8Mile/</URL_Base>
+ <UserName>guest</UserName>
+ <Login Username="guest" Password="freepwd"/>
+ <Number_Files>324</Number_Files>
+ <Deja_Vu>Yes</Deja_Vu>
+ </Source>
+ <Content>
+ <Item>
+ <Title>8 Mile</Title>
+ <FileName>8Mile.mpg</FileName>
+ <FileSize>702453789</FileSize>
+ <URL>ftp://guest:freepwd@168.1.1.145/media/8Mile/8mile.mpg</URL>
+ <Type>Movie</Type>
+ <Hash Type="SHA1">EKR94KF985873KD930ER4KD94</Hash>
+ </Item>
+ <Item>
+ <Title>Lose Yourself</Title>
+ <Artist>Eminem</Artist>
+ <FileName>eminem_loseyourself.mp3</FileName>
+ <FileSize>4235654</FileSize>
+ <URL>ftp://guest:freepwd@168.1.1.145/media/8Mile/eminem_loseyourself.mp3</URL>
+ <Type>SoundRecording</Type>
+ <Hash Type="SHA1">B5A94KF93673KD930D21DFD94</Hash>
+ </Item>
+ </Content>
+ <History>
+ <Notice ID="12321" TimeStamp="2003-08-30T10:23:13Z">freeform text area</Notice>
+ <Notice ID="19832" TimeStamp="2003-08-30T11:03:00Z">freeform text area</Notice>
+ </History>
+ <Notes>
+ Open area for freeform text notes, filelists, etc...
+
+ drwxr-xr-x 2 staff ftp 4096 May 15 13:21 morestuff
+ -rw-r--r-- 1 staff ftp 702453789 Mar 24 15:34 8Mile.mpg
+ -rw-r--r-- 1 staff ftp 4235654 Mar 24 07:44 eminem_loseyourself.mp3
+ -rw-r--r-- 1 staff ftp 3914249 Apr 4 07:53 xzibit_spitshine.mp3
+ -rw-r--r-- 1 staff ftp 1525267 Feb 24 16:39 50cent_wanksta.mp3
+ -rw-r--r-- 1 staff ftp 25188 Feb 24 16:42 coverart.jpg
+ </Notes>
+</Infringement>
diff --git a/t/data/0.6/full.yaml b/t/data/0.6/full.yaml
new file mode 100644
index 0000000..7639a59
--- /dev/null
+++ b/t/data/0.6/full.yaml
@@ -0,0 +1,72 @@
+root: Infringement
+---
+Case:
+ ID: A1234567
+ Ref_URL: http://www.contentowner.com/trackingid.asp?A1234567
+ Severity: Normal
+ Status: 'First Notice, Open'
+Complainant:
+ Address: '100 Anywhere Street, Anywhere, CA 90000'
+ Contact: John Doe
+ Email: antipiracy at contentowner.com
+ Entity: Content Owner Inc.
+ Phone: 555-555-1212
+Content:
+ Item:
+ - FileName: 8Mile.mpg
+ FileSize: 702453789
+ Hash:
+ Type: SHA1
+ _: EKR94KF985873KD930ER4KD94
+ Title: 8 Mile
+ Type: Movie
+ URL: ftp://guest:freepwd@168.1.1.145/media/8Mile/8mile.mpg
+ - Artist: Eminem
+ FileName: eminem_loseyourself.mp3
+ FileSize: 4235654
+ Hash:
+ Type: SHA1
+ _: B5A94KF93673KD930D21DFD94
+ Title: Lose Yourself
+ Type: SoundRecording
+ URL: ftp://guest:freepwd@168.1.1.145/media/8Mile/eminem_loseyourself.mp3
+History:
+ Notice:
+ - ID: 12321
+ TimeStamp: 2003-08-30T10:23:13Z
+ _: freeform text area
+ - ID: 19832
+ TimeStamp: 2003-08-30T11:03:00Z
+ _: freeform text area
+Notes: |-2
+
+ Open area for freeform text notes, filelists, etc...
+
+ drwxr-xr-x 2 staff ftp 4096 May 15 13:21 morestuff
+ -rw-r--r-- 1 staff ftp 702453789 Mar 24 15:34 8Mile.mpg
+ -rw-r--r-- 1 staff ftp 4235654 Mar 24 07:44 eminem_loseyourself.mp3
+ -rw-r--r-- 1 staff ftp 3914249 Apr 4 07:53 xzibit_spitshine.mp3
+ -rw-r--r-- 1 staff ftp 1525267 Feb 24 16:39 50cent_wanksta.mp3
+ -rw-r--r-- 1 staff ftp 25188 Feb 24 16:42 coverart.jpg
+
+Service_Provider:
+ Address: '100 Anywhere Street, Anywhere, CA 90000'
+ Contact: John Doe
+ Email: dmca_agent at ispbroadband.net
+ Entity: ISP Broadband Inc.
+ Phone: 555-555-1212
+Source:
+ DNS_Name: pcp574.nshville.tn.ispbroadband.net
+ Deja_Vu: Yes
+ IP_Address: 168.1.1.145
+ IP_Block: '?????'
+ Login:
+ Password: freepwd
+ Username: guest
+ MAC_Address: 00-00-39-B6-00-A4
+ Number_Files: 324
+ Port: 21
+ TimeStamp: 2003-08-30T12:34:53Z
+ Type: FTP
+ URL_Base: ftp://guest:freepwd@168.1.1.145/media/8Mile/
+ UserName: guest
diff --git a/t/data/0.7/full.xml b/t/data/0.7/full.xml
new file mode 100644
index 0000000..63ada36
--- /dev/null
+++ b/t/data/0.7/full.xml
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<Infringement xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="Infringement_schema-0.7.xsd">
+ <Case>
+ <ID>A1234567</ID>
+ <Ref_URL>http://www.contentowner.com/trackingid.asp?A1234567</Ref_URL>
+ <Status>First Notice, Open</Status>
+ <Severity>Normal</Severity>
+ </Case>
+ <Complainant>
+ <Entity>Content Owner Inc.</Entity>
+ <Contact>John Doe</Contact>
+ <Address>100 Anywhere Street, Anywhere, CA 90000</Address>
+ <Phone>555-555-1212</Phone>
+ <Email>antipiracy at contentowner.com</Email>
+ </Complainant>
+ <Service_Provider>
+ <Entity>ISP Broadband Inc.</Entity>
+ <Contact>John Doe</Contact>
+ <Address>100 Anywhere Street, Anywhere, CA 90000</Address>
+ <Phone>555-555-1212</Phone>
+ <Email>dmca_agent at ispbroadband.net</Email>
+ </Service_Provider>
+ <Source>
+ <TimeStamp>2003-08-30T12:34:53Z</TimeStamp>
+ <IP_Address>168.1.1.145</IP_Address>
+ <Port>21</Port>
+ <DNS_Name>pcp574.nshville.tn.ispbroadband.net</DNS_Name>
+ <MAC_Address>00-00-39-B6-00-A4</MAC_Address>
+ <IP_Block>?????</IP_Block>
+ <Type>FTP</Type>
+ <URL_Base>ftp://guest:freepwd@168.1.1.145/media/8Mile/</URL_Base>
+ <UserName>guest</UserName>
+ <Login Username="guest" Password="freepwd"/>
+ <Number_Files>324</Number_Files>
+ <Deja_Vu>Yes</Deja_Vu>
+ </Source>
+ <Content>
+ <Item>
+ <TimeStamp>2003-08-30T12:34:53Z</TimeStamp>
+ <Title>8 Mile</Title>
+ <FileName>8Mile.mpg</FileName>
+ <FileSize>702453789</FileSize>
+ <URL>ftp://guest:freepwd@168.1.1.145/media/8Mile/8mile.mpg</URL>
+ <Type>Movie</Type>
+ <Hash Type="SHA1">EKR94KF985873KD930ER4KD94</Hash>
+ </Item>
+ <Item>
+ <TimeStamp>2003-08-30T12:34:53Z</TimeStamp>
+ <Title>Lose Yourself</Title>
+ <Artist>Eminem</Artist>
+ <FileName>eminem_loseyourself.mp3</FileName>
+ <FileSize>4235654</FileSize>
+ <URL>ftp://guest:freepwd@168.1.1.145/media/8Mile/eminem_loseyourself.mp3</URL>
+ <Type>SoundRecording</Type>
+ <Hash Type="SHA1">B5A94KF93673KD930D21DFD94</Hash>
+ </Item>
+ </Content>
+ <History>
+ <Notice ID="12321" TimeStamp="2003-08-30T10:23:13Z">freeform text area</Notice>
+ <Notice ID="19832" TimeStamp="2003-08-30T11:03:00Z">freeform text area</Notice>
+ </History>
+ <Notes>
+ Open area for freeform text notes, filelists, etc...
+
+ drwxr-xr-x 2 staff ftp 4096 May 15 13:21 morestuff
+ -rw-r--r-- 1 staff ftp 702453789 Mar 24 15:34 8Mile.mpg
+ -rw-r--r-- 1 staff ftp 4235654 Mar 24 07:44 eminem_loseyourself.mp3
+ -rw-r--r-- 1 staff ftp 3914249 Apr 4 07:53 xzibit_spitshine.mp3
+ -rw-r--r-- 1 staff ftp 1525267 Feb 24 16:39 50cent_wanksta.mp3
+ -rw-r--r-- 1 staff ftp 25188 Feb 24 16:42 coverart.jpg
+ </Notes>
+</Infringement>
diff --git a/t/data/0.7/full.yaml b/t/data/0.7/full.yaml
new file mode 100644
index 0000000..d23b289
--- /dev/null
+++ b/t/data/0.7/full.yaml
@@ -0,0 +1,74 @@
+root: Infringement
+---
+Case:
+ ID: A1234567
+ Ref_URL: http://www.contentowner.com/trackingid.asp?A1234567
+ Severity: Normal
+ Status: 'First Notice, Open'
+Complainant:
+ Address: '100 Anywhere Street, Anywhere, CA 90000'
+ Contact: John Doe
+ Email: antipiracy at contentowner.com
+ Entity: Content Owner Inc.
+ Phone: 555-555-1212
+Content:
+ Item:
+ - FileName: 8Mile.mpg
+ FileSize: 702453789
+ Hash:
+ Type: SHA1
+ _: EKR94KF985873KD930ER4KD94
+ TimeStamp: 2003-08-30T12:34:53Z
+ Title: 8 Mile
+ Type: Movie
+ URL: ftp://guest:freepwd@168.1.1.145/media/8Mile/8mile.mpg
+ - Artist: Eminem
+ FileName: eminem_loseyourself.mp3
+ FileSize: 4235654
+ Hash:
+ Type: SHA1
+ _: B5A94KF93673KD930D21DFD94
+ TimeStamp: 2003-08-30T12:34:53Z
+ Title: Lose Yourself
+ Type: SoundRecording
+ URL: ftp://guest:freepwd@168.1.1.145/media/8Mile/eminem_loseyourself.mp3
+History:
+ Notice:
+ - ID: 12321
+ TimeStamp: 2003-08-30T10:23:13Z
+ _: freeform text area
+ - ID: 19832
+ TimeStamp: 2003-08-30T11:03:00Z
+ _: freeform text area
+Notes: |-2
+
+ Open area for freeform text notes, filelists, etc...
+
+ drwxr-xr-x 2 staff ftp 4096 May 15 13:21 morestuff
+ -rw-r--r-- 1 staff ftp 702453789 Mar 24 15:34 8Mile.mpg
+ -rw-r--r-- 1 staff ftp 4235654 Mar 24 07:44 eminem_loseyourself.mp3
+ -rw-r--r-- 1 staff ftp 3914249 Apr 4 07:53 xzibit_spitshine.mp3
+ -rw-r--r-- 1 staff ftp 1525267 Feb 24 16:39 50cent_wanksta.mp3
+ -rw-r--r-- 1 staff ftp 25188 Feb 24 16:42 coverart.jpg
+
+Service_Provider:
+ Address: '100 Anywhere Street, Anywhere, CA 90000'
+ Contact: John Doe
+ Email: dmca_agent at ispbroadband.net
+ Entity: ISP Broadband Inc.
+ Phone: 555-555-1212
+Source:
+ DNS_Name: pcp574.nshville.tn.ispbroadband.net
+ Deja_Vu: Yes
+ IP_Address: 168.1.1.145
+ IP_Block: '?????'
+ Login:
+ Password: freepwd
+ Username: guest
+ MAC_Address: 00-00-39-B6-00-A4
+ Number_Files: 324
+ Port: 21
+ TimeStamp: 2003-08-30T12:34:53Z
+ Type: FTP
+ URL_Base: ftp://guest:freepwd@168.1.1.145/media/8Mile/
+ UserName: guest
diff --git a/t/parse.t b/t/parse.t
new file mode 100644
index 0000000..82d52c8
--- /dev/null
+++ b/t/parse.t
@@ -0,0 +1,22 @@
+use strict;
+use warnings;
+
+use Test::More tests => 9;
+use File::Spec;
+use YAML::Any qw(LoadFile);
+
+use_ok('Parse::ACNS');
+
+foreach my $spec (qw(0.6 0.7)) {
+ foreach my $file ( glob File::Spec->catfile(qw(t data), $spec, '*.xml') ) {
+ foreach my $version ( $spec, 'compat' ) {
+ my $p = Parse::ACNS->new( version => $version );
+ my $got = $p->parse( XML::LibXML->new->parse_file( $file ) );
+ ok($got, "parsed '$file' in $version version mode");
+ my $expected = LoadFile( substr($file, 0, -3) .'yaml' );
+ is_deeply($got, $expected, 'data matches expected');
+ }
+ }
+}
+
+
commit 0f30e057da21b9de9cf9e64bb33cdbde0e7f4d9d
Author: Ruslan Zakirov <ruz at bestpractical.com>
Date: Wed Jan 26 15:01:02 2011 +0300
minor
diff --git a/lib/Parse/ACNS.pm b/lib/Parse/ACNS.pm
index dca7bb8..7922281 100644
--- a/lib/Parse/ACNS.pm
+++ b/lib/Parse/ACNS.pm
@@ -6,12 +6,6 @@ use warnings;
package Parse::ACNS;
our $VERSION = '0.01';
-use File::ShareDir ();
-use File::Spec ();
-use Scalar::Util qw(blessed);
-use XML::LibXML;
-use XML::Compile::Schema;
-
=head1 NAME
Parse::ACNS - parser for Automated Copyright Notice System (ACNS) XML
@@ -28,6 +22,12 @@ Parse::ACNS - parser for Automated Copyright Notice System (ACNS) XML
=cut
+use File::ShareDir ();
+use File::Spec ();
+use Scalar::Util qw(blessed);
+use XML::LibXML;
+use XML::Compile::Schema;
+
our %CACHE = (
);
commit 128fce054672e35c94fe00550793fbe6d826ffdf
Author: Ruslan Zakirov <ruz at bestpractical.com>
Date: Wed Jan 26 15:01:31 2011 +0300
fix initial code
diff --git a/lib/Parse/ACNS.pm b/lib/Parse/ACNS.pm
index 7922281..17b60ef 100644
--- a/lib/Parse/ACNS.pm
+++ b/lib/Parse/ACNS.pm
@@ -48,13 +48,14 @@ sub init {
);
}
- my $path = File::ShareDir::class_file(
+ my $path = File::ShareDir::dist_file(
+ 'Parse-ACNS',
File::Spec->catfile( 'schema', $self->{'version'}, 'infringement.xsd' )
);
$self->{'reader'} = $CACHE{$path}{'reader'};
unless ( $self->{'reader'} ) {
- my $schema = XML::Compile::Schema( [$path] );
+ my $schema = XML::Compile::Schema->new( [$path] );
$self->{'reader'} = $schema->compile( READER => 'Infringement' );
}
return $self;
commit c33630e30db2787685460ddfd420494af34c89fd
Author: Ruslan Zakirov <ruz at bestpractical.com>
Date: Wed Jan 26 15:02:12 2011 +0300
there is no point in all these parse_xxx functions
diff --git a/lib/Parse/ACNS.pm b/lib/Parse/ACNS.pm
index 17b60ef..496fc8b 100644
--- a/lib/Parse/ACNS.pm
+++ b/lib/Parse/ACNS.pm
@@ -66,46 +66,6 @@ sub parse {
return $self->{'reader'}->( shift );
}
-sub parse_any {
- my $self = shift;
- my $source = shift;
- if ( blessed($source) ) {
- if ( $source->isa('XML::LibXML') ) {
- return $self->parse( $source );
- }
- else {
- require Carp;
- Carp::croak('Parsing from object of type '. ref($source) . ' is not supported');
- }
- }
- elsif ( ref $source ) {
- return $self->parse_fh( $source );
- }
- else {
- if ( -e $source ) {
- return $self->parse_file( $source );
- }
- else {
- return $self->parse_string( $source );
- }
- }
-}
-
-sub parse_string {
- my $self = shift;
- return $self->parse( XML::LibXML->new->parse_string(shift) );
-}
-
-sub parse_file {
- my $self = shift;
- return $self->parse( XML::LibXML->new->parse_file(shift) );
-}
-
-sub parse_fh {
- my $self = shift;
- return $self->parse( XML::LibXML->new->parse_fh(shift) );
-}
-
=head1 AUTHOR
Ruslan Zakirov E<lt>ruz at bestpractical.comE<gt>
commit cd8346eb2818eeba599f6bd74278c625ed8484aa
Author: Ruslan Zakirov <ruz at bestpractical.com>
Date: Wed Jan 26 15:37:25 2011 +0300
diag parsed structures under verbose testing
diff --git a/t/parse.t b/t/parse.t
index 82d52c8..e22be7e 100644
--- a/t/parse.t
+++ b/t/parse.t
@@ -15,6 +15,10 @@ foreach my $spec (qw(0.6 0.7)) {
ok($got, "parsed '$file' in $version version mode");
my $expected = LoadFile( substr($file, 0, -3) .'yaml' );
is_deeply($got, $expected, 'data matches expected');
+ if ( $ENV{'TEST_VERBOSE'} ) {
+ require Data::Dumper;
+ diag( Data::Dumper::Dumper( $got ) );
+ }
}
}
}
commit e966694747235df6d87581a6892067410800f66d
Author: Ruslan Zakirov <ruz at bestpractical.com>
Date: Wed Jan 26 15:37:47 2011 +0300
documentation
diff --git a/README b/README
index 5e796a9..cad3d31 100644
--- a/README
+++ b/README
@@ -3,12 +3,91 @@ NAME
SYNOPSIS
use Parse::ACNS;
- my $parser = Parse::ACNS->new(
- version => 'compat',
- );
- $parser->parse( );
+ my $data = Parse::ACNS->new->parse( XML::LibXML->load_xml( string => $xml ) );
DESCRIPTION
+ ACNS stands for Automated Copyright Notice System. It's an open source,
+ royalty free system that universities, ISP's, or anyone that handles
+ large volumes of copyright notices can implement on their network to
+ increase the efficiency and reduce the costs of responding to the
+ notices... See "http://mpto.unistudios.com/xml/" for more details.
+
+ This module parses ACNS XML into a perl data structure. Supports both
+ 0.6 and 0.7 version. Parser strictly follows XML Schemas, so throws
+ errors on malformed data.
+
+ However, it doesn't extract ACNS XML from email messages.
+
+METHODS
+ new
+ Constructor, takes list of named arguments.
+
+ version - version of the specification
+
+ compat - default value, can parse both 0.7 and 0.6 XML by making
+ TimeStamp element in Infringement/Content/Item optional. This is the
+ only difference between the spec versions.
+ 0.7 or 0.6 - strict parsing of the specified version.
+
+ parse
+ my $data = Parse::ACNS->new->parse( XML::LibXML->load_xml(...) );
+
+ Takes XML::LibXML::Document containing an ACNS XML and returns it as a
+ perl struture. Read XML::LibXML::Parser on parsing from different
+ sources.
+
+ Returned data structure follows XML and its Schema, for example:
+
+ {
+ 'Case' => {
+ 'ID' => 'A1234567',
+ 'Status' => ...,
+ ...
+ },
+ 'Complainant' => {
+ 'Email' => 'antipiracy at contentowner.com',
+ 'Phone' => ...,
+ ...
+ },
+ 'Source' => {
+ 'TimeStamp' => '2003-08-30T12:34:53Z',
+ 'UserName' => 'guest',
+ 'Login' => { ... },
+ 'IP_Address' => ...,
+ ...
+ }
+ 'Service_Provider' => { ... }
+ 'Content' => {
+ 'Item' => [
+ {
+ 'TimeStamp' => '2003-08-30T12:34:53Z',
+ 'FileName' => '8Mile.mpg',
+ 'Hash' => {
+ 'Type' => 'SHA1',
+ '_' => 'EKR94KF985873KD930ER4KD94'
+ },
+ ...
+ },
+ { ... },
+ ...
+ ]
+ },
+ 'History' => {
+ 'Notice' => [
+ {
+ 'ID' => '12321',
+ 'TimeStamp' => '2003-08-30T10:23:13Z',
+ '_' => 'freeform text area'
+ },
+ { ... },
+ ...
+ ]
+ },
+ 'Notes' => '
+ Open area for freeform text notes, filelists, etc...
+ '
+ }
+
AUTHOR
Ruslan Zakirov <ruz at bestpractical.com>
diff --git a/lib/Parse/ACNS.pm b/lib/Parse/ACNS.pm
index 496fc8b..148701c 100644
--- a/lib/Parse/ACNS.pm
+++ b/lib/Parse/ACNS.pm
@@ -11,15 +11,24 @@ our $VERSION = '0.01';
Parse::ACNS - parser for Automated Copyright Notice System (ACNS) XML
=head1 SYNOPSIS
-
+
use Parse::ACNS;
- my $parser = Parse::ACNS->new(
- version => 'compat',
- );
- $parser->parse( );
+ my $data = Parse::ACNS->new->parse( XML::LibXML->load_xml( string => $xml ) );
=head1 DESCRIPTION
+ACNS stands for Automated Copyright Notice System. It's an open source,
+royalty free system that universities, ISP's, or anyone that handles large
+volumes of copyright notices can implement on their network to increase
+the efficiency and reduce the costs of responding to the notices...
+See "http://mpto.unistudios.com/xml/" for more details.
+
+This module parses ACNS XML into a perl data structure. Supports both 0.6 and
+0.7 version. Parser strictly follows XML Schemas, so throws errors on malformed
+data.
+
+However, it B<doesn't> extract ACNS XML from email messages.
+
=cut
use File::ShareDir ();
@@ -31,6 +40,30 @@ use XML::Compile::Schema;
our %CACHE = (
);
+=head1 METHODS
+
+=head2 new
+
+Constructor, takes list of named arguments.
+
+=over 4
+
+=item version - version of the specification
+
+=over 4
+
+=item compat - default value, can parse both 0.7 and 0.6 XML by making
+TimeStamp element in Infringement/Content/Item optional. This is the
+only difference between the spec versions.
+
+=item 0.7 or 0.6 - strict parsing of the specified version.
+
+=back
+
+=back
+
+=cut
+
sub new {
my $proto = shift;
return (bless { @_ }, ref($proto) || $proto)->init;
@@ -61,6 +94,67 @@ sub init {
return $self;
}
+=head2 parse
+
+ my $data = Parse::ACNS->new->parse( XML::LibXML->load_xml(...) );
+
+Takes L<XML::LibXML::Document> containing an ACNS XML and returns it as a perl
+struture. Read L<XML::LibXML::Parser> on parsing from different sources.
+
+Returned data structure follows XML and its Schema, for example:
+
+ {
+ 'Case' => {
+ 'ID' => 'A1234567',
+ 'Status' => ...,
+ ...
+ },
+ 'Complainant' => {
+ 'Email' => 'antipiracy at contentowner.com',
+ 'Phone' => ...,
+ ...
+ },
+ 'Source' => {
+ 'TimeStamp' => '2003-08-30T12:34:53Z',
+ 'UserName' => 'guest',
+ 'Login' => { ... },
+ 'IP_Address' => ...,
+ ...
+ }
+ 'Service_Provider' => { ... }
+ 'Content' => {
+ 'Item' => [
+ {
+ 'TimeStamp' => '2003-08-30T12:34:53Z',
+ 'FileName' => '8Mile.mpg',
+ 'Hash' => {
+ 'Type' => 'SHA1',
+ '_' => 'EKR94KF985873KD930ER4KD94'
+ },
+ ...
+ },
+ { ... },
+ ...
+ ]
+ },
+ 'History' => {
+ 'Notice' => [
+ {
+ 'ID' => '12321',
+ 'TimeStamp' => '2003-08-30T10:23:13Z',
+ '_' => 'freeform text area'
+ },
+ { ... },
+ ...
+ ]
+ },
+ 'Notes' => '
+ Open area for freeform text notes, filelists, etc...
+ '
+ }
+
+=cut
+
sub parse {
my $self = shift;
return $self->{'reader'}->( shift );
-----------------------------------------------------------------------
More information about the Bps-public-commit
mailing list