Path-Dispatcher-Declarative-0.03/000755 000765 000024 00000000000 11463777121 017276 5ustar00sartakstaff000000 000000 Path-Dispatcher-Declarative-0.03/Changes000644 000765 000024 00000000642 11463777030 020572 0ustar00sartakstaff000000 000000 Revision history for Path-Dispatcher-Declarative 0.03 2010-11-02 Improve reinstatement of $1, $2 so they don't leak outside of the scope of your blocks Remove a couple stray references to named rules 0.02 2010-10-24 Reinstate the back-compat that Path-Dispatcher 1.00 broke by setting $1, $2, etc. for you 0.01 2010-03-16 Factored out of Path-Dispatcher Path-Dispatcher-Declarative-0.03/inc/000755 000765 000024 00000000000 11463777121 020047 5ustar00sartakstaff000000 000000 Path-Dispatcher-Declarative-0.03/lib/000755 000765 000024 00000000000 11463777121 020044 5ustar00sartakstaff000000 000000 Path-Dispatcher-Declarative-0.03/Makefile.PL000644 000765 000024 00000000446 11463776744 021266 0ustar00sartakstaff000000 000000 use inc::Module::Install; name 'Path-Dispatcher-Declarative'; all_from 'lib/Path/Dispatcher/Declarative.pm'; repository 'http://github.com/bestpractical/path-dispatcher-declarative'; requires 'Path::Dispatcher' => '1.02'; requires 'Any::Moose'; requires 'Sub::Exporter'; WriteAll; Path-Dispatcher-Declarative-0.03/MANIFEST000644 000765 000024 00000001341 11463777115 020431 0ustar00sartakstaff000000 000000 Changes inc/Module/Install.pm inc/Module/Install/Base.pm inc/Module/Install/Can.pm inc/Module/Install/Fetch.pm inc/Module/Install/Makefile.pm inc/Module/Install/Metadata.pm inc/Module/Install/Win32.pm inc/Module/Install/WriteAll.pm lib/Path/Dispatcher/Declarative.pm lib/Path/Dispatcher/Declarative/Builder.pm Makefile.PL MANIFEST This list of files META.yml t/016-more-under.t t/020-chain.t t/021-declarative-defaults.t t/100-declarative.t t/101-subclass.t t/102-abort.t t/103-input.t t/104-config.t t/105-empty.t t/106-metadata.t t/200-under-next_rule.t t/300-complete-simple.t t/301-complete-complex.t t/302-complete-delimiter.t t/303-complete-alternation.t t/304-complete-enum.t t/800-cb-slash-path-delimiter.t t/801-cb-chaining.t Path-Dispatcher-Declarative-0.03/META.yml000644 000765 000024 00000001231 11463777113 020545 0ustar00sartakstaff000000 000000 --- abstract: 'sugary dispatcher' author: - 'Shawn M Moore, C<< >>' 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 name: Path-Dispatcher-Declarative no_index: directory: - inc - t requires: Any::Moose: 0 Path::Dispatcher: 1.02 Sub::Exporter: 0 perl: 5.8.1 resources: license: http://dev.perl.org/licenses/ repository: http://github.com/bestpractical/path-dispatcher-declarative version: 0.03 Path-Dispatcher-Declarative-0.03/t/000755 000765 000024 00000000000 11463777121 017541 5ustar00sartakstaff000000 000000 Path-Dispatcher-Declarative-0.03/t/016-more-under.t000644 000765 000024 00000002466 11456531035 022311 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 8; my @calls; do { package Under::Where; use Path::Dispatcher::Declarative -base; under 'ticket' => sub { on 'create' => sub { push @calls, "ticket create" }; on 'update' => sub { push @calls, "ticket update" }; }; under 'blog' => sub { under 'post' => sub { on 'create' => sub { push @calls, "create blog post" }; on 'delete' => sub { push @calls, "delete blog post" }; }; under 'comment' => sub { on 'create' => sub { push @calls, "create blog comment" }; on 'delete' => sub { push @calls, "delete blog comment" }; }; }; }; Under::Where->run('ticket create'); is_deeply([splice @calls], ['ticket create']); Under::Where->run('ticket update'); is_deeply([splice @calls], ['ticket update']); Under::Where->run('ticket foo'); is_deeply([splice @calls], []); Under::Where->run('blog'); is_deeply([splice @calls], []); Under::Where->run('blog post'); is_deeply([splice @calls], []); Under::Where->run('blog post create'); is_deeply([splice @calls], ['create blog post']); Under::Where->run('blog comment'); is_deeply([splice @calls], []); Under::Where->run('blog comment create'); is_deeply([splice @calls], ['create blog comment']); Path-Dispatcher-Declarative-0.03/t/020-chain.t000644 000765 000024 00000010300 11456531035 021273 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 40; use Path::Dispatcher; my $predicate = Path::Dispatcher::Rule::Tokens->new( tokens => ['ticket'], prefix => 1, ); my $chain = Path::Dispatcher::Rule::Chain->new; my $create = Path::Dispatcher::Rule::Tokens->new( tokens => ['create'], ); my $update = Path::Dispatcher::Rule::Tokens->new( tokens => ['update'], prefix => 1, ); my $under_always = Path::Dispatcher::Rule::Under->new( predicate => $predicate, rules => [Path::Dispatcher::Rule::Always->new, $create, $update], ); my $under_chain = Path::Dispatcher::Rule::Under->new( predicate => $predicate, rules => [$chain, $create, $update], ); my %tests = ( "ticket" => { fail => 1, catchall => 1, always => 1, }, "ticket create" => {}, "ticket update" => {}, " ticket update " => { name => "whitespace doesn't matter for token-based rules", }, "ticket update foo" => { name => "'ticket update' rule is prefix", }, "ticket create foo" => { fail => 1, catchall => 1, always => 1, name => "did not match 'ticket create foo' because it's not a suffix", }, "comment create" => { fail => 1, name => "did not match 'comment create' because the prefix is ticket", }, "ticket delete" => { fail => 1, catchall => 1, always => 1, name => "did not match 'ticket delete' because delete is not a suffix", }, ); sub run_tests { my $under = shift; my $is_always = shift; for my $path (keys %tests) { my $data = $tests{$path}; my $name = $data->{name} || $path; my $match = $under->match(Path::Dispatcher::Path->new($path)); $match = !$match if $data->{fail} && !($is_always && $data->{always}); # Always always matches ok($match, $name); } my $catchall = Path::Dispatcher::Rule::Regex->new( regex => qr/()/, ); $under->add_rule($catchall); for my $path (keys %tests) { my $data = $tests{$path}; my $name = $data->{name} || $path; my $match = $under->match(Path::Dispatcher::Path->new($path)); $match = !$match if $data->{fail} && !$data->{catchall}; ok($match, $name); } } run_tests $under_chain, 0; run_tests $under_always, 1; my @result; do { package ChainDispatch; use Path::Dispatcher::Declarative -base; under 'ticket' => sub { chain { push @result, "(ticket chain)"; }; on 'create' => sub { push @result, "ticket create" }; chain { push @result, "(ticket chain just for update)"; }; on 'update' => sub { push @result, "ticket update" }; }; under 'blog' => sub { chain { push @result, "(blog chain)"; }; under 'post' => sub { chain { push @result, "(after post)"; }; on 'create' => sub { push @result, "create blog post" }; on 'delete' => sub { push @result, "delete blog post" }; }; chain { push @result, "(before comment)"; }; under 'comment' => sub { on 'create' => sub { push @result, "create blog comment" }; on 'delete' => sub { push @result, "delete blog comment" }; chain { push @result, "(never included)"; }; }; }; }; ChainDispatch->run('ticket create'); is_deeply([splice @result], ['(ticket chain)', 'ticket create']); ChainDispatch->run('ticket update'); is_deeply([splice @result], ['(ticket chain)', '(ticket chain just for update)', 'ticket update']); ChainDispatch->run('ticket foo'); is_deeply([splice @result], []); ChainDispatch->run('blog'); is_deeply([splice @result], []); ChainDispatch->run('blog post'); is_deeply([splice @result], []); ChainDispatch->run('blog post create'); is_deeply([splice @result], ['(blog chain)', '(after post)', 'create blog post']); ChainDispatch->run('blog comment'); is_deeply([splice @result], []); ChainDispatch->run('blog comment create'); is_deeply([splice @result], ['(blog chain)', '(before comment)', 'create blog comment']); Path-Dispatcher-Declarative-0.03/t/021-declarative-defaults.t000644 000765 000024 00000000764 11456531035 024317 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 1; my @calls; do { package Web::Dispatcher; use base 'Path::Dispatcher::Declarative'; use constant token_delimiter => '/'; package My::Other::Dispatcher; # we can't use a package in the same file :/ BEGIN { Web::Dispatcher->import('-base') }; on ['foo', 'bar'] => sub { push @calls, '/foo/bar'; }; }; My::Other::Dispatcher->run('/foo/bar'); is_deeply([splice @calls], ['/foo/bar']); Path-Dispatcher-Declarative-0.03/t/100-declarative.t000644 000765 000024 00000003620 11456531035 022502 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 11; my @calls; do { package MyApp::Dispatcher; use Path::Dispatcher::Declarative -base; on qr/(b)(ar)(.*)/ => sub { push @calls, [$1, $2, $3]; }; on ['token', 'matching'] => sub { push @calls, [$1, $2]; }; rewrite quux => 'bar'; rewrite qr/^quux-(.*)/ => sub { "bar:$1" }; on alpha => sub { push @calls, "alpha" }; under alpha => sub { then { push @calls, "alpha (chain) "; }; on one => sub { push @calls, "one"; }; then { push @calls, "(before two or three) "; }; on two => sub { push @calls, "two"; }; on three => sub { push @calls, "three"; }; }; }; ok(MyApp::Dispatcher->isa('Path::Dispatcher::Declarative'), "use Path::Dispatcher::Declarative sets up ISA"); can_ok('MyApp::Dispatcher' => qw/dispatcher dispatch run/); MyApp::Dispatcher->run('foobarbaz'); is_deeply([splice @calls], [ [ 'b', 'ar', 'baz' ], ]); MyApp::Dispatcher->run('quux'); is_deeply([splice @calls], [ [ 'b', 'ar', '' ], ]); MyApp::Dispatcher->run('quux-hello'); is_deeply([splice @calls], [ [ 'b', 'ar', ':hello' ], ]); MyApp::Dispatcher->run('token matching'); is_deeply([splice @calls], [ [ 'token', 'matching' ], ]); MyApp::Dispatcher->run('Token Matching'); is_deeply([splice @calls], [], "token matching is by default case sensitive"); MyApp::Dispatcher->run('alpha'); is_deeply([splice @calls], ['alpha']); MyApp::Dispatcher->run('alpha one'); is_deeply([splice @calls], ['alpha (chain) ', 'one']); MyApp::Dispatcher->run('alpha two'); is_deeply([splice @calls], ['alpha (chain) ', '(before two or three) ', 'two']); MyApp::Dispatcher->run('alpha three'); is_deeply([splice @calls], ['alpha (chain) ', '(before two or three) ', 'three']); Path-Dispatcher-Declarative-0.03/t/101-subclass.t000644 000765 000024 00000001516 11456531035 022041 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 2; my @calls; do { package MyFramework::Dispatcher; use Path::Dispatcher::Declarative -base; on 'quit' => sub { push @calls, 'framework: quit' }; package MyApp::Dispatcher; # this hack is here because "use" expects there to be a file for the module BEGIN { MyFramework::Dispatcher->import("-base") } on qr/.*/ => sub { push @calls, 'app: first .*'; next_rule; }; redispatch_to('MyFramework::Dispatcher'); on qr/.*/ => sub { push @calls, 'app: second .*'; next_rule; }; }; MyApp::Dispatcher->run("quit"); is_deeply([splice @calls], [ 'app: first .*', 'framework: quit', ]); MyApp::Dispatcher->run("other"); is_deeply([splice @calls], [ 'app: first .*', 'app: second .*', ]); Path-Dispatcher-Declarative-0.03/t/102-abort.t000644 000765 000024 00000002537 11456531035 021336 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 2; my @calls; do { package MyFramework::Dispatcher; use Path::Dispatcher::Declarative -base; on qr/abort/ => sub { push @calls, 'framework on abort'; }; on qr/next rule/ => sub { push @calls, 'framework before next_rule'; next_rule; push @calls, 'framework after next_rule'; }; on qr/next rule/ => sub { push @calls, 'framework before next_rule 2'; next_rule; push @calls, 'framework after next_rule 2'; }; package MyApp::Dispatcher; # this hack is here because "use" expects there to be a file for the module BEGIN { MyFramework::Dispatcher->import("-base") } on qr/next rule/ => sub { push @calls, 'app before next_rule'; next_rule; push @calls, 'app after next_rule'; }; on qr/next rule/ => sub { push @calls, 'app before next_rule 2'; next_rule; push @calls, 'app after next_rule 2'; }; redispatch_to('MyFramework::Dispatcher'); }; MyApp::Dispatcher->run('abort'); is_deeply([splice @calls], [ 'framework on abort', ]); MyApp::Dispatcher->run('next rule'); is_deeply([splice @calls], [ 'app before next_rule', 'app before next_rule 2', 'framework before next_rule', 'framework before next_rule 2', ]); Path-Dispatcher-Declarative-0.03/t/103-input.t000644 000765 000024 00000002203 11460760121 021350 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 1; my @calls; do { package MyFramework::Dispatcher; use Path::Dispatcher::Declarative -base; on qr/a(rg)s/ => sub { push @calls, { from => "framework", args => [@_], it => $_, one => $1, two => $2, }; }; package MyApp::Dispatcher; # this hack is here because "use" expects there to be a file for the module BEGIN { MyFramework::Dispatcher->import("-base") } on qr/ar(g)s/ => sub { push @calls, { from => "app", args => [@_], it => $_, one => $1, two => $2, }; next_rule; }; redispatch_to(MyFramework::Dispatcher->dispatcher); }; MyApp::Dispatcher->run('args', 1..3); is_deeply([splice @calls], [ { from => 'app', one => 'g', two => undef, it => 'args', args => [1, 2, 3], }, { from => 'framework', one => 'rg', two => undef, it => 'args', args => [1, 2, 3], }, ]); Path-Dispatcher-Declarative-0.03/t/104-config.t000644 000765 000024 00000001410 11456531035 021463 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 5; my @calls; do { package RESTy::Dispatcher; use Path::Dispatcher::Declarative -base, -default => { token_delimiter => '/', case_sensitive_tokens => 0, }; on ['=', 'model', 'Comment'] => sub { push @calls, $3 }; }; ok(RESTy::Dispatcher->isa('Path::Dispatcher::Declarative'), "use Path::Dispatcher::Declarative sets up ISA"); RESTy::Dispatcher->run('= model Comment'); is_deeply([splice @calls], []); RESTy::Dispatcher->run('/=/model/Comment'); is_deeply([splice @calls], ["Comment"]); RESTy::Dispatcher->run('/=/model/comment'); is_deeply([splice @calls], ["comment"]); RESTy::Dispatcher->run('///=///model///COMMENT///'); is_deeply([splice @calls], ["COMMENT"]); Path-Dispatcher-Declarative-0.03/t/105-empty.t000644 000765 000024 00000000556 11456531035 021367 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 2; my @calls; do { package MyApp::Dispatcher; use Path::Dispatcher::Declarative -base; on '' => sub { push @calls, "empty: $_"; }; }; MyApp::Dispatcher->run("foo"); is_deeply([splice @calls], []); MyApp::Dispatcher->run(""); is_deeply([splice @calls], ["empty: "]); Path-Dispatcher-Declarative-0.03/t/106-metadata.t000644 000765 000024 00000002036 11456531035 022005 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 2; my @calls; do { package MyApp::Dispatcher; use Path::Dispatcher::Declarative -base; on { method => 'GET' } => sub { push @calls, "method: GET, path: $_"; }; }; my $path = Path::Dispatcher::Path->new( path => "/REST/Ticket/1.yml", metadata => { method => "GET", query_parameters => { owner => 'Sartak', status => 'closed', }, }, ); MyApp::Dispatcher->run($path); is_deeply([splice @calls], ["method: GET, path: /REST/Ticket/1.yml"]); do { package MyApp::Other::Dispatcher; use Path::Dispatcher::Declarative -base; on { query_parameters => { owner => qr/^\w+$/, }, } => sub { push @calls, "query_parameters/owner/regex"; }; }; TODO: { local $TODO = "metadata can't be a deep data structure"; eval { MyApp::Other::Dispatcher->run($path); }; is_deeply([splice @calls], ["query_parameters/owner/regex"]); }; Path-Dispatcher-Declarative-0.03/t/200-under-next_rule.t000644 000765 000024 00000001262 11456531035 023340 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 1; my @calls; do { package MyApp::Dispatcher; use Path::Dispatcher::Declarative -base; under first => sub { on qr/./ => sub { push @calls, "[$_] first -> regex"; next_rule; }; on second => sub { push @calls, "[$_] first -> string, via next_rule"; }; }; }; TODO: { local $TODO = "under doesn't pass its matched fragment as part of the path"; MyApp::Dispatcher->run("first second"); is_deeply([splice @calls], [ "[first second] first -> regex", "[first second] first -> string, via next_rule", ]); } Path-Dispatcher-Declarative-0.03/t/300-complete-simple.t000644 000765 000024 00000003075 11456531035 023324 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 16; use Path::Dispatcher; my $complete = Path::Dispatcher::Rule::Eq->new(string => "complete"); is_deeply([$complete->complete(Path::Dispatcher::Path->new('x'))], []); is_deeply([$complete->complete(Path::Dispatcher::Path->new('completexxx'))], []); is_deeply([$complete->complete(Path::Dispatcher::Path->new('cxxx'))], []); is_deeply([$complete->complete(Path::Dispatcher::Path->new('c'))], ['complete']); is_deeply([$complete->complete(Path::Dispatcher::Path->new('compl'))], ['complete']); is_deeply([$complete->complete(Path::Dispatcher::Path->new('complete'))], []); do { package MyApp::Dispatcher; use Path::Dispatcher::Declarative -base; on foo => sub { die "do not call blocks!" }; on bar => sub { die "do not call blocks!" }; on baz => sub { die "do not call blocks!" }; }; my $dispatcher = MyApp::Dispatcher->dispatcher; sub complete_ok { local $Test::Builder::Level = $Test::Builder::Level + 1; my $path = shift; my @expected = @_; my @got = $dispatcher->complete($path); my $message = @expected == 0 ? "no completions" : @expected == 1 ? "one completion" : @expected . " completions"; $message .= " for path '$path'"; is_deeply(\@got, \@expected, $message); } complete_ok('x'); complete_ok('foooo'); complete_ok('baq'); complete_ok(f => 'foo'); complete_ok(fo => 'foo'); complete_ok('foo'); complete_ok('b' => 'bar', 'baz'); complete_ok('ba' => 'bar', 'baz'); complete_ok('bar'); complete_ok('baz'); Path-Dispatcher-Declarative-0.03/t/301-complete-complex.t000644 000765 000024 00000003574 11456531035 023507 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 16; do { package MyApp::Dispatcher; use Path::Dispatcher::Declarative -base; on qr/(b)(ar)(.*)/ => sub { die "do not call blocks!" }; on ['token', 'matching'] => sub { die "do not call blocks!" }; rewrite quux => 'bar'; rewrite qr/^quux-(.*)/ => sub { "bar:$1" }; on alpha => sub { die "do not call blocks!" }; under alpha => sub { then { die "do not call blocks!" }; on one => sub { die "do not call blocks!" }; then { die "do not call blocks!" }; on two => sub { die "do not call blocks!" }; on three => sub { die "do not call blocks!" }; }; under beta => sub { on a => sub { die "do not call blocks!" }; on b => sub { die "do not call blocks!" }; }; }; my $dispatcher = MyApp::Dispatcher->dispatcher; sub complete_ok { local $Test::Builder::Level = $Test::Builder::Level + 1; my $path = shift; my @expected = @_; my @got = $dispatcher->complete($path); my $message = @expected == 0 ? "no completions" : @expected == 1 ? "one completion" : @expected . " completions"; $message .= " for path '$path'"; is_deeply(\@got, \@expected, $message); } complete_ok('x'); complete_ok(q => 'quux'); complete_ok(a => 'alpha'); complete_ok(alpha => 'alpha one', 'alpha two', 'alpha three'); complete_ok(t => 'token'); complete_ok(token => 'token matching'); complete_ok('token m' => 'token matching'); complete_ok('token matchin' => 'token matching'); complete_ok('token matching'); complete_ok(bet => 'beta'); complete_ok(beta => 'beta a', 'beta b'); complete_ok('beta a'); complete_ok('beta b'); complete_ok('beta c'); TODO: { local $TODO = "cannot complete regex rules (yet!)"; complete_ok(quux => 'quux-'); complete_ok(b => 'bar', 'beta'); }; Path-Dispatcher-Declarative-0.03/t/302-complete-delimiter.t000644 000765 000024 00000003165 11456531035 024013 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 18; do { package MyApp::Dispatcher; use Path::Dispatcher::Declarative -base, -default => { token_delimiter => '/', }; on ['token', 'matching'] => sub { die "do not call blocks!" }; under alpha => sub { on one => sub { die "do not call blocks!" }; on two => sub { die "do not call blocks!" }; on three => sub { die "do not call blocks!" }; }; }; my $dispatcher = MyApp::Dispatcher->dispatcher; sub complete_ok { local $Test::Builder::Level = $Test::Builder::Level + 1; my $path = shift; my @expected = @_; my @got = $dispatcher->complete($path); my $message = @expected == 0 ? "no completions" : @expected == 1 ? "one completion" : @expected . " completions"; $message .= " for path '$path'"; is_deeply(\@got, \@expected, $message); } complete_ok(t => 'token'); complete_ok(toke => 'token'); complete_ok('token' => 'token/matching'); complete_ok('token/' => 'token/matching'); complete_ok('token/m' => 'token/matching'); complete_ok('token/matchin' => 'token/matching'); complete_ok('token/matching'); complete_ok('token/x'); complete_ok('token/mx'); complete_ok(a => 'alpha'); complete_ok(alph => 'alpha'); complete_ok(alpha => 'alpha/one', 'alpha/two', 'alpha/three'); complete_ok('alpha/' => 'alpha/one', 'alpha/two', 'alpha/three'); complete_ok('alpha/o' => 'alpha/one'); complete_ok('alpha/t' => 'alpha/two', 'alpha/three'); complete_ok('alpha/tw' => 'alpha/two'); complete_ok('alpha/th' => 'alpha/three'); complete_ok('alpha/x'); Path-Dispatcher-Declarative-0.03/t/303-complete-alternation.t000644 000765 000024 00000002636 11456531035 024360 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 20; do { package MyApp::Dispatcher; use Path::Dispatcher::Declarative -base; under gate => sub { on [ ['foo', 'bar', 'baz'] ] => sub { die }; on quux => sub { die }; }; }; my $dispatcher = MyApp::Dispatcher->dispatcher; sub complete_ok { local $Test::Builder::Level = $Test::Builder::Level + 1; my $path = shift; my @expected = @_; my @got = $dispatcher->complete($path); my $message = @expected == 0 ? "no completions" : @expected == 1 ? "one completion" : @expected . " completions"; $message .= " for path '$path'"; is_deeply(\@got, \@expected, $message); } complete_ok('z'); complete_ok('gate z'); complete_ok('zig '); complete_ok('zig f'); complete_ok('zig fo'); complete_ok('zig foo'); complete_ok(g => 'gate'); complete_ok(ga => 'gate'); complete_ok(gat => 'gate'); complete_ok(gate => 'gate foo', 'gate bar', 'gate baz', 'gate quux'); complete_ok('gate ' => 'gate foo', 'gate bar', 'gate baz', 'gate quux'); complete_ok('gate f' => 'gate foo'); complete_ok('gate b' => 'gate bar', 'gate baz'); complete_ok('gate ba' => 'gate bar', 'gate baz'); complete_ok('gate q' => 'gate quux'); complete_ok('gate quu' => 'gate quux'); complete_ok('gate foo'); complete_ok('gate bar'); complete_ok('gate baz'); complete_ok('gate quux'); Path-Dispatcher-Declarative-0.03/t/304-complete-enum.t000644 000765 000024 00000002636 11456531035 023005 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 20; do { package MyApp::Dispatcher; use Path::Dispatcher::Declarative -base; under gate => sub { on enum('foo', 'bar', 'baz') => sub { die }; on quux => sub { die }; }; }; my $dispatcher = MyApp::Dispatcher->dispatcher; sub complete_ok { local $Test::Builder::Level = $Test::Builder::Level + 1; my $path = shift; my @expected = @_; my @got = $dispatcher->complete($path); my $message = @expected == 0 ? "no completions" : @expected == 1 ? "one completion" : @expected . " completions"; $message .= " for path '$path'"; is_deeply(\@got, \@expected, $message); } complete_ok('z'); complete_ok('gate z'); complete_ok('zig '); complete_ok('zig f'); complete_ok('zig fo'); complete_ok('zig foo'); complete_ok(g => 'gate'); complete_ok(ga => 'gate'); complete_ok(gat => 'gate'); complete_ok(gate => 'gate foo', 'gate bar', 'gate baz', 'gate quux'); complete_ok('gate ' => 'gate foo', 'gate bar', 'gate baz', 'gate quux'); complete_ok('gate f' => 'gate foo'); complete_ok('gate b' => 'gate bar', 'gate baz'); complete_ok('gate ba' => 'gate bar', 'gate baz'); complete_ok('gate q' => 'gate quux'); complete_ok('gate quu' => 'gate quux'); complete_ok('gate foo'); complete_ok('gate bar'); complete_ok('gate baz'); complete_ok('gate quux'); Path-Dispatcher-Declarative-0.03/t/800-cb-slash-path-delimiter.t000644 000765 000024 00000001167 11456531035 024634 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 3; my @result; do { package MyDispatcher; use Path::Dispatcher::Declarative -base, -default => { token_delimiter => '/', }; under show => sub { on inventory => sub { push @result, "inventory"; }; on score => sub { push @result, "score"; }; }; }; MyDispatcher->run('show/inventory'); is_deeply([splice @result], ['inventory']); MyDispatcher->run('show/score'); is_deeply([splice @result], ['score']); MyDispatcher->run('show inventory'); is_deeply([splice @result], []); Path-Dispatcher-Declarative-0.03/t/801-cb-chaining.t000644 000765 000024 00000001271 11456531035 022371 0ustar00sartakstaff000000 000000 #!/usr/bin/env perl use strict; use warnings; use Test::More tests => 3; my @result; do { package MyDispatcher; use Path::Dispatcher::Declarative -base; under show => sub { then { push @result, "Displaying"; }; on inventory => sub { push @result, "inventory"; }; on score => sub { push @result, "score"; }; }; }; MyDispatcher->run('show inventory'); is_deeply([splice @result], ['Displaying', 'inventory']); MyDispatcher->run('show score'); is_deeply([splice @result], ['Displaying', 'score']); MyDispatcher->run('show'); is_deeply([splice @result], ['Displaying']); # This is kinda weird Path-Dispatcher-Declarative-0.03/lib/Path/000755 000765 000024 00000000000 11463777121 020740 5ustar00sartakstaff000000 000000 Path-Dispatcher-Declarative-0.03/lib/Path/Dispatcher/000755 000765 000024 00000000000 11463777121 023026 5ustar00sartakstaff000000 000000 Path-Dispatcher-Declarative-0.03/lib/Path/Dispatcher/Declarative/000755 000765 000024 00000000000 11463777121 025251 5ustar00sartakstaff000000 000000 Path-Dispatcher-Declarative-0.03/lib/Path/Dispatcher/Declarative.pm000644 000765 000024 00000012201 11463777041 025604 0ustar00sartakstaff000000 000000 package Path::Dispatcher::Declarative; use strict; use warnings; use 5.008001; our $VERSION = '0.03'; use Path::Dispatcher; use Path::Dispatcher::Declarative::Builder; use Sub::Exporter; use constant dispatcher_class => 'Path::Dispatcher'; use constant builder_class => 'Path::Dispatcher::Declarative::Builder'; our $CALLER; # Sub::Exporter doesn't make this available my $exporter = Sub::Exporter::build_exporter({ into_level => 1, groups => { default => \&build_sugar, }, }); sub import { my $self = shift; my $pkg = caller; my @args = grep { !/^-base$/i } @_; # just loading the class.. return if @args == @_; do { no strict 'refs'; push @{ $pkg . '::ISA' }, $self; }; local $CALLER = $pkg; $exporter->($self, @args); } sub build_sugar { my ($class, $group, $arg) = @_; my $into = $CALLER; $class->populate_defaults($arg); my $dispatcher = $class->dispatcher_class->new(name => $into); my $builder = $class->builder_class->new( dispatcher => $dispatcher, %$arg, ); return { dispatcher => sub { $builder->dispatcher }, rewrite => sub { $builder->rewrite(@_) }, on => sub { $builder->on(@_) }, under => sub { $builder->under(@_) }, redispatch_to => sub { $builder->redispatch_to(@_) }, enum => sub { $builder->enum(@_) }, next_rule => sub { $builder->next_rule(@_) }, last_rule => sub { $builder->last_rule(@_) }, complete => sub { $builder->complete(@_) }, then => sub (&) { $builder->then(@_) }, chain => sub (&) { $builder->chain(@_) }, # NOTE on shift if $into: if caller is $into, then this function is # being used as sugar otherwise, it's probably a method call, so # discard the invocant dispatch => sub { shift if caller ne $into; $builder->dispatch(@_) }, run => sub { shift if caller ne $into; $builder->run(@_) }, }; } sub populate_defaults { my $class = shift; my $arg = shift; for my $option ('token_delimiter', 'case_sensitive_tokens') { next if exists $arg->{$option}; next unless $class->can($option); my $default = $class->$option; next unless defined $default; # use the builder's default $arg->{$option} = $class->$option; } } 1; __END__ =head1 NAME Path::Dispatcher::Declarative - sugary dispatcher =head1 SYNOPSIS package MyApp::Dispatcher; use Path::Dispatcher::Declarative -base; on score => sub { show_score() }; on ['wield', qr/^\w+$/] => sub { wield_weapon($2) }; rewrite qr/^inv/ => "display inventory"; under display => sub { on inventory => sub { show_inventory() }; on score => sub { show_score() }; }; package Interpreter; MyApp::Dispatcher->run($input); =head1 DESCRIPTION L rocks! =head1 KEYWORDS =head2 dispatcher -> Dispatcher Returns the L object for this class; the object that the sugar is modifying. This is useful for adding custom rules through the regular API, and inspection. =head2 dispatch path -> Dispatch Invokes the dispatcher on the given path and returns a L object. Acts as a keyword within the same package; otherwise as a method (since these declarative dispatchers are supposed to be used by other packages). =head2 run path, args Performs a dispatch then invokes the L method on it. =head2 on path => sub {} Adds a rule to the dispatcher for the given path. The path may be: =over 4 =item a string This is taken to mean a single token; creates an L rule. =item an array reference This is creates a L rule. =item a regular expression This is creates a L rule. =item a code reference This is creates a L rule. =back =head2 under path => sub {} Creates a L rule. The contents of the coderef should be nothing other L and C calls. =head2 then sub { } Creates a L rule that will continue on to the next rule via C The only argument is a coderef that processes normally (like L). NOTE: You *can* avoid running a following rule by using C. An example: under show => sub { then { print "Displaying "; }; on inventory => sub { print "inventory:\n"; ... }; on score => sub { print "score:\n"; ... }; =head1 AUTHOR Shawn M Moore, C<< >> =head1 BUGS Please report any bugs or feature requests to C, or through the web interface at L. =head1 COPYRIGHT & LICENSE Copyright 2008-2010 Best Practical Solutions. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. =cut Path-Dispatcher-Declarative-0.03/lib/Path/Dispatcher/Declarative/Builder.pm000644 000765 000024 00000014654 11463775333 027212 0ustar00sartakstaff000000 000000 package Path::Dispatcher::Declarative::Builder; use Any::Moose; our $OUTERMOST_DISPATCHER; our $UNDER_RULE; has dispatcher => ( is => 'ro', isa => 'Path::Dispatcher', lazy => 1, default => sub { return Path::Dispatcher->new }, ); has case_sensitive_tokens => ( is => 'rw', isa => 'Bool', default => 1, ); has token_delimiter => ( is => 'rw', isa => 'Str', default => ' ', ); sub next_rule () { die "Path::Dispatcher next rule\n"; } sub last_rule () { die "Path::Dispatcher abort\n"; } sub dispatch { my $self = shift; local $OUTERMOST_DISPATCHER = $self->dispatcher if !$OUTERMOST_DISPATCHER; $OUTERMOST_DISPATCHER->dispatch(@_); } sub run { my $self = shift; local $OUTERMOST_DISPATCHER = $self->dispatcher if !$OUTERMOST_DISPATCHER; $OUTERMOST_DISPATCHER->run(@_); } sub complete { my $self = shift; my $dispatcher = shift; local $OUTERMOST_DISPATCHER = $self->dispatcher if !$OUTERMOST_DISPATCHER; $OUTERMOST_DISPATCHER->complete(@_); } sub rewrite { my $self = shift; my ($from, $to) = @_; my $rewrite = sub { local $OUTERMOST_DISPATCHER = $self->dispatcher if !$OUTERMOST_DISPATCHER; my $path = ref($to) eq 'CODE' ? $to->() : $to; $OUTERMOST_DISPATCHER->run($path, @_); }; $self->_add_rule($from, $rewrite); } sub on { my $self = shift; $self->_add_rule(@_); } sub enum { my $self = shift; Path::Dispatcher::Rule::Enum->new( enum => [@_], ); } sub then { my $self = shift; my $block = shift; my $rule = Path::Dispatcher::Rule::Always->new( block => sub { $block->(@_); next_rule; }, ); $self->_add_rule($rule); } sub chain { my $self = shift; my $block = shift; my $rule = Path::Dispatcher::Rule::Chain->new( block => $block, ); $self->_add_rule($rule); } sub under { my $self = shift; my ($matcher, $rules) = @_; my $predicate = $self->_create_rule($matcher, prefix => 1); my $under = Path::Dispatcher::Rule::Under->new( predicate => $predicate, ); $self->_add_rule($under, @_); do { local $UNDER_RULE = $under; $rules->($UNDER_RULE); }; } sub redispatch_to { my $self = shift; my $dispatcher = shift; # assume it's a declarative dispatcher if (!ref($dispatcher)) { $dispatcher = $dispatcher->dispatcher; } my $redispatch = Path::Dispatcher::Rule::Dispatch->new( dispatcher => $dispatcher, ); $self->_add_rule($redispatch); } sub rule_creators { return { ARRAY => sub { my ($self, $tokens, %args) = @_; Path::Dispatcher::Rule::Tokens->new( tokens => $tokens, delimiter => $self->token_delimiter, case_sensitive => $self->case_sensitive_tokens, %args, ), }, HASH => sub { my ($self, $metadata_matchers, %args) = @_; if (keys %$metadata_matchers == 1) { my ($field) = keys %$metadata_matchers; my ($value) = values %$metadata_matchers; my $matcher = $self->_create_rule($value); return Path::Dispatcher::Rule::Metadata->new( field => $field, matcher => $matcher, %args, ); } die "Doesn't support multiple metadata rules yet"; }, CODE => sub { my ($self, $matcher, %args) = @_; Path::Dispatcher::Rule::CodeRef->new( matcher => $matcher, %args, ), }, Regexp => sub { my ($self, $regex, %args) = @_; Path::Dispatcher::Rule::Regex->new( regex => $regex, %args, ), }, empty => sub { my ($self, $undef, %args) = @_; Path::Dispatcher::Rule::Empty->new( %args, ), }, }; } sub _create_rule { my ($self, $matcher, %args) = @_; my $rule_creator; if ($matcher eq '') { $rule_creator = $self->rule_creators->{empty}; } elsif (!ref($matcher)) { $rule_creator = $self->rule_creators->{ARRAY}; $matcher = [$matcher]; } else { $rule_creator = $self->rule_creators->{ ref $matcher }; } $rule_creator or die "I don't know how to create a rule for type $matcher"; return $rule_creator->($self, $matcher, %args); } sub _add_rule { my $self = shift; my $rule; if (blessed($_[0]) && $_[0]->isa('Path::Dispatcher::Rule')) { $rule = shift; } else { my ($matcher, $block) = splice @_, 0, 2; # set $1, etc my $old_block = $block; $block = sub { my $match = shift; my @pos = @{ $match->positional_captures }; # we don't have direct write access to $1 and friends, so we have to # do this little hack. the only way we can update $1 is by matching # against a regex (5.10 fixes that).. my $re = join '', map { defined($_) ? "(\Q$_\E)" : "(wontmatch)?" } @pos; my $str = join '', map { defined($_) ? $_ : "" } @pos; # we need to check length because Perl's annoying gotcha of the empty regex # actually being an alias for whatever the previously used regex was # (useful last decade when qr// hadn't been invented) # we need to do the match anyway, because we have to clear the number vars ($str, $re) = ("x", "x") if length($str) == 0; $str =~ qr{^$re$} or die "Unable to match '$str' against a copy of itself ($re)!"; $old_block->(@_); }; $rule = $self->_create_rule($matcher, block => $block); } # FIXME: broken since move from ::Declarative # XXX: caller level should be closer to $Test::Builder::Level # my (undef, $file, $line) = caller(1); my (undef, $file, $line) = caller(2); my $rule_name = "$file:$line"; if (!defined(wantarray)) { my $parent = $UNDER_RULE || $self->dispatcher; $parent->add_rule($rule); } else { return $rule, @_; } } __PACKAGE__->meta->make_immutable; no Any::Moose; 1; Path-Dispatcher-Declarative-0.03/inc/Module/000755 000765 000024 00000000000 11463777121 021274 5ustar00sartakstaff000000 000000 Path-Dispatcher-Declarative-0.03/inc/Module/Install/000755 000765 000024 00000000000 11463777121 022702 5ustar00sartakstaff000000 000000 Path-Dispatcher-Declarative-0.03/inc/Module/Install.pm000644 000765 000024 00000030135 11463777113 023243 0ustar00sartakstaff000000 000000 #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 $/; }; 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 $/; }; 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. Path-Dispatcher-Declarative-0.03/inc/Module/Install/Base.pm000644 000765 000024 00000002147 11463777113 024117 0ustar00sartakstaff000000 000000 #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 Path-Dispatcher-Declarative-0.03/inc/Module/Install/Can.pm000644 000765 000024 00000003333 11463777113 023744 0ustar00sartakstaff000000 000000 #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 Path-Dispatcher-Declarative-0.03/inc/Module/Install/Fetch.pm000644 000765 000024 00000004627 11463777113 024303 0ustar00sartakstaff000000 000000 #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@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; Path-Dispatcher-Declarative-0.03/inc/Module/Install/Makefile.pm000644 000765 000024 00000027032 11463777113 024762 0ustar00sartakstaff000000 000000 #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 =~ 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 Path-Dispatcher-Declarative-0.03/inc/Module/Install/Metadata.pm000644 000765 000024 00000043020 11463777113 024760 0ustar00sartakstaff000000 000000 #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}{<}g; $author =~ s{E}{>}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; Path-Dispatcher-Declarative-0.03/inc/Module/Install/Win32.pm000644 000765 000024 00000003403 11463777113 024143 0ustar00sartakstaff000000 000000 #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; Path-Dispatcher-Declarative-0.03/inc/Module/Install/WriteAll.pm000644 000765 000024 00000002376 11463777113 024774 0ustar00sartakstaff000000 000000 #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;