MooseX::SimpleConfig(3pm)				User Contributed Perl Documentation				 MooseX::SimpleConfig(3pm)

NAME

       MooseX::SimpleConfig - A Moose role for setting attributes from a simple configfile

SYNOPSIS

	 ## A YAML configfile named /etc/my_app.yaml:
	 foo: bar
	 baz: 123

	 ## In your class
	 package My::App;
	 use Moose;

	 with 'MooseX::SimpleConfig';

	 has 'foo' => (is => 'ro', isa => 'Str', required => 1);
	 has 'baz'  => (is => 'rw', isa => 'Int', required => 1);

	 # ... rest of the class here

	 ## in your script
	 #!/usr/bin/perl

	 use My::App;

	 my $app = My::App->new_with_config(configfile => '/etc/my_app.yaml');
	 # ... rest of the script here

	 ####################
	 ###### combined with MooseX::Getopt:

	 ## In your class
	 package My::App;
	 use Moose;

	 with 'MooseX::SimpleConfig';
	 with 'MooseX::Getopt';

	 has 'foo' => (is => 'ro', isa => 'Str', required => 1);
	 has 'baz'  => (is => 'rw', isa => 'Int', required => 1);

	 # ... rest of the class here

	 ## in your script
	 #!/usr/bin/perl

	 use My::App;

	 my $app = My::App->new_with_options();
	 # ... rest of the script here

	 ## on the command line
	 % perl my_app_script.pl -configfile /etc/my_app.yaml -otherthing 123

DESCRIPTION

       This role loads simple configfiles to set object attributes.  It is based on the abstract role MooseX::ConfigFromFile, and uses Config::Any
       to load your configfile.  Config::Any will in turn support any of a variety of different config formats, detected by the file extension.
       See Config::Any for more details about supported formats.

       Like all MooseX::ConfigFromFile -derived configfile loaders, this module is automatically supported by the MooseX::Getopt role as well,
       which allows specifying "-configfile" on the commandline.

ATTRIBUTES

   configfile
       Provided by the base role MooseX::ConfigFromFile.  You can provide a default configfile pathname like so:

	 has '+configfile' => ( default => '/etc/myapp.yaml' );

       You can pass an array of filenames if you want, but as usual the array has to be wrapped in a sub ref.

	 has '+configfile' => ( default => sub { [ '/etc/myapp.yaml', '/etc/myapp_local.yml' ] } );

       Config files are trivially merged at the top level, with the right-hand files taking precedence.

CLASS METHODS

   new_with_config
       Provided by the base role MooseX::ConfigFromFile.  Acts just like regular "new()", but also accepts an argument "configfile" to specify the
       configfile from which to load other attributes.	Explicit arguments to "new_with_config" will override anything loaded from the configfile.

   get_config_from_file
       Called internally by either "new_with_config" or MooseX::Getopt's "new_with_options".  Invokes Config::Any to parse "configfile".

AUTHOR

       Brandon L. Black, <blblack@gmail.com>

LICENSE

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

perl v5.14.2							    2012-06-19						 MooseX::SimpleConfig(3pm)