X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FUtils.pm;h=c0eeefe13f3b3c22c9e5f56ac3fe8627bbe993f0;hb=05850e06de30638a8aca661a2c38fa45493fc6bd;hp=785c60792be7ee508207efef296f52cc5f2d1751;hpb=2d90477f073b682da61622da7c0330bfd336d0fa;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Utils.pm b/lib/Catalyst/Utils.pm index 785c607..c0eeefe 100644 --- a/lib/Catalyst/Utils.pm +++ b/lib/Catalyst/Utils.pm @@ -2,6 +2,11 @@ package Catalyst::Utils; use strict; use attributes (); +use Catalyst::Exception; +use File::Spec; +use HTTP::Request; +use Path::Class; +use URI; =head1 NAME @@ -17,28 +22,28 @@ See L. =over 4 -=item attrs($coderef) +=item appprefix($class) -Returns attributes for coderef in a arrayref +Returns the application prefix for the class. -=cut + MyApp::Foo becomes myapp_foo -sub attrs { attributes::get( $_[0] ) || [] } +=cut -=item prefix($class, $name); +sub appprefix { + my $class = shift; + $class =~ s/\:\:/_/g; + $class = lc($class); + return $class; +} -Returns a prefixed action. +=item attrs($coderef) - MyApp::C::Foo::Bar, yada becomes /foo/bar/yada +Returns attributes for coderef in a arrayref =cut -sub prefix { - my ( $class, $name ) = @_; - my $prefix = &class2prefix($class); - $name = "$prefix/$name" if $prefix; - return $name; -} +sub attrs { attributes::get( $_[0] ) || [] } =item class2appclass($class); @@ -91,7 +96,22 @@ sub class2classsuffix { return $class; } -=item class2prefix($class); +=item class2env($class); + +Returns the environment name for class. + + MyApp becomes MYAPP + My::App becomes MY_APP + +=cut + +sub class2env { + my $class = shift || ''; + $class =~ s/\:\:/_/g; + return uc($class); +} + +=item class2prefix( $class, $case ); Returns the prefix for class. @@ -101,14 +121,133 @@ Returns the prefix for class. sub class2prefix { my $class = shift || ''; + my $case = shift || 0; my $prefix; if ( $class =~ /^.*::([MVC]|Model|View|Controller)?::(.*)$/ ) { - $prefix = lc $2; + $prefix = $case ? $2 : lc $2; $prefix =~ s/\:\:/\//g; } return $prefix; } +=item class2tempdir( $class [, $create ] ); + +Returns a tempdir for class. If create is true it will try to create the path. + + My::App becomes /tmp/my/app + My::App::C::Foo::Bar becomes /tmp/my/app/c/foo/bar + +=cut + +sub class2tempdir { + my $class = shift || ''; + my $create = shift || 0; + my @parts = split '::', lc $class; + + my $tmpdir = dir( File::Spec->tmpdir, @parts )->cleanup; + + if ( $create && !-e $tmpdir ) { + + eval { $tmpdir->mkpath }; + + if ($@) { + Catalyst::Exception->throw( + message => qq/Couldn't create tmpdir '$tmpdir', "$@"/ ); + } + } + + return $tmpdir->stringify; +} + +=item home($class) + +Returns home directory for given class. + +=cut + +sub home { + my $name = shift; + $name =~ s/\:\:/\//g; + my $home = 0; + if ( my $path = $INC{"$name.pm"} ) { + $home = file($path)->absolute->dir; + $name =~ /(\w+)$/; + my $append = $1; + my $subdir = dir($home)->subdir($append); + for ( split '/', $name ) { $home = dir($home)->parent } + if ( $home =~ /blib$/ ) { $home = dir($home)->parent } + elsif (!-f file( $home, 'Makefile.PL' ) + && !-f file( $home, 'Build.PL' ) ) + { + $home = $subdir; + } + + # clean up relative path: + # MyApp/script/.. -> MyApp + my ($lastdir) = $home->dir_list( -1, 1 ); + if ( $lastdir eq '..' ) { + $home = dir($home)->parent->parent; + } + } + return $home; +} + +=item prefix($class, $name); + +Returns a prefixed action. + + MyApp::C::Foo::Bar, yada becomes /foo/bar/yada + +=cut + +sub prefix { + my ( $class, $name ) = @_; + my $prefix = &class2prefix($class); + $name = "$prefix/$name" if $prefix; + return $name; +} + +=item reflect_actions($class); + +Returns an arrayref containing all actions of a component class. + +=cut + +sub reflect_actions { + my $class = shift; + my $actions = []; + eval '$actions = $class->_action_cache'; + + if ($@) { + Catalyst::Exception->throw( message => + qq/Couldn't reflect actions of component "$class", "$@"/ ); + } + + return $actions; +} + +=item request($request) + +Returns a HTTP::Request object. + +=cut + +sub request { + my $request = shift; + unless ( ref $request ) { + if ( $request =~ m/http/i ) { + $request = URI->new($request)->canonical; + } + else { + $request = URI->new( 'http://localhost' . $request )->canonical; + } + } + unless ( ref $request eq 'HTTP::Request' ) { + $request = HTTP::Request->new( 'GET', $request ); + } + return $request; +} + =back =head1 AUTHOR