Catalyst-Model-Adaptor-0.10/0000755000076500000240000000000011531052161014222 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/Changes0000644000076500000240000000230411531052124015513 0ustar t0mstaffChange history for Catalyst::Model::Adaptor 0.10 23 Febuary 2011 - Allow callers pass some args at instance time 0.09 4 August 2010 - Use Catalyst::Utils::ensure_class_loaded on the adapted class, instead of eval/require, so that inner classes in already-loaded packages will work. 0.08 9 Febuary 2010 - Correctly built distribution. MANIFEST.SKIP fixed to avoid the issue in future. 0.07 9 Febuary 2010 - Catalyst::Runtime is a runtime dependency. RT#48842 0.06 3 January 2010 - Fix a minor documentation problem. Reported by Cory Watson. 0.05 7 August 2009 - Fix a minor documentation problem. Reported by Eric Prestemon. (Closes RT#48487) - Switch from Class::C3 to MRO::Compat. 0.04 16 July 2008 - If no arguments are supplied, then construct new objects with {} by default, rather than undef, as Moose classes fail if given undef. 0.03 6 August 2008 - make TWMC optional, since it can't pass its test anymore 0.02 11 April 2008 - a minor documentation change 0.01 6 October 2007 - first version, released upon an unsuspecting comprehensive archive network Catalyst-Model-Adaptor-0.10/inc/0000755000076500000240000000000011531052161014773 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/inc/Module/0000755000076500000240000000000011531052161016220 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/inc/Module/Install/0000755000076500000240000000000011531052161017626 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/inc/Module/Install/AuthorTests.pm0000644000076500000240000000221511531052135022452 0ustar t0mstaff#line 1 package Module::Install::AuthorTests; use 5.005; use strict; use Module::Install::Base; use Carp (); #line 16 use vars qw{$VERSION $ISCORE @ISA}; BEGIN { $VERSION = '0.002'; $ISCORE = 1; @ISA = qw{Module::Install::Base}; } #line 42 sub author_tests { my ($self, @dirs) = @_; _add_author_tests($self, \@dirs, 0); } #line 56 sub recursive_author_tests { my ($self, @dirs) = @_; _add_author_tests($self, \@dirs, 1); } sub _wanted { my $href = shift; sub { /\.t$/ and -f $_ and $href->{$File::Find::dir} = 1 } } sub _add_author_tests { my ($self, $dirs, $recurse) = @_; return unless $Module::Install::AUTHOR; my @tests = $self->tests ? (split / /, $self->tests) : 't/*.t'; # XXX: pick a default, later -- rjbs, 2008-02-24 my @dirs = @$dirs ? @$dirs : Carp::confess "no dirs given to author_tests"; @dirs = grep { -d } @dirs; if ($recurse) { require File::Find; my %test_dir; File::Find::find(_wanted(\%test_dir), @dirs); $self->tests( join ' ', @tests, map { "$_/*.t" } sort keys %test_dir ); } else { $self->tests( join ' ', @tests, map { "$_/*.t" } sort @dirs ); } } #line 107 1; Catalyst-Model-Adaptor-0.10/inc/Module/Install/Base.pm0000644000076500000240000000214711531052135021043 0ustar t0mstaff#line 1 package Module::Install::Base; use strict 'vars'; use vars qw{$VERSION}; BEGIN { $VERSION = '0.99'; } # 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 Catalyst-Model-Adaptor-0.10/inc/Module/Install/Can.pm0000644000076500000240000000333311531052135020670 0ustar t0mstaff#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 = '0.99'; @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 Catalyst-Model-Adaptor-0.10/inc/Module/Install/Fetch.pm0000644000076500000240000000462711531052135021227 0ustar t0mstaff#line 1 package Module::Install::Fetch; use strict; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '0.99'; @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; Catalyst-Model-Adaptor-0.10/inc/Module/Install/Makefile.pm0000644000076500000240000002703211531052135021706 0ustar t0mstaff#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 = '0.99'; @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 Catalyst-Model-Adaptor-0.10/inc/Module/Install/Metadata.pm0000644000076500000240000004302011531052135021704 0ustar t0mstaff#line 1 package Module::Install::Metadata; use strict 'vars'; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '0.99'; @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; Catalyst-Model-Adaptor-0.10/inc/Module/Install/ReadmeFromPod.pm0000644000076500000240000000114411531052135022651 0ustar t0mstaff#line 1 package Module::Install::ReadmeFromPod; use strict; use warnings; use base qw(Module::Install::Base); use vars qw($VERSION); $VERSION = '0.06'; sub readme_from { my $self = shift; return unless $Module::Install::AUTHOR; my $file = shift || return; my $clean = shift; require Pod::Text; my $parser = Pod::Text->new(); open README, '> README' or die "$!\n"; $parser->output_fh( *README ); $parser->parse_file( $file ); return 1 unless $clean; $self->postamble(<<"END"); distclean :: license_clean license_clean: \t\$(RM_F) README END return 1; } 'Readme!'; __END__ #line 89 Catalyst-Model-Adaptor-0.10/inc/Module/Install/Win32.pm0000644000076500000240000000340311531052135021067 0ustar t0mstaff#line 1 package Module::Install::Win32; use strict; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '0.99'; @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; Catalyst-Model-Adaptor-0.10/inc/Module/Install/WriteAll.pm0000644000076500000240000000237611531052135021720 0ustar t0mstaff#line 1 package Module::Install::WriteAll; use strict; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '0.99'; @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; Catalyst-Model-Adaptor-0.10/inc/Module/Install.pm0000644000076500000240000003002611531052135020166 0ustar t0mstaff#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 = '0.99'; # 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'}; 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. Catalyst-Model-Adaptor-0.10/lib/0000755000076500000240000000000011531052161014770 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/lib/Catalyst/0000755000076500000240000000000011531052161016554 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/lib/Catalyst/Helper/0000755000076500000240000000000011531052161017773 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/lib/Catalyst/Helper/Model/0000755000076500000240000000000011531052161021033 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/lib/Catalyst/Helper/Model/Adaptor.pm0000644000076500000240000000360111334137761022776 0ustar t0mstaffpackage Catalyst::Helper::Model::Adaptor; use strict; use warnings; =head1 NAME Catalyst::Helper::Model::Adaptor - helper for the incredibly lazy =head1 SYNOPSIS Running: ./script/myapp_create.pl model SomeClass Adaptor MyApp::Backend::SomeClass create Will create C that looks like: package YourApp::Model::SomeClass; use strict; use warnings; use base 'Catalyst::Model::Adaptor'; __PACKAGE__->config( class => 'MyApp::Backend::SomeClass', constructor => 'create', ); 1; Why you need a script to generate that is beyond me, but here it is. =head1 ARGUMENTS ./script/myapp_create.pl model Adaptor [] You need to sepecify the C (the name of the model), and C, the class being adapted. If C<< $class->new >> isn't going to do what you want, pass the name of C<$class>'s constructor as C. =cut sub mk_compclass { my ( $class, $helper, $adapted_class, $const ) = @_; my ($type) = ($class =~ /^Catalyst::Helper::Model::(.+)$/); die "i am nothing. that doesn't make sense." unless $type; my %args = ( adapted_class => $adapted_class, constructor => $const, type => $type ); my $file = $helper->{file}; $helper->render_file( 'compclass', $file, \%args ); } =head1 AUTHOR Jonathan Rockway C<< >> =head1 LICENSE This library is free software. You can redistribute it and/or modify it under the same terms as perl itself. No copyright claim is asserted over the generated code. =cut 1; __DATA__ __compclass__ package [% class %]; use strict; use warnings; use base 'Catalyst::Model::[% type %]'; __PACKAGE__->config( class => '[% adapted_class || 'Fill::This::In' %]', constructor => '[% constructor || 'new'%]', ); 1; Catalyst-Model-Adaptor-0.10/lib/Catalyst/Helper/Model/Factory/0000755000076500000240000000000011531052161022442 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/lib/Catalyst/Helper/Model/Factory/PerRequest.pm0000644000076500000240000000053711233534230025105 0ustar t0mstaffpackage Catalyst::Helper::Model::Factory::PerRequest; use strict; use warnings; use base 'Catalyst::Helper::Model::Adaptor'; =head1 NAME Catalyst::Helper::Model::Factory::PerRequest - helper for the incredibly lazy =head1 I CAN HAS DOCS? Yes, you can has. See L and C. =cut 1; Catalyst-Model-Adaptor-0.10/lib/Catalyst/Helper/Model/Factory.pm0000644000076500000240000000047311233534230023005 0ustar t0mstaffpackage Catalyst::Helper::Model::Factory; use strict; use warnings; use base 'Catalyst::Helper::Model::Adaptor'; =head1 NAME Catalyst::Helper::Model::Factory - helper for the incredibly lazy =head1 I CAN HAS DOCS? Yes, you can has. See L and C. =cut 1; Catalyst-Model-Adaptor-0.10/lib/Catalyst/Model/0000755000076500000240000000000011531052161017614 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/lib/Catalyst/Model/Adaptor/0000755000076500000240000000000011531052161021206 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/lib/Catalyst/Model/Adaptor/Base.pm0000644000076500000240000000257711531051473022436 0ustar t0mstaffpackage Catalyst::Model::Adaptor::Base; use strict; use warnings; use Carp; use MRO::Compat; use base 'Catalyst::Model'; sub _load_adapted_class { my ($self) = @_; croak 'need class' unless $self->{class}; my $adapted_class = $self->{class}; Catalyst::Utils::ensure_class_loaded($adapted_class); return $adapted_class; } sub _create_instance { my ($self, $app, $rest) = @_; my $constructor = $self->{constructor} || 'new'; my $arg = $self->prepare_arguments($app, $rest); my $adapted_class = $self->{class}; return $adapted_class->$constructor($self->mangle_arguments($arg)); } sub prepare_arguments { my ($self, $app, $arg) = @_; return exists $self->{args} ? { %{$self->{args}}, %$arg, } : $arg; } sub mangle_arguments { my ($self, $args) = @_; return $args; } 1; __END__ =head1 NAME Catalyst::Model::Adaptor::Base - internal base class for Catalyst::Model::Adaptor and friends. =head1 SYNOPSIS # There are no user-serviceable parts in here. =head1 METHODS =head2 _load_adapted_class Load the adapted class =head2 _create_instance Instantiate the adapted class =head2 prepare_arguments Prepare the arguements =head2 mangle_arguments Make the arguements amenable to the adapted class =head1 SEE ALSO L L L Catalyst-Model-Adaptor-0.10/lib/Catalyst/Model/Adaptor.pm0000644000076500000240000001456011531051577021564 0ustar t0mstaffpackage Catalyst::Model::Adaptor; use strict; use warnings; use MRO::Compat; use base 'Catalyst::Model::Adaptor::Base'; our $VERSION = '0.10'; sub COMPONENT { my ($class, $app, @rest) = @_; my $arg = {}; if ( scalar @rest ) { if ( ref($rest[0]) eq 'HASH' ) { $arg = $rest[0]; } else { $arg = { @rest }; } } my $self = $class->next::method($app, $arg); $self->_load_adapted_class; return $self->_create_instance( $app, $class->merge_config_hashes($class->config || {}, $arg) ); } 1; __END__ =head1 NAME Catalyst::Model::Adaptor - use a plain class as a Catalyst model =head1 SYNOPSIS Given a good old perl class like: package NotMyApp::SomeClass; use Moose; # to provide "new" sub method { 'yay' } Wrap it with a Catalyst model: package MyApp::Model::SomeClass; use base 'Catalyst::Model::Adaptor'; __PACKAGE__->config( class => 'NotMyApp::SomeClass' ); Then you can use C from your Catalyst app: sub action :Whatever { my ($self, $c) = @_; my $someclass = $c->model('SomeClass'); $someclass->method; # yay } Note that C is instantiated at application startup time. If you want the adapted class to be created for call to C<< $c->model >>, see L instead. If you want the adapted class to be created once per request, see L. =head1 DESCRIPTION The idea is that you don't want your Catalyst model to be anything other than a line or two of glue. Using this module ensures that your Model classes are separate from your application and therefore are well-abstracted, reusable, and easily testable. Right now there are too many modules on CPAN that are Catalyst-specific. Most of the models would be better written as a class that handles most of the functionality with just a bit of glue to make it work nicely with Catalyst. This module aims to make integrating your class with Catalyst trivial, so you won't have to do any extra work to make your model generic. For a good example of a Model that takes the right design approach, take a look at L. All it does is glues an existing L to Catalyst. It provides a bit of sugar, but no actual functionality. Everything important happens in the C object. The end result of that is that you can use your app's DBIC schema without ever thinking about Catalyst. This is a Good Thing. Catalyst is glue, not a way of life! =head1 CONFIGURATION Subclasses of this model accept the following configuration keys, which can be hard-coded like: package MyApp::Model::SomeClass; use base 'Catalyst::Model::Adaptor'; __PACKAGE__->config( class => 'NotMyApp::SomeClass' ); Or be specified as application config: package MyApp; MyApp->config->{'Model::SomeClass'} = { class => 'NotMyApp::SomeClass' }; Or in your ConfigLoader-loaded config file: --- Model::SomeClass: class: NotMyApp::SomeClass args: foo: ... bar: ... This is exactly like every other Catalyst component, so you should already know this. Anyway, here are the options: =head2 class This is the name of the class you're adapting to Catalyst. It MUST be specified. Your application will die horribly if it can't require this package. =head2 constructor This is the name of the class method in C that will create an instance of the class. It defaults to C. Your application will die horribly if it can't call this method. =head2 args This is a hashref of arguments to pass to the constructor of C. It is optional, of course. If you omit it, nothing is passed to the constructor (as opposed to C<{}>, an empty hashref). =head1 METHODS There are no methods that you call directly. When you call C<< $c->model >> on a model that subclasses this, you'll get back an instance of the class being adapted, not this model. These methods are called by Catalyst: =head2 COMPONENT Setup this component. =head1 CUSTOMIZING THE PROCESS By default, the instance of your adapted class is instantiated like this: my $args = $self->prepare_arguments($app); # $app sometimes called $c $adapted_class->$constructor($self->mangle_arguments($args)); Since a static hashref of arguments may not be what C<$class> needs, you can override the following methods to change what C<$args> is. NOTE: If you need to pass some args at instance time, you can do something like: my $model = $c->model('MyFoo', { foo => 'myfoo' }); or my $model = $c->model('MyFoo', foo => 'myfoo'); =head2 prepare_arguments This method is passed the entire configuration for the class and the Catalyst application, and returns the hashref of arguments to be passed to the constructor. If you need to get dynamic data out of your application to pass to the consturctor, do it here. By default, this method returns the C configuration key. Example: sub prepare_arguments { my ($self, $app) = @_; # $app sometimes written as $c return { foobar => $app->config->{foobar}, baz => $self->{baz} }; } =head2 mangle_arguments This method is passed the hashref from C, mangles them into a form that your constructor will like, and returns the mangled form. If your constuctor wants a list instead of a hashref, this is your opportunity to do the conversion. Example: sub mangle_arguments { my ($self, $args) = @_; return %$args; # now the args are a plain list } If you need to do more than this, you might as well just write the whole class yourself. This module is designed to make the common case work with 1 line of code. For special needs, it's easier to just write the model yourself. =head1 SEE ALSO If you need a new instance returned each time C<< $c->model >> is called, use L instead. If you need to have exactly one instance created per request, use L instead. =head1 AUTHOR Jonathan Rockway C<< >> =head1 CONTRIBUTORS Wallace Reis C<< >> =head1 LICENSE This module is Copyright (c) 2007 Jonathan Rockway. You may use, modify, and redistribute it under the same terms as Perl itself. Catalyst-Model-Adaptor-0.10/lib/Catalyst/Model/Factory/0000755000076500000240000000000011531052161021223 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/lib/Catalyst/Model/Factory/PerRequest.pm0000644000076500000240000000221111531051612023654 0ustar t0mstaffpackage Catalyst::Model::Factory::PerRequest; use strict; use warnings; use MRO::Compat; use base 'Catalyst::Model::Factory'; our $VERSION = '0.10'; sub ACCEPT_CONTEXT { my ($self, $context, @args) = @_; my $id = '__'. ref $self; return $context->stash->{$id} ||= $self->next::method($context, @args); } 1; __END__ =head1 NAME Catalyst::Model::Factory::PerRequest - use a plain class as a Catalyst model, instantiating it once per Catalyst request =head1 SYNOPSIS This module works just like L, except that a fresh instance of your adapted class is once per Catalyst request, not every time you ask for the object via C<< $c->model >>. =head1 CUSTOMIZING You can customize your subclass just like L. Instead of C<$app>, though, you'll get C<$c>, the current request context. =head1 METHODS These methods are called by Catalyst, not by you: =head2 COMPONENT Load your class =head2 ACCEPT_CONTEXT Create an instance of your class and return it. =head1 SEE ALSO For all the critical documentation, see L. Catalyst-Model-Adaptor-0.10/lib/Catalyst/Model/Factory.pm0000644000076500000240000000307211531051631021564 0ustar t0mstaffpackage Catalyst::Model::Factory; use strict; use warnings; use MRO::Compat; use base 'Catalyst::Model::Adaptor::Base'; use Catalyst::Utils (); use Scalar::Util 'blessed'; our $VERSION = '0.10'; sub COMPONENT { my ($class, @args) = @_; my $self = $class->next::method(@args); $self->_load_adapted_class; return $self; } sub ACCEPT_CONTEXT { my ($self, $context, @args) = @_; my $arg = {}; if ( scalar @args ) { if ( ref($args[0]) eq 'HASH' ) { $arg = $args[0]; } else { $arg = { @args }; } } my $suffix = Catalyst::Utils::class2classsuffix(blessed $self); return $self->_create_instance( $context, $self->merge_config_hashes($context->config->{$suffix} || {}, $arg), ); } 1; __END__ =head1 NAME Catalyst::Model::Factory - use a plain class as a Catalyst model, instantiating it every time it is requested =head1 SYNOPSIS This module works just like L, except that a fresh instance of your adapted class is created every time it is requested via C<< $c->model >>. =head1 CUSTOMIZING You can customize your subclass just like L. Instead of C<$app>, though, you'll get C<$c>, the current request context. =head1 METHODS These methods are called by Catalyst, not by you: =head2 COMPONENT Load your class =head2 ACCEPT_CONTEXT Create an instance of your class and return it. =head1 SEE ALSO For all the critical documentation, see L. Catalyst-Model-Adaptor-0.10/Makefile.PL0000644000076500000240000000062211531052124016173 0ustar t0mstaffuse inc::Module::Install 0.91; use Module::Install::ReadmeFromPod; use Module::Install::AuthorTests; name 'Catalyst-Model-Adaptor'; all_from 'lib/Catalyst/Model/Adaptor.pm'; readme_from; requires 'MRO::Compat'; requires 'Catalyst::Runtime'; build_requires 'Test::More'; build_requires 'ok'; author_tests('t/author'); repository 'git://github.com/bobtfish/catalyst-model-adaptor.git'; WriteAll(); Catalyst-Model-Adaptor-0.10/MANIFEST0000644000076500000240000000234611531052142015357 0ustar t0mstaffChanges inc/Module/Install.pm inc/Module/Install/AuthorTests.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/ReadmeFromPod.pm inc/Module/Install/Win32.pm inc/Module/Install/WriteAll.pm lib/Catalyst/Helper/Model/Adaptor.pm lib/Catalyst/Helper/Model/Factory.pm lib/Catalyst/Helper/Model/Factory/PerRequest.pm lib/Catalyst/Model/Adaptor.pm lib/Catalyst/Model/Adaptor/Base.pm lib/Catalyst/Model/Factory.pm lib/Catalyst/Model/Factory/PerRequest.pm Makefile.PL MANIFEST This list of files MANIFEST.SKIP META.yml README t/00-load.t t/author/pod-coverage.t t/author/pod.t t/lib/Makefile.PL t/lib/script/testapp_server.pl t/lib/script/testapp_test.pl t/lib/TestApp.pm t/lib/TestApp/Backend/InnerPackage.pm t/lib/TestApp/Backend/SomeClass.pm t/lib/TestApp/BaseController/Adaptor.pm t/lib/TestApp/Controller/Adaptor.pm t/lib/TestApp/Controller/Factory.pm t/lib/TestApp/Controller/InnerPackage.pm t/lib/TestApp/Controller/PerRequest.pm t/lib/TestApp/Controller/Root.pm t/lib/TestApp/Model/Factory.pm t/lib/TestApp/Model/InnerPackage.pm t/lib/TestApp/Model/NoArgs.pm t/lib/TestApp/Model/PerRequest.pm t/lib/TestApp/Model/SomeClass.pm t/live-test.t Catalyst-Model-Adaptor-0.10/MANIFEST.SKIP0000644000076500000240000000016611334141455016131 0ustar t0mstaff.gitignore .git/ blib pm_to_blib MANIFEST.bak MANIFEST.SKIP~ cover_db Makefile$ Makefile.old$ ^Catalyst-Model-Adaptor Catalyst-Model-Adaptor-0.10/META.yml0000644000076500000240000000121711531052135015475 0ustar t0mstaff--- abstract: 'use a plain class as a Catalyst model' author: - 'Jonathan Rockway C<< >>' build_requires: ExtUtils::MakeMaker: 6.42 Test::More: 0 ok: 0 configure_requires: ExtUtils::MakeMaker: 6.42 distribution_type: module generated_by: 'Module::Install version 0.99' license: perl meta-spec: url: http://module-build.sourceforge.net/META-spec-v1.4.html version: 1.4 name: Catalyst-Model-Adaptor no_index: directory: - inc - t requires: Catalyst::Runtime: 0 MRO::Compat: 0 resources: license: http://dev.perl.org/licenses/ repository: git://github.com/bobtfish/catalyst-model-adaptor.git version: 0.10 Catalyst-Model-Adaptor-0.10/README0000644000076500000240000001366111531051473015116 0ustar t0mstaffNAME Catalyst::Model::Adaptor - use a plain class as a Catalyst model SYNOPSIS Given a good old perl class like: package NotMyApp::SomeClass; use Moose; # to provide "new" sub method { 'yay' } Wrap it with a Catalyst model: package MyApp::Model::SomeClass; use base 'Catalyst::Model::Adaptor'; __PACKAGE__->config( class => 'NotMyApp::SomeClass' ); Then you can use "NotMyApp::SomeClass" from your Catalyst app: sub action :Whatever { my ($self, $c) = @_; my $someclass = $c->model('SomeClass'); $someclass->method; # yay } Note that "NotMyApp::SomeClass" is instantiated at application startup time. If you want the adapted class to be created for call to "$c->model", see Catalyst::Model::Factory instead. If you want the adapted class to be created once per request, see Catalyst::Model::Factory::PerRequest. DESCRIPTION The idea is that you don't want your Catalyst model to be anything other than a line or two of glue. Using this module ensures that your Model classes are separate from your application and therefore are well-abstracted, reusable, and easily testable. Right now there are too many modules on CPAN that are Catalyst-specific. Most of the models would be better written as a class that handles most of the functionality with just a bit of glue to make it work nicely with Catalyst. This module aims to make integrating your class with Catalyst trivial, so you won't have to do any extra work to make your model generic. For a good example of a Model that takes the right design approach, take a look at Catalyst::Model::DBIC::Schema. All it does is glues an existing DBIx::Class::Schema to Catalyst. It provides a bit of sugar, but no actual functionality. Everything important happens in the "DBIx::Class::Schema" object. The end result of that is that you can use your app's DBIC schema without ever thinking about Catalyst. This is a Good Thing. Catalyst is glue, not a way of life! CONFIGURATION Subclasses of this model accept the following configuration keys, which can be hard-coded like: package MyApp::Model::SomeClass; use base 'Catalyst::Model::Adaptor'; __PACKAGE__->config( class => 'NotMyApp::SomeClass' ); Or be specified as application config: package MyApp; MyApp->config->{'Model::SomeClass'} = { class => 'NotMyApp::SomeClass' }; Or in your ConfigLoader-loaded config file: --- Model::SomeClass: class: NotMyApp::SomeClass args: foo: ... bar: ... This is exactly like every other Catalyst component, so you should already know this. Anyway, here are the options: class This is the name of the class you're adapting to Catalyst. It MUST be specified. Your application will die horribly if it can't require this package. constructor This is the name of the class method in "class" that will create an instance of the class. It defaults to "new". Your application will die horribly if it can't call this method. args This is a hashref of arguments to pass to the constructor of "class". It is optional, of course. If you omit it, nothing is passed to the constructor (as opposed to "{}", an empty hashref). METHODS There are no methods that you call directly. When you call "$c->model" on a model that subclasses this, you'll get back an instance of the class being adapted, not this model. These methods are called by Catalyst: COMPONENT Setup this component. CUSTOMIZING THE PROCESS By default, the instance of your adapted class is instantiated like this: my $args = $self->prepare_arguments($app); # $app sometimes called $c $adapted_class->$constructor($self->mangle_arguments($args)); Since a static hashref of arguments may not be what $class needs, you can override the following methods to change what $args is. NOTE: If you need to pass some args at instance time, you can do something like: my $model = $c->model('MyFoo', { foo => 'myfoo' }); or my $model = $c->model('MyFoo', foo => 'myfoo'); prepare_arguments This method is passed the entire configuration for the class and the Catalyst application, and returns the hashref of arguments to be passed to the constructor. If you need to get dynamic data out of your application to pass to the consturctor, do it here. By default, this method returns the "args" configuration key. Example: sub prepare_arguments { my ($self, $app) = @_; # $app sometimes written as $c return { foobar => $app->config->{foobar}, baz => $self->{baz} }; } mangle_arguments This method is passed the hashref from "prepare_arguments", mangles them into a form that your constructor will like, and returns the mangled form. If your constuctor wants a list instead of a hashref, this is your opportunity to do the conversion. Example: sub mangle_arguments { my ($self, $args) = @_; return %$args; # now the args are a plain list } If you need to do more than this, you might as well just write the whole class yourself. This module is designed to make the common case work with 1 line of code. For special needs, it's easier to just write the model yourself. SEE ALSO If you need a new instance returned each time "$c->model" is called, use Catalyst::Model::Factory instead. If you need to have exactly one instance created per request, use Catalyst::Model::Factory::PerRequest instead. AUTHOR Jonathan Rockway "" CONTRIBUTORS Wallace Reis "" LICENSE This module is Copyright (c) 2007 Jonathan Rockway. You may use, modify, and redistribute it under the same terms as Perl itself. Catalyst-Model-Adaptor-0.10/t/0000755000076500000240000000000011531052161014465 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/t/00-load.t0000644000076500000240000000035211334137754016023 0ustar t0mstaff#!/usr/bin/env perl use strict; use warnings; use Test::More tests => 4; use ok 'Catalyst::Model::Adaptor::Base'; use ok 'Catalyst::Model::Adaptor'; use ok 'Catalyst::Model::Factory'; use ok 'Catalyst::Model::Factory::PerRequest'; Catalyst-Model-Adaptor-0.10/t/author/0000755000076500000240000000000011531052161015767 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/t/author/pod-coverage.t0000644000076500000240000000025411233534230020531 0ustar t0mstaff#!perl -T use Test::More; eval "use Test::Pod::Coverage 1.04"; plan skip_all => "Test::Pod::Coverage 1.04 required for testing POD coverage" if $@; all_pod_coverage_ok(); Catalyst-Model-Adaptor-0.10/t/author/pod.t0000644000076500000240000000021411233534230016734 0ustar t0mstaff#!perl -T use Test::More; eval "use Test::Pod 1.14"; plan skip_all => "Test::Pod 1.14 required for testing POD" if $@; all_pod_files_ok(); Catalyst-Model-Adaptor-0.10/t/lib/0000755000076500000240000000000011531052161015233 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/t/lib/Makefile.PL0000644000076500000240000000000011233534230017174 0ustar t0mstaffCatalyst-Model-Adaptor-0.10/t/lib/script/0000755000076500000240000000000011531052161016537 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/t/lib/script/testapp_server.pl0000644000076500000240000000616011233534230022146 0ustar t0mstaff#!/usr/bin/env perl BEGIN { $ENV{CATALYST_ENGINE} ||= 'HTTP'; $ENV{CATALYST_SCRIPT_GEN} = 31; require Catalyst::Engine::HTTP; } use strict; use warnings; use Getopt::Long; use Pod::Usage; use FindBin; use lib "$FindBin::Bin/.."; my $debug = 0; my $fork = 0; my $help = 0; my $host = undef; my $port = 3000; my $keepalive = 0; my $restart = 0; my $restart_delay = 1; my $restart_regex = '\.yml$|\.yaml$|\.pm$'; my $restart_directory = undef; my $background = 0; my $pidfile = "/tmp/testapp.pid"; my @argv = @ARGV; GetOptions( 'debug|d' => \$debug, 'fork' => \$fork, 'help|?' => \$help, 'host=s' => \$host, 'port=s' => \$port, 'keepalive|k' => \$keepalive, 'restart|r' => \$restart, 'restartdelay|rd=s' => \$restart_delay, 'restartregex|rr=s' => \$restart_regex, 'restartdirectory=s' => \$restart_directory, 'daemon' => \$background, 'pidfile=s' => \$pidfile, ); pod2usage(1) if $help; if ( $restart ) { $ENV{CATALYST_ENGINE} = 'HTTP::Restarter'; } if ( $debug ) { $ENV{CATALYST_DEBUG} = 1; } # This is require instead of use so that the above environment # variables can be set at runtime. require TestApp; TestApp->run( $port, $host, { argv => \@argv, 'fork' => $fork, keepalive => $keepalive, restart => $restart, restart_delay => $restart_delay, restart_regex => qr/$restart_regex/, restart_directory => $restart_directory, background => $background, pidfile => $pidfile, } ); 1; =head1 NAME testapp_server.pl - Catalyst Testserver =head1 SYNOPSIS testapp_server.pl [options] Options: -d -debug force debug mode -f -fork handle each request in a new process (defaults to false) -? -help display this help and exits -host host (defaults to all) -p -port port (defaults to 3000) -k -keepalive enable keep-alive connections -r -restart restart when files get modified (defaults to false) -rd -restartdelay delay between file checks -rr -restartregex regex match files that trigger a restart when modified (defaults to '\.yml$|\.yaml$|\.pm$') -restartdirectory the directory to search for modified files (defaults to '../') -daemon background the server -pidfile=filename store the pid if the server in filename, if daemonizing See also: perldoc Catalyst::Manual perldoc Catalyst::Manual::Intro =head1 DESCRIPTION Run a Catalyst Testserver for this application. =head1 AUTHOR Sebastian Riedel, C Maintained by the Catalyst Core Team. =head1 COPYRIGHT This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself. =cut Catalyst-Model-Adaptor-0.10/t/lib/script/testapp_test.pl0000644000076500000240000000024511233534230021615 0ustar t0mstaff#!/usr/bin/env perl use strict; use warnings; use FindBin; use lib "$FindBin::Bin/.."; use Catalyst::Test 'TestApp'; print request($ARGV[0])->content . "\n"; 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/0000755000076500000240000000000011531052161016613 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/t/lib/TestApp/Backend/0000755000076500000240000000000011531052161020142 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/t/lib/TestApp/Backend/InnerPackage.pm0000644000076500000240000000033511426250711023034 0ustar t0mstaffpackage TestApp::Backend::InnerPackage; sub foo { 42 } package TestApp::Backend::InnerPackage::Inner; use Moose; has 'okay' => ( is => 'ro', default => 'Alright!', ); no Moose; __PACKAGE__->meta->make_immutable; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/Backend/SomeClass.pm0000644000076500000240000000043111334137761022402 0ustar t0mstaffpackage TestApp::Backend::SomeClass; use Moose; my $id = 0; sub BUILD { $id++; } has _count => ( is => 'rw', isa => 'Int', default => 0 ); sub count { my $self = shift; return $self->_count($self->_count+1); } sub id { return $id; } has foo => ( is => 'ro' ); 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/BaseController/0000755000076500000240000000000011531052161021531 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/t/lib/TestApp/BaseController/Adaptor.pm0000644000076500000240000000137511233534230023470 0ustar t0mstaffpackage TestApp::BaseController::Adaptor; use strict; use warnings; use base 'Catalyst::Controller'; sub model { shift->{model} } sub is_a :Path(isa) { my ($self, $c) = @_; $c->res->body(ref $c->model($self->model)); } sub id :Local { my ($self, $c) = @_; $c->res->body($c->model($self->model)->id); } sub id_twice :Local { my ($self, $c) = @_; $c->res->body(join '|', map { $c->model($self->model)->id } 1..2); } sub count :Local { my ($self, $c) = @_; $c->res->body($c->model($self->model)->count); } sub count_twice :Local { my ($self, $c) = @_; $c->res->body(join '|', map { $c->model($self->model)->count } 1..2); } sub foo :Local { my ($self, $c) = @_; $c->res->body($c->model($self->model)->foo); } 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/Controller/0000755000076500000240000000000011531052161020736 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/t/lib/TestApp/Controller/Adaptor.pm0000644000076500000240000000024011233534230022663 0ustar t0mstaffpackage TestApp::Controller::Adaptor; use strict; use warnings; use base 'TestApp::BaseController::Adaptor'; __PACKAGE__->config( model => 'SomeClass' ); 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/Controller/Factory.pm0000644000076500000240000000041611531051473022711 0ustar t0mstaffpackage TestApp::Controller::Factory; use strict; use warnings; use base 'TestApp::BaseController::Adaptor'; __PACKAGE__->config( model => 'Factory' ); sub foo :Local { my ($self, $c) = @_; $c->res->body($c->model($self->model, foo => 'factory')->foo); } 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/Controller/InnerPackage.pm0000644000076500000240000000025011426250711023624 0ustar t0mstaffpackage TestApp::Controller::InnerPackage; use strict; use warnings; use base 'TestApp::BaseController::Adaptor'; __PACKAGE__->config( model => 'InnerPackage' ); 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/Controller/PerRequest.pm0000644000076500000240000000043311531051473023400 0ustar t0mstaffpackage TestApp::Controller::PerRequest; use strict; use warnings; use base 'TestApp::BaseController::Adaptor'; __PACKAGE__->config( model => 'PerRequest' ); sub foo :Local { my ($self, $c) = @_; $c->res->body($c->model($self->model, { foo => 'perrequest' })->foo); } 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/Controller/Root.pm0000644000076500000240000000034511233534230022222 0ustar t0mstaffpackage TestApp::Controller::Root; use strict; use warnings; __PACKAGE__->config(namespace => q{}); use base 'Catalyst::Controller'; # your actions replace this one sub main :Path { $_[1]->res->body('

It works

') } 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/Model/0000755000076500000240000000000011531052161017653 5ustar t0mstaffCatalyst-Model-Adaptor-0.10/t/lib/TestApp/Model/Factory.pm0000644000076500000240000000024511233534230021622 0ustar t0mstaffpackage TestApp::Model::Factory; use strict; use warnings; use base 'Catalyst::Model::Factory'; __PACKAGE__->config( class => 'TestApp::Backend::SomeClass' ); 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/Model/InnerPackage.pm0000644000076500000240000000033111426250711022541 0ustar t0mstaffpackage TestApp::Model::InnerPackage; use strict; use warnings; use TestApp::Backend::InnerPackage; use base 'Catalyst::Model::Adaptor'; __PACKAGE__->config( class => 'TestApp::Backend::InnerPackage::Inner' ); 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/Model/NoArgs.pm0000644000076500000240000000024411334137761021415 0ustar t0mstaffpackage TestApp::Model::NoArgs; use strict; use warnings; use base 'Catalyst::Model::Adaptor'; __PACKAGE__->config( class => 'TestApp::Backend::SomeClass' ); 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/Model/PerRequest.pm0000644000076500000240000000026411233534230022313 0ustar t0mstaffpackage TestApp::Model::PerRequest; use strict; use warnings; use base 'Catalyst::Model::Factory::PerRequest'; __PACKAGE__->config( class => 'TestApp::Backend::SomeClass' ); 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp/Model/SomeClass.pm0000644000076500000240000000024711233534230022106 0ustar t0mstaffpackage TestApp::Model::SomeClass; use strict; use warnings; use base 'Catalyst::Model::Adaptor'; __PACKAGE__->config( class => 'TestApp::Backend::SomeClass' ); 1; Catalyst-Model-Adaptor-0.10/t/lib/TestApp.pm0000644000076500000240000000054711334137761017172 0ustar t0mstaffpackage TestApp; use strict; use warnings; use Catalyst; # Note __PACKAGE__->config->{'Model::NoArgs} -> not configured :) __PACKAGE__->config->{'Model::SomeClass'}{args} = { foo => 'bar' }; __PACKAGE__->config->{'Model::Factory'}{args} = { foo => 'baz' }; __PACKAGE__->config->{'Model::PerRequest'}{args} = { foo => 'quux' }; __PACKAGE__->setup; 1; Catalyst-Model-Adaptor-0.10/t/live-test.t0000644000076500000240000001012411531051473016571 0ustar t0mstaff#!/usr/bin/env perl use strict; use warnings; use Test::More; # setup library path use FindBin qw($Bin); use lib "$Bin/lib"; BEGIN { plan skip_all => 'this test needs Test::WWW::Mechanize::Catalyst' unless eval "require Test::WWW::Mechanize::Catalyst"; plan skip_all => 'this test needs Moose' unless eval "require Moose"; plan tests => 49; } # make sure testapp works use ok 'TestApp'; # a live test against TestApp, the test application use Test::WWW::Mechanize::Catalyst 'TestApp'; my $mech = Test::WWW::Mechanize::Catalyst->new; $mech->get_ok('http://localhost/', 'get main page'); $mech->content_like(qr/it works/i, 'see if it has our text'); # adaptor { $mech->get_ok('http://localhost/adaptor/isa', 'get the class name'); $mech->content_like(qr/^TestApp::Backend::SomeClass$/, 'adapted class is itself'); } { $mech->get_ok('http://localhost/adaptor/id_twice', 'get id_twice'); my ($a, $b) = split /\|/, $mech->content; is $a, $b, 'same instance both times'; $mech->get_ok('http://localhost/adaptor/id', 'get id'); is $mech->content, $a, 'same instance for different request'; } { $mech->get_ok('http://localhost/adaptor/foo', 'get foo'); $mech->content_like(qr/^bar$/, 'got foo = bar'); } { $mech->get_ok('http://localhost/adaptor/count', 'get count'); my $a = $mech->content; $mech->get_ok('http://localhost/adaptor/count', 'get count (+1)'); my $b = $mech->content; is $b, $a+1, 'same instance across requests'; } { $mech->get_ok('http://localhost/adaptor/count_twice', 'get count_twice'); my ($a, $b) = split/\|/, $mech->content; is $a, 3, '3 count for a'; is $b, 4, '4 count for b'; } # factory { $mech->get_ok('http://localhost/factory/isa', 'get the class name'); $mech->content_like(qr/^TestApp::Backend::SomeClass$/, 'adapted class is itself'); } { $mech->get_ok('http://localhost/factory/id_twice', 'get id_twice'); my ($a, $b) = split /\|/, $mech->content; is $b, $a+1, 'different instance both times'; $mech->get_ok('http://localhost/factory/id', 'get id'); is $mech->content, $b+1, 'same instance for different request too'; } { $mech->get_ok('http://localhost/factory/foo', 'get foo'); $mech->content_like(qr/^factory$/, 'got foo = factory'); } { $mech->get_ok('http://localhost/factory/count', 'get count'); my $a = $mech->content; $mech->get_ok('http://localhost/factory/count', 'get count (+1)'); my $b = $mech->content; is $a, 1, '1st request for a'; is $b, 1, '1st request for b too'; } { $mech->get_ok('http://localhost/factory/count_twice', 'get count_twice'); my ($a, $b) = split/\|/, $mech->content; is $a, 1, '1 count for a'; is $b, 1, '1 count for b too'; } # per_request { $mech->get_ok('http://localhost/perrequest/isa', 'get the class name'); $mech->content_like(qr/^TestApp::Backend::SomeClass$/, 'adapted class is itself'); } { $mech->get_ok('http://localhost/perrequest/id_twice', 'get id_twice'); my ($a, $b) = split /\|/, $mech->content; is $a, $b, 'same instance both times'; $mech->get_ok('http://localhost/perrequest/id', 'get id'); is $mech->content, $a+1, 'different instance for different request'; } { $mech->get_ok('http://localhost/perrequest/foo', 'get foo'); $mech->content_like(qr/^perrequest$/, 'got foo = perrequest'); } { $mech->get_ok('http://localhost/perrequest/count', 'get count'); my $a = $mech->content; $mech->get_ok('http://localhost/perrequest/count', 'get count (+1)'); my $b = $mech->content; is $a, 1, '1st request for a'; is $b, 1, '1st request for b too'; } { $mech->get_ok('http://localhost/perrequest/count_twice', 'get count_twice'); my ($a, $b) = split/\|/, $mech->content; is $a, 1, '1 count for a'; is $b, 2, '2 count for b'; } # inner package { $mech->get_ok('http://localhost/innerpackage/isa', 'get the class name'); $mech->content_like(qr/^TestApp::Backend::InnerPackage::Inner$/, 'got the right package for inner class'); }