blob: 8230aad7e856b3ea72c2063245c6c90fd09771fd [file] [log] [blame]
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -05001# -*- Mode: python; py-indent-offset: 4; indent-tabs-mode: nil; coding: utf-8; -*-
2
Davide Pesavento0b272e02023-09-23 20:22:01 -04003import os
4import subprocess
5from waflib import Context, Logs
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -05006
Davide Pesaventoec8f8542023-01-18 23:10:24 -05007VERSION = '0.4.0'
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -05008APPNAME = 'PSync'
9GIT_TAG_PREFIX = ''
10
Ashlesh Gawanded51690a2019-11-11 22:51:06 -060011BOOST_COMPRESSION_CODE = '''
12#include <boost/iostreams/filter/{0}.hpp>
13int main() {{ boost::iostreams::{0}_compressor test; }}
14'''
Ashlesh Gawanded51690a2019-11-11 22:51:06 -060015COMPRESSION_SCHEMES = ['zlib', 'gzip', 'bzip2', 'lzma', 'zstd']
16
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050017def options(opt):
Davide Pesavento042dfb32020-07-23 21:07:16 -040018 opt.load(['compiler_cxx', 'gnu_dirs'])
19 opt.load(['default-compiler-flags',
20 'coverage', 'sanitizers', 'boost',
Davide Pesavento8c7c2282024-03-13 18:32:32 -040021 'doxygen', 'sphinx'],
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050022 tooldir=['.waf-tools'])
23
Davide Pesavento17b266c2019-04-06 21:37:43 -040024 optgrp = opt.add_option_group('PSync Options')
25 optgrp.add_option('--with-examples', action='store_true', default=False,
26 help='Build examples')
27 optgrp.add_option('--with-tests', action='store_true', default=False,
28 help='Build unit tests')
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050029
Ashlesh Gawanded51690a2019-11-11 22:51:06 -060030 for scheme in COMPRESSION_SCHEMES:
Davide Pesavento0b272e02023-09-23 20:22:01 -040031 optgrp.add_option(f'--without-{scheme}', action='store_true', default=False,
32 help=f'Disable support for {scheme} (de)compression')
Ashlesh Gawanded51690a2019-11-11 22:51:06 -060033
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050034def configure(conf):
Davide Pesavento042dfb32020-07-23 21:07:16 -040035 conf.load(['compiler_cxx', 'gnu_dirs',
Davide Pesaventoda278492019-01-29 15:00:49 -050036 'default-compiler-flags', 'boost',
Davide Pesavento8c7c2282024-03-13 18:32:32 -040037 'doxygen', 'sphinx'])
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050038
Davide Pesavento17b266c2019-04-06 21:37:43 -040039 conf.env.WITH_EXAMPLES = conf.options.with_examples
40 conf.env.WITH_TESTS = conf.options.with_tests
41
Davide Pesaventof2784382022-07-09 19:58:53 -040042 conf.find_program('dot', mandatory=False)
43
44 # Prefer pkgconf if it's installed, because it gives more correct results
45 # on Fedora/CentOS/RHEL/etc. See https://bugzilla.redhat.com/show_bug.cgi?id=1953348
46 # Store the result in env.PKGCONFIG, which is the variable used inside check_cfg()
47 conf.find_program(['pkgconf', 'pkg-config'], var='PKGCONFIG')
Davide Pesavento75496282021-04-25 16:38:22 -040048
Davide Pesavento85a73d22022-03-06 16:00:01 -050049 pkg_config_path = os.environ.get('PKG_CONFIG_PATH', f'{conf.env.LIBDIR}/pkgconfig')
Davide Pesaventoec8f8542023-01-18 23:10:24 -050050 conf.check_cfg(package='libndn-cxx', args=['libndn-cxx >= 0.8.1', '--cflags', '--libs'],
Davide Pesavento85a73d22022-03-06 16:00:01 -050051 uselib_store='NDN_CXX', pkg_config_path=pkg_config_path)
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050052
Davide Pesavento0b272e02023-09-23 20:22:01 -040053 conf.check_boost(lib='iostreams', mt=True)
Davide Pesavento690272d2023-09-23 20:33:42 -040054 if conf.env.BOOST_VERSION_NUMBER < 107100:
55 conf.fatal('The minimum supported version of Boost is 1.71.0.\n'
56 'Please upgrade your distribution or manually install a newer version of Boost.\n'
57 'For more information, see https://redmine.named-data.net/projects/nfd/wiki/Boost')
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050058
Ashlesh Gawanded51690a2019-11-11 22:51:06 -060059 for scheme in COMPRESSION_SCHEMES:
Davide Pesavento0b272e02023-09-23 20:22:01 -040060 if getattr(conf.options, f'without_{scheme}'):
Ashlesh Gawanded51690a2019-11-11 22:51:06 -060061 continue
62 conf.check_cxx(fragment=BOOST_COMPRESSION_CODE.format(scheme),
63 use='BOOST', execute=False, mandatory=False,
Davide Pesavento0b272e02023-09-23 20:22:01 -040064 msg=f'Checking for {scheme} support in boost iostreams',
65 define_name=f'HAVE_{scheme.upper()}')
66
67 if conf.env.WITH_TESTS:
68 conf.check_boost(lib='unit_test_framework', mt=True, uselib_store='BOOST_TESTS')
Ashlesh Gawanded51690a2019-11-11 22:51:06 -060069
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050070 conf.check_compiler_flags()
71
Davide Pesavento17b266c2019-04-06 21:37:43 -040072 # Loading "late" to prevent tests from being compiled with profiling flags
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050073 conf.load('coverage')
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050074 conf.load('sanitizers')
75
76 # If there happens to be a static library, waf will put the corresponding -L flags
77 # before dynamic library flags. This can result in compilation failure when the
78 # system has a different version of the PSync library installed.
Davide Pesavento17b266c2019-04-06 21:37:43 -040079 conf.env.prepend_value('STLIBPATH', ['.'])
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050080
Davide Pesavento17b266c2019-04-06 21:37:43 -040081 conf.define_cond('WITH_TESTS', conf.env.WITH_TESTS)
82 # The config header will contain all defines that were added using conf.define()
83 # or conf.define_cond(). Everything that was added directly to conf.env.DEFINES
84 # will not appear in the config header, but will instead be passed directly to the
85 # compiler on the command line.
86 conf.write_config_header('PSync/detail/config.hpp', define_prefix='PSYNC_')
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -050087
88def build(bld):
Davide Pesavento0b272e02023-09-23 20:22:01 -040089 bld.shlib(
90 target='PSync',
91 vnum=VERSION,
92 cnum=VERSION,
93 source=bld.path.ant_glob('PSync/**/*.cpp'),
94 use='BOOST NDN_CXX',
95 includes='.',
96 export_includes='.')
Davide Pesavento17b266c2019-04-06 21:37:43 -040097
98 if bld.env.WITH_TESTS:
99 bld.recurse('tests')
100
101 if bld.env.WITH_EXAMPLES:
102 bld.recurse('examples')
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500103
Davide Pesavento0b272e02023-09-23 20:22:01 -0400104 # Install header files
Ashlesh Gawande78b94ad2018-12-13 15:29:19 -0600105 headers = bld.path.ant_glob('PSync/**/*.hpp')
Davide Pesaventoc407dee2022-07-21 23:56:05 -0400106 bld.install_files('${INCLUDEDIR}', headers, relative_trick=True)
Davide Pesavento0b272e02023-09-23 20:22:01 -0400107 bld.install_files('${INCLUDEDIR}/PSync/detail', 'PSync/detail/config.hpp')
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500108
Davide Pesavento17b266c2019-04-06 21:37:43 -0400109 bld(features='subst',
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500110 source='PSync.pc.in',
111 target='PSync.pc',
Davide Pesavento34f7eea2019-11-09 17:33:45 -0500112 install_path='${LIBDIR}/pkgconfig',
113 VERSION=VERSION)
Ashlesh Gawande4c0a7472018-08-08 12:20:33 -0500114
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500115def docs(bld):
116 from waflib import Options
117 Options.commands = ['doxygen', 'sphinx'] + Options.commands
118
119def doxygen(bld):
120 version(bld)
121
122 if not bld.env.DOXYGEN:
123 bld.fatal('Cannot build documentation ("doxygen" not found in PATH)')
124
125 bld(features='subst',
126 name='doxygen.conf',
127 source=['docs/doxygen.conf.in',
128 'docs/named_data_theme/named_data_footer-with-analytics.html.in'],
129 target=['docs/doxygen.conf',
130 'docs/named_data_theme/named_data_footer-with-analytics.html'],
131 VERSION=VERSION,
Davide Pesavento75496282021-04-25 16:38:22 -0400132 HAVE_DOT='YES' if bld.env.DOT else 'NO',
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500133 HTML_FOOTER='../build/docs/named_data_theme/named_data_footer-with-analytics.html' \
134 if os.getenv('GOOGLE_ANALYTICS', None) \
135 else '../docs/named_data_theme/named_data_footer.html',
136 GOOGLE_ANALYTICS=os.getenv('GOOGLE_ANALYTICS', ''))
137
138 bld(features='doxygen',
139 doxyfile='docs/doxygen.conf',
140 use='doxygen.conf')
141
142def sphinx(bld):
143 version(bld)
144
145 if not bld.env.SPHINX_BUILD:
146 bld.fatal('Cannot build documentation ("sphinx-build" not found in PATH)')
147
148 bld(features='sphinx',
149 config='docs/conf.py',
150 outdir='docs',
151 source=bld.path.ant_glob('docs/**/*.rst'),
Davide Pesavento34f7eea2019-11-09 17:33:45 -0500152 version=VERSION_BASE,
153 release=VERSION)
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500154
155def version(ctx):
156 # don't execute more than once
157 if getattr(Context.g_module, 'VERSION_BASE', None):
158 return
159
160 Context.g_module.VERSION_BASE = Context.g_module.VERSION
161 Context.g_module.VERSION_SPLIT = VERSION_BASE.split('.')
162
163 # first, try to get a version string from git
164 gotVersionFromGit = False
165 try:
Davide Pesavento0b272e02023-09-23 20:22:01 -0400166 cmd = ['git', 'describe', '--always', '--match', f'{GIT_TAG_PREFIX}*']
167 out = subprocess.run(cmd, capture_output=True, check=True, text=True).stdout.strip()
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500168 if out:
169 gotVersionFromGit = True
170 if out.startswith(GIT_TAG_PREFIX):
171 Context.g_module.VERSION = out.lstrip(GIT_TAG_PREFIX)
172 else:
173 # no tags matched
Davide Pesavento0b272e02023-09-23 20:22:01 -0400174 Context.g_module.VERSION = f'{VERSION_BASE}-commit-{out}'
175 except (OSError, subprocess.SubprocessError):
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500176 pass
177
Alexander Afanasyev89edd8f2020-06-01 18:58:54 -0400178 versionFile = ctx.path.find_node('VERSION.info')
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500179 if not gotVersionFromGit and versionFile is not None:
180 try:
181 Context.g_module.VERSION = versionFile.read()
182 return
183 except EnvironmentError:
184 pass
185
186 # version was obtained from git, update VERSION file if necessary
187 if versionFile is not None:
188 try:
189 if versionFile.read() == Context.g_module.VERSION:
190 # already up-to-date
191 return
192 except EnvironmentError as e:
Davide Pesavento0b272e02023-09-23 20:22:01 -0400193 Logs.warn(f'{versionFile} exists but is not readable ({e.strerror})')
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500194 else:
Alexander Afanasyev89edd8f2020-06-01 18:58:54 -0400195 versionFile = ctx.path.make_node('VERSION.info')
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500196
197 try:
198 versionFile.write(Context.g_module.VERSION)
199 except EnvironmentError as e:
Davide Pesavento0b272e02023-09-23 20:22:01 -0400200 Logs.warn(f'{versionFile} is not writable ({e.strerror})')
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500201
202def dist(ctx):
Davide Pesavento46bac782023-02-19 20:32:24 -0500203 ctx.algo = 'tar.xz'
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500204 version(ctx)
205
206def distcheck(ctx):
Davide Pesavento46bac782023-02-19 20:32:24 -0500207 ctx.algo = 'tar.xz'
Ashlesh Gawande0b2897e2018-06-20 14:40:47 -0500208 version(ctx)