NAME

       Poet::Manual::Configuring - Built-in Poet configuration options

DESCRIPTION

       This is a list of configuration keys used by Poet itself. These may be placed in any Poet
       conf file, e.g. "local.cfg" or "conf/global/*.cfg".

       Entries like "foo.bar" can be listed either in dot notation

           foo.bar: 5

       or as part of a hash:

           foo:
              bar: 5

       See Dot notation for details.

       cache
           The entire hash under this entry will be passed to Poet::Cache->config(). See
           Poet::Cache for examples. e.g.

              cache:
                 defaults:
                    expires_variance: 0.2
                 storage:
                    file:
                       driver: File
                       root_dir: ${root}/data/cache
                    memcached:
                       driver: Memcached
                       servers: ["10.0.0.15:11211", "10.0.0.15:11212"]
                       compress_threshold: 4096
                 namespace:
                    /some/component:       { storage: file, expires_in: 5min }
                    /some/other/component: { storage: memcached, expires_in: 1h }
                    Some::Library:         { storage: memcached, expires_in: 10min }

       env.bin_dir, env.comps_dir, etc.
           These entries affect what is returned from "$poet->bin_dir", "$poet->bin_path",
           "$poet->comps_dir", etc., and thus where various Poet resources are kept. See
           Poet::Environment. For example, to move data and logs into external directories
           outside the environment:

               env:
                 data_dir: /some/external/data/dir
                 logs_dir: /some/external/logs/dir

       log.defaults, log.category
           Specify the log level, output location, and layout string for logging, in the default
           case and for particular categories respectively. See Poet::Log for examples. e.g.

               log:
                 defaults:
                   level: info
                   output: poet.log
                   layout: "%d{dd/MMM/yyyy:HH:mm:ss.SS} [%p] %c - %m - %F:%L - %P%n"
                 category:
                   CHI:
                     level: debug
                     output: chi.log
                     layout: "%d{dd/MMM/yyyy:HH:mm:ss.SS} %m - %P%n"
                   MyApp::Foo:
                     output: stdout

       log.log4perl_conf
           Bypass Poet's simplified logging configuration and specify a log4perl conf file
           directly. e.g.

               log:
                 log4perl_conf: /path/to/log4perl.conf

       mason
           The hash under this entry will be treated as options that are passed to "Mason->new"
           for the main Mason instance, overriding any default options.  See Poet::Mason. e.g.

               mason:
                 static_source: 1
                 static_source_touch_file: ${root}/data/purge.dat

       server.default_content_type
           Content type for requests that don't explicitly set one. Defaults to "text/html".

       server.host
           The IP address to listen on.

       server.load_modules
           A list of modules to load on server startup, e.g.

               server.load_modules:
                  - DBI
                  - List::Util
                  - MyApp::Foo
                  - MyApp::Bar

       server.port
           The port to listen on.

SEE ALSO

       Poet

AUTHOR

       Jonathan Swartz <swartz@pobox.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Jonathan Swartz.

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