#!/usr/bin/env python import glob import io import os from waflib import Logs, Options from waflib.extras import autowaf # Library and package version (UNIX style major, minor, micro) # major increment <=> incompatible changes # minor increment <=> compatible changes (additions) # micro increment <=> no interface changes SERD_VERSION = '1.0.0' SERD_MAJOR_VERSION = '1' # Mandatory waf variables APPNAME = 'serd' # Package name for waf dist VERSION = SERD_VERSION # Package version for waf dist top = '.' # Source directory out = 'build' # Build directory def options(ctx): ctx.load('compiler_c') autowaf.set_options(ctx, test=True) opt = ctx.get_option_group('Configuration options') autowaf.add_flags( opt, {'no-utils': 'do not build command line utilities', 'stack-check': 'include runtime stack sanity checks', 'static': 'build static library', 'no-shared': 'do not build shared library', 'static-progs': 'build programs as static binaries', 'largefile': 'build with large file support on 32-bit systems', 'no-posix': 'do not use POSIX functions, even if present'}) def configure(conf): autowaf.display_header('Serd Configuration') conf.load('compiler_c', cache=True) conf.load('autowaf', cache=True) autowaf.set_c_lang(conf, 'c99') conf.env.update({ 'BUILD_UTILS': not Options.options.no_utils, 'BUILD_SHARED': not Options.options.no_shared, 'STATIC_PROGS': Options.options.static_progs, 'BUILD_STATIC': Options.options.static or Options.options.static_progs}) if not conf.env.BUILD_SHARED and not conf.env.BUILD_STATIC: conf.fatal('Neither a shared nor a static build requested') if Options.options.stack_check: conf.define('SERD_STACK_CHECK', SERD_VERSION) if Options.options.largefile: conf.env.append_unique('DEFINES', ['_FILE_OFFSET_BITS=64']) if not Options.options.no_posix: for name, header in {'posix_memalign': 'stdlib.h', 'posix_fadvise': 'fcntl.h', 'fileno': 'stdio.h'}.items(): autowaf.check_function(conf, 'c', name, header_name = header, define_name = 'HAVE_' + name.upper(), defines = ['_POSIX_C_SOURCE=200809L'], mandatory = False) autowaf.set_lib_env(conf, 'serd', SERD_VERSION) conf.write_config_header('serd_config.h', remove=False) autowaf.display_summary( conf, {'Build static library': bool(conf.env['BUILD_STATIC']), 'Build shared library': bool(conf.env['BUILD_SHARED']), 'Build utilities': bool(conf.env['BUILD_UTILS']), 'Build unit tests': conf.is_defined('HAVE_GL')}) lib_source = ['src/base64.c', 'src/byte_sink.c', 'src/byte_source.c', 'src/cursor.c', 'src/env.c', 'src/n3.c', 'src/node.c', 'src/nodes.c', 'src/reader.c', 'src/sink.c', 'src/statement.c', 'src/string.c', 'src/syntax.c', 'src/system.c', 'src/uri.c', 'src/world.c', 'src/writer.c', 'src/zix/digest.c', 'src/zix/hash.c'] def build(bld): # C Headers includedir = '${INCLUDEDIR}/serd-%s/serd' % SERD_MAJOR_VERSION bld.install_files(includedir, bld.path.ant_glob('serd/*.h')) # Pkgconfig file autowaf.build_pc(bld, 'SERD', SERD_VERSION, SERD_MAJOR_VERSION, [], {'SERD_MAJOR_VERSION' : SERD_MAJOR_VERSION}) defines = [] lib_args = {'export_includes': ['.'], 'includes': ['.', './src'], 'cflags': ['-fvisibility=hidden'], 'lib': ['m'], 'vnum': SERD_VERSION, 'install_path': '${LIBDIR}'} if bld.env.MSVC_COMPILER: lib_args['cflags'] = [] lib_args['lib'] = [] defines = [] # Shared Library if bld.env.BUILD_SHARED: bld(features = 'c cshlib', source = lib_source, name = 'libserd', target = 'serd-%s' % SERD_MAJOR_VERSION, defines = defines + ['SERD_SHARED', 'SERD_INTERNAL'], **lib_args) # Static library if bld.env.BUILD_STATIC: bld(features = 'c cstlib', source = lib_source, name = 'libserd_static', target = 'serd-%s' % SERD_MAJOR_VERSION, defines = defines + ['SERD_INTERNAL'], **lib_args) if bld.env.BUILD_TESTS: test_args = {'includes': ['.', './src'], 'cflags': [''] if bld.env.NO_COVERAGE else ['--coverage'], 'linkflags': [''] if bld.env.NO_COVERAGE else ['--coverage'], 'lib': lib_args['lib'], 'install_path': ''} # Profiled static library for test coverage bld(features = 'c cstlib', source = lib_source, name = 'libserd_profiled', target = 'serd_profiled', defines = defines + ['SERD_INTERNAL'], **test_args) # Test programs for prog in [('serdi_static', 'src/serdi.c'), ('serd_test', 'tests/serd_test.c'), ('read_chunk_test', 'tests/read_chunk_test.c'), ('nodes_test', 'tests/nodes_test.c')]: bld(features = 'c cprogram', source = prog[1], use = 'libserd_profiled', target = prog[0], defines = defines, **test_args) # Utilities if bld.env.BUILD_UTILS: obj = bld(features = 'c cprogram', source = 'src/serdi.c', target = 'serdi', includes = ['.', './src'], use = 'libserd', lib = lib_args['lib'], install_path = '${BINDIR}') if not bld.env.BUILD_SHARED or bld.env.STATIC_PROGS: obj.use = 'libserd_static' if bld.env.STATIC_PROGS: obj.env.SHLIB_MARKER = obj.env.STLIB_MARKER obj.linkflags = ['-static'] # Documentation autowaf.build_dox(bld, 'SERD', SERD_VERSION, top, out) # Man page bld.install_files('${MANDIR}/man1', 'doc/serdi.1') bld.add_post_fun(autowaf.run_ldconfig) if bld.env.DOCS: bld.add_post_fun(lambda ctx: autowaf.make_simple_dox(APPNAME)) def lint(ctx): "checks code for style issues" import subprocess cmd = ("clang-tidy -p=. -header-filter=.* -checks=\"*," + "-bugprone-suspicious-string-compare," + "-clang-analyzer-alpha.*," + "-google-readability-todo," + "-hicpp-signed-bitwise," + "-llvm-header-guard," + "-misc-unused-parameters," + "-readability-else-after-return\" " + "../src/*.c") subprocess.call(cmd, cwd='build', shell=True) def amalgamate(ctx): "builds single-file amalgamated source" import shutil import re shutil.copy('serd/serd.h', 'build/serd.h') def include_line(line): return (not re.match('#include "[^/]*\.h"', line) and not re.match('#include "serd/serd.h"', line)) with open('build/serd.c', 'w') as amalgamation: amalgamation.write('/* This is amalgamated code, do not edit! */\n') amalgamation.write('#include "serd.h"\n\n') for header_path in ['src/serd_internal.h', 'src/byte_sink.h', 'src/byte_source.h', 'src/stack.h', 'src/string_utils.h', 'src/uri_utils.h', 'src/reader.h']: with open(header_path) as header: for l in header: if include_line(l): amalgamation.write(l) for f in lib_source: with open(f) as fd: amalgamation.write('\n/**\n @file %s\n*/' % f) for l in fd: if include_line(l): amalgamation.write(l) for i in ['c', 'h']: Logs.info('Wrote build/serd.%s' % i) def upload_docs(ctx): os.system('rsync -ravz --delete -e ssh build/doc/html/ drobilla@drobilla.net:~/drobilla.net/docs/serd/') for page in glob.glob('doc/*.[1-8]'): os.system('soelim %s | pre-grohtml troff -man -wall -Thtml | post-grohtml > build/%s.html' % (page, page)) os.system('rsync -avz --delete -e ssh build/%s.html drobilla@drobilla.net:~/drobilla.net/man/' % page) def file_equals(patha, pathb, subst_from='', subst_to=''): with io.open(patha, 'rU', encoding='utf-8') as fa: with io.open(pathb, 'rU', encoding='utf-8') as fb: for linea in fa: lineb = fb.readline() if (linea.replace(subst_from, subst_to) != lineb.replace(subst_from, subst_to)): fa.seek(0) fb.seek(0) show_diff(fa.readlines(), fb.readlines(), patha, pathb) return False return True def earl_assertion(test, passed, asserter): import datetime asserter_str = '' if asserter is not None: asserter_str = '\n\tearl:assertedBy <%s> ;' % asserter passed_str = 'earl:failed' if passed: passed_str = 'earl:passed' return ''' [] a earl:Assertion ;%s earl:subject ; earl:test <%s> ; earl:result [ a earl:TestResult ; earl:outcome %s ; dc:date "%s"^^xsd:dateTime ] . ''' % (asserter_str, test, passed_str, datetime.datetime.now().replace(microsecond=0).isoformat()) def show_diff(from_lines, to_lines, from_filename, to_filename): import difflib import sys 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) def check_output(out_filename, check_filename, subst_from='', subst_to=''): if not os.access(out_filename, os.F_OK): Logs.pprint('RED', 'FAIL: output %s is missing' % out_filename) elif not file_equals(check_filename, out_filename, subst_from, subst_to): Logs.pprint('RED', 'FAIL: %s != %s' % (os.path.abspath(out_filename), check_filename)) else: return True return False def test_osyntax_options(osyntax): if osyntax.lower() == 'ntriples' or osyntax.lower() == 'nquads': return ' -a' return '' def test_thru(ctx, base, path, check_filename, flags, isyntax, osyntax, options='', quiet=False): in_filename = os.path.join(ctx.path.abspath(), path) out_filename = path + '.thru' command = ('serdi_static %s %s -i %s -o %s -p foo "%s" "%s" | ' 'serdi_static %s -i %s -o %s -c foo - "%s" > %s') % ( options + test_osyntax_options(isyntax), flags.ljust(5), isyntax, isyntax, in_filename, base, options + test_osyntax_options(osyntax), isyntax, osyntax, base, out_filename) if autowaf.run_test(ctx, APPNAME, command, 0, name=' to ' + out_filename, quiet=quiet): autowaf.run_test( ctx, APPNAME, lambda: check_output(out_filename, check_filename, '_:docid', '_:genid'), True, name='from ' + out_filename, quiet=quiet) else: Logs.pprint('RED', 'FAIL: error running %s' % command) def file_uri_to_path(uri): try: from urlparse import urlparse # Python 2 except: from urllib.parse import urlparse # Python 3 path = urlparse(uri).path drive = os.path.splitdrive(path[1:])[0] return path if not drive else path[1:] def load_rdf(filename): "Load an RDF file into python dictionaries via serdi. Only supports URIs." import subprocess import re model = {} proc = subprocess.Popen(['./serdi_static', filename], stdout=subprocess.PIPE) for line in proc.communicate()[0].splitlines(): matches = re.match('<([^ ]*)> <([^ ]*)> <([^ ]*)> \.', line.decode('utf-8')) if matches: if matches.group(1) not in model: model[matches.group(1)] = {} if matches.group(2) not in model[matches.group(1)]: model[matches.group(1)][matches.group(2)] = [] model[matches.group(1)][matches.group(2)] += [matches.group(3)] return model def get_resources_with_type(model, rdf_class): tests = [] for s, desc in model.items(): if rdf_class in desc['http://www.w3.org/1999/02/22-rdf-syntax-ns#type']: tests += [s] return tests def test_suite(ctx, base_uri, testdir, report, isyntax, osyntax, options=''): import itertools srcdir = ctx.path.abspath() mf = 'http://www.w3.org/2001/sw/DataAccess/tests/test-manifest#' model = load_rdf(os.path.join(srcdir, 'tests', testdir, 'manifest.ttl')) asserter = '' if os.getenv('USER') == 'drobilla': asserter = 'http://drobilla.net/drobilla#me' def run_test(command, expected_return, name, quiet=False): header = Options.options.verbose_tests result = autowaf.run_test(ctx, APPNAME, command, expected_return, name=name, header=header, quiet=quiet) if expected_return is not None and expected_return != 0: autowaf.run_test(ctx, APPNAME, lambda: bool(result[1][1]), True, name=name + ' prints error message', quiet=True) return result def run_tests(test_class, expected_return): tests = get_resources_with_type(model, test_class) if len(tests) == 0: return thru_flags = ['-e', '-b', '-r http://example.org/'] thru_options = [] for n in range(len(thru_flags) + 1): thru_options += list(itertools.combinations(thru_flags, n)) thru_options_iter = itertools.cycle(thru_options) quiet = not Options.options.verbose_tests tests_name = '%s.%s' % (testdir, test_class[test_class.find('#') + 1:]) with autowaf.begin_tests(ctx, APPNAME, tests_name): for (num, test) in enumerate(sorted(tests)): action_node = model[test][mf + 'action'][0] action = os.path.join('tests', testdir, os.path.basename(action_node)) rel_action = os.path.join(os.path.relpath(srcdir), action) abs_action = os.path.join(srcdir, action) uri = base_uri + os.path.basename(action) command = 'serdi_static -a %s %s "%s" > %s' % ( options, rel_action, uri, action + '.out') # Run strict test result = run_test(command, expected_return, action, quiet=quiet) if (mf + 'result') in model[test]: # Check output against test suite check_uri = model[test][mf + 'result'][0] check_path = file_uri_to_path(check_uri) result = autowaf.run_test( ctx, APPNAME, lambda: check_output(action + '.out', check_path), True, name=str(action) + ' check', quiet=True) # Run round-trip tests test_thru(ctx, uri, action, check_path, ' '.join(next(thru_options_iter)), isyntax, osyntax, options, quiet=True) # Write test report entry if report is not None: report.write(earl_assertion(test, result[0], asserter)) # Run lax test run_test(command.replace('serdi_static', 'serdi_static -l'), None, action + ' lax', True) def test_types(): types = [] for lang in ['Turtle', 'NTriples', 'Trig', 'NQuads']: types += [['http://www.w3.org/ns/rdftest#Test%sPositiveSyntax' % lang, 0], ['http://www.w3.org/ns/rdftest#Test%sNegativeSyntax' % lang, 1], ['http://www.w3.org/ns/rdftest#Test%sNegativeEval' % lang, 1], ['http://www.w3.org/ns/rdftest#Test%sEval' % lang, 0]] return types for i in test_types(): run_tests(i[0], i[1]) def run_test_suites(ctx, opts): "runs all manifest-driven test suites with the given serdi options" # Serd-specific test cases serd_base = 'http://drobilla.net/sw/serd/tests/' test_suite(ctx, serd_base + 'good/', 'good', None, 'Turtle', 'NTriples', opts) test_suite(ctx, serd_base + 'bad/', 'bad', None, 'Turtle', 'NTriples', opts) # Standard test suites with open('earl.ttl', 'w') as report: report.write('@prefix earl: .\n' '@prefix dc: .\n') with open(os.path.join(ctx.path.abspath(), 'serd.ttl')) as serd_ttl: for line in serd_ttl: report.write(line) w3c_base = 'http://www.w3.org/2013/' test_suite(ctx, w3c_base + 'NTriplesTests/', 'NTriplesTests', report, 'NTriples', 'NTriples', opts) test_suite(ctx, w3c_base + 'TurtleTests/', 'TurtleTests', report, 'Turtle', 'NTriples', opts) test_suite(ctx, w3c_base + 'NQuadsTests/', 'NQuadsTests', report, 'NQuads', 'NQuads', opts) test_suite(ctx, w3c_base + 'TriGTests/', 'TriGTests', report, 'TriG', 'NQuads', opts) def test(ctx): "runs test suite" # Create test output directories for i in ['bad', 'good', 'TurtleTests', 'NTriplesTests', 'NQuadsTests', 'TriGTests']: try: test_dir = os.path.join(autowaf.build_dir(APPNAME, 'tests'), i) os.makedirs(test_dir) for i in glob.glob(test_dir + '/*.*'): os.remove(i) except: pass srcdir = ctx.path.abspath() os.environ['PATH'] = '.' + os.pathsep + os.getenv('PATH') autowaf.pre_test(ctx, APPNAME) autowaf.run_tests(ctx, APPNAME, ['serd_test', 'read_chunk_test', 'nodes_test'], name='Unit') def test_syntax_io(in_name, expected_name, lang): in_path = 'tests/good/%s' % in_name autowaf.run_test( ctx, APPNAME, 'serdi_static -o %s "%s/%s" "%s" > %s.out' % ( lang, srcdir, in_path, in_path, in_path), 0, name=in_name) autowaf.run_test( ctx, APPNAME, lambda: file_equals('%s/tests/good/%s' % (srcdir, expected_name), '%s.out' % in_path), True, quiet=True, name=in_name + '-check') with autowaf.begin_tests(ctx, APPNAME, 'ThroughSyntax'): test_syntax_io('base.ttl', 'base.ttl', 'turtle') test_syntax_io('qualify-in.ttl', 'qualify-out.ttl', 'turtle') test_syntax_io('pretty.trig', 'pretty.trig', 'trig') nul = os.devnull autowaf.run_tests(ctx, APPNAME, [ 'serdi_static %s/tests/good/manifest.ttl > %s' % (srcdir, nul), 'serdi_static -v > %s' % nul, 'serdi_static -h > %s' % nul, 'serdi_static -s " a <#Thingie> ." > %s' % nul, 'serdi_static %s > %s' % (nul, nul) ], 0, name='GoodCommands') autowaf.run_tests(ctx, APPNAME, [ 'serdi_static -q %s/tests/bad/bad-id-clash.ttl > %s' % (srcdir, nul), 'serdi_static > %s' % nul, 'serdi_static ftp://example.org/unsupported.ttl > %s' % nul, 'serdi_static -i > %s' % nul, 'serdi_static -k > %s' % nul, 'serdi_static -k -1 > %s' % nul, 'serdi_static -o > %s' % nul, 'serdi_static -z > %s' % nul, 'serdi_static -p > %s' % nul, 'serdi_static -c > %s' % nul, 'serdi_static -r > %s' % nul, 'serdi_static -i illegal > %s' % nul, 'serdi_static -o illegal > %s' % nul, 'serdi_static -i turtle > %s' % nul, 'serdi_static /no/such/file > %s' % nul], 1, name='BadCommands') with autowaf.begin_tests(ctx, APPNAME, 'IoErrors'): # Test read error by reading a directory autowaf.run_test(ctx, APPNAME, 'serdi_static -e "file://%s/"' % srcdir, 1, name='read_error') # Test read error with bulk input by reading a directory autowaf.run_test(ctx, APPNAME, 'serdi_static "file://%s/"' % srcdir, 1, name='read_error_bulk') # Test write error by writing to /dev/full if os.path.exists('/dev/full'): autowaf.run_test(ctx, APPNAME, 'serdi_static "file://%s/tests/good/manifest.ttl" > /dev/full' % srcdir, 1, name='write_error') run_test_suites(ctx, '') autowaf.post_test(ctx, APPNAME) def posts(ctx): path = str(ctx.path.abspath()) autowaf.news_to_posts( os.path.join(path, 'NEWS'), {'title' : 'Serd', 'description' : autowaf.get_blurb(os.path.join(path, 'README.md')), 'dist_pattern' : 'http://download.drobilla.net/serd-%s.tar.bz2'}, { 'Author' : 'drobilla', 'Tags' : 'Hacking, RDF, Serd' }, os.path.join(out, 'posts'))