lib/Catalyst/Plugin/ConfigLoader/YAML.pm

   1 package Catalyst::Plugin::ConfigLoader::YAML;\r
   2 \r
   3 use strict;\r
   4 use warnings;\r
   5 \r
   6 =head1 NAME\r
   7 \r
   8 Catalyst::Plugin::ConfigLoader::YAML - Load YAML config files\r
   9 \r
  10 =head1 DESCRIPTION\r
  11 \r
  12 Loads YAML files. Example:\r
  13 \r
  14     ---\r
  15     name: TestApp\r
  16     Controller::Foo:\r
  17         foo: bar\r
  18 \r
  19 =head1 METHODS\r
  20 \r
  21 =head2 extensions( )\r
  22 \r
  23 return an array of valid extensions (C<yml>, C<yaml>).\r
  24 \r
  25 =cut\r
  26 \r
  27 sub extensions {\r
  28     return qw( yml yaml );\r
  29 }\r
  30 \r
  31 =head2 load( $file )\r
  32 \r
  33 Attempts to load C<$file> as a YAML file.\r
  34 \r
  35 =cut\r
  36 \r
  37 sub load {\r
  38     my $class = shift;\r
  39     my $file  = shift;\r
  40 \r
  41     eval { require YAML::Syck; };\r
  42     if( $@ ) {\r
  43         require YAML;\r
  44         return YAML::LoadFile( $file );\r
  45     }\r
  46     else {\r
  47         open( my $fh, $file ) or die $!;\r
  48         my $content = do { local $/; <$fh> };\r
  49         close $fh;\r
  50         return YAML::Syck::Load( $content );\r
  51     }\r
  52 }\r
  53 \r
  54 =head1 AUTHOR\r
  55 \r
  56 =over 4 \r
  57 \r
  58 =item * Brian Cassidy E<lt>bricas@cpan.orgE<gt>\r
  59 \r
  60 =back\r
  61 \r
  62 =head1 COPYRIGHT AND LICENSE\r
  63 \r
  64 Copyright 2006 by Brian Cassidy\r
  65 \r
  66 This library is free software; you can redistribute it and/or modify\r
  67 it under the same terms as Perl itself. \r
  68 \r
  69 =head1 SEE ALSO\r
  70 \r
  71 =over 4 \r
  72 \r
  73 =item * L<Catalyst>\r
  74 \r
  75 =item * L<Catalyst::Plugin::ConfigLoader>\r
  76 \r
  77 =back\r
  78 \r
  79 =cut\r
  80 \r
  81 1;