lib/Config/Any/Perl.pm

   1 package Config::Any::Perl;
   2
   3 use strict;
   4 use warnings;
   5
   6 use base 'Config::Any::Base';
   7 use File::Spec;
   8 use Cwd ();
   9
  10 =head1 NAME
  11
  12 Config::Any::Perl - Load Perl config files
  13
  14 =head1 DESCRIPTION
  15
  16 Loads Perl files. Example:
  17
  18     {
  19         name => 'TestApp',
  20         'Controller::Foo' => {
  21             foo => 'bar'
  22         },
  23         'Model::Baz' => {
  24             qux => 'xyzzy'
  25         }
  26     }
  27
  28 =head1 METHODS
  29
  30 =head2 extensions( )
  31
  32 return an array of valid extensions (C<pl>, C<perl>).
  33
  34 =cut
  35
  36 sub extensions {
  37     return qw( pl perl );
  38 }
  39
  40 =head2 load( $file )
  41
  42 Attempts to load C<$file> as a Perl file.
  43
  44 =cut
  45
  46 sub load {
  47     my $class = shift;
  48     my $file  = shift;
  49
  50     my( $exception, $content );
  51     {
  52         local $@;
  53         # previously this would load based on . being in @INC, and wouldn't
  54         # trigger taint errors even if '.' probably should have been considered
  55         # tainted.  untaint for backwards compatibility.
  56         my ($cwd) = Cwd::cwd() =~ /\A(.*)\z/s;
  57         $content = do File::Spec->rel2abs($file, $cwd);
  58         $exception = $@ || $!
  59             if !defined $content;
  60     }
  61     die $exception if $exception;
  62
  63     return $content;
  64 }
  65
  66 =head1 AUTHOR
  67
  68 Brian Cassidy <bricas@cpan.org>
  69
  70 =head1 COPYRIGHT AND LICENSE
  71
  72 Copyright 2006-2016 by Brian Cassidy
  73
  74 This library is free software; you can redistribute it and/or modify
  75 it under the same terms as Perl itself.
  76
  77 =head1 SEE ALSO
  78
  79 =over 4
  80
  81 =item * L<Catalyst>
  82
  83 =item * L<Config::Any>
  84
  85 =back
  86
  87 =cut
  88
  89 1;