NAME
       Config::Augeas::Validator - A generic configuration validator API

SYNOPSIS
       use Config::Augeas::Validator;

       # Initialize
       my $validator = Config::Augeas::Validator->new(rulesdir => $rulesdir);

       $validator->play(@files);
       exit $validator->{err};

CONFIGURATION
    The Config::Augeas::Validator configuration files are INI files.

  DEFAULT SECTION
    The DEFAULT section is mandatory. It contains the following variables:

    lens    The name of the lens to use, for example:

            "lens=Httpd"

    err_code
            The exit code to return when a test fails. This parameter is
            optional. Example:

            "err_code=3"

  RULES
    Each section apart from the DEFAULT section defines a rule, as listed in
    the rules variable of the DEFAULT section. Each rule contains several
    parameters.

    name    The rule description, for example:

            "name=Application Type"

    explanation
            The explanation for the rule, for example:

            "explanation=Check that application type is FOO or BAR"

    type    The type of rule. For now, Config::Augeas::Validator only
            supports the count type, which returns the count nodes matching
            expr. Example:

            "type=count"

    expr    The Augeas expression for the rule. The $file variable is the
            path to the file in the Augeas tree. Example:

            "expr=$file/VirtualHost[#comment =~ regexp("^1#
            +((AI|BO)\+?|DR)$")]"

    value   The value expected for the test. For example, if using the count
            type, the number of matches expected for the expression.
            Example:

            "value=1"

    level   The importance level of the test. Possible values are 'error'
            (default) and 'warning'. When set to 'error', a failed test will
            interrupt the processing and set the return code. When set to
            'warning', a failed test will display a warning, continue, and
            have no effect on the return code. When set to 'ignore', the
            test is ignored and never run.

            "level=warning"

SEE ALSO
    Config::Augeas

FILES
    /etc/augeas-validator/rules.d The default rules directory for
    Config::Augeas::Validator.

