X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FHelper.pm;h=203238fad01b2175b6b1143d1303ab7b936099a6;hb=91864987dc0e2256fe00b94853ba5b3a18f01ea2;hp=81258bcca6339624a5da1790d937cada6f1965cb;hpb=d7c505f31a1c555f2cc3bee7ddfb550a808cd091;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Helper.pm b/lib/Catalyst/Helper.pm index 81258bc..203238f 100644 --- a/lib/Catalyst/Helper.pm +++ b/lib/Catalyst/Helper.pm @@ -34,6 +34,8 @@ sub mk_app { $self->_mk_dirs; $self->_mk_appclass; $self->_mk_makefile; + $self->_mk_readme; + $self->_mk_changes; $self->_mk_apptest; $self->_mk_server; $self->_mk_test; @@ -41,37 +43,159 @@ sub mk_app { return 1; } +=head3 mk_component + +=cut + +sub mk_component { + my ( $self, $app, $type, $name, $helper, @args ) = @_; + return 0 + if ( $name =~ /[^\w\:]/ || !\$type =~ /^model|m|view|v|controller|c\$/i ); + return 0 if $name =~ /[^\w\:]/; + $type = 'M' if $type =~ /model|m/i; + $type = 'V' if $type =~ /view|v/i; + $type = 'C' if $type =~ /controller|c/i; + $self->{type} = $type; + $self->{name} = $name; + $self->{class} = "$app\::$type\::$name"; + $self->{app} = $app; + + # Class + my $appdir = File::Spec->catdir( split /\:\:/, $app ); + my $path = File::Spec->catdir( $FindBin::Bin, '..', 'lib', $appdir, $type ); + my $file = $name; + if ( $name =~ /\:/ ) { + my @path = split /\:\:/, $name; + $file = pop @path; + $path = File::Spec->catdir( $path, @path ); + mkpath $path; + } + $file = File::Spec->catfile( $path, "$file.pm" ); + $self->{file} = $file; + + # Test + $self->{test_dir} = File::Spec->catdir( $FindBin::Bin, '..', 't' ); + $self->{test} = $self->next_test; + + # Helper + if ($helper) { + my $comp = 'Model'; + $comp = 'View' if $type eq 'V'; + $comp = 'Controller' if $type eq 'C'; + my $class = "Catalyst::Helper::$comp\::$helper"; + eval "require $class"; + die qq/Couldn't load helper "$class", "$@"/ if $@; + if ( $class->can('mk_compclass') ) { + return 1 unless $class->mk_compclass( $self, @args ); + } + else { return 1 unless $self->_mk_compclass } + + if ( $class->can('mk_comptest') ) { + $class->mk_comptest( $self, @args ); + } + else { $self->_mk_comptest } + } + + # Fallback + else { + return 1 unless $self->_mk_compclass; + $self->_mk_comptest; + } + return 1; +} + +=head3 mk_dir + +=cut + +sub mk_dir { + my ( $self, $dir ) = @_; + if ( -d $dir ) { + print qq/ exists "$dir"\n/; + return 0; + } + if ( mkpath $dir) { + print qq/created "$dir"\n/; + return 1; + } + die qq/Couldn't create "$dir", "$!"/; +} + +=head3 mk_file + +=cut + +sub mk_file { + my ( $self, $file, $content ) = @_; + if ( -e $file ) { + print qq/ exists "$file"\n/; + return 0; + } + if ( my $f = IO::File->new("> $file") ) { + print $f $content; + print qq/created "$file"\n/; + return 1; + } + die qq/Couldn't create "$file", "$!"/; +} + +=head3 next_test + +=cut + +sub next_test { + my ( $self, $tname ) = @_; + my $dir = $self->{test_dir}; + my $num = '01'; + for my $i (<$dir/*.t>) { + $i =~ /(\d+)[^\/]*.t$/; + my $j = $1 || $num; + $num = $j if $j > $num; + } + $num++; + $num = sprintf '%02d', $num; + if ($tname) { $tname = "$num$tname.t" } + else { + my $name = $self->{name}; + my $type = $self->{type}; + my $prefix = $name; + $prefix =~ s/::/_/g; + $prefix = lc $prefix; + $tname = lc( $num . $type . '_' . $prefix . '.t' ); + $self->{prefix} = $prefix; + } + return "$dir/$tname"; +} + sub _mk_dirs { my $self = shift; - mkpath $self->{dir} unless -d $self->{dir}; - $self->{bin} = File::Spec->catdir( $self->{dir}, 'bin' ); - mkpath $self->{bin}; + $self->mk_dir( $self->{dir} ); + $self->{script} = File::Spec->catdir( $self->{dir}, 'script' ); + $self->mk_dir( $self->{script} ); $self->{lib} = File::Spec->catdir( $self->{dir}, 'lib' ); - mkpath $self->{lib}; + $self->mk_dir( $self->{lib} ); $self->{root} = File::Spec->catdir( $self->{dir}, 'root' ); - mkpath $self->{root}; + $self->mk_dir( $self->{root} ); $self->{t} = File::Spec->catdir( $self->{dir}, 't' ); - mkpath $self->{t}; + $self->mk_dir( $self->{t} ); $self->{class} = File::Spec->catdir( split( /\:\:/, $self->{name} ) ); $self->{mod} = File::Spec->catdir( $self->{lib}, $self->{class} ); - mkpath $self->{mod}; + $self->mk_dir( $self->{mod} ); $self->{m} = File::Spec->catdir( $self->{mod}, 'M' ); - mkpath $self->{m}; + $self->mk_dir( $self->{m} ); $self->{v} = File::Spec->catdir( $self->{mod}, 'V' ); - mkpath $self->{v}; + $self->mk_dir( $self->{v} ); $self->{c} = File::Spec->catdir( $self->{mod}, 'C' ); - mkpath $self->{c}; + $self->mk_dir( $self->{c} ); $self->{base} = File::Spec->rel2abs( $self->{dir} ); } sub _mk_appclass { - my $self = shift; - my $mod = $self->{mod}; - my $name = $self->{name}; - my $base = $self->{base}; - my $class = IO::File->new("> $mod.pm") - or die qq/Couldn't open "$mod.pm", "$!"/; - print $class <<"EOF"; + my $self = shift; + my $mod = $self->{mod}; + my $name = $self->{name}; + my $base = $self->{base}; + $self->mk_file( "$mod.pm", <<"EOF"); package $name; use strict; @@ -121,13 +245,11 @@ EOF } sub _mk_makefile { - my $self = shift; - my $name = $self->{name}; - my $dir = $self->{dir}; - my $class = $self->{class}; - my $makefile = IO::File->new("> $dir/Makefile.PL") - or die qq/Couldn't open "$dir\/Makefile.PL", "$!"/; - print $makefile <<"EOF"; + my $self = shift; + my $name = $self->{name}; + my $dir = $self->{dir}; + my $class = $self->{class}; + $self->mk_file( "$dir\/Makefile.PL", <<"EOF"); use ExtUtils::MakeMaker; WriteMakefile( @@ -138,27 +260,53 @@ WriteMakefile( EOF } +sub _mk_readme { + my $self = shift; + my $dir = $self->{dir}; + $self->mk_file( "$dir\/README", <<"EOF"); +Run script/server.pl to test the application. +EOF +} + +sub _mk_changes { + my $self = shift; + my $name = $self->{name}; + my $dir = $self->{dir}; + my $time = localtime time; + $self->mk_file( "$dir\/Changes", <<"EOF"); +This file documents the revision history for Perl extension $name. + +0.01 $time + - initial revision, generated by Catalyst +EOF +} + sub _mk_apptest { my $self = shift; my $t = $self->{t}; my $name = $self->{name}; - my $test = IO::File->new("> $t/01app.t") - or die qq/Couldn't open "$t\/01app.t", "$!"/; - print $test <<"EOF"; + $self->mk_file( "$t\/01app.t", <<"EOF"); use Test::More tests => 2; use_ok( Catalyst::Test, '$name' ); ok( request('/')->is_success ); EOF + $self->mk_file( "$t\/02podcoverage.t", <<"EOF"); +use Test::More; + +eval "use Test::Pod::Coverage 1.04"; +plan skip_all => 'Test::Pod::Coverage 1.04 required' if \$@; +plan skip_all => 'set TEST_POD to enable this test' unless \$ENV{TEST_POD}; + +all_pod_coverage_ok(); +EOF } sub _mk_server { my $self = shift; my $name = $self->{name}; - my $bin = $self->{bin}; - my $server = IO::File->new("> $bin/server") - or die qq/Could't open "$bin\/server", "$!"/; - print $server <<"EOF"; + my $script = $self->{script}; + $self->mk_file( "$script\/server.pl", <<"EOF"); #!/usr/bin/perl -w use strict; @@ -186,11 +334,11 @@ server - Catalyst Testserver =head1 SYNOPSIS -server [options] +server.pl [options] Options: - -help display this help and exits - -port port (defaults to 3000) + -? -help display this help and exits + -p -port port (defaults to 3000) See also: perldoc Catalyst::Manual @@ -213,16 +361,14 @@ the same terms as perl itself. =cut EOF - chmod 0700, "$bin/server"; + chmod 0700, "$script/server.pl"; } sub _mk_test { - my $self = shift; - my $name = $self->{name}; - my $bin = $self->{bin}; - my $test = IO::File->new("> $bin/test") - or die qq/Could't open "$bin\/test", "$!"/; - print $test <<"EOF"; + my $self = shift; + my $name = $self->{name}; + my $script = $self->{script}; + $self->mk_file( "$script/test.pl", <<"EOF"); #!/usr/bin/perl -w use strict; @@ -251,14 +397,14 @@ test - Catalyst Test =head1 SYNOPSIS -test [options] uri +test.pl [options] uri Options: -help display this help and exits Examples: - perl test http://localhost/some_action - perl test /some_action + test.pl http://localhost/some_action + test.pl /some_action See also: perldoc Catalyst::Manual @@ -281,16 +427,14 @@ the same terms as perl itself. =cut EOF - chmod 0700, "$bin/test"; + chmod 0700, "$script/test.pl"; } sub _mk_create { my $self = shift; my $name = $self->{name}; - my $bin = $self->{bin}; - my $create = IO::File->new("> $bin/create") - or die qq/Could't open "$bin\/create", "$!"/; - print $create <<"EOF"; + my $script = $self->{script}; + $self->mk_file( "$script\/create.pl", <<"EOF"); #!/usr/bin/perl -w use strict; @@ -316,19 +460,19 @@ create - Create a new Catalyst Component =head1 SYNOPSIS -create [options] model|view|controller name [helper] [options] +create.pl [options] model|view|controller name [helper] [options] Options: -help display this help and exits Examples: - perl create controller My::Controller - perl create view My::View - perl create view MyView TT - perl create view TT TT - perl create model My::Model - perl create model SomeDB CDBI dbi:SQLite:/tmp/my.db - perl create model AnotherDB CDBI dbi:Pg:dbname=foo root 4321 + create.pl controller My::Controller + create.pl view My::View + create.pl view MyView TT + create.pl view TT TT + create.pl model My::Model + create.pl model SomeDB CDBI dbi:SQLite:/tmp/my.db + create.pl model AnotherDB CDBI dbi:Pg:dbname=foo root 4321 See also: perldoc Catalyst::Manual @@ -351,82 +495,7 @@ the same terms as perl itself. =cut EOF - chmod 0700, "$bin/create"; -} - -=head3 mk_component - -=cut - -sub mk_component { - my ( $self, $app, $type, $name, $helper, @args ) = @_; - return 0 - if ( $name =~ /[^\w\:]/ || !\$type =~ /^model|m|view|v|controller|c\$/i ); - return 0 if $name =~ /[^\w\:]/; - $type = 'M' if $type =~ /model|m/i; - $type = 'V' if $type =~ /view|v/i; - $type = 'C' if $type =~ /controller|c/i; - $self->{type} = $type; - $self->{name} = $name; - $self->{class} = "$app\::$type\::$name"; - $self->{app} = $app; - - # Class - my $appdir = File::Spec->catdir( split /\:\:/, $app ); - my $path = File::Spec->catdir( $FindBin::Bin, '..', 'lib', $appdir, $type ); - my $file = $name; - if ( $name =~ /\:/ ) { - my @path = split /\:\:/, $name; - $file = pop @path; - $path = File::Spec->catdir( $path, @path ); - mkpath $path; - } - $file = File::Spec->catfile( $path, "$file.pm" ); - $self->{file} = $file; - - # Test - my $dir = File::Spec->catdir( $FindBin::Bin, '..', 't' ); - my $num = '01'; - for my $i (<$dir/*.t>) { - $i =~ /(\d+)[^\/]*.t$/; - my $j = $1 || $num; - $num = $j if $j > $num; - } - $num++; - $num = sprintf '%02d', $num; - my $prefix = $name; - $prefix =~ s/::/_/g; - $prefix = lc $prefix; - my $tname = lc( $num . $type . '_' . $prefix . '.t' ); - $self->{prefix} = $prefix; - $self->{test_dir} = $dir; - $self->{test} = "$dir/$tname"; - - # Helper - if ($helper) { - my $comp = 'Model'; - $comp = 'View' if $type eq 'V'; - $comp = 'Controller' if $type eq 'C'; - my $class = "Catalyst::Helper::$comp\::$helper"; - eval "require $class"; - die qq/Couldn't load helper "$class", "$@"/ if $@; - if ( $class->can('mk_compclass') ) { - $class->mk_compclass( $self, @args ); - } - else { $self->_mk_compclass } - - if ( $class->can('mk_comptest') ) { - $class->mk_comptest( $self, @args ); - } - else { $self->_mk_comptest } - } - - # Fallback - else { - $self->_mk_compclass; - $self->_mk_comptest; - } - return 1; + chmod 0700, "$script/create.pl"; } sub _mk_compclass { @@ -447,9 +516,7 @@ $app->action( ); EOF my $file = $self->{file}; - my $comp = IO::File->new("> $file") - or die qq/Couldn't open "$file", "$!"/; - print $comp <<"EOF"; + return $self->mk_file( "$file", <<"EOF"); package $class; use strict; @@ -489,10 +556,8 @@ sub _mk_comptest { my $class = $self->{class}; my $app = $self->{app}; my $test = $self->{test}; - my $t = IO::File->new("> $test") or die qq/Couldn't open "$test", "$!"/; - if ( $self->{type} eq 'C' ) { - print $t <<"EOF"; + $self->mk_file( "$test", <<"EOF"); use Test::More tests => 3; use_ok( Catalyst::Test, '$app' ); use_ok('$class'); @@ -501,13 +566,33 @@ ok( request('$prefix')->is_success ); EOF } else { - print $t <<"EOF"; + $self->mk_file( "$test", <<"EOF"); use Test::More tests => 1; use_ok('$class'); EOF } } +=head1 HELPERS + +Helpers are classes that provide two methods. + + * mk_compclass - creates the Component class + * mk_comptest - creates the Component test + +So when you call C, create would try to execute +Catalyst::Helper::View::TT->mk_compclass and +Catalyst::Helper::View::TT->mk_comptest. + +See L and L for +examples. + +All helper classes should be under one of the following namespaces. + + Catalyst::Helper::Model:: + Catalyst::Helper::View:: + Catalyst::Helper::Controller:: + =head1 SEE ALSO L, L, L,