1 package Catalyst::Utils;
11 Catalyst::Utils - The Catalyst Utils
25 Returns attributes for coderef in a arrayref
29 sub attrs { attributes::get( $_[0] ) || [] }
31 =item class2appclass($class);
33 Returns the appclass for class.
35 MyApp::C::Foo::Bar becomes MyApp
36 My::App::C::Foo::Bar becomes My::App
41 my $class = shift || '';
43 if ( $class =~ /^(.*)::([MVC]|Model|View|Controller)?::.*$/ ) {
49 =item class2classprefix($class);
51 Returns the classprefix for 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 =item class2classsuffix($class);
69 Returns the classsuffix for class.
71 MyApp::C::Foo::Bar becomes C::Foo::Bar
75 sub class2classsuffix {
76 my $class = shift || '';
77 my $prefix = class2appclass($class) || '';
78 $class =~ s/$prefix\:\://;
82 =item class2prefix( $class, $case );
84 Returns the prefix for class.
86 My::App::C::Foo::Bar becomes /foo/bar
91 my $class = shift || '';
92 my $case = shift || 0;
94 if ( $class =~ /^.*::([MVC]|Model|View|Controller)?::(.*)$/ ) {
95 $prefix = $case ? $2 : lc $2;
96 $prefix =~ s/\:\:/\//g;
103 Returns home directory for given class.
109 $name =~ s/\:\:/\//g;
111 if ( my $path = $INC{"$name.pm"} ) {
112 $home = file($path)->absolute->dir;
115 my $subdir = dir($home)->subdir($append);
116 for ( split '/', $name ) { $home = dir($home)->parent }
117 if ( $home =~ /blib$/ ) { $home = dir($home)->parent }
118 elsif (!-f file( $home, 'Makefile.PL' )
119 && !-f file( $home, 'Build.PL' ) )
123 # clean up relative path:
124 # MyApp/script/.. -> MyApp
125 my ($lastdir) = $home->dir_list( -1, 1 );
126 if ( $lastdir eq '..' ) {
127 $home = dir($home)->parent->parent;
133 =item prefix($class, $name);
135 Returns a prefixed action.
137 MyApp::C::Foo::Bar, yada becomes /foo/bar/yada
142 my ( $class, $name ) = @_;
143 my $prefix = &class2prefix($class);
144 $name = "$prefix/$name" if $prefix;
148 =item reflect_actions($class);
150 Returns an arrayref containing all actions of a component class.
154 sub reflect_actions {
157 eval '$actions = $class->_action_cache';
158 die qq/Couldn't reflect actions of component "$class", "$@"/ if $@;
162 =item request($string);
164 Returns an C<HTTP::Request> from a string.
171 unless ( ref $request ) {
173 if ( $request =~ m/http/i ) {
174 $request = URI->new($request)->canonical;
177 $request = URI->new( 'http://localhost' . $request )->canonical;
181 unless ( ref $request eq 'HTTP::Request' ) {
182 $request = HTTP::Request->new( 'GET', $request );
192 Sebastian Riedel, C<sri@cpan.org>
196 This program is free software, you can redistribute it and/or modify it under
197 the same terms as Perl itself.