Mark Gardner

NAME

MouseX::SimpleConfig - A Mouse role for setting attributes from a simple configfile

VERSION

version 0.11

SYNOPSIS

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

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

  with 'MouseX::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 MouseX::Getopt:

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

  with 'MouseX::SimpleConfig';
  with 'MouseX::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 MouseX::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 MouseX::ConfigFromFile -derived configfile loaders, this module is automatically supported by the MouseX::Getopt role as well, which allows specifying -configfile on the commandline.

ATTRIBUTES

configfile

Provided by the base role MouseX::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.

METHODS

new_with_config

Class method provided by the base role MouseX::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

Class method called internally by either new_with_config or MouseX::Getopt's new_with_options. Invokes Config::Any to parse configfile.

BUGS

Please report any bugs or feature requests on the bugtracker website http://github.com/mjg/MouseX-SimpleConfig/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHORS

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

  • Mark Gardner <mjgardner@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Infinity Interactive.

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




Hosting generously
sponsored by Bytemark