blob: 0241a042219a8e36ce840f6bc6191cc6699b2381 [file] [log] [blame]
Alexander Afanasyev7a696fb2012-03-01 17:17:22 -08001# -*- Mode: python; py-indent-offset: 4; indent-tabs-mode: nil; coding: utf-8; -*-
2
Davide Pesavento9330c2e2023-09-14 21:38:02 -04003import os
4import subprocess
5from waflib import Context, Logs
Davide Pesaventoc47774f2019-11-09 17:25:09 -05006
Davide Pesavento3fb27eb2022-12-31 14:00:51 -05007VERSION = '0.5.5'
Yingdi Yu06a678a2014-08-01 17:07:08 -07008APPNAME = 'ChronoSync'
Alexander Afanasyevf5fca3a2018-02-22 10:50:04 -05009GIT_TAG_PREFIX = ''
Davide Pesavento7ef57e22017-10-28 16:58:43 -040010
Alexander Afanasyeve76f2632012-03-05 00:18:42 -080011def options(opt):
Davide Pesavento5f408ae2020-07-15 21:17:04 -040012 opt.load(['compiler_cxx', 'gnu_dirs'])
13 opt.load(['default-compiler-flags',
14 'coverage', 'sanitizers', 'boost',
15 'doxygen', 'sphinx_build'],
Yingdi Yu06a678a2014-08-01 17:07:08 -070016 tooldir=['.waf-tools'])
Alexander Afanasyev6133f9a2013-07-14 10:58:26 -070017
Davide Pesaventoc47774f2019-11-09 17:25:09 -050018 optgrp = opt.add_option_group('ChronoSync Options')
19 optgrp.add_option('--with-tests', action='store_true', default=False,
20 help='Build unit tests')
Alexander Afanasyev7a696fb2012-03-01 17:17:22 -080021
Alexander Afanasyev8f25cbb2012-03-01 23:53:40 -080022def configure(conf):
Davide Pesavento5f408ae2020-07-15 21:17:04 -040023 conf.load(['compiler_cxx', 'gnu_dirs',
Davide Pesaventoc47774f2019-11-09 17:25:09 -050024 'default-compiler-flags', 'boost',
Alexander Afanasyevf3192eb2016-12-19 17:11:20 -080025 'doxygen', 'sphinx_build'])
Alexander Afanasyev158ec0d2012-04-05 13:48:55 -070026
Davide Pesaventoc47774f2019-11-09 17:25:09 -050027 conf.env.WITH_TESTS = conf.options.with_tests
Yingdi Yu7c64e5c2014-04-30 14:06:37 -070028
Davide Pesavento9c4bd6d2022-07-26 15:28:08 -040029 conf.find_program('dot', mandatory=False)
30
31 # Prefer pkgconf if it's installed, because it gives more correct results
32 # on Fedora/CentOS/RHEL/etc. See https://bugzilla.redhat.com/show_bug.cgi?id=1953348
33 # Store the result in env.PKGCONFIG, which is the variable used inside check_cfg()
34 conf.find_program(['pkgconf', 'pkg-config'], var='PKGCONFIG')
35
Davide Pesavento5a6292d2022-03-12 15:26:16 -050036 pkg_config_path = os.environ.get('PKG_CONFIG_PATH', f'{conf.env.LIBDIR}/pkgconfig')
Davide Pesavento3fb27eb2022-12-31 14:00:51 -050037 conf.check_cfg(package='libndn-cxx', args=['libndn-cxx >= 0.8.1', '--cflags', '--libs'],
Davide Pesavento5a6292d2022-03-12 15:26:16 -050038 uselib_store='NDN_CXX', pkg_config_path=pkg_config_path)
Davide Pesaventoc47774f2019-11-09 17:25:09 -050039
Davide Pesavento9330c2e2023-09-14 21:38:02 -040040 conf.check_boost(lib='iostreams', mt=True)
Davide Pesaventoc47774f2019-11-09 17:25:09 -050041
Davide Pesavento9330c2e2023-09-14 21:38:02 -040042 if conf.env.WITH_TESTS:
43 conf.check_boost(lib='filesystem unit_test_framework', mt=True, uselib_store='BOOST_TESTS')
Alexander Afanasyev0ad7c212012-04-05 13:31:14 -070044
Alexander Afanasyev12d5faa2017-09-21 19:04:22 -040045 conf.check_compiler_flags()
46
Davide Pesavento7ef57e22017-10-28 16:58:43 -040047 # Loading "late" to prevent tests from being compiled with profiling flags
48 conf.load('coverage')
Ashlesh Gawande687cf922017-05-30 15:04:16 -050049 conf.load('sanitizers')
50
Alexander Afanasyevf3192eb2016-12-19 17:11:20 -080051 # If there happens to be a static library, waf will put the corresponding -L flags
52 # before dynamic library flags. This can result in compilation failure when the
53 # system has a different version of the ChronoSync library installed.
Davide Pesaventoc47774f2019-11-09 17:25:09 -050054 conf.env.prepend_value('STLIBPATH', ['.'])
Alexander Afanasyevf3192eb2016-12-19 17:11:20 -080055
Davide Pesavento07684bc2021-02-07 20:09:28 -050056 conf.define_cond('WITH_TESTS', conf.env.WITH_TESTS)
Davide Pesaventoc47774f2019-11-09 17:25:09 -050057 # The config header will contain all defines that were added using conf.define()
58 # or conf.define_cond(). Everything that was added directly to conf.env.DEFINES
59 # will not appear in the config header, but will instead be passed directly to the
60 # compiler on the command line.
Davide Pesavento07684bc2021-02-07 20:09:28 -050061 conf.write_config_header('src/detail/config.hpp', define_prefix='CHRONOSYNC_')
Yingdi Yub20ae812014-08-15 11:20:19 -070062
Alexander Afanasyev7eb59112014-07-02 14:21:11 -070063def build(bld):
Davide Pesavento9330c2e2023-09-14 21:38:02 -040064 bld.shlib(
65 target='ChronoSync',
66 vnum=VERSION,
67 cnum=VERSION,
68 source=bld.path.ant_glob('src/**/*.cpp'),
69 use='BOOST NDN_CXX',
70 includes='src/detail',
71 export_includes='src src/detail')
Yingdi Yu7c64e5c2014-04-30 14:06:37 -070072
Davide Pesaventoc47774f2019-11-09 17:25:09 -050073 if bld.env.WITH_TESTS:
Yingdi Yub20ae812014-08-15 11:20:19 -070074 bld.recurse('tests')
Alexander Afanasyev6af3c152012-06-07 21:14:24 -070075
Davide Pesavento9330c2e2023-09-14 21:38:02 -040076 # Install header files
Davide Pesavento07684bc2021-02-07 20:09:28 -050077 srcdir = bld.path.find_dir('src')
78 bld.install_files('${INCLUDEDIR}/ChronoSync',
79 srcdir.ant_glob('**/*.hpp'),
80 cwd=srcdir,
81 relative_trick=True)
Davide Pesavento9330c2e2023-09-14 21:38:02 -040082 bld.install_files('${INCLUDEDIR}/ChronoSync/detail', 'src/detail/config.hpp')
Alexander Afanasyeve76f2632012-03-05 00:18:42 -080083
Davide Pesaventoc47774f2019-11-09 17:25:09 -050084 bld(features='subst',
Alexander Afanasyev7804c232013-07-14 12:15:41 -070085 source='ChronoSync.pc.in',
86 target='ChronoSync.pc',
Davide Pesaventoc47774f2019-11-09 17:25:09 -050087 install_path='${LIBDIR}/pkgconfig',
88 VERSION=VERSION)
Alexander Afanasyev6af3c152012-06-07 21:14:24 -070089
Yingdi Yu06a678a2014-08-01 17:07:08 -070090def docs(bld):
91 from waflib import Options
92 Options.commands = ['doxygen', 'sphinx'] + Options.commands
93
Alexander Afanasyev7eb59112014-07-02 14:21:11 -070094def doxygen(bld):
Yingdi Yu06a678a2014-08-01 17:07:08 -070095 version(bld)
96
Alexander Afanasyev34ebcb72012-03-08 15:54:55 -080097 if not bld.env.DOXYGEN:
Alexander Afanasyev40491df2018-03-09 16:29:52 -050098 bld.fatal('Cannot build documentation ("doxygen" not found in PATH)')
Yingdi Yu06a678a2014-08-01 17:07:08 -070099
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500100 bld(features='subst',
101 name='doxygen.conf',
102 source=['docs/doxygen.conf.in',
103 'docs/named_data_theme/named_data_footer-with-analytics.html.in'],
104 target=['docs/doxygen.conf',
105 'docs/named_data_theme/named_data_footer-with-analytics.html'],
106 VERSION=VERSION,
Davide Pesavento9c4bd6d2022-07-26 15:28:08 -0400107 HAVE_DOT='YES' if bld.env.DOT else 'NO',
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500108 HTML_FOOTER='../build/docs/named_data_theme/named_data_footer-with-analytics.html' \
109 if os.getenv('GOOGLE_ANALYTICS', None) \
110 else '../docs/named_data_theme/named_data_footer.html',
111 GOOGLE_ANALYTICS=os.getenv('GOOGLE_ANALYTICS', ''))
112
113 bld(features='doxygen',
114 doxyfile='docs/doxygen.conf',
115 use='doxygen.conf')
Yingdi Yu06a678a2014-08-01 17:07:08 -0700116
117def sphinx(bld):
118 version(bld)
119
120 if not bld.env.SPHINX_BUILD:
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500121 bld.fatal('Cannot build documentation ("sphinx-build" not found in PATH)')
122
123 bld(features='sphinx',
124 config='docs/conf.py',
125 outdir='docs',
126 source=bld.path.ant_glob('docs/**/*.rst'),
Davide Pesaventoc47774f2019-11-09 17:25:09 -0500127 version=VERSION_BASE,
128 release=VERSION)
Yingdi Yu06a678a2014-08-01 17:07:08 -0700129
130def version(ctx):
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500131 # don't execute more than once
Yingdi Yu06a678a2014-08-01 17:07:08 -0700132 if getattr(Context.g_module, 'VERSION_BASE', None):
133 return
134
135 Context.g_module.VERSION_BASE = Context.g_module.VERSION
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500136 Context.g_module.VERSION_SPLIT = VERSION_BASE.split('.')
Yingdi Yu06a678a2014-08-01 17:07:08 -0700137
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500138 # first, try to get a version string from git
139 gotVersionFromGit = False
Yingdi Yu06a678a2014-08-01 17:07:08 -0700140 try:
Davide Pesavento9330c2e2023-09-14 21:38:02 -0400141 cmd = ['git', 'describe', '--always', '--match', f'{GIT_TAG_PREFIX}*']
142 out = subprocess.run(cmd, capture_output=True, check=True, text=True).stdout.strip()
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500143 if out:
144 gotVersionFromGit = True
Alexander Afanasyevf5fca3a2018-02-22 10:50:04 -0500145 if out.startswith(GIT_TAG_PREFIX):
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500146 Context.g_module.VERSION = out.lstrip(GIT_TAG_PREFIX)
Alexander Afanasyevf5fca3a2018-02-22 10:50:04 -0500147 else:
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500148 # no tags matched
Davide Pesavento9330c2e2023-09-14 21:38:02 -0400149 Context.g_module.VERSION = f'{VERSION_BASE}-commit-{out}'
150 except (OSError, subprocess.SubprocessError):
Yingdi Yu06a678a2014-08-01 17:07:08 -0700151 pass
152
Alexander Afanasyev675d6fb2020-06-01 18:55:17 -0400153 versionFile = ctx.path.find_node('VERSION.info')
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500154 if not gotVersionFromGit and versionFile is not None:
Alexander Afanasyevf5fca3a2018-02-22 10:50:04 -0500155 try:
156 Context.g_module.VERSION = versionFile.read()
157 return
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500158 except EnvironmentError:
Alexander Afanasyevf5fca3a2018-02-22 10:50:04 -0500159 pass
160
161 # version was obtained from git, update VERSION file if necessary
162 if versionFile is not None:
163 try:
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500164 if versionFile.read() == Context.g_module.VERSION:
165 # already up-to-date
166 return
167 except EnvironmentError as e:
Davide Pesavento9330c2e2023-09-14 21:38:02 -0400168 Logs.warn(f'{versionFile} exists but is not readable ({e.strerror})')
Alexander Afanasyevf5fca3a2018-02-22 10:50:04 -0500169 else:
Alexander Afanasyev675d6fb2020-06-01 18:55:17 -0400170 versionFile = ctx.path.make_node('VERSION.info')
Alexander Afanasyevf5fca3a2018-02-22 10:50:04 -0500171
Alexander Afanasyevf5fca3a2018-02-22 10:50:04 -0500172 try:
173 versionFile.write(Context.g_module.VERSION)
Alexander Afanasyev40491df2018-03-09 16:29:52 -0500174 except EnvironmentError as e:
Davide Pesavento9330c2e2023-09-14 21:38:02 -0400175 Logs.warn(f'{versionFile} is not writable ({e.strerror})')
Alexander Afanasyevf5fca3a2018-02-22 10:50:04 -0500176
Yingdi Yu06a678a2014-08-01 17:07:08 -0700177def dist(ctx):
Davide Pesavento2ff10562023-02-19 20:14:06 -0500178 ctx.algo = 'tar.xz'
Yingdi Yu06a678a2014-08-01 17:07:08 -0700179 version(ctx)
180
181def distcheck(ctx):
Davide Pesavento2ff10562023-02-19 20:14:06 -0500182 ctx.algo = 'tar.xz'
Yingdi Yu06a678a2014-08-01 17:07:08 -0700183 version(ctx)