X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=lib%2FCatalyst%2FUtils.pm;h=1bccecba7ada144b97fa0d5a216598843458b8c2;hp=3f594e6a42d456c6ec33cfed4228f5f36a7277cf;hb=81436df99bdb4a0afd7367fb946c5481b483919d;hpb=9c7b676881de2255b45fdab5bfb71f58a5e6d236 diff --git a/lib/Catalyst/Utils.pm b/lib/Catalyst/Utils.pm index 3f594e6..1bccecb 100644 --- a/lib/Catalyst/Utils.pm +++ b/lib/Catalyst/Utils.pm @@ -10,7 +10,6 @@ use Cwd; use Class::Load 'is_class_loaded'; use String::RewritePrefix; use Class::Load (); - use namespace::clean; =head1 NAME @@ -384,26 +383,43 @@ that 'env' now lists COLUMNS.) As last resort, default value of 80 chars will be used. +Calling C with a true value will cause it to be recalculated; you +can use this to cause it to get recalculated when your terminal is resized like +this + + $SIG{WINCH} = sub { Catalyst::Utils::term_width(1) }; + =cut my $_term_width; sub term_width { + my $force_reset = shift; + + undef $_term_width if $force_reset; + return $_term_width if $_term_width; my $width; eval ' - require Term::Size::Any; - my ($columns, $rows) = Term::Size::Any::chars; - $width = $columns; - 1; + use Term::Size::Any; + ($width) = Term::Size::Any::chars; + 1; ' or do { + if($@ =~m[Can't locate Term/Size/Any.pm]) { + warn "Term::Size::Any is not installed, can't autodetect terminal column width\n"; + } else { + warn "There was an error trying to detect your terminal size: $@\n"; + } + warn 'Trouble trying to detect your terminal size, looking at $ENV{COLUMNS}'."\n"; $width = $ENV{COLUMNS} if exists($ENV{COLUMNS}) && $ENV{COLUMNS} =~ m/^\d+$/; }; - $width = 80 unless ($width && $width >= 80); + do { + warn "Cannot determine desired terminal width, using default of 80 columns\n"; + $width = 80 } unless ($width && $width >= 80); return $_term_width = $width; } @@ -486,6 +502,8 @@ sub apply_registered_middleware { return $new_psgi; } + + =head1 PSGI Helpers Utility functions to make it easier to work with PSGI applications under Catalyst @@ -505,7 +523,7 @@ Localize C<$env> under the current controller path prefix: my $env = $c->Catalyst::Utils::env_at_path_prefix; } -Assuming you have a requst like GET /user/name: +Assuming you have a request like GET /user/name: In the example case C<$env> will have PATH_INFO of '/name' instead of '/user/name' and SCRIPT_NAME will now be '/user'. @@ -530,7 +548,7 @@ sub env_at_path_prefix { =head2 env_at_action -Localize C<$env> under the current controller path prefix: +Localize C<$env> under the current action namespace. package MyApp::Controller::User; @@ -543,11 +561,16 @@ Localize C<$env> under the current controller path prefix: my $env = $c->Catalyst::Utils::env_at_action; } -Assuming you have a requst like GET /user/name: +Assuming you have a request like GET /user/name: In the example case C<$env> will have PATH_INFO of '/' instead of '/user/name' and SCRIPT_NAME will now be '/user/name'. +Alternatively, assuming you have a request like GET /user/name/foo: + +In this example case C<$env> will have PATH_INFO of '/foo' instead of +'/user/name/foo' and SCRIPT_NAME will now be '/user/name'. + This is probably a common case where you want to mount a PSGI application under an action but let the Args fall through to the PSGI app. @@ -575,7 +598,7 @@ sub env_at_action { =head2 env_at_request_uri -Localize C<$env> under the current controller path prefix: +Localize C<$env> under the current request URI: package MyApp::Controller::User; @@ -588,7 +611,7 @@ Localize C<$env> under the current controller path prefix: my $env = $c->Catalyst::Utils::env_at_request_uri } -Assuming you have a requst like GET /user/name/hello: +Assuming you have a request like GET /user/name/hello: In the example case C<$env> will have PATH_INFO of '/' instead of '/user/name' and SCRIPT_NAME will now be '/user/name/hello'.