NAME

Data::Semantic::Test - Testing Data::Semantic objects

SYNOPSIS

Data::Semantic::Test->new;

DESCRIPTION

This class makes it easy to test new semantic data classes based on Data::Semantic. It uses the Test::CompanionClasses meechanism. So to test the subclass Data::Semantic::URI::http you would write a corresponding Data::Semantic::URI::http_TEST test class. In your test class you need to define the following structure:

use constant TESTDATA => (
    {
        args => {},
        valid => [ qw(
            http://localhost/
            http://use.perl.org/~hanekomu/journal?entry=12345
        ) ],
        invalid  => [ qw(
            news://localhost/
            http://?123
            https://localhost/
        ) ],
    },
    {
        args => { scheme => 'https?' },
        valid => [ qw(
            http://localhost/
            http://use.perl.org/~hanekomu/journal?entry=12345
            https://localhost/
            https://use.perl.org/~hanekomu/journal?entry=12345
        ) ],
        invalid  => [ qw(
            news://localhost/
            http://?123
        ) ],
    },
    {
        args => { scheme => 'https' },
        valid => [ qw(
            https://localhost/
            https://use.perl.org/~hanekomu/journal?entry=12345
        ) ],
        invalid  => [ qw(
            http://localhost/
            http://use.perl.org/~hanekomu/journal?entry=12345
            http://?123
            news://localhost/
        ) ],
    },
);

So you define one or more scenarios, each within its own hashref within the TESTDATA list. In each scenario you have a list of arguments to pass to the semantic data object constructor. Given those arguments, certain values will be considered valid and others invalid.

See Test::CompanionClasses for more information on how these tests are run.

Data::Semantic::Test inherits from Test::CompanionClasses::Base.

The superclass Test::CompanionClasses::Base defines these methods and functions:

new(), clear_package(), make_real_object(), package(), package_clear(),
planned_test_count()

The superclass Class::Accessor::Complex defines these methods and functions:

carp(), cluck(), croak(), flatten(), mk_abstract_accessors(),
mk_array_accessors(), mk_boolean_accessors(),
mk_class_array_accessors(), mk_class_hash_accessors(),
mk_class_scalar_accessors(), mk_concat_accessors(),
mk_forward_accessors(), mk_hash_accessors(), mk_integer_accessors(),
mk_new(), mk_object_accessors(), mk_scalar_accessors(),
mk_set_accessors(), mk_singleton()

The superclass Class::Accessor defines these methods and functions:

_carp(), _croak(), _mk_accessors(), accessor_name_for(),
best_practice_accessor_name_for(), best_practice_mutator_name_for(),
follow_best_practice(), get(), make_accessor(), make_ro_accessor(),
make_wo_accessor(), mk_accessors(), mk_ro_accessors(),
mk_wo_accessors(), mutator_name_for(), set()

The superclass Class::Accessor::Installer defines these methods and functions:

install_accessor(), subname()

The superclass Data::Inherited defines these methods and functions:

every_hash(), every_list(), flush_every_cache_by_key()

METHODS

TAGS

If you talk about this module in blogs, on del.icio.us or anywhere else, please use the datasemantic tag.

VERSION

This document describes version 0.02 of Data::Semantic::Test.

BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests to <bug-data-semantic@rt.cpan.org>, or through the web interface at http://rt.cpan.org.

INSTALLATION

See perlmodinstall for information and options on installing Perl modules.

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://www.perl.com/CPAN/authors/id/M/MA/MARCEL/>.

AUTHOR

Marcel Grünauer, <marcel@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2007 by Marcel Grünauer

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

cpanm Data::Semantic

perl -MCPAN -e shell
install Data::Semantic