blob: d4264d4afc839462a118466adfd391dd1caa99f0 [file] [log] [blame]
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -04001# -*- Mode: python; py-indent-offset: 4; indent-tabs-mode: nil; coding: utf-8; -*-
2
Davide Pesavento84348a22023-09-14 02:40:41 -04003import os
4import subprocess
5from waflib import Context, Logs
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -04006
7VERSION = '0.1.0'
8APPNAME = 'ndn-nac'
Davide Pesavento8f9d0622018-11-27 01:23:37 -05009GIT_TAG_PREFIX = 'nac-'
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040010
11def options(opt):
Davide Pesavento8f9d0622018-11-27 01:23:37 -050012 opt.load(['compiler_cxx', 'gnu_dirs'])
Davide Pesaventod4689c82021-10-07 02:53:03 -040013 opt.load(['default-compiler-flags',
14 'coverage', 'sanitizers', 'boost',
15 'doxygen', 'sphinx_build'],
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040016 tooldir=['.waf-tools'])
17
Davide Pesavento969d0f32023-09-14 14:28:41 -040018 optgrp = opt.add_option_group('NAC Options')
Davide Pesaventod4689c82021-10-07 02:53:03 -040019 optgrp.add_option('--with-examples', action='store_true', default=False,
20 help='Build examples')
Davide Pesavento27680ae2019-04-06 19:40:01 -040021 optgrp.add_option('--with-tests', action='store_true', default=False,
22 help='Build unit tests')
Davide Pesavento969d0f32023-09-14 14:28:41 -040023 optgrp.add_option('--without-tools', action='store_false', default=True, dest='with_tools',
24 help='Do not build tools')
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040025
26def configure(conf):
Davide Pesavento8f9d0622018-11-27 01:23:37 -050027 conf.load(['compiler_cxx', 'gnu_dirs',
28 'default-compiler-flags', 'boost',
29 'doxygen', 'sphinx_build'])
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040030
Davide Pesaventod4689c82021-10-07 02:53:03 -040031 conf.env.WITH_EXAMPLES = conf.options.with_examples
Davide Pesavento27680ae2019-04-06 19:40:01 -040032 conf.env.WITH_TESTS = conf.options.with_tests
Davide Pesavento969d0f32023-09-14 14:28:41 -040033 conf.env.WITH_TOOLS = conf.options.with_tools
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040034
Davide Pesavento7e7bd892022-07-10 00:30:06 -040035 conf.find_program('dot', mandatory=False)
36
37 # Prefer pkgconf if it's installed, because it gives more correct results
38 # on Fedora/CentOS/RHEL/etc. See https://bugzilla.redhat.com/show_bug.cgi?id=1953348
39 # Store the result in env.PKGCONFIG, which is the variable used inside check_cfg()
40 conf.find_program(['pkgconf', 'pkg-config'], var='PKGCONFIG')
Davide Pesaventoebeaeae2021-04-26 00:42:26 -040041
Davide Pesavento714dba02022-03-17 20:46:28 -040042 pkg_config_path = os.environ.get('PKG_CONFIG_PATH', f'{conf.env.LIBDIR}/pkgconfig')
Davide Pesaventod64a9d12023-01-01 16:30:03 -050043 conf.check_cfg(package='libndn-cxx', args=['libndn-cxx >= 0.8.1', '--cflags', '--libs'],
Davide Pesavento714dba02022-03-17 20:46:28 -040044 uselib_store='NDN_CXX', pkg_config_path=pkg_config_path)
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040045
Davide Pesavento27680ae2019-04-06 19:40:01 -040046 boost_libs = ['system', 'program_options']
47 if conf.env.WITH_TESTS:
48 boost_libs.append('unit_test_framework')
Alexander Afanasyevc9934282018-07-17 18:41:36 -040049
Davide Pesavento27680ae2019-04-06 19:40:01 -040050 conf.check_boost(lib=boost_libs, mt=True)
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040051
52 conf.check_compiler_flags()
53
54 # Loading "late" to prevent tests from being compiled with profiling flags
55 conf.load('coverage')
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040056 conf.load('sanitizers')
57
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040058 # If there happens to be a static library, waf will put the corresponding -L flags
59 # before dynamic library flags. This can result in compilation failure when the
Davide Pesavento27680ae2019-04-06 19:40:01 -040060 # system has a different version of the ndn-nac library installed.
61 conf.env.prepend_value('STLIBPATH', ['.'])
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040062
Davide Pesavento27680ae2019-04-06 19:40:01 -040063 conf.define_cond('WITH_TESTS', conf.env.WITH_TESTS)
64 # The config header will contain all defines that were added using conf.define()
65 # or conf.define_cond(). Everything that was added directly to conf.env.DEFINES
66 # will not appear in the config header, but will instead be passed directly to the
67 # compiler on the command line.
68 conf.write_config_header('config.hpp', define_prefix='NAC_')
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040069
70def build(bld):
71 version(bld)
72
Alexander Afanasyev2b57aeb2018-06-15 18:32:28 -040073 bld(features='subst',
74 name='version.hpp',
75 source='src/version.hpp.in',
76 target='src/version.hpp',
Davide Pesavento84348a22023-09-14 02:40:41 -040077 install_path='${INCLUDEDIR}/ndn-nac',
Alexander Afanasyev2b57aeb2018-06-15 18:32:28 -040078 VERSION_STRING=VERSION_BASE,
79 VERSION_BUILD=VERSION,
80 VERSION=int(VERSION_SPLIT[0]) * 1000000 +
81 int(VERSION_SPLIT[1]) * 1000 +
82 int(VERSION_SPLIT[2]),
83 VERSION_MAJOR=VERSION_SPLIT[0],
84 VERSION_MINOR=VERSION_SPLIT[1],
85 VERSION_PATCH=VERSION_SPLIT[2])
86
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040087 bld.shlib(
Davide Pesavento8f9d0622018-11-27 01:23:37 -050088 target='ndn-nac',
89 name='libndn-nac',
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040090 vnum=VERSION_BASE,
91 cnum=VERSION_BASE,
Davide Pesavento8f9d0622018-11-27 01:23:37 -050092 source=bld.path.ant_glob('src/**/*.cpp'),
93 use='BOOST NDN_CXX',
94 includes=['src', '.'],
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040095 export_includes=['src', '.'])
96
Davide Pesavento27680ae2019-04-06 19:40:01 -040097 if bld.env.WITH_TESTS:
Alexander Afanasyev77f6ae12018-06-14 17:54:17 -040098 bld.recurse('tests')
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -040099
Davide Pesavento969d0f32023-09-14 14:28:41 -0400100 if bld.env.WITH_TOOLS:
101 bld.recurse('tools')
102
Davide Pesavento27680ae2019-04-06 19:40:01 -0400103 if bld.env.WITH_EXAMPLES:
104 bld.recurse('examples')
Alexander Afanasyev2b57aeb2018-06-15 18:32:28 -0400105
Davide Pesavento84348a22023-09-14 02:40:41 -0400106 # Install header files
107 bld.install_files('${INCLUDEDIR}/ndn-nac', bld.path.find_dir('src').ant_glob('*.hpp'))
108 bld.install_files('${INCLUDEDIR}/ndn-nac', bld.path.find_resource('config.hpp'))
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400109
Davide Pesavento8f9d0622018-11-27 01:23:37 -0500110 bld(features='subst',
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400111 source='libndn-nac.pc.in',
112 target='libndn-nac.pc',
Davide Pesavento13527ec2019-11-09 13:50:36 -0500113 install_path='${LIBDIR}/pkgconfig',
114 VERSION=VERSION)
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400115
116def docs(bld):
117 from waflib import Options
118 Options.commands = ['doxygen', 'sphinx'] + Options.commands
119
120def doxygen(bld):
121 version(bld)
122
123 if not bld.env.DOXYGEN:
124 bld.fatal('Cannot build documentation ("doxygen" not found in PATH)')
125
126 bld(features='subst',
127 name='doxygen.conf',
128 source=['docs/doxygen.conf.in',
129 'docs/named_data_theme/named_data_footer-with-analytics.html.in'],
130 target=['docs/doxygen.conf',
131 'docs/named_data_theme/named_data_footer-with-analytics.html'],
132 VERSION=VERSION,
Davide Pesaventoebeaeae2021-04-26 00:42:26 -0400133 HAVE_DOT='YES' if bld.env.DOT else 'NO',
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400134 HTML_FOOTER='../build/docs/named_data_theme/named_data_footer-with-analytics.html' \
135 if os.getenv('GOOGLE_ANALYTICS', None) \
136 else '../docs/named_data_theme/named_data_footer.html',
137 GOOGLE_ANALYTICS=os.getenv('GOOGLE_ANALYTICS', ''))
138
139 bld(features='doxygen',
140 doxyfile='docs/doxygen.conf',
141 use='doxygen.conf')
142
143def sphinx(bld):
144 version(bld)
145
146 if not bld.env.SPHINX_BUILD:
147 bld.fatal('Cannot build documentation ("sphinx-build" not found in PATH)')
148
149 bld(features='sphinx',
150 config='docs/conf.py',
151 outdir='docs',
152 source=bld.path.ant_glob('docs/**/*.rst'),
Davide Pesaventoec61b742020-04-18 01:00:12 -0400153 version=VERSION_BASE,
154 release=VERSION)
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400155
156def version(ctx):
157 # don't execute more than once
158 if getattr(Context.g_module, 'VERSION_BASE', None):
159 return
160
161 Context.g_module.VERSION_BASE = Context.g_module.VERSION
162 Context.g_module.VERSION_SPLIT = VERSION_BASE.split('.')
163
164 # first, try to get a version string from git
165 gotVersionFromGit = False
166 try:
Davide Pesavento84348a22023-09-14 02:40:41 -0400167 cmd = ['git', 'describe', '--always', '--match', f'{GIT_TAG_PREFIX}*']
168 out = subprocess.run(cmd, capture_output=True, check=True, text=True).stdout.strip()
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400169 if out:
170 gotVersionFromGit = True
171 if out.startswith(GIT_TAG_PREFIX):
172 Context.g_module.VERSION = out.lstrip(GIT_TAG_PREFIX)
173 else:
174 # no tags matched
Davide Pesavento84348a22023-09-14 02:40:41 -0400175 Context.g_module.VERSION = f'{VERSION_BASE}-commit-{out}'
176 except (OSError, subprocess.SubprocessError):
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400177 pass
178
Alexander Afanasyev1b9be6c2020-06-01 19:20:41 -0400179 versionFile = ctx.path.find_node('VERSION.info')
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400180 if not gotVersionFromGit and versionFile is not None:
181 try:
182 Context.g_module.VERSION = versionFile.read()
183 return
184 except EnvironmentError:
185 pass
186
187 # version was obtained from git, update VERSION file if necessary
188 if versionFile is not None:
189 try:
190 if versionFile.read() == Context.g_module.VERSION:
191 # already up-to-date
192 return
193 except EnvironmentError as e:
Davide Pesavento84348a22023-09-14 02:40:41 -0400194 Logs.warn(f'{versionFile} exists but is not readable ({e.strerror})')
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400195 else:
Alexander Afanasyev1b9be6c2020-06-01 19:20:41 -0400196 versionFile = ctx.path.make_node('VERSION.info')
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400197
198 try:
199 versionFile.write(Context.g_module.VERSION)
200 except EnvironmentError as e:
Davide Pesavento84348a22023-09-14 02:40:41 -0400201 Logs.warn(f'{versionFile} is not writable ({e.strerror})')
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400202
203def dist(ctx):
Davide Pesavento7228e532023-02-18 02:26:45 -0500204 ctx.algo = 'tar.xz'
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400205 version(ctx)
206
207def distcheck(ctx):
Davide Pesavento7228e532023-02-18 02:26:45 -0500208 ctx.algo = 'tar.xz'
Alexander Afanasyev6e64ac92018-06-14 17:25:38 -0400209 version(ctx)