The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Toader-0.4.0
River stage zero No dependents
++
/ Toader::Config

NAME

Toader::Config - Represents the Toader config.

VERSION

Version 0.0.1

METHODS

new

This initiates the object.

    my $foo = Toader::Config->new;
    if ( $foo->error ){
        warn('error:'.$foo->error.': '.$foo->errorString);
    }

getConfig

This returns the Config::Tiny object storing the Toader config.

There is no need to do any error checking as long as Toader new suceeded with out issue.

    my $config=$foo->getConfig;

getConfigFile

listSections

This returns a list of sections.

    my @sections=$foo->listSections;

listVariables

This returns a list of variables for a section.

    my @variables=$foo->listVariables( $section );
    if ( $foo->error ){
        warn( 'error:'.$foo->error.': '.$foo->errorString );
    }

valueDel

This deletes a specified value.

Two arguments are taken. The first is the section. If not specified, "_" is used. The second and required one is the variable name.

As long as the section exists, which it always will for '_', and a variable name is specified, this won't error.

        $foo->valueDel( $section, $variable );

valueGet

This returns a value that has been set for a variable.

Two arguments are taken. The first is the section. If not specified, "_" is used. The second and required one is the variable name.

As long as the section exists, which it always will for '_', and a variable name is specified, this won't error.

If a value does not exist, undef is returned.

    my $value=$foo->valueGet( $section, $variable );

valueSet

This sets a new value for the config.

Third arguments are taken. The first is the section. If not specified, "_" is used. The second and required one is the variable name. The third and required is the the value.

If the specified section does not exist, a new one will be created.

Neither the section or variable name can match /[\t \n\=\#\;]/.

    my $value=$foo->valueSet( $section, $variable, $value );

write

Writes the config out to the Toader config file.

    $foo->write;
    if ( $foo->error ){
        warn('error:'.$foo->error.': '.$foo->errorString);
    }

ERROR CODES

1

No Toader object specified.

2

The specified object is not a Toader object.

3

The Toader object did not return a directory.

4

Failed to read the config file.

5

The section does not exist.

6

No variable name specified.

7

Variable or section matched /[\t \n\=\#\;]/.

8

Failed to write the config out.

AUTHOR

Zane C. Bowers-Hadley, <vvelox at vvelox.net>

BUGS

Please report any bugs or feature requests to bug-toader at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Toader. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Toader::Config

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2011 Zane C. Bowers-Hadley.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.