/ 
QDRDBMS-0.0.0
/ QDRDBMS::Validator

NAME

QDRDBMS::Validator - A common comprehensive test suite to run against all Engines

VERSION

This document describes QDRDBMS::Validator version 0.0.0 for Perl 5.

SYNOPSIS

This can be the complete content of the main t/*.t file for an example QDRDBMS Engine distribution:

use 5.008001;
use utf8;
use strict;
use warnings FATAL => 'all';

# Load the test suite.
use QDRDBMS::Validator;

# Run the test suite.
QDRDBMS::Validator::main({
        'engine_name' => 'QDRDBMS::Engine::Example',
        'dbms_config' => {},
    });

1;

The current release of QDRDBMS::Validator uses Test::More internally, and main() will invoke it to output what the standard Perl test harness expects. It is expected that this will change in the future so that Validator does not use Test::More internally, and rather will simply return test results in a data structure that the main t/*.t then can disseminate and pass the components to Test::More itself.

DESCRIPTION

The QDRDBMS::Validator Perl 5 module is a common comprehensive test suite to run against all QDRDBMS Engines. You run it against a QDRDBMS Engine module to ensure that the Engine and/or the database behind it implements the parts of the QDRDBMS API that your application needs, and that the API is implemented correctly. QDRDBMS::Validator is intended to guarantee a measure of quality assurance (QA) for QDRDBMS, so your application can use the database access framework with confidence of safety.

Alternately, if you are writing a QDRDBMS Engine module yourself, QDRDBMS::Validator saves you the work of having to write your own test suite for it. You can also be assured that if your module passes QDRDBMS::Validator's approval, then your module can be easily swapped in for other Engine modules by your users, and that any changes you make between releases haven't broken something important.

QDRDBMS::Validator would be used similarly to how Sun has an official validation suite for Java Virtual Machines to make sure they implement the official Java specification.

For reference and context, please see the FEATURE SUPPORT VALIDATION documentation section in the core QDRDBMS module.

Note that, as is the nature of test suites, QDRDBMS::Validator will be getting regular updates and additions, so that it anticipates all of the different ways that people want to use their databases. This task is unlikely to ever be finished, given the seemingly infinite size of the task. You are welcome and encouraged to submit more tests to be included in this suite at any time, as holes in coverage are discovered.

This documentation is pending.

INTERFACE

This documentation is pending; this section may also be split into several.

DIAGNOSTICS

This documentation is pending.

CONFIGURATION AND ENVIRONMENT

This documentation is pending.

DEPENDENCIES

This file requires any version of Perl 5.x.y that is at least 5.8.1.

It also requires these Perl 5 classes that are in the current distribution: QDRDBMS::AST-(0.0.0), QDRDBMS-0.0.0.

INCOMPATIBILITIES

None reported.

SEE ALSO

Go to QDRDBMS for the majority of distribution-internal references, and QDRDBMS::SeeAlso for the majority of distribution-external references.

BUGS AND LIMITATIONS

This documentation is pending.

AUTHOR

Darren Duncan (perl@DarrenDuncan.net)

LICENCE AND COPYRIGHT

This file is part of the QDRDBMS framework.

QDRDBMS is Copyright © 2002-2007, Darren Duncan.

See the LICENCE AND COPYRIGHT of QDRDBMS for details.

ACKNOWLEDGEMENTS

The ACKNOWLEDGEMENTS in QDRDBMS apply to this file too.