1 package Catalyst::Utils;
5 use Catalyst::Exception;
13 Catalyst::Utils - The Catalyst Utils
25 =item appprefix($class)
27 Returns the application prefix for the class.
29 MyApp::Foo becomes myapp_foo
42 Returns attributes for coderef in a arrayref
46 sub attrs { attributes::get( $_[0] ) || [] }
48 =item class2appclass($class);
50 Returns the appclass for class.
52 MyApp::C::Foo::Bar becomes MyApp
53 My::App::C::Foo::Bar becomes My::App
58 my $class = shift || '';
60 if ( $class =~ /^(.*)::([MVC]|Model|View|Controller)?::.*$/ ) {
66 =item class2classprefix($class);
68 Returns the classprefix for class.
70 MyApp::C::Foo::Bar becomes MyApp::C
71 My::App::C::Foo::Bar becomes My::App::C
75 sub class2classprefix {
76 my $class = shift || '';
78 if ( $class =~ /^(.*::[MVC]|Model|View|Controller)?::.*$/ ) {
84 =item class2classsuffix($class);
86 Returns the classsuffix for class.
88 MyApp::C::Foo::Bar becomes C::Foo::Bar
92 sub class2classsuffix {
93 my $class = shift || '';
94 my $prefix = class2appclass($class) || '';
95 $class =~ s/$prefix\:\://;
99 =item class2env($class);
101 Returns the environment name for class.
104 My::App becomes MY_APP
109 my $class = shift || '';
110 $class =~ s/\:\:/_/g;
114 =item class2prefix( $class, $case );
116 Returns the prefix for class.
118 My::App::C::Foo::Bar becomes /foo/bar
123 my $class = shift || '';
124 my $case = shift || 0;
126 if ( $class =~ /^.*::([MVC]|Model|View|Controller)?::(.*)$/ ) {
127 $prefix = $case ? $2 : lc $2;
128 $prefix =~ s/\:\:/\//g;
133 =item class2tempdir( $class [, $create ] );
135 Returns a tempdir for class. If create is true it will try to create the path.
137 My::App becomes /tmp/my/app
138 My::App::C::Foo::Bar becomes /tmp/my/app/c/foo/bar
143 my $class = shift || '';
144 my $create = shift || 0;
145 my @parts = split '::', lc $class;
147 my $tmpdir = dir( File::Spec->tmpdir, @parts )->cleanup;
149 if ( $create && !-e $tmpdir ) {
151 eval { $tmpdir->mkpath };
154 Catalyst::Exception->throw(
155 message => qq/Couldn't create tmpdir '$tmpdir', "$@"/ );
159 return $tmpdir->stringify;
164 Returns home directory for given class.
170 $name =~ s/\:\:/\//g;
172 if ( my $path = $INC{"$name.pm"} ) {
173 $home = file($path)->absolute->dir;
176 my $subdir = dir($home)->subdir($append);
177 for ( split '/', $name ) { $home = dir($home)->parent }
178 if ( $home =~ /blib$/ ) { $home = dir($home)->parent }
179 elsif (!-f file( $home, 'Makefile.PL' )
180 && !-f file( $home, 'Build.PL' ) )
185 # clean up relative path:
186 # MyApp/script/.. -> MyApp
187 my ($lastdir) = $home->dir_list( -1, 1 );
188 if ( $lastdir eq '..' ) {
189 $home = dir($home)->parent->parent;
195 =item prefix($class, $name);
197 Returns a prefixed action.
199 MyApp::C::Foo::Bar, yada becomes /foo/bar/yada
204 my ( $class, $name ) = @_;
205 my $prefix = &class2prefix($class);
206 $name = "$prefix/$name" if $prefix;
210 =item reflect_actions($class);
212 Returns an arrayref containing all actions of a component class.
216 sub reflect_actions {
219 eval '$actions = $class->_action_cache';
222 Catalyst::Exception->throw( message =>
223 qq/Couldn't reflect actions of component "$class", "$@"/ );
229 =item request($request)
231 Returns a HTTP::Request object.
237 unless ( ref $request ) {
238 if ( $request =~ m/http/i ) {
239 $request = URI->new($request)->canonical;
242 $request = URI->new( 'http://localhost' . $request )->canonical;
245 unless ( ref $request eq 'HTTP::Request' ) {
246 $request = HTTP::Request->new( 'GET', $request );
255 Sebastian Riedel, C<sri@cpan.org>
259 This program is free software, you can redistribute it and/or modify it under
260 the same terms as Perl itself.