NAME

    Mojolicious::Plugin::Nour::Config - Robustly imports config from a
    ./config sub-directory loaded with nested YAML files

VERSION

    version 0.09

USAGE

    Place your YAML configuration files under a ./config sub-directory from
    your mojo app's home directory. There's an example in the package
    tarball you can look at, but roughly something like this:

         $ find ./config/
        ./config/
        ./config/application
        ./config/application/nested
        ./config/application/nested/example.yml
        ./config/application.yml
        ./config/database
        ./config/database/private
        ./config/database/private/production.yml
        ./config/database/private/README.md
        ./config/database/config.yml

    Somewhere in your startup routine, include something like this:

        $self->plugin( 'Mojolicious::Plugin::Nour::Config', {
            -base => 'config'
            , -helpers => 1 # adds some unrelated helper methods i wrote
            , -silence => 1 # turning this on disables the config dump on startup in the debug log
        } );

    On application startup, if you haven't turned the silence option on you
    can see your configuration from the debug log:

        [Tue Apr  8 12:10:21 2014] [debug] config
        {
          'application' => {
            'nested' => {
              'example' => {
                'wow' => 'amazing'
              }
            },
            'secret' => 'don\'t tell anyone'
          },
          'database' => {
            'default' => {
              'database' => 'production',
              'option' => {
                'AutoCommit' => '1',
                'PrintError' => '1',
                'RaiseError' => '1',
                'pg_bool_tf' => '0',
                'pg_enable_utf8' => '1'
              },
              'password' => 'nour',
              'username' => 'nour'
            },
            'development' => {
              'dsn' => 'dbi:Pg:dbname=nourdb_dev',
              'password' => 'sharabash',
              'username' => 'nour'
            },
            'production' => {
              'dsn' => 'dbi:Pg:dbname=nourdb_prod;host=secret.com',
              'password' => 'secret',
              'username' => 'override'
            }
          }
        }

    Neat, right? Yeah.

SUPPORT

 Bugs / Feature Requests

    Please report any bugs or feature requests through the issue tracker at
    https://github.com/sharabash/mojolicious-plugin-nour-config/issues. You
    will be notified automatically of any progress on your issue.

 Source Code

    This is open source software. The code repository is available for
    public review and contribution under the terms of the license.

    https://github.com/sharabash/mojolicious-plugin-nour-config

      git clone git://github.com/sharabash/mojolicious-plugin-nour-config.git

AUTHOR

    Nour Sharabash <amirite@cpan.org>

CONTRIBUTOR

    Nour Sharabash <nour.sharabash@gmail.com>

COPYRIGHT AND LICENSE

    This software is copyright (c) 2014 by Nour Sharabash.

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