1 package Catalyst::Utils;
5 use Catalyst::Exception;
13 Catalyst::Utils - The Catalyst Utils
27 Returns attributes for coderef in a arrayref
31 sub attrs { attributes::get( $_[0] ) || [] }
33 =item class2appclass($class);
35 Returns the appclass for class.
37 MyApp::C::Foo::Bar becomes MyApp
38 My::App::C::Foo::Bar becomes My::App
43 my $class = shift || '';
45 if ( $class =~ /^(.*)::([MVC]|Model|View|Controller)?::.*$/ ) {
51 =item class2classprefix($class);
53 Returns the classprefix for class.
55 MyApp::C::Foo::Bar becomes MyApp::C
56 My::App::C::Foo::Bar becomes My::App::C
60 sub class2classprefix {
61 my $class = shift || '';
63 if ( $class =~ /^(.*::[MVC]|Model|View|Controller)?::.*$/ ) {
69 =item class2classsuffix($class);
71 Returns the classsuffix for class.
73 MyApp::C::Foo::Bar becomes C::Foo::Bar
77 sub class2classsuffix {
78 my $class = shift || '';
79 my $prefix = class2appclass($class) || '';
80 $class =~ s/$prefix\:\://;
84 =item class2env($class);
86 Returns the enviroment name for class.
89 My::App becomes MY_APP
94 my $class = shift || '';
99 =item class2prefix( $class, $case );
101 Returns the prefix for class.
103 My::App::C::Foo::Bar becomes /foo/bar
108 my $class = shift || '';
109 my $case = shift || 0;
111 if ( $class =~ /^.*::([MVC]|Model|View|Controller)?::(.*)$/ ) {
112 $prefix = $case ? $2 : lc $2;
113 $prefix =~ s/\:\:/\//g;
118 =item class2tempdir( $class [, $create ] );
120 Returns a tempdir for class. If create is true it will try to create the path.
122 My::App becomes /tmp/my/app
123 My::App::C::Foo::Bar becomes /tmp/my/app/c/foo/bar
128 my $class = shift || '';
129 my $create = shift || 0;
130 my @parts = split '::', lc $class;
132 my $tmpdir = dir( File::Spec->tmpdir, @parts )->cleanup;
134 if ( $create && ! -e $tmpdir ) {
136 eval { $tmpdir->mkpath };
139 Catalyst::Exception->throw(
140 message => qq/Couldn't create tmpdir '$tmpdir', "$@"/
145 return $tmpdir->stringify;
150 Returns home directory for given class.
156 $name =~ s/\:\:/\//g;
158 if ( my $path = $INC{"$name.pm"} ) {
159 $home = file($path)->absolute->dir;
162 my $subdir = dir($home)->subdir($append);
163 for ( split '/', $name ) { $home = dir($home)->parent }
164 if ( $home =~ /blib$/ ) { $home = dir($home)->parent }
165 elsif (!-f file( $home, 'Makefile.PL' )
166 && !-f file( $home, 'Build.PL' ) )
170 # clean up relative path:
171 # MyApp/script/.. -> MyApp
172 my ($lastdir) = $home->dir_list( -1, 1 );
173 if ( $lastdir eq '..' ) {
174 $home = dir($home)->parent->parent;
180 =item prefix($class, $name);
182 Returns a prefixed action.
184 MyApp::C::Foo::Bar, yada becomes /foo/bar/yada
189 my ( $class, $name ) = @_;
190 my $prefix = &class2prefix($class);
191 $name = "$prefix/$name" if $prefix;
195 =item reflect_actions($class);
197 Returns an arrayref containing all actions of a component class.
201 sub reflect_actions {
204 eval '$actions = $class->_action_cache';
207 Catalyst::Exception->throw(
208 message => qq/Couldn't reflect actions of component "$class", "$@"/
215 =item request($string);
217 Returns an C<HTTP::Request> from a string.
224 unless ( ref $request ) {
226 if ( $request =~ m/http/i ) {
227 $request = URI->new($request)->canonical;
230 $request = URI->new( 'http://localhost' . $request )->canonical;
234 unless ( ref $request eq 'HTTP::Request' ) {
235 $request = HTTP::Request->new( 'GET', $request );
245 Sebastian Riedel, C<sri@cpan.org>
249 This program is free software, you can redistribute it and/or modify it under
250 the same terms as Perl itself.