#!/usr/bin/env python import os import sys from waflib import Build, Logs, Options, TaskGen 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 PUGL_VERSION = '0.2.0' PUGL_MAJOR_VERSION = '0' # Mandatory waf variables APPNAME = 'pugl' # Package name for waf dist VERSION = PUGL_VERSION # Package version for waf dist top = '.' # Source directory out = 'build' # Build directory def options(ctx): ctx.load('compiler_c') ctx.load('compiler_cxx') opts = ctx.configuration_options() opts.add_option('--target', default=None, dest='target', help='target platform (e.g. "win32" or "darwin")') ctx.add_flags( opts, {'all-headers': 'install complete header implementation', 'no-gl': 'do not build OpenGL support', 'no-cxx': 'do not build C++ examples', 'no-cairo': 'do not build Cairo support', 'no-static': 'do not build static library', 'no-shared': 'do not build shared library'}) ctx.get_option_group('Test options').add_option( '--gui-tests', action='store_true', help='Run GUI tests') def configure(conf): conf.load('compiler_c', cache=True) if not Options.options.no_cxx: try: conf.load('compiler_cxx', cache=True) except Exception: pass conf.load('autowaf', cache=True) autowaf.set_c_lang(conf, 'c99') if 'COMPILER_CXX' in conf.env: autowaf.set_cxx_lang(conf, 'c++11') conf.env.ALL_HEADERS = Options.options.all_headers conf.env.TARGET_PLATFORM = Options.options.target or sys.platform platform = conf.env.TARGET_PLATFORM if Options.options.strict: # Check for programs used by lint target conf.find_program("flake8", var="FLAKE8", mandatory=False) conf.find_program("clang-tidy", var="CLANG_TIDY", mandatory=False) conf.find_program("iwyu_tool", var="IWYU_TOOL", mandatory=False) if Options.options.ultra_strict: # All warnings enabled by autowaf, disable some we trigger autowaf.add_compiler_flags(conf.env, '*', { 'clang': [ '-Wno-padded', '-Wno-reserved-id-macro', '-Wno-switch-enum', ], 'gcc': [ '-Wno-inline', '-Wno-padded', '-Wno-suggest-attribute=const', '-Wno-suggest-attribute=malloc', '-Wno-suggest-attribute=pure', '-Wno-switch-enum', ], 'msvc': [ '/wd4061', # enumerator in switch is not explicitly handled '/wd4514', # unreferenced inline function has been removed '/wd4710', # function not inlined '/wd4711', # function selected for automatic inline expansion '/wd4820', # padding added after construct '/wd5045', # will insert Spectre mitigation for memory load ], }) autowaf.add_compiler_flags(conf.env, 'c', { 'clang': [ '-Wno-bad-function-cast', '-Wno-float-equal', '-Wno-implicit-fallthrough', ], 'gcc': [ '-Wno-bad-function-cast', '-Wno-float-equal', ], 'msvc': [ '/wd4191', # unsafe conversion from type to type '/wd4706', # assignment within conditional expression '/wd4710', # function not inlined '/wd5045', # will insert Spectre mitigation for memory load ], }) autowaf.add_compiler_flags(conf.env, 'cxx', { 'clang': [ '-Wno-documentation-unknown-command', '-Wno-old-style-cast', ], 'gcc': [ '-Wno-old-style-cast', '-Wno-suggest-final-methods', ], 'msvc': [ '/wd4355', # 'this' used in base member initializer list '/wd4571', # structured exceptions (SEH) are no longer caught ], }) # Add some platform-specific warning suppressions if conf.env.TARGET_PLATFORM == "win32": autowaf.add_compiler_flags(conf.env, '*', { 'gcc': ['-Wno-cast-function-type', '-Wno-conversion', '-Wno-format', '-Wno-suggest-attribute=format'], 'clang': ['-D_CRT_SECURE_NO_WARNINGS', '-Wno-format-nonliteral', '-Wno-nonportable-system-include-path'], }) elif conf.env.TARGET_PLATFORM == 'darwin': autowaf.add_compiler_flags(conf.env, '*', { 'clang': ['-DGL_SILENCE_DEPRECATION', '-Wno-deprecated-declarations', '-Wno-direct-ivar-access'], 'gcc': ['-DGL_SILENCE_DEPRECATION', '-Wno-deprecated-declarations', '-Wno-direct-ivar-access'], }) # Check for base system libraries needed on some systems conf.check_cc(lib='m', uselib_store='M', mandatory=False) conf.check_cc(lib='dl', uselib_store='DL', mandatory=False) # Check for "native" platform dependencies conf.env.HAVE_GL = False if platform == 'darwin': conf.check_cc(framework_name='Cocoa', framework='Cocoa', uselib_store='COCOA') conf.check_cc(framework_name='Corevideo', framework='Corevideo', uselib_store='COREVIDEO') if not Options.options.no_gl: conf.check_cc(framework_name='OpenGL', uselib_store='GL', mandatory=False) conf.env.HAVE_GL = conf.env.FRAMEWORK_GL elif platform == 'win32': conf.check_cc(lib='gdi32', uselib_store='GDI32') conf.check_cc(lib='user32', uselib_store='USER32') if not Options.options.no_gl: conf.check_cc(lib='opengl32', uselib_store='GL', mandatory=False) conf.env.HAVE_GL = conf.env.LIB_GL else: conf.check_cc(lib='X11', uselib_store='X11') xsync_fragment = """#include #include int main(void) { XSyncQueryExtension(0, 0, 0); return 0; }""" if conf.check_cc(fragment=xsync_fragment, uselib_store='XSYNC', lib='Xext', mandatory=False, msg='Checking for function XSyncQueryExtension'): conf.define('HAVE_XSYNC', 1) if conf.check_cc(lib='Xcursor', uselib_store='XCURSOR', mandatory=False): conf.define('HAVE_XCURSOR', 1) if conf.check_cc(lib='Xrandr', uselib_store='XRANDR', mandatory=False): conf.define('HAVE_XRANDR', 1) if not Options.options.no_gl: glx_fragment = """#include int main(void) { glXSwapBuffers(0, 0); return 0; }""" conf.check_cc(lib='GLX', uselib_store='GLX', mandatory=False) conf.check_cc(lib='GL', uselib_store='GL', mandatory=False) conf.check_cc(fragment=glx_fragment, lib='GLX' if conf.env.LIB_GLX else 'GL', mandatory=False, msg='Checking for GLX') conf.env.HAVE_GL = conf.env.LIB_GL or conf.env.LIB_GLX # Check for Cairo via pkg-config if not Options.options.no_cairo: autowaf.check_pkg(conf, 'cairo', uselib_store = 'CAIRO', atleast_version = '1.0.0', system = True, mandatory = False) conf.env.update({ 'BUILD_SHARED': not Options.options.no_shared, 'BUILD_STATIC': conf.env.BUILD_TESTS or not Options.options.no_static, 'BUILD_STRICT_HEADER_TEST': Options.options.strict}) if conf.env.TARGET_PLATFORM == 'win32': conf.env.PUGL_PLATFORM = 'win' elif conf.env.TARGET_PLATFORM == 'darwin': conf.env.PUGL_PLATFORM = 'mac' else: conf.env.PUGL_PLATFORM = 'x11' autowaf.set_lib_env(conf, 'pugl', PUGL_VERSION, lib='pugl_' + conf.env.PUGL_PLATFORM) autowaf.set_lib_env(conf, 'pugl_gl', PUGL_VERSION, lib='pugl_%s_gl' % conf.env.PUGL_PLATFORM) autowaf.display_summary( conf, {"Build static library": bool(conf.env.BUILD_STATIC), "Build shared library": bool(conf.env.BUILD_SHARED), "OpenGL support": bool(conf.env.HAVE_GL), "Cairo support": bool(conf.env.HAVE_CAIRO)}) def _build_pc_file(bld, name, desc, target, libname, deps={}, requires=[]): "Builds a pkg-config file for a library" env = bld.env prefix = env.PREFIX xprefix = os.path.dirname(env.LIBDIR) libname = '%s-%s' % (libname, PUGL_MAJOR_VERSION) uselib = deps.get('uselib', []) pkg_deps = [l for l in uselib if 'PKG_' + l.lower() in env] lib_deps = [l for l in uselib if 'PKG_' + l.lower() not in env] link_flags = [env.LIB_ST % l for l in (deps.get('lib', []) + [libname])] for l in lib_deps: link_flags += [env.LIB_ST % l for l in env['LIB_' + l]] for f in deps.get('framework', []): link_flags += ['-framework', f] bld(features='subst', source='pugl.pc.in', target='%s-%s.pc' % (target, PUGL_MAJOR_VERSION), install_path=os.path.join(env.LIBDIR, 'pkgconfig'), PREFIX=prefix, EXEC_PREFIX='${prefix}' if xprefix == prefix else xprefix, LIBDIR='${exec_prefix}/' + os.path.basename(env.LIBDIR), INCLUDEDIR=env.INCLUDEDIR.replace(prefix, '${prefix}', 1), NAME=name, DESCRIPTION=desc, PUGL_MAJOR_VERSION=PUGL_MAJOR_VERSION, REQUIRES=' '.join(requires + [p.lower() for p in pkg_deps]), LIBS=' '.join(link_flags)) gl_tests = ['gl_hints'] basic_tests = [ 'realize', 'redisplay', 'show_hide', 'stub_hints', 'timer', 'update', ] tests = gl_tests + basic_tests def build(bld): # C Headers includedir = '${INCLUDEDIR}/pugl-%s/pugl' % PUGL_MAJOR_VERSION bld.install_files(includedir, bld.path.ant_glob('include/pugl/*.h')) bld.install_files(includedir, bld.path.ant_glob('include/pugl/*.hpp')) bld.install_files(includedir, bld.path.ant_glob('include/pugl/*.ipp')) if bld.env.ALL_HEADERS: detaildir = os.path.join(includedir, 'detail') bld.install_files(detaildir, bld.path.ant_glob('include/pugl/detail/*.h')) bld.install_files(detaildir, bld.path.ant_glob('include/pugl/detail/*.c')) # Library dependencies of pugl libraries (for building examples) deps = {} def build_pugl_lib(name, **kwargs): deps[name] = {} for k in ('lib', 'framework', 'uselib'): deps[name][k] = kwargs.get(k, []) args = kwargs.copy() args.update({'includes': ['include'], 'export_includes': ['include'], 'install_path': '${LIBDIR}', 'vnum': PUGL_VERSION}) flags = [] if not bld.env.MSVC_COMPILER: flags = ['-fvisibility=hidden'] if bld.env.TARGET_PLATFORM != 'win32': flags = ['-fPIC'] if bld.env.BUILD_SHARED: bld(features = 'c cshlib', name = name, target = 'pugl_%s-%s' % (name, PUGL_MAJOR_VERSION), defines = ['PUGL_INTERNAL', 'PUGL_SHARED'], cflags = flags, linkflags = flags, **args) if bld.env.BUILD_STATIC: bld(features = 'c cstlib', name = 'pugl_%s_static' % name, target = 'pugl_%s-%s' % (name, PUGL_MAJOR_VERSION), defines = ['PUGL_INTERNAL', 'PUGL_DISABLE_DEPRECATED'], cflags = flags, linkflags = flags, **args) def build_platform(platform, **kwargs): build_pugl_lib(platform, **kwargs) _build_pc_file(bld, 'Pugl', 'Pugl GUI library core', 'pugl', 'pugl_%s' % platform, deps=kwargs) def build_backend(platform, backend, **kwargs): name = '%s_%s' % (platform, backend) label = 'OpenGL' if backend == 'gl' else backend.title() build_pugl_lib(name, **kwargs) _build_pc_file(bld, 'Pugl %s' % label, 'Pugl GUI library with %s backend' % label, 'pugl-%s' % backend, 'pugl_' + name, deps=kwargs, requires=['pugl-%s' % PUGL_MAJOR_VERSION]) lib_source = ['include/pugl/detail/implementation.c'] if bld.env.TARGET_PLATFORM == 'win32': platform = 'win' build_platform('win', uselib=['GDI32', 'USER32'], source=lib_source + ['include/pugl/detail/win.c']) build_backend('win', 'stub', uselib=['GDI32', 'USER32'], source=['include/pugl/detail/win_stub.c']) if bld.env.HAVE_GL: build_backend('win', 'gl', uselib=['GDI32', 'USER32', 'GL'], source=['include/pugl/detail/win_gl.c']) if bld.env.HAVE_CAIRO: build_backend('win', 'cairo', uselib=['CAIRO', 'GDI32', 'USER32'], source=['include/pugl/detail/win_cairo.c', 'include/pugl/detail/win_stub.c']) elif bld.env.TARGET_PLATFORM == 'darwin': platform = 'mac' build_platform('mac', framework=['Cocoa', 'Corevideo'], source=lib_source + ['include/pugl/detail/mac.m']) build_backend('mac', 'stub', framework=['Cocoa', 'Corevideo'], source=['include/pugl/detail/mac_stub.m']) if bld.env.HAVE_GL: build_backend('mac', 'gl', framework=['Cocoa', 'Corevideo', 'OpenGL'], source=['include/pugl/detail/mac_gl.m']) if bld.env.HAVE_CAIRO: build_backend('mac', 'cairo', framework=['Cocoa', 'Corevideo'], uselib=['CAIRO'], source=['include/pugl/detail/mac_cairo.m']) else: platform = 'x11' build_platform('x11', uselib=['M', 'X11', 'XSYNC', 'XCURSOR', 'XRANDR'], source=lib_source + ['include/pugl/detail/x11.c']) build_backend('x11', 'stub', uselib=['X11'], source=['include/pugl/detail/x11_stub.c']) if bld.env.HAVE_GL: glx_lib = 'GLX' if bld.env.LIB_GLX else 'GL' build_backend('x11', 'gl', uselib=[glx_lib, 'X11'], source=['include/pugl/detail/x11_gl.c']) if bld.env.HAVE_CAIRO: build_backend('x11', 'cairo', uselib=['CAIRO', 'X11'], source=['include/pugl/detail/x11_cairo.c', 'include/pugl/detail/x11_stub.c']) def build_example(prog, source, platform, backend, **kwargs): lang = 'cxx' if source[0].endswith('.cpp') else 'c' use = ['pugl_%s_static' % platform, 'pugl_%s_%s_static' % (platform, backend)] target = prog if bld.env.TARGET_PLATFORM == 'darwin': target = '{0}.app/Contents/MacOS/{0}'.format(prog) bld(features = 'subst', source = 'resources/Info.plist.in', target = '{}.app/Contents/Info.plist'.format(prog), includes = ['.'], install_path = '', NAME = prog) backend_lib = platform + '_' + backend for k in ('lib', 'framework', 'uselib'): kwargs.update({k: (kwargs.get(k, []) + deps.get(platform, {}).get(k, []) + deps.get(backend_lib, {}).get(k, []))}) bld(features = '%s %sprogram' % (lang, lang), source = source, target = target, includes = ['.'], use = use, install_path = '', **kwargs) if bld.env.BUILD_TESTS: for s in ('rect.vert', 'rect.frag'): # Copy shaders to build directory for example programs bld(features = 'subst', is_copy = True, source = 'shaders/%s' % s, target = 'shaders/%s' % s) if bld.env.HAVE_GL: glad_cflags = [] if bld.env.MSVC_COMPILER else ['-Wno-pedantic'] build_example('pugl_embed_demo', ['examples/pugl_embed_demo.c'], platform, 'gl', uselib=['GL', 'M']) build_example('pugl_window_demo', ['examples/pugl_window_demo.c'], platform, 'gl', uselib=['GL', 'M']) build_example('pugl_cursor_demo', ['examples/pugl_cursor_demo.c'], platform, 'gl', uselib=['GL', 'M']) build_example('pugl_print_events', ['examples/pugl_print_events.c'], platform, 'stub') build_example('pugl_shader_demo', ['examples/pugl_shader_demo.c', 'examples/glad/glad.c'], platform, 'gl', cflags=glad_cflags, uselib=['DL', 'GL', 'M']) for test in gl_tests: bld(features = 'c cprogram', source = 'test/test_%s.c' % test, target = 'test/test_%s' % test, install_path = '', use = ['pugl_%s_static' % platform, 'pugl_%s_gl_static' % platform], uselib = deps[platform]['uselib'] + ['GL']) if bld.env.HAVE_CAIRO: build_example('pugl_cairo_demo', ['examples/pugl_cairo_demo.c'], platform, 'cairo', uselib=['M', 'CAIRO']) for test in basic_tests: bld(features = 'c cprogram', source = 'test/test_%s.c' % test, target = 'test/test_%s' % test, install_path = '', use = ['pugl_%s_static' % platform, 'pugl_%s_stub_static' % platform, 'pugl_%s_gl_static' % platform], uselib = deps[platform]['uselib'] + ['CAIRO']) if bld.env.BUILD_STRICT_HEADER_TEST: # Make a hyper strict warning environment for checking API headers strict_env = bld.env.derive() autowaf.remove_all_warning_flags(strict_env) autowaf.enable_all_warnings(strict_env) autowaf.set_warnings_as_errors(strict_env) autowaf.add_compiler_flags(strict_env, '*', { 'clang': ['-Wno-padded'], 'gcc': ['-Wno-padded', '-Wno-suggest-attribute=const'], 'msvc': [ '/wd4514', # unreferenced inline function has been removed '/wd4820', # padding added after construct ], }) autowaf.add_compiler_flags(strict_env, 'cxx', { 'clang': ['-Wno-documentation-unknown-command'], 'msvc': [ '/wd4355', # 'this' used in base member initializer list '/wd4571', # structured exceptions are no longer caught ], }) # Check that C headers build with (almost) no warnings bld(features = 'c cprogram', source = 'test/test_build.c', target = 'test/test_build_c', install_path = '', env = strict_env, use = ['pugl_%s_static' % platform], uselib = deps[platform]['uselib'] + ['CAIRO']) # Check that C++ headers build with (almost) no warnings bld(features = 'cxx cxxprogram', source = 'test/test_build.cpp', target = 'test/test_build_cpp', install_path = '', env = strict_env, use = ['pugl_%s_static' % platform], uselib = deps[platform]['uselib'] + ['CAIRO']) if bld.env.CXX and bld.env.HAVE_GL: build_example('pugl_cxx_demo', ['examples/pugl_cxx_demo.cpp'], platform, 'gl', defines=['PUGL_DISABLE_DEPRECATED'], uselib=['GL', 'M']) if bld.env.DOCS: autowaf.build_dox(bld, 'PUGL', PUGL_VERSION, top, out) def test(tst): if tst.options.gui_tests: with tst.group('gui') as check: for test in basic_tests: check(['test/test_%s' % test]) if tst.env.HAVE_GL: for test in gl_tests: check(['test/test_%s' % test]) class LintContext(Build.BuildContext): fun = cmd = 'lint' def lint(ctx): "checks code for style issues" import json import subprocess st = 0 if "FLAKE8" in ctx.env: Logs.info("Running flake8") st = subprocess.call([ctx.env.FLAKE8[0], "wscript", "--ignore", "E221,W504,E251,E241,E741"]) else: Logs.warn("Not running flake8") if "IWYU_TOOL" in ctx.env: Logs.info("Running include-what-you-use") cmd = [ctx.env.IWYU_TOOL[0], "-o", "clang", "-p", "build", "--", "-Xiwyu", "--check_also=pugl/*.h", "-Xiwyu", "--check_also=pugl/*.hpp", "-Xiwyu", "--check_also=pugl/*.ipp", "-Xiwyu", "--check_also=pugl/detail/*.c", "-Xiwyu", "--check_also=pugl/detail/*.h", "-Xiwyu", "--check_also=pugl/detail/*.m"] output = subprocess.check_output(cmd).decode('utf-8') if 'error: ' in output: sys.stdout.write(output) st += 1 else: Logs.warn("Not running include-what-you-use") if "CLANG_TIDY" in ctx.env and "clang" in ctx.env.CC[0]: Logs.info("Running clang-tidy") with open('build/compile_commands.json', 'r') as db: commands = json.load(db) files = [c['file'] for c in commands if os.path.basename(c['file']) != 'glad.c'] c_files = [os.path.join('build', f) for f in files if f.endswith('.c')] cpp_files = [os.path.join('build', f) for f in files if f.endswith('.cpp')] c_files = list(map(os.path.abspath, c_files)) cpp_files = list(map(os.path.abspath, cpp_files)) procs = [] for c_file in c_files: cmd = [ctx.env.CLANG_TIDY[0], "--quiet", "-p=.", c_file] procs += [subprocess.Popen(cmd, cwd="build")] for cpp_file in cpp_files: cmd = [ctx.env.CLANG_TIDY[0], '--header-filter=".*\\.hpp"', "--quiet", "-p=.", cpp_file] procs += [subprocess.Popen(cmd, cwd="build")] for proc in procs: stdout, stderr = proc.communicate() st += proc.returncode else: Logs.warn("Not running clang-tidy") if st != 0: sys.exit(st) # Alias .m files to be compiled like .c files, gcc will do the right thing. @TaskGen.extension('.m') def m_hook(self, node): return self.create_compiled_task('c', node)