table of contents
Test::RDF(3pm) | User Contributed Perl Documentation | Test::RDF(3pm) |
NAME¶
Test::RDF - Test RDF data for content, validity and equality, etc.
VERSION¶
Version 1.22
SYNOPSIS¶
use Test::RDF; is_valid_rdf($rdf_string, $syntax, 'RDF string is valid according to selected syntax'); is_rdf($rdf_string, $syntax1, $expected_rdf_string, $syntax2, 'The two strings have the same triples'); isomorph_graphs($model, $expected_model, 'The two models have the same triples'); are_subgraphs($model1, $model2, 'Model 1 is a subgraph of model 2' ); has_uri($uri_string, $model, 'Has correct URI'); hasnt_uri($uri_string, $model, "Hasn't correct URI"); has_subject($uri_string, $model, 'Subject URI is found'); has_predicate($uri_string, $model, 'Predicate URI is found'); has_object_uri($uri_string, $model, 'Object URI is found'); has_type($uri_string, $model, 'Class URI is found'); has_literal($string, $language, $datatype, $model, 'Literal is found'); hasnt_literal($string, $language, $datatype, $model, 'Literal is not found'); pattern_target($model); pattern_ok($pattern, '$pattern found in $model'); pattern_fail($pattern, '$pattern not found in $model');
DESCRIPTION¶
This Perl module, Test::RDF, provides tools for testing code whichdeals with RDF. It can test RDF for validity, check if two RDF graphsare the same, or subgraphs of each other, if a URI is or is not in adataset, if it has certain subjects, predicates, objects orliterals. It can also test to see if a full pattern is present orabsent.
EXPORT¶
is_valid_rdf¶
Use to check if the input RDF string is valid in the chosen syntax
is_rdf¶
Use to check if the input RDF strings are isomorphic (i.e. the same).
isomorph_graphs¶
Use to check if the input RDF::Trine::Models have isomorphic graphs.
are_subgraphs¶
Use to check if the first RDF::Trine::Models is a subgraph of the second.
has_subject¶
Check if the string URI passed as first argument is a subject in anyof the statements given in the model given as second argument.
has_predicate¶
Check if the string URI passed as first argument is a predicate in anyof the statements given in the model given as second argument.
has_object_uri¶
Check if the string URI passed as first argument is a object in anyof the statements given in the model given as second argument.
has_type¶
Check if the string URI passed as first argument is an RDF classinstance in any of the statements given in the model given as secondargument.
has_literal¶
Check if the string passed as first argument, with correspondingoptional language and datatype as second and third respectively, is aliteral in any of the statements given in the model given as fourthargument.
language and datatype may not occur in the same statement, so the testfails if they are both set. If none are used, use "undef", like e.g.
has_literal('A test', undef, undef, $model, 'Simple literal');
A test for a typed literal may be done like
has_literal('42', undef, 'http://www.w3.org/2001/XMLSchema#integer', $model, 'Just an integer');
and a language literal like
has_literal('This is a Another test', 'en', undef, $model, 'Language literal');
hasnt_literal¶
This is like the above, only the opposite: It checks if a literaldoesn't exist. Like the above, the test will fail if the literal isinvalid, however.
has_uri¶
Check if the string URI passed as first argument is present in any ofthe statements given in the model given as second argument.
hasnt_uri¶
Check if the string URI passed as first argument is not present in anyof the statements given in the model given as second argument.
pattern_target¶
Tests that the object passed as its parameter is an RDF::Trine::Model orRDF::Trine::Store. That is, tests that it is a valid thing to match basicgraph patterns against.
Additionally, this test establishes the target for future "pattern_ok" tests.
pattern_ok¶
Tests that the pattern passed matches against the target established by"pattern_target". The pattern may be passed as an RDF::Trine::Pattern, or a list of RDF::Trine::Statement objects.
use Test::RDF; use RDF::Trine qw[iri literal blank variable statement]; use My::Module; my $foaf = RDF::Trine::Namespace->new('http://xmlns.com/foaf/0.1/'); pattern_target(My::Module->get_model); # check isa RDF::Trine::Model pattern_ok( statement( variable('who'), $foaf->name, literal('Kjetil Kjernsmo') ), statement( variable('who'), $foaf->page, iri('http://search.cpan.org/~kjetilk/') ), "Data contains Kjetil's details." );
Note: "pattern_target" must have been tested before any "pattern_ok" tests.
pattern_fail¶
The same as above, but tests if the pattern returns no results instead.
NOTE¶
Graph isomorphism is a complex problem, so do not attempt to run theisomorphism tests on large datasets. For more information see<http://en.wikipedia.org/wiki/Graph_isomorphism_problem>.
AUTHOR¶
Kjetil Kjernsmo, "<kjetilk at cpan.org>"
BUGS¶
Please report any bugs using github <https://github.com/kjetilk/Test-RDF/issues>
SUPPORT¶
You can find documentation for this module with the perldoc command.
perldoc Test::RDF
You may find the Perl and RDF community website <http://www.perlrdf.org/> useful.
You can also look for information at:
- AnnoCPAN: Annotated CPAN documentation
- CPAN Ratings
- Search CPAN
- MetaCPAN
ACKNOWLEDGEMENTS¶
Michael Hendricks wrote the first Test::RDF. The present module is acomplete rewrite from scratch using Gregory Todd William'sRDF::Trine::Graph to do the heavy lifting.
Toby Inkster has submitted the pattern_* functions.
LICENSE AND COPYRIGHT¶
Copyright 2010 ABC Startsiden AS.Copyright 2010, 2011, 2012, 2013, 2014, 2015, 2017 Kjetil Kjernsmo.
This program is free software; you can redistribute it and/or modify itunder the terms of either: the GNU General Public License as publishedby the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
2024-03-07 | perl v5.38.2 |