blob: 1c2494473c0f24bae3e511da6f70ac67f034bdd9 [file] [log] [blame]
akmhoque298385a2014-02-13 14:13:09 -06001# -*- Mode: python; py-indent-offset: 4; indent-tabs-mode: nil; coding: utf-8; -*-
Yingdi Yu40cd1c32014-04-17 15:02:17 -07002"""
Ashlesh Gawande30d96e42021-03-21 19:15:33 -07003Copyright (c) 2014-2021, The University of Memphis,
Vince Lehmanc2e51f62015-01-20 15:03:11 -06004 Regents of the University of California,
5 Arizona Board of Regents.
Yingdi Yu40cd1c32014-04-17 15:02:17 -07006
7This file is part of NLSR (Named-data Link State Routing).
8See AUTHORS.md for complete list of NLSR authors and contributors.
9
10NLSR is free software: you can redistribute it and/or modify it under the terms
11of the GNU General Public License as published by the Free Software Foundation,
12either version 3 of the License, or (at your option) any later version.
13
14NLSR is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
15without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
16PURPOSE. See the GNU General Public License for more details.
17
18You should have received a copy of the GNU General Public License along with
19NLSR, e.g., in COPYING.md file. If not, see <http://www.gnu.org/licenses/>.
20"""
21
Davide Pesaventof75bfda2019-11-10 18:34:13 -050022from waflib import Context, Logs, Utils
23import os, subprocess
24
Saurab Dulalcf064442020-12-14 11:04:57 -060025VERSION = "0.6.0"
sfayer93d9ec32014-12-04 23:34:41 +000026APPNAME = "nlsr"
Davide Pesavento6ebfd7c2017-08-26 17:52:54 -040027BUGREPORT = "https://redmine.named-data.net/projects/nlsr"
28URL = "https://named-data.net/doc/NLSR/"
Vince Lehmanb722b102014-08-24 16:33:49 -050029GIT_TAG_PREFIX = "NLSR-"
akmhoque298385a2014-02-13 14:13:09 -060030
akmhoque298385a2014-02-13 14:13:09 -060031def options(opt):
Yingdi Yu40cd1c32014-04-17 15:02:17 -070032 opt.load(['compiler_cxx', 'gnu_dirs'])
Davide Pesaventoc58cc7f2017-08-08 16:51:28 -050033 opt.load(['default-compiler-flags', 'coverage', 'sanitizers',
Davide Pesavento6ebfd7c2017-08-26 17:52:54 -040034 'boost', 'doxygen', 'sphinx_build'],
Davide Pesaventoe5569912019-01-29 19:39:06 -050035 tooldir=['.waf-tools'])
akmhoque298385a2014-02-13 14:13:09 -060036
Davide Pesaventof75bfda2019-11-10 18:34:13 -050037 optgrp = opt.add_option_group('NLSR Options')
38 optgrp.add_option('--with-tests', action='store_true', default=False,
39 help='Build unit tests')
Ashlesh Gawande30d96e42021-03-21 19:15:33 -070040 optgrp.add_option('--with-chronosync', action='store_true', default=False,
41 help='Build with Chronosync support')
akmhoque05d5fcf2014-04-15 14:58:45 -050042
akmhoque298385a2014-02-13 14:13:09 -060043def configure(conf):
Vince Lehmanb722b102014-08-24 16:33:49 -050044 conf.load(['compiler_cxx', 'gnu_dirs',
Davide Pesavento6ebfd7c2017-08-26 17:52:54 -040045 'default-compiler-flags', 'boost',
Vince Lehmanb722b102014-08-24 16:33:49 -050046 'doxygen', 'sphinx_build'])
akmhoque298385a2014-02-13 14:13:09 -060047
Davide Pesaventof75bfda2019-11-10 18:34:13 -050048 conf.env.WITH_TESTS = conf.options.with_tests
Alexander Afanasyevfb2adee2015-03-30 10:56:55 -070049
Davide Pesaventof75bfda2019-11-10 18:34:13 -050050 pkg_config_path = os.environ.get('PKG_CONFIG_PATH', '%s/pkgconfig' % conf.env.LIBDIR)
51 conf.check_cfg(package='libndn-cxx', args=['--cflags', '--libs'], uselib_store='NDN_CXX',
52 pkg_config_path=pkg_config_path)
akmhoque85d88332014-02-17 21:11:21 -060053
Davide Pesaventof75bfda2019-11-10 18:34:13 -050054 boost_libs = ['system', 'iostreams', 'filesystem', 'regex']
55 if conf.env.WITH_TESTS:
56 boost_libs += ['program_options', 'unit_test_framework']
akmhoque85d88332014-02-17 21:11:21 -060057
dmcoomescf8d0ed2017-02-21 11:39:01 -060058 conf.check_boost(lib=boost_libs, mt=True)
Davide Pesaventoe5569912019-01-29 19:39:06 -050059 if conf.env.BOOST_VERSION_NUMBER < 105800:
60 conf.fatal('Minimum required Boost version is 1.58.0\n'
Alexander Afanasyev67758b12018-03-06 18:36:44 -050061 'Please upgrade your distribution or manually install a newer version of Boost'
62 ' (https://redmine.named-data.net/projects/nfd/wiki/Boost_FAQ)')
akmhoque05d5fcf2014-04-15 14:58:45 -050063
Ashlesh Gawande30d96e42021-03-21 19:15:33 -070064 if conf.options.with_chronosync:
65 conf.check_cfg(package='ChronoSync', args=['--cflags', '--libs'],
66 uselib_store='CHRONOSYNC', pkg_config_path=pkg_config_path)
akmhoque05d5fcf2014-04-15 14:58:45 -050067
Davide Pesaventof75bfda2019-11-10 18:34:13 -050068 conf.check_cfg(package='PSync', args=['--cflags', '--libs'], uselib_store='PSYNC',
69 pkg_config_path=pkg_config_path)
Ashlesh Gawande32ec3fd2018-07-18 13:42:32 -050070
Alexander Afanasyev67758b12018-03-06 18:36:44 -050071 conf.check_compiler_flags()
72
Davide Pesaventoe5569912019-01-29 19:39:06 -050073 # Loading "late" to prevent tests from being compiled with profiling flags
Yingdi Yu40cd1c32014-04-17 15:02:17 -070074 conf.load('coverage')
Davide Pesaventoc58cc7f2017-08-08 16:51:28 -050075 conf.load('sanitizers')
76
Davide Pesaventof75bfda2019-11-10 18:34:13 -050077 conf.define_cond('WITH_TESTS', conf.env.WITH_TESTS)
78 # The config header will contain all defines that were added using conf.define()
79 # or conf.define_cond(). Everything that was added directly to conf.env.DEFINES
80 # will not appear in the config header, but will instead be passed directly to the
81 # compiler on the command line.
Yingdi Yu40cd1c32014-04-17 15:02:17 -070082 conf.write_config_header('config.hpp')
akmhoque05d5fcf2014-04-15 14:58:45 -050083
Vince Lehmanb722b102014-08-24 16:33:49 -050084def build(bld):
85 version(bld)
86
Davide Pesaventoe5569912019-01-29 19:39:06 -050087 bld(features='subst',
Alexander Afanasyev67758b12018-03-06 18:36:44 -050088 name='version.hpp',
Vince Lehmanb722b102014-08-24 16:33:49 -050089 source='src/version.hpp.in',
90 target='src/version.hpp',
Vince Lehmanb722b102014-08-24 16:33:49 -050091 VERSION_STRING=VERSION_BASE,
92 VERSION_BUILD=VERSION,
93 VERSION=int(VERSION_SPLIT[0]) * 1000000 +
94 int(VERSION_SPLIT[1]) * 1000 +
95 int(VERSION_SPLIT[2]),
96 VERSION_MAJOR=VERSION_SPLIT[0],
97 VERSION_MINOR=VERSION_SPLIT[1],
Davide Pesaventoc58cc7f2017-08-08 16:51:28 -050098 VERSION_PATCH=VERSION_SPLIT[2])
Vince Lehmanb722b102014-08-24 16:33:49 -050099
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500100 bld.objects(
Yingdi Yu40cd1c32014-04-17 15:02:17 -0700101 target='nlsr-objects',
Davide Pesaventoe5569912019-01-29 19:39:06 -0500102 source=bld.path.ant_glob('src/**/*.cpp',
Yingdi Yu40cd1c32014-04-17 15:02:17 -0700103 excl=['src/main.cpp']),
Ashlesh Gawande30d96e42021-03-21 19:15:33 -0700104 use='NDN_CXX BOOST CHRONOSYNC PSYNC',
Yingdi Yu40cd1c32014-04-17 15:02:17 -0700105 includes='. src',
Davide Pesaventoc58cc7f2017-08-08 16:51:28 -0500106 export_includes='. src')
akmhoque298385a2014-02-13 14:13:09 -0600107
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500108 bld.program(
Yingdi Yu40cd1c32014-04-17 15:02:17 -0700109 target='bin/nlsr',
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500110 name='nlsr',
Yingdi Yu40cd1c32014-04-17 15:02:17 -0700111 source='src/main.cpp',
Davide Pesaventoc58cc7f2017-08-08 16:51:28 -0500112 use='nlsr-objects')
akmhoque298385a2014-02-13 14:13:09 -0600113
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500114 bld.program(
Vince Lehmanc439d662015-04-27 10:56:00 -0500115 target='bin/nlsrc',
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500116 name='nlsrc',
Vince Lehmanc439d662015-04-27 10:56:00 -0500117 source='tools/nlsrc.cpp',
Davide Pesaventoe5569912019-01-29 19:39:06 -0500118 use='nlsr-objects')
Vince Lehmanc439d662015-04-27 10:56:00 -0500119
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500120 if bld.env.WITH_TESTS:
Yingdi Yu40cd1c32014-04-17 15:02:17 -0700121 bld.recurse('tests')
Vince Lehmanb722b102014-08-24 16:33:49 -0500122
Davide Pesavento0da3eab2019-01-31 01:10:00 -0500123 bld.install_as('${SYSCONFDIR}/ndn/nlsr.conf.sample', 'nlsr.conf')
124
125 if Utils.unversioned_sys_platform() == 'linux':
126 bld(features='subst',
127 name='nlsr.service',
128 source='systemd/nlsr.service.in',
129 target='systemd/nlsr.service')
130
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500131 if bld.env.SPHINX_BUILD:
132 bld(features='sphinx',
133 name='manpages',
134 builder='man',
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500135 config='docs/conf.py',
Davide Pesavento0da3eab2019-01-31 01:10:00 -0500136 outdir='docs/manpages',
Davide Pesaventof75bfda2019-11-10 18:34:13 -0500137 source=bld.path.ant_glob('docs/manpages/*.rst'),
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500138 install_path='${MANDIR}',
Davide Pesaventof75bfda2019-11-10 18:34:13 -0500139 version=VERSION_BASE,
140 release=VERSION)
Vince Lehmanb722b102014-08-24 16:33:49 -0500141
142def docs(bld):
143 from waflib import Options
144 Options.commands = ['doxygen', 'sphinx'] + Options.commands
145
146def doxygen(bld):
147 version(bld)
148
149 if not bld.env.DOXYGEN:
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500150 bld.fatal('Cannot build documentation ("doxygen" not found in PATH)')
Vince Lehmanb722b102014-08-24 16:33:49 -0500151
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500152 bld(features='subst',
153 name='doxygen.conf',
154 source=['docs/doxygen.conf.in',
155 'docs/named_data_theme/named_data_footer-with-analytics.html.in'],
156 target=['docs/doxygen.conf',
157 'docs/named_data_theme/named_data_footer-with-analytics.html'],
158 VERSION=VERSION,
159 HTML_FOOTER='../build/docs/named_data_theme/named_data_footer-with-analytics.html' \
160 if os.getenv('GOOGLE_ANALYTICS', None) \
161 else '../docs/named_data_theme/named_data_footer.html',
162 GOOGLE_ANALYTICS=os.getenv('GOOGLE_ANALYTICS', ''))
163
164 bld(features='doxygen',
165 doxyfile='docs/doxygen.conf',
166 use='doxygen.conf')
Vince Lehmanb722b102014-08-24 16:33:49 -0500167
168def sphinx(bld):
169 version(bld)
170
171 if not bld.env.SPHINX_BUILD:
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500172 bld.fatal('Cannot build documentation ("sphinx-build" not found in PATH)')
173
174 bld(features='sphinx',
175 config='docs/conf.py',
176 outdir='docs',
177 source=bld.path.ant_glob('docs/**/*.rst'),
Davide Pesaventof75bfda2019-11-10 18:34:13 -0500178 version=VERSION_BASE,
179 release=VERSION)
Vince Lehmanb722b102014-08-24 16:33:49 -0500180
181def version(ctx):
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500182 # don't execute more than once
Vince Lehmanb722b102014-08-24 16:33:49 -0500183 if getattr(Context.g_module, 'VERSION_BASE', None):
184 return
185
186 Context.g_module.VERSION_BASE = Context.g_module.VERSION
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500187 Context.g_module.VERSION_SPLIT = VERSION_BASE.split('.')
Vince Lehmanb722b102014-08-24 16:33:49 -0500188
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500189 # first, try to get a version string from git
190 gotVersionFromGit = False
Vince Lehmanb722b102014-08-24 16:33:49 -0500191 try:
192 cmd = ['git', 'describe', '--always', '--match', '%s*' % GIT_TAG_PREFIX]
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500193 out = subprocess.check_output(cmd, universal_newlines=True).strip()
194 if out:
195 gotVersionFromGit = True
Vince Lehmanb722b102014-08-24 16:33:49 -0500196 if out.startswith(GIT_TAG_PREFIX):
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500197 Context.g_module.VERSION = out.lstrip(GIT_TAG_PREFIX)
Vince Lehmanb722b102014-08-24 16:33:49 -0500198 else:
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500199 # no tags matched
200 Context.g_module.VERSION = '%s-commit-%s' % (VERSION_BASE, out)
Davide Pesaventoa08dc3f2018-05-24 00:40:28 -0400201 except (OSError, subprocess.CalledProcessError):
Vince Lehmanb722b102014-08-24 16:33:49 -0500202 pass
203
Alexander Afanasyev96ebd9b2020-06-01 19:16:52 -0400204 versionFile = ctx.path.find_node('VERSION.info')
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500205 if not gotVersionFromGit and versionFile is not None:
Vince Lehmanb722b102014-08-24 16:33:49 -0500206 try:
207 Context.g_module.VERSION = versionFile.read()
208 return
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500209 except EnvironmentError:
Vince Lehmanb722b102014-08-24 16:33:49 -0500210 pass
211
212 # version was obtained from git, update VERSION file if necessary
213 if versionFile is not None:
214 try:
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500215 if versionFile.read() == Context.g_module.VERSION:
216 # already up-to-date
217 return
218 except EnvironmentError as e:
219 Logs.warn('%s exists but is not readable (%s)' % (versionFile, e.strerror))
Vince Lehmanb722b102014-08-24 16:33:49 -0500220 else:
Alexander Afanasyev96ebd9b2020-06-01 19:16:52 -0400221 versionFile = ctx.path.make_node('VERSION.info')
Vince Lehmanb722b102014-08-24 16:33:49 -0500222
Vince Lehmanb722b102014-08-24 16:33:49 -0500223 try:
224 versionFile.write(Context.g_module.VERSION)
Alexander Afanasyev67758b12018-03-06 18:36:44 -0500225 except EnvironmentError as e:
226 Logs.warn('%s is not writable (%s)' % (versionFile, e.strerror))
Vince Lehmanb722b102014-08-24 16:33:49 -0500227
228def dist(ctx):
229 version(ctx)
230
231def distcheck(ctx):
232 version(ctx)