MooseX::SimpleConfig - A Moose role for setting attributes from a simple configfile
## 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
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.
-configfile
Provided by the base role MooseX::ConfigFromFile. You can provide a default configfile pathname like so:
has +configfile ( default => '/etc/myapp.yaml' );
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.
new()
configfile
new_with_config
Called internally by either new_with_config or MooseX::Getopt's new_with_options. Invokes Config::Any to parse configfile.
new_with_options
Brandon L. Black, <blblack@gmail.com>
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install MooseX::SimpleConfig, copy and paste the appropriate command in to your terminal.
cpanm
cpanm MooseX::SimpleConfig
CPAN shell
perl -MCPAN -e shell install MooseX::SimpleConfig
For more information on module installation, please visit the detailed CPAN module installation guide.