X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=lib%2FCatalyst.pm;h=90d158af0d91d153a8bb5af8d6e7deada777bc50;hp=3182f9489df717954e3ac92551aa5b51813f55ff;hb=b5c7bbe3fa0325dca62c6c0eb5dcfc7c015e3c59;hpb=0556eb49954590b794221ed3a033565c85dbeb32 diff --git a/lib/Catalyst.pm b/lib/Catalyst.pm index 3182f94..90d158a 100644 --- a/lib/Catalyst.pm +++ b/lib/Catalyst.pm @@ -1,13 +1,13 @@ package Catalyst; use strict; -use base 'Class::Data::Inheritable'; +use base 'Catalyst::Base'; use UNIVERSAL::require; use Catalyst::Log; -__PACKAGE__->mk_classdata($_) for qw/_config log/; +__PACKAGE__->mk_classdata($_) for qw/engine log/; -our $VERSION = '4.30'; +our $VERSION = '5.00'; our @ISA; =head1 NAME @@ -40,23 +40,19 @@ Catalyst - The Elegant MVC Web Application Framework use Catalyst qw/-Debug -Engine=CGI/; - __PACKAGE__->action( '!default' => sub { $_[1]->res->output('Hello') } ); + sub default : Private { $_[1]->res->output('Hello') } ); - __PACKAGE__->action( - 'index.html' => sub { - my ( $self, $c ) = @_; - $c->res->output('Hello'); - $c->forward('_foo'); - } - ); + sub index : Path('/index.html') { + my ( $self, $c ) = @_; + $c->res->output('Hello'); + $c->forward('_foo'); + } - __PACKAGE__->action( - '/^product[_]*(\d*).html$/' => sub { - my ( $self, $c ) = @_; - $c->stash->{template} = 'product.tt'; - $c->stash->{product} = $c->req->snippets->[0]; - } - ); + sub product : Regex('/^product[_]*(\d*).html$/') { + my ( $self, $c ) = @_; + $c->stash->{template} = 'product.tt'; + $c->stash->{product} = $c->req->snippets->[0]; + } See also L @@ -70,7 +66,7 @@ The key concept of Catalyst is DRY (Don't Repeat Yourself). See L for more documentation. Catalyst plugins can be loaded by naming them as arguments to the "use Catalyst" statement. -Omit the C prefix from the plugin name, +Omit the C prefix from the plugin name, so C becomes C. use Catalyst 'My::Module'; @@ -125,39 +121,41 @@ Returns a hashref containing your applications settings. =cut -sub config { - my $self = shift; - $self->_config( {} ) unless $self->_config; - if ( $_[0] ) { - my $config = $_[1] ? {@_} : $_[0]; - while ( my ( $key, $val ) = each %$config ) { - $self->_config->{$key} = $val; - } - } - return $self->_config; -} - sub import { my ( $self, @options ) = @_; my $caller = caller(0); - # Class - { + unless ( $caller->isa($self) ) { no strict 'refs'; - *{"$caller\::handler"} = - sub { Catalyst::Engine::handler( $caller, @_ ) }; push @{"$caller\::ISA"}, $self; } - $self->log( Catalyst::Log->new ); + + if ( $caller->engine ) { + return; # Catalyst is allready initialized + } + + unless ( $caller->log ) { + $caller->log( Catalyst::Log->new ); + } + + if ( $ENV{CATALYST_DEBUG} || $ENV{ uc($caller) . '_DEBUG' } ) { + no strict 'refs'; + *{"$caller\::debug"} = sub { 1 }; + $caller->log->debug('Debug messages enabled'); + } # Options my $engine = - $ENV{MOD_PERL} ? 'Catalyst::Engine::Apache' : 'Catalyst::Engine::CGI'; + $ENV{MOD_PERL} + ? 'Catalyst::Engine::Apache' + : 'Catalyst::Engine::CGI'; + + my @plugins; foreach (@options) { if (/^\-Debug$/) { - no warnings; + next if $caller->debug; no strict 'refs'; - *{"$self\::debug"} = sub { 1 }; + *{"$caller\::debug"} = sub { 1 }; $caller->log->debug('Debug messages enabled'); } elsif (/^-Engine=(.*)$/) { $engine = "Catalyst::Engine::$1" } @@ -171,26 +169,45 @@ sub import { $caller->log->error(qq/Couldn't load plugin "$plugin", "$@"/); } else { - $caller->log->debug(qq/Loaded plugin "$plugin"/) - if $caller->debug; + push @plugins, " $plugin"; no strict 'refs'; push @{"$caller\::ISA"}, $plugin; } } } + $caller->log->debug( 'Loaded plugins', @plugins ) + if ( @plugins && $caller->debug ); # Engine $engine = "Catalyst::Engine::$ENV{CATALYST_ENGINE}" if $ENV{CATALYST_ENGINE}; + $engine->require; die qq/Couldn't load engine "$engine", "$@"/ if $@; { no strict 'refs'; push @{"$caller\::ISA"}, $engine; } + $caller->engine($engine); $caller->log->debug(qq/Loaded engine "$engine"/) if $caller->debug; } +=item $c->engine + +Contains the engine class. + +=item $c->log + +Contains the logging object. Unless it is already set Catalyst sets this up with a +C object. To use your own log class: + + $c->log( MyLogger->new ); + $c->log->info("now logging with my own logger!"); + +Your log class should implement the methods described in the C +man page. + + =back =head1 SUPPORT @@ -203,7 +220,7 @@ Mailing-Lists: http://lists.rawmode.org/mailman/listinfo/catalyst http://lists.rawmode.org/mailman/listinfo/catalyst-dev - + =head1 SEE ALSO L, L, L, @@ -216,9 +233,9 @@ Sebastian Riedel, C =head1 THANK YOU Andrew Ford, Andrew Ruthven, Christian Hansen, Christopher Hicks, -Danijel Milicevic, David Naughton, Gary Ashton Jones, Jesse Sheidlower, -Johan Lindstrom, Marcus Ramberg, Tatsuhiko Miyagawa and all the others -who've helped. +Dan Sully, Danijel Milicevic, David Naughton, Gary Ashton Jones, +Jesse Sheidlower, Johan Lindstrom, Marcus Ramberg, Tatsuhiko Miyagawa +and all the others who've helped. =head1 LICENSE