made the local suffix overrideable as per robkinyon's suggestion

[catagits/Catalyst-Plugin-ConfigLoader.git] / lib / Catalyst / Plugin / ConfigLoader.pm

diff --git a/lib/Catalyst/Plugin/ConfigLoader.pm b/lib/Catalyst/Plugin/ConfigLoader.pm
index fc0b9a1..ab332da 100644 (file)
--- a/lib/Catalyst/Plugin/ConfigLoader.pm
+++ b/lib/Catalyst/Plugin/ConfigLoader.pm
@@ -7,7 +7,7 @@ use NEXT;
 use Module::Pluggable::Object ();\r
 use Data::Visitor::Callback;\r
 \r
-our $VERSION = '0.11';\r
+our $VERSION = '0.12';\r
 \r
 =head1 NAME\r
 \r
@@ -48,6 +48,7 @@ loaded, set the C<config()> section.
 sub setup {\r
     my $c = shift;\r
     my( $path, $extension ) = $c->get_config_path;\r
+    my $suffix = $c->get_config_local_suffix;\r
 \r
     my $finder = Module::Pluggable::Object->new(\r
         search_path => [ __PACKAGE__ ],\r
@@ -62,7 +63,7 @@ sub setup {
             push @files, $path;\r
         }\r
         else {\r
-            @files = map { ( "$path.$_", "${path}_local.$_" ) } @extensions;\r
+            @files = map { ( "$path.$_", "${path}_${suffix}.$_" ) } @extensions;\r
         }\r
 \r
         for( @files ) {\r
@@ -94,7 +95,7 @@ ConfigLoader provides a default finalize_config method which
 walks through the loaded config hash and replaces any strings\r
 beginning containing C<__HOME__> with the full path to\r
 app's home directory (i.e. C<$c-E<gt>path_to('')> ).\r
-You can also use C<__path_to('foo/bar')__> which translates to\r
+You can also use C<__path_to(foo/bar)__> which translates to\r
 C<$c-E<gt>path_to('foo', 'bar')> \r
 \r
 =cut\r
@@ -123,9 +124,9 @@ The order of preference is specified as:
 \r
 =item * C<$ENV{ MYAPP_CONFIG }>\r
 \r
-=item * C<$c->config->{ file }>\r
+=item * C<$c-E<gt>config-E<gt>{ file }>\r
 \r
-=item * C<$c->path_to( $application_prefix )>\r
+=item * C<$c-E<gt>path_to( $application_prefix )>\r
 \r
 =back\r
 \r
@@ -152,6 +153,35 @@ sub get_config_path {
     return( $path, $extension );\r
 }\r
 \r
+=head2 get_config_local_suffix\r
+\r
+Determines the suffix of files used to override the main config. By default\r
+this value is C<local>, but it can be specified in the following order of preference:\r
+\r
+=over 4\r
+\r
+=item * C<$ENV{ CATALYST_CONFIG_LOCAL_SUFFIX }>\r
+\r
+=item * C<$ENV{ MYAPP_CONFIG_LOCAL_SUFFIX }>\r
+\r
+=item * C<$c-E<gt>config-E<gt>{ config_local_suffix }>\r
+\r
+\r
+=back\r
+\r
+=cut\r
+\r
+sub get_config_local_suffix {\r
+    my $c       = shift;\r
+    my $appname = ref $c || $c;\r
+    my $suffix  = $ENV{ CATALYST_CONFIG_LOCAL_SUFFIX }\r
+        || $ENV{ Catalyst::Utils::class2env( $appname ) . '_CONFIG_LOCAL_SUFFIX' }\r
+        || $c->config->{ config_local_suffix }\r
+        || 'local';\r
+\r
+    return $suffix;\r
+}\r
+\r
 sub _fix_syntax {\r
     my $config     = shift;\r
     my @components = (\r