1 package Catalyst::Utils;
4 use Catalyst::Exception;
12 Catalyst::Utils - The Catalyst Utils
24 =item appprefix($class)
26 Returns the application prefix for the class.
28 MyApp::Foo becomes myapp_foo
39 =item class2appclass($class);
41 Returns the appclass for class.
43 MyApp::C::Foo::Bar becomes MyApp
44 My::App::C::Foo::Bar becomes My::App
49 my $class = shift || '';
51 if ( $class =~ /^(.*)::([MVC]|Model|View|Controller)?::.*$/ ) {
57 =item class2classprefix($class);
59 Returns the classprefix for class.
61 MyApp::C::Foo::Bar becomes MyApp::C
62 My::App::C::Foo::Bar becomes My::App::C
66 sub class2classprefix {
67 my $class = shift || '';
69 if ( $class =~ /^(.*::[MVC]|Model|View|Controller)?::.*$/ ) {
75 =item class2classsuffix($class);
77 Returns the classsuffix for class.
79 MyApp::C::Foo::Bar becomes C::Foo::Bar
83 sub class2classsuffix {
84 my $class = shift || '';
85 my $prefix = class2appclass($class) || '';
86 $class =~ s/$prefix\:\://;
90 =item class2env($class);
92 Returns the environment name for class.
95 My::App becomes MY_APP
100 my $class = shift || '';
101 $class =~ s/\:\:/_/g;
105 =item class2prefix( $class, $case );
107 Returns the prefix for class.
109 My::App::C::Foo::Bar becomes /foo/bar
114 my $class = shift || '';
115 my $case = shift || 0;
117 if ( $class =~ /^.*::([MVC]|Model|View|Controller)?::(.*)$/ ) {
118 $prefix = $case ? $2 : lc $2;
119 $prefix =~ s/\:\:/\//g;
124 =item class2tempdir( $class [, $create ] );
126 Returns a tempdir for class. If create is true it will try to create the path.
128 My::App becomes /tmp/my/app
129 My::App::C::Foo::Bar becomes /tmp/my/app/c/foo/bar
134 my $class = shift || '';
135 my $create = shift || 0;
136 my @parts = split '::', lc $class;
138 my $tmpdir = dir( File::Spec->tmpdir, @parts )->cleanup;
140 if ( $create && !-e $tmpdir ) {
142 eval { $tmpdir->mkpath };
145 Catalyst::Exception->throw(
146 message => qq/Couldn't create tmpdir '$tmpdir', "$@"/ );
150 return $tmpdir->stringify;
155 Returns home directory for given class.
161 $name =~ s/\:\:/\//g;
163 if ( my $path = $INC{"$name.pm"} ) {
164 $home = file($path)->absolute->dir;
167 my $subdir = dir($home)->subdir($append);
168 for ( split '/', $name ) { $home = dir($home)->parent }
169 if ( $home =~ /blib$/ ) { $home = dir($home)->parent }
170 elsif (!-f file( $home, 'Makefile.PL' )
171 && !-f file( $home, 'Build.PL' ) )
176 # clean up relative path:
177 # MyApp/script/.. -> MyApp
178 my ($lastdir) = $home->dir_list( -1, 1 );
179 if ( $lastdir eq '..' ) {
180 $home = dir($home)->parent->parent;
186 =item prefix($class, $name);
188 Returns a prefixed action.
190 MyApp::C::Foo::Bar, yada becomes /foo/bar/yada
195 my ( $class, $name ) = @_;
196 my $prefix = &class2prefix($class);
197 $name = "$prefix/$name" if $prefix;
201 =item request($request)
203 Returns a HTTP::Request object.
209 unless ( ref $request ) {
210 if ( $request =~ m/http/i ) {
211 $request = URI->new($request)->canonical;
214 $request = URI->new( 'http://localhost' . $request )->canonical;
217 unless ( ref $request eq 'HTTP::Request' ) {
218 $request = HTTP::Request->new( 'GET', $request );
227 Sebastian Riedel, C<sri@cpan.org>
231 This program is free software, you can redistribute it and/or modify it under
232 the same terms as Perl itself.