Compleated POD documentation. Rewrited example.

Also added condition to skip directories durring configuration
files processing.

Author: Eugene Ponizovsky

README

@@ -12,7 +12,7 @@ To install this module type the following:
 
 DESCRIPTION
 
-Config::Processor is the cascading configuration files parser with file inclusions
+Config::Processor is the cascading configuration files processor with file inclusions
 and variables interpolation support.
 
 AUTHOR
@@ -27,4 +27,3 @@ All rights reserved.
 This module is free software; you can redistribute it and/or modify it under
 the same terms as Perl itself.
 
-

examples/etc/db.json

@@ -1,33 +1,31 @@
-{ "db": {
-    "generic": {
-      "port":   "5432",
-      "dbname": "main",
-      "options": {
-        "PrintWarn":      0,
-        "PrintError":     0,
-        "RaiseError":     1,
-        "pg_enable_utf8": 1
-      }
-    },
-
-    "master": {
-      "underlay": { "var": "db.generic" },
-      "host":     "master-db.myservice.com"
-    },
+{ "myapp": {
+    "db": {
+      "connectors": {
+        "underlay": [
+          { "include": "db_connectors/default.yml" },
+          { "include": "db_connectors/default_test.yml" }
+        ],
 
-    "slave": {
-      "underlay": { "var": "db.generic" },
-      "host":     "slave-db.myservice.com"
-    },
+        "stat_master": {
+          "underlay": { "var": "myapp.db.connectors.default" },
+          "host":     "stat-master.mydb.com",
+          "username": "stat_writer",
+          "password": "stat_writer_pass"
+        },
 
-    "test": {
-      "underlay": { "var": "db.generic" },
-      "host":     "test-db.myservice.com"
-    },
+        "stat_slave": {
+          "underlay": { "var": "myapp.db.connectors.default" },
+          "host":     "stat-slave.mydb.com",
+          "username": "stat_reader",
+          "password": "stat_reader_pass"
+        },
 
-    "overlay": [
-      { "include": "db_production.yml" },
-      { "include": "db_test.json" }
-    ]
+        "test": {
+          "underlay": { "var": "myapp.db.connectors.default_test" },
+          "username": "test",
+          "password": "test_pass"
+        }
+      }
+    }
   }
 }

examples/etc/db_connectors/default.yml

@@ -0,0 +1,7 @@
+default:
+  port:   "1234"
+  dbname: 'stat'
+  options:
+    PrintWarn:  0
+    PrintError: 0
+    RaiseError: 1

examples/etc/db_connectors/default_test.yml

@@ -0,0 +1,3 @@
+default_test:
+  underlay: { var: myapp.db.connectors.default }
+  host: 'stat-test.mydb.com'

examples/etc/db_production.yml

@@ -0,0 +1,11 @@
+myapp:
+  media_formats: [ "images", "audio", "video" ]
+
+  dirs:
+    root_dir: "/myapp"
+    templates_dir: "${myapp.dirs.root_dir}/templates"
+    sessions_dir: "${myapp.dirs.root_dir}/sessions"
+    media_dirs:
+      - "${myapp.dirs.root_dir}/medis/${myapp.media_formats.0}"
+      - "${myapp.dirs.root_dir}/media/${myapp.media_formats.1}"
+      - "${myapp.dirs.root_dir}/media/${myapp.media_formats.2}"