1 package Catalyst::Utils;
4 use Catalyst::Exception;
12 Catalyst::Utils - The Catalyst Utils
22 =head2 appprefix($class)
24 MyApp::Foo becomes myapp_foo
35 =head2 class2appclass($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 =head2 class2classprefix($class);
53 MyApp::C::Foo::Bar becomes MyApp::C
54 My::App::C::Foo::Bar becomes My::App::C
58 sub class2classprefix {
59 my $class = shift || '';
61 if ( $class =~ /^(.*::[MVC]|Model|View|Controller)?::.*$/ ) {
67 =head2 class2classsuffix($class);
69 MyApp::C::Foo::Bar becomes C::Foo::Bar
73 sub class2classsuffix {
74 my $class = shift || '';
75 my $prefix = class2appclass($class) || '';
76 $class =~ s/$prefix\:\://;
80 =head2 class2env($class);
82 Returns the environment name for class.
85 My::App becomes MY_APP
90 my $class = shift || '';
95 =head2 class2prefix( $class, $case );
97 Returns the uri prefix for a class. If case is false the prefix is converted to lowercase.
99 My::App::C::Foo::Bar becomes foo/bar
104 my $class = shift || '';
105 my $case = shift || 0;
107 if ( $class =~ /^.*::([MVC]|Model|View|Controller)?::(.*)$/ ) {
108 $prefix = $case ? $2 : lc $2;
109 $prefix =~ s/\:\:/\//g;
114 =head2 class2tempdir( $class [, $create ] );
116 Returns a tempdir for a class. If create is true it will try to create the path.
118 My::App becomes /tmp/my/app
119 My::App::C::Foo::Bar becomes /tmp/my/app/c/foo/bar
124 my $class = shift || '';
125 my $create = shift || 0;
126 my @parts = split '::', lc $class;
128 my $tmpdir = dir( File::Spec->tmpdir, @parts )->cleanup;
130 if ( $create && !-e $tmpdir ) {
132 eval { $tmpdir->mkpath };
135 Catalyst::Exception->throw(
136 message => qq/Couldn't create tmpdir '$tmpdir', "$@"/ );
140 return $tmpdir->stringify;
145 Returns home directory for given class.
151 $name =~ s/\:\:/\//g;
153 if ( my $path = $INC{"$name.pm"} ) {
154 $home = file($path)->absolute->dir;
157 my $subdir = dir($home)->subdir($append);
158 for ( split '/', $name ) { $home = dir($home)->parent }
159 if ( $home =~ /blib$/ ) { $home = dir($home)->parent }
160 elsif (!-f file( $home, 'Makefile.PL' )
161 && !-f file( $home, 'Build.PL' ) )
166 # clean up relative path:
167 # MyApp/script/.. -> MyApp
168 my ($lastdir) = $home->dir_list( -1, 1 );
169 if ( $lastdir eq '..' ) {
170 $home = dir($home)->parent->parent;
176 =head2 prefix($class, $name);
178 Returns a prefixed action.
180 MyApp::C::Foo::Bar, yada becomes foo/bar/yada
185 my ( $class, $name ) = @_;
186 my $prefix = &class2prefix($class);
187 $name = "$prefix/$name" if $prefix;
193 Returns an L<HTTP::Request> object for a uri.
199 unless ( ref $request ) {
200 if ( $request =~ m/http/i ) {
201 $request = URI->new($request)->canonical;
204 $request = URI->new( 'http://localhost' . $request )->canonical;
207 unless ( ref $request eq 'HTTP::Request' ) {
208 $request = HTTP::Request->new( 'GET', $request );
215 Sebastian Riedel, C<sri@cpan.org>
219 This program is free software, you can redistribute it and/or modify it under
220 the same terms as Perl itself.