NAME

       Catalyst::Utils - The Catalyst Utils

SYNOPSIS

       See Catalyst.

DESCRIPTION

       Catalyst Utilities.

METHODS

   appprefix($class)
           MyApp::Foo becomes myapp_foo

   class2appclass($class);
           MyApp::Controller::Foo::Bar becomes MyApp
           My::App::Controller::Foo::Bar becomes My::App

   class2classprefix($class);
           MyApp::Controller::Foo::Bar becomes MyApp::Controller
           My::App::Controller::Foo::Bar becomes My::App::Controller

   class2classsuffix($class);
           MyApp::Controller::Foo::Bar becomes Controller::Foo::Bar

   class2env($class);
       Returns the environment name for class.

           MyApp becomes MYAPP
           My::App becomes MY_APP

   class2prefix( $class, $case );
       Returns the uri prefix for a class. If case is false the prefix is converted to lowercase.

           My::App::Controller::Foo::Bar becomes foo/bar

   class2tempdir( $class [, $create ] );
       Returns a tempdir for a class. If create is true it will try to create the path.

           My::App becomes /tmp/my/app
           My::App::Controller::Foo::Bar becomes /tmp/my/app/c/foo/bar

   home($class)
       Returns home directory for given class.

   dist_indicator_file_list
       Returns a list of files which can be tested to check if you're inside a CPAN distribution
       which is not yet installed.

       These are:

       Makefile.PL
       Build.PL
       dist.ini
       cpanfile

   prefix($class, $name);
       Returns a prefixed action.

           MyApp::Controller::Foo::Bar, yada becomes foo/bar/yada

   request($uri)
       Returns an HTTP::Request object for a uri.

   ensure_class_loaded($class_name, \%opts)
       Loads the class unless it already has been loaded.

       If $opts{ignore_loaded} is true always tries the require whether the package already
       exists or not. Only pass this if you're either (a) sure you know the file exists on disk
       or (b) have code to catch the file not found exception that will result if it doesn't.

   merge_hashes($hashref, $hashref)
       Base code to recursively merge two hashes together with right-hand precedence.

   env_value($class, $key)
       Checks for and returns an environment value. For instance, if $key is 'home', then this
       method will check for and return the first value it finds, looking at $ENV{MYAPP_HOME} and
       $ENV{CATALYST_HOME}.

   term_width
       Try to guess terminal width to use with formatting of debug output

       All you need to get this work, is:

       1) Install Term::Size::Any, or

       2) Export $COLUMNS from your shell.

       (Warning to bash users: 'echo $COLUMNS' may be showing you the bash variable, not
       $ENV{COLUMNS}. 'export COLUMNS=$COLUMNS' and you should see that 'env' now lists COLUMNS.)

       As last resort, default value of 80 chars will be used.

   resolve_namespace
       Method which adds the namespace for plugins and actions.

         __PACKAGE__->setup(qw(MyPlugin));

         # will load Catalyst::Plugin::MyPlugin

   build_middleware (@args)
       Internal application that converts a single middleware definition (see "psgi_middleware"
       in Catalyst) into an actual instance of middleware.

   apply_registered_middleware ($psgi)
       Given a $psgi reference, wrap all the "registered_middlewares" in Catalyst around it and
       return the wrapped version.

       This exists to deal with the fact Catalyst registered middleware can be either an object
       with a wrap method or a coderef.

AUTHORS

       Catalyst Contributors, see Catalyst.pm

COPYRIGHT

       This library is free software. You can redistribute it and/or modify it under the same
       terms as Perl itself.