Marcel Grünauer > Property-Lookup-1.101400 > Property::Lookup::File

Download:
Property-Lookup-1.101400.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 1.101400   Source  

NAME ^

Property::Lookup::File - File-based property lookup layer

VERSION ^

version 1.101400

SYNOPSIS ^

    use Property::Lookup;

    my %opt;
    GetOptions(\%opt, '...');

    my $config = Property::Lookup->new;
    $config->add_layer(file => 'conf.yaml');
    $config->add_layer(getopt => \%opt);
    $config->default_layer({
        foo => 23,
    });

    my $foo = $config->foo;

    # ...

    use Property::Lookup::Local;
    local %Property::Lookup::Local::opt = (bar => 'baz');

DESCRIPTION ^

This class implements a file-based property lookup layer. It subclasses Property::Lookup::Hash but implements a custom init method - see its documentation.

METHODS ^

init

    my $layer = Property::Lookup::File->new(filename => 'conf.yaml');

If a filename has been set, it uses YAML to read that file. Before parsing it, certain substitutions are performed:

The word SELF is replaced by the path to the configuration file. This way file names relative to the configuration file can be specified.

A dollar sign, followed by an identifier - one or more word characters - is replaced by its equivalent value from the %ENV hash.

Normally you will use this layer via the add_layer() method from Property::Lookup.

INSTALLATION ^

See perlmodinstall for information and options on installing Perl modules.

BUGS AND LIMITATIONS ^

No bugs have been reported.

Please report any bugs or feature requests through the web interface at http://rt.cpan.org/Public/Dist/Display.html?Name=Property-Lookup.

AVAILABILITY ^

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see http://search.cpan.org/dist/Property-Lookup/.

The development version lives at http://github.com/hanekomu/Property-Lookup/. Instead of sending patches, please fork this project using the standard git and github infrastructure.

AUTHOR ^

  Marcel Gruenauer <marcel@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2009 by Marcel Gruenauer.

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

syntax highlighting: