NAME

Catalyst::Plugin::ConfigurablePathTo - Provides a configurable path_to()

VERSION

Version 0.01

SYNOPSIS

This plugin provides a way to have generic configurable paths in Catalyst.

# in myapp.yml

path_to:

  profiles: /usr/local/profiles

  tempfiles: /tmp/myapp_tempfiles

  ...

# in some Catalyst controller

  # 'profiles' is defined in the config file, so you'll
  # get '/usr/local/profiles' back
  my $profiles_path = $c->path_to('profiles');

  # it also correctly creates the paths, using Path::Class
  # you'll get '/tmp/myapp_tempfiles/file.tmp' back
  my $temp_path = $c->path_to('tempfiles', 'file.tmp');

  # performs as the original path_to() would if it's not defined
  # in the config file
  my #other_path = $c->path_to('other');

METHODS

$c->path_to( @path )

If $path[0] represents an already configured path in the application config file, $path[0] is replaced with the configured path and @path is merged into a Path::Class object.

Otherwise, @path is merged with $c->config->{home} into a Path::Class object.

AUTHOR

Nilson Santos Figueiredo Júnior, <nilsonsfj at cpan.org>

BUGS

Please report any bugs or feature requests directly to the author. If you ask nicely it will probably get fixed or implemented.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Catalyst::Plugin::ConfigurablePathTo

You can also look for information at:

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Catalyst-Plugin-ConfigurablePathTo

• CPAN Ratings

  http://cpanratings.perl.org/d/Catalyst-Plugin-ConfigurablePathTo

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Catalyst-Plugin-ConfigurablePathTo

• Search CPAN

  http://search.cpan.org/dist/Catalyst-Plugin-ConfigurablePathTo

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2006 Nilson Santos Figueiredo Junior, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.