#!/usr/bin/env python3 """Run an RDF test suite with serdi.""" import serd_test_util import argparse import datetime import difflib import itertools import os import re import shlex import subprocess import sys import tempfile import urllib.parse def log_error(message): """Log an error message to stderr""" sys.stderr.write("error: ") sys.stderr.write(message) def test_osyntax_options(osyntax): if osyntax.lower() == "ntriples" or osyntax.lower() == "nquads": return ["-o", "ascii"] return [] def test_thru( base_uri, path, check_path, out_test_dir, flags, isyntax, osyntax, command_prefix, ): """Test lossless round-tripping through two different syntaxes.""" assert isyntax is not None assert osyntax is not None test_name = os.path.basename(path) out_path = os.path.join(out_test_dir, test_name + ".pass") thru_path = os.path.join(out_test_dir, test_name + ".thru") out_cmd = ( command_prefix + [f for sublist in flags for f in sublist] + [ "-i", isyntax, "-o", isyntax, "-p", "foo", "-w", out_path, "-I", base_uri, path, ] ) thru_cmd = ( command_prefix + test_osyntax_options(osyntax) + [ "-i", isyntax, "-o", osyntax, "-c", "foo", "-w", thru_path, "-o", "ascii", "-I", base_uri, out_path, ] ) subprocess.run(out_cmd, check=True) subprocess.run(thru_cmd, check=True) with open(thru_path, "wb") as out: subprocess.run(thru_cmd, check=True, stdout=out) if not _file_equals(check_path, thru_path): log_error( "Round-tripped output {} does not match {}\n".format( check_path, thru_path ) ) return 1 return 0 def _uri_path(uri): path = urllib.parse.urlparse(uri).path drive = os.path.splitdrive(path[1:])[0] return path if not drive else path[1:] def _test_input_syntax(test_class): """Return the output syntax use for a given test class.""" if "NTriples" in test_class: return "NTriples" if "Turtle" in test_class: return "Turtle" if "NQuads" in test_class: return "NQuads" if "Trig" in test_class: return "Trig" raise Exception("Unknown test class <{}>".format(test_class)) def _test_output_syntax(test_class): """Return the output syntax use for a given test class.""" if "NTriples" in test_class or "Turtle" in test_class: return "NTriples" if "NQuads" in test_class or "Trig" in test_class: return "NQuads" raise Exception("Unknown test class <{}>".format(test_class)) def _option_combinations(options): """Return an iterator that cycles through all combinations of options.""" combinations = [] for count in range(len(options) + 1): combinations += list(itertools.combinations(options, count)) return itertools.cycle(combinations) def _show_diff(from_lines, to_lines, from_filename, to_filename): same = True for line in difflib.unified_diff( from_lines, to_lines, fromfile=os.path.abspath(from_filename), tofile=os.path.abspath(to_filename), ): sys.stderr.write(line) same = False return same def _file_equals(patha, pathb): for path in (patha, pathb): if not os.access(path, os.F_OK): log_error("missing file {}\n".format(path)) return False with open(patha, "r", encoding="utf-8") as fa: with open(pathb, "r", encoding="utf-8") as fb: return _show_diff(fa.readlines(), fb.readlines(), patha, pathb) def _file_lines_equal(patha, pathb, subst_from="", subst_to=""): import io for path in (patha, pathb): if not os.access(path, os.F_OK): sys.stderr.write("error: missing file %s" % path) return False la = sorted(set(io.open(patha, encoding="utf-8").readlines())) lb = sorted(set(io.open(pathb, encoding="utf-8").readlines())) if la != lb: _show_diff(la, lb, patha, pathb) return False return True def test_suite( manifest_path, base_uri, report_filename, input_syntax, output_syntax, command_prefix, ): """Run all tests in a test suite manifest.""" mf = "http://www.w3.org/2001/sw/DataAccess/tests/test-manifest#" test_dir = os.path.dirname(manifest_path) model, instances = serd_test_util.load_rdf( command_prefix + ["-I", base_uri], manifest_path ) top_dir = os.path.commonpath([os.getcwd(), os.path.abspath(test_dir)]) out_test_dir = os.path.relpath(test_dir, top_dir) os.makedirs(out_test_dir, exist_ok=True) asserter = "" if os.getenv("USER") == "drobilla": asserter = "http://drobilla.net/drobilla#me" class Results: def __init__(self): self.n_tests = 0 self.n_failures = 0 def run_tests(test_class, tests, expected_return, results): thru_flags = [["-f"], ["-b", "1"], ["-r", "http://example.org/"]] thru_options_iter = _option_combinations(thru_flags) if output_syntax is not None: osyntax = output_syntax else: osyntax = _test_output_syntax(test_class) if input_syntax is not None: isyntax = input_syntax else: isyntax = _test_input_syntax(test_class) for test in sorted(tests): test_uri = model[test][mf + "action"][0] test_uri_path = _uri_path(test_uri) test_name = os.path.basename(test_uri_path) test_path = os.path.join(test_dir, test_name) command = command_prefix + [ "-o", osyntax, "-o", "ascii", "-I", test_uri, test_path, ] command_string = " ".join(shlex.quote(c) for c in command) out_filename = os.path.join(out_test_dir, test_name + ".out") results.n_tests += 1 if expected_return == 0: # Positive test # Run strict test with open(out_filename, "w") as stdout: proc = subprocess.run(command, check=False, stdout=stdout) if proc.returncode == 0: passed = True else: results.n_failures += 1 log_error( "Unexpected failure of command: {}\n".format( command_string ) ) if proc.returncode == 0 and mf + "result" in model[test]: # Check output against expected output from test suite check_uri = model[test][mf + "result"][0] check_filename = os.path.basename(_uri_path(check_uri)) check_path = os.path.join(test_dir, check_filename) if not _file_equals(check_path, out_filename): results.n_failures += 1 log_error( "Output {} does not match {}\n".format( out_filename, check_path ) ) # Run round-trip tests results.n_failures += test_thru( test_uri, test_path, check_path, out_test_dir, list(next(thru_options_iter)), isyntax, osyntax, command_prefix, ) # Run model test for positive test (must succeed) out_filename = os.path.join( out_test_dir, test_name + ".model.out" ) model_command = command_prefix + [ "-m", "-o", osyntax, "-o", "ascii", "-w", out_filename, "-I", test_uri, test_path, ] proc = subprocess.run(model_command, check=True) if proc.returncode == 0 and ( (mf + "result") in model[test] ): if not _file_lines_equal(check_path, out_filename): results.n_failures += 1 else: # Negative test with open(out_filename, "w") as stdout: with tempfile.TemporaryFile() as stderr: proc = subprocess.run( command, check=False, stdout=stdout, stderr=stderr ) if proc.returncode != 0: passed = True else: results.n_failures += 1 log_error( "Unexpected success of command: {}\n".format( command_string ) ) # Check that an error message was printed stderr.seek(0, 2) # Seek to end if stderr.tell() == 0: # Empty results.n_failures += 1 log_error( "No error message printed by command: {}\n".format( command_string ) ) result = 1 # Write test report entry if report_filename: with open(report_filename, "a") as report: report.write( serd_test_util.earl_assertion(test, passed, asserter) ) # Run all test types in the test suite results = Results() ns_rdftest = "http://www.w3.org/ns/rdftest#" for test_class, instances in instances.items(): if test_class.startswith(ns_rdftest): expected = ( 1 if "lax" not in command_prefix and "Negative" in test_class else 0 ) run_tests(test_class, instances, expected, results) # Print result summary if results.n_failures > 0: log_error( "{}/{} tests failed\n".format(results.n_failures, results.n_tests) ) else: sys.stdout.write("All {} tests passed\n".format(results.n_tests)) return results.n_failures def main(): """Run the command line tool.""" parser = argparse.ArgumentParser( usage="%(prog)s [OPTION]... MANIFEST BASE_URI -- [SERDI_OPTION]...", description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter, ) parser.add_argument("--report", help="path to write result report to") parser.add_argument("--serdi", default="serdi", help="path to serdi") parser.add_argument("--syntax", default=None, help="input syntax") parser.add_argument("--osyntax", default=None, help="output syntax") parser.add_argument("--wrapper", default="", help="executable wrapper") parser.add_argument("manifest", help="test suite manifest.ttl file") parser.add_argument("base_uri", help="base URI for tests") parser.add_argument( "serdi_option", nargs=argparse.REMAINDER, help="option for serdi" ) args = parser.parse_args(sys.argv[1:]) command_prefix = ( shlex.split(args.wrapper) + [args.serdi] + args.serdi_option ) return test_suite( args.manifest, args.base_uri, args.report, args.syntax, args.osyntax, command_prefix, ) if __name__ == "__main__": try: sys.exit(main()) except subprocess.CalledProcessError as e: if e.stderr is not None: sys.stderr.write(e.stderr.decode("utf-8")) sys.stderr.write("error: %s\n" % e) sys.exit(e.returncode)