NAME

TBX::Checker - Check TBX validity using TBXChecker

VERSION

version 0.03

SYNOPSIS

        use TBX::Checker qw(check);
        my ($passed, $messages) = check('/path/to/file.tbx');
        $passed && print 'ok!'
                or print join (qq{\n}, @$messages);

DESCRIPTION

This modules allows you to use the Java TBXChecker utility from Perl. It has one function, check which returns the errors found by the TBXChecker (hopefully none!).

METHODS

check

Checks the validity of the given TBX file. Returns 2 elements: a boolean representing the validity of the input TBX, and an array reference containing messages returned by TBXChecker.

Arguments: a string containing a TBX file path, or a string pointer containing TBX data to be checked, followed by named arguments accepted by TBXChecker. For example: check('file.tbx', loglevel = 'ALL')>. The allowed parameters are listed below:

    loglevel      Increase level of output while processing.
                         OFF     => Error code only.
                         SEVERE  => Error code only.
                         WARNING => Valid or invalid message (default).
                         INFO    => Location of files used in processing.
                         CONFIG  => .
                         FINE    => .
                         FINER   => .
                         FINEST  => .
                         ALL     => All logging messages.
    lang           ISO-639 lowercase two-letter language code.
    country      ISO-3166 uppercase two-letter country code.
    variant
    system       System ID to use for relative paths in document.
                         Default: Uses the directory where the file is located.
    version       Displays version information and quits.
    environment    Adds the environmental conditions on startup to the messages.

Keep in mind that if you use a string pointer instead of a file name, all relative URI's will be resolved from the current working directory.

SEE ALSO

The TBXChecker project is located on SourceForge in a project called tbxutil.

AUTHOR

Nathan Glenn <garfieldnate@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Alan K. Melby.

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