akmhoque | 298385a | 2014-02-13 14:13:09 -0600 | [diff] [blame] | 1 | # -*- Mode: python; py-indent-offset: 4; indent-tabs-mode: nil; coding: utf-8; -*- |
Yingdi Yu | 40cd1c3 | 2014-04-17 15:02:17 -0700 | [diff] [blame] | 2 | """ |
Davide Pesavento | e28d875 | 2022-03-19 03:55:25 -0400 | [diff] [blame^] | 3 | Copyright (c) 2014-2022, The University of Memphis, |
Vince Lehman | c2e51f6 | 2015-01-20 15:03:11 -0600 | [diff] [blame] | 4 | Regents of the University of California, |
| 5 | Arizona Board of Regents. |
Yingdi Yu | 40cd1c3 | 2014-04-17 15:02:17 -0700 | [diff] [blame] | 6 | |
| 7 | This file is part of NLSR (Named-data Link State Routing). |
| 8 | See AUTHORS.md for complete list of NLSR authors and contributors. |
| 9 | |
| 10 | NLSR is free software: you can redistribute it and/or modify it under the terms |
| 11 | of the GNU General Public License as published by the Free Software Foundation, |
| 12 | either version 3 of the License, or (at your option) any later version. |
| 13 | |
| 14 | NLSR is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; |
| 15 | without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR |
| 16 | PURPOSE. See the GNU General Public License for more details. |
| 17 | |
| 18 | You should have received a copy of the GNU General Public License along with |
| 19 | NLSR, e.g., in COPYING.md file. If not, see <http://www.gnu.org/licenses/>. |
| 20 | """ |
| 21 | |
Davide Pesavento | f75bfda | 2019-11-10 18:34:13 -0500 | [diff] [blame] | 22 | from waflib import Context, Logs, Utils |
| 23 | import os, subprocess |
| 24 | |
Saurab Dulal | cf06444 | 2020-12-14 11:04:57 -0600 | [diff] [blame] | 25 | VERSION = "0.6.0" |
sfayer | 93d9ec3 | 2014-12-04 23:34:41 +0000 | [diff] [blame] | 26 | APPNAME = "nlsr" |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 27 | GIT_TAG_PREFIX = "NLSR-" |
akmhoque | 298385a | 2014-02-13 14:13:09 -0600 | [diff] [blame] | 28 | |
akmhoque | 298385a | 2014-02-13 14:13:09 -0600 | [diff] [blame] | 29 | def options(opt): |
Yingdi Yu | 40cd1c3 | 2014-04-17 15:02:17 -0700 | [diff] [blame] | 30 | opt.load(['compiler_cxx', 'gnu_dirs']) |
Davide Pesavento | 7ae8b08 | 2021-10-12 21:45:47 -0400 | [diff] [blame] | 31 | opt.load(['default-compiler-flags', |
| 32 | 'coverage', 'sanitizers', 'boost', |
| 33 | 'doxygen', 'sphinx_build'], |
Davide Pesavento | e556991 | 2019-01-29 19:39:06 -0500 | [diff] [blame] | 34 | tooldir=['.waf-tools']) |
akmhoque | 298385a | 2014-02-13 14:13:09 -0600 | [diff] [blame] | 35 | |
Davide Pesavento | f75bfda | 2019-11-10 18:34:13 -0500 | [diff] [blame] | 36 | optgrp = opt.add_option_group('NLSR Options') |
| 37 | optgrp.add_option('--with-tests', action='store_true', default=False, |
| 38 | help='Build unit tests') |
Ashlesh Gawande | 30d96e4 | 2021-03-21 19:15:33 -0700 | [diff] [blame] | 39 | optgrp.add_option('--with-chronosync', action='store_true', default=False, |
Davide Pesavento | 7ae8b08 | 2021-10-12 21:45:47 -0400 | [diff] [blame] | 40 | help='Build with ChronoSync support') |
akmhoque | 05d5fcf | 2014-04-15 14:58:45 -0500 | [diff] [blame] | 41 | |
akmhoque | 298385a | 2014-02-13 14:13:09 -0600 | [diff] [blame] | 42 | def configure(conf): |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 43 | conf.load(['compiler_cxx', 'gnu_dirs', |
Davide Pesavento | 6ebfd7c | 2017-08-26 17:52:54 -0400 | [diff] [blame] | 44 | 'default-compiler-flags', 'boost', |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 45 | 'doxygen', 'sphinx_build']) |
akmhoque | 298385a | 2014-02-13 14:13:09 -0600 | [diff] [blame] | 46 | |
Davide Pesavento | f75bfda | 2019-11-10 18:34:13 -0500 | [diff] [blame] | 47 | conf.env.WITH_TESTS = conf.options.with_tests |
Alexander Afanasyev | fb2adee | 2015-03-30 10:56:55 -0700 | [diff] [blame] | 48 | |
Davide Pesavento | 7ae8b08 | 2021-10-12 21:45:47 -0400 | [diff] [blame] | 49 | conf.find_program('dot', var='DOT', mandatory=False) |
| 50 | |
Davide Pesavento | d1f1df8 | 2022-03-12 16:40:37 -0500 | [diff] [blame] | 51 | pkg_config_path = os.environ.get('PKG_CONFIG_PATH', f'{conf.env.LIBDIR}/pkgconfig') |
| 52 | conf.check_cfg(package='libndn-cxx', args=['libndn-cxx >= 0.8.0', '--cflags', '--libs'], |
| 53 | uselib_store='NDN_CXX', pkg_config_path=pkg_config_path) |
akmhoque | 85d8833 | 2014-02-17 21:11:21 -0600 | [diff] [blame] | 54 | |
Davide Pesavento | f75bfda | 2019-11-10 18:34:13 -0500 | [diff] [blame] | 55 | boost_libs = ['system', 'iostreams', 'filesystem', 'regex'] |
| 56 | if conf.env.WITH_TESTS: |
Davide Pesavento | d1f1df8 | 2022-03-12 16:40:37 -0500 | [diff] [blame] | 57 | boost_libs.append('unit_test_framework') |
akmhoque | 85d8833 | 2014-02-17 21:11:21 -0600 | [diff] [blame] | 58 | |
dmcoomes | cf8d0ed | 2017-02-21 11:39:01 -0600 | [diff] [blame] | 59 | conf.check_boost(lib=boost_libs, mt=True) |
Davide Pesavento | d1f1df8 | 2022-03-12 16:40:37 -0500 | [diff] [blame] | 60 | if conf.env.BOOST_VERSION_NUMBER < 106501: |
Davide Pesavento | 7ae8b08 | 2021-10-12 21:45:47 -0400 | [diff] [blame] | 61 | conf.fatal('The minimum supported version of Boost is 1.65.1.\n' |
| 62 | 'Please upgrade your distribution or manually install a newer version of Boost.\n' |
| 63 | 'For more information, see https://redmine.named-data.net/projects/nfd/wiki/Boost') |
akmhoque | 05d5fcf | 2014-04-15 14:58:45 -0500 | [diff] [blame] | 64 | |
Ashlesh Gawande | 30d96e4 | 2021-03-21 19:15:33 -0700 | [diff] [blame] | 65 | if conf.options.with_chronosync: |
Davide Pesavento | d1f1df8 | 2022-03-12 16:40:37 -0500 | [diff] [blame] | 66 | conf.check_cfg(package='ChronoSync', args=['ChronoSync >= 0.5.4', '--cflags', '--libs'], |
Ashlesh Gawande | 30d96e4 | 2021-03-21 19:15:33 -0700 | [diff] [blame] | 67 | uselib_store='CHRONOSYNC', pkg_config_path=pkg_config_path) |
akmhoque | 05d5fcf | 2014-04-15 14:58:45 -0500 | [diff] [blame] | 68 | |
Davide Pesavento | d1f1df8 | 2022-03-12 16:40:37 -0500 | [diff] [blame] | 69 | conf.check_cfg(package='PSync', args=['PSync >= 0.3.0', '--cflags', '--libs'], |
| 70 | uselib_store='PSYNC', pkg_config_path=pkg_config_path) |
Ashlesh Gawande | 32ec3fd | 2018-07-18 13:42:32 -0500 | [diff] [blame] | 71 | |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 72 | conf.check_compiler_flags() |
| 73 | |
Davide Pesavento | e556991 | 2019-01-29 19:39:06 -0500 | [diff] [blame] | 74 | # Loading "late" to prevent tests from being compiled with profiling flags |
Yingdi Yu | 40cd1c3 | 2014-04-17 15:02:17 -0700 | [diff] [blame] | 75 | conf.load('coverage') |
Davide Pesavento | c58cc7f | 2017-08-08 16:51:28 -0500 | [diff] [blame] | 76 | conf.load('sanitizers') |
| 77 | |
Davide Pesavento | f75bfda | 2019-11-10 18:34:13 -0500 | [diff] [blame] | 78 | conf.define_cond('WITH_TESTS', conf.env.WITH_TESTS) |
Junxiao Shi | a3a6397 | 2022-01-24 02:03:41 +0000 | [diff] [blame] | 79 | conf.define('DEFAULT_CONFIG_FILE', '%s/ndn/nlsr.conf' % conf.env.SYSCONFDIR) |
Davide Pesavento | f75bfda | 2019-11-10 18:34:13 -0500 | [diff] [blame] | 80 | # The config header will contain all defines that were added using conf.define() |
| 81 | # or conf.define_cond(). Everything that was added directly to conf.env.DEFINES |
| 82 | # will not appear in the config header, but will instead be passed directly to the |
| 83 | # compiler on the command line. |
Yingdi Yu | 40cd1c3 | 2014-04-17 15:02:17 -0700 | [diff] [blame] | 84 | conf.write_config_header('config.hpp') |
akmhoque | 05d5fcf | 2014-04-15 14:58:45 -0500 | [diff] [blame] | 85 | |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 86 | def build(bld): |
| 87 | version(bld) |
| 88 | |
Davide Pesavento | e556991 | 2019-01-29 19:39:06 -0500 | [diff] [blame] | 89 | bld(features='subst', |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 90 | name='version.hpp', |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 91 | source='src/version.hpp.in', |
| 92 | target='src/version.hpp', |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 93 | VERSION_STRING=VERSION_BASE, |
| 94 | VERSION_BUILD=VERSION, |
| 95 | VERSION=int(VERSION_SPLIT[0]) * 1000000 + |
| 96 | int(VERSION_SPLIT[1]) * 1000 + |
| 97 | int(VERSION_SPLIT[2]), |
| 98 | VERSION_MAJOR=VERSION_SPLIT[0], |
| 99 | VERSION_MINOR=VERSION_SPLIT[1], |
Davide Pesavento | c58cc7f | 2017-08-08 16:51:28 -0500 | [diff] [blame] | 100 | VERSION_PATCH=VERSION_SPLIT[2]) |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 101 | |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 102 | bld.objects( |
Yingdi Yu | 40cd1c3 | 2014-04-17 15:02:17 -0700 | [diff] [blame] | 103 | target='nlsr-objects', |
Davide Pesavento | e556991 | 2019-01-29 19:39:06 -0500 | [diff] [blame] | 104 | source=bld.path.ant_glob('src/**/*.cpp', |
Yingdi Yu | 40cd1c3 | 2014-04-17 15:02:17 -0700 | [diff] [blame] | 105 | excl=['src/main.cpp']), |
Ashlesh Gawande | 30d96e4 | 2021-03-21 19:15:33 -0700 | [diff] [blame] | 106 | use='NDN_CXX BOOST CHRONOSYNC PSYNC', |
Yingdi Yu | 40cd1c3 | 2014-04-17 15:02:17 -0700 | [diff] [blame] | 107 | includes='. src', |
Davide Pesavento | c58cc7f | 2017-08-08 16:51:28 -0500 | [diff] [blame] | 108 | export_includes='. src') |
akmhoque | 298385a | 2014-02-13 14:13:09 -0600 | [diff] [blame] | 109 | |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 110 | bld.program( |
Yingdi Yu | 40cd1c3 | 2014-04-17 15:02:17 -0700 | [diff] [blame] | 111 | target='bin/nlsr', |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 112 | name='nlsr', |
Yingdi Yu | 40cd1c3 | 2014-04-17 15:02:17 -0700 | [diff] [blame] | 113 | source='src/main.cpp', |
Davide Pesavento | c58cc7f | 2017-08-08 16:51:28 -0500 | [diff] [blame] | 114 | use='nlsr-objects') |
akmhoque | 298385a | 2014-02-13 14:13:09 -0600 | [diff] [blame] | 115 | |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 116 | bld.program( |
Vince Lehman | c439d66 | 2015-04-27 10:56:00 -0500 | [diff] [blame] | 117 | target='bin/nlsrc', |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 118 | name='nlsrc', |
Vince Lehman | c439d66 | 2015-04-27 10:56:00 -0500 | [diff] [blame] | 119 | source='tools/nlsrc.cpp', |
Davide Pesavento | e556991 | 2019-01-29 19:39:06 -0500 | [diff] [blame] | 120 | use='nlsr-objects') |
Vince Lehman | c439d66 | 2015-04-27 10:56:00 -0500 | [diff] [blame] | 121 | |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 122 | if bld.env.WITH_TESTS: |
Yingdi Yu | 40cd1c3 | 2014-04-17 15:02:17 -0700 | [diff] [blame] | 123 | bld.recurse('tests') |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 124 | |
Davide Pesavento | 0da3eab | 2019-01-31 01:10:00 -0500 | [diff] [blame] | 125 | bld.install_as('${SYSCONFDIR}/ndn/nlsr.conf.sample', 'nlsr.conf') |
| 126 | |
| 127 | if Utils.unversioned_sys_platform() == 'linux': |
| 128 | bld(features='subst', |
| 129 | name='nlsr.service', |
| 130 | source='systemd/nlsr.service.in', |
| 131 | target='systemd/nlsr.service') |
| 132 | |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 133 | if bld.env.SPHINX_BUILD: |
| 134 | bld(features='sphinx', |
| 135 | name='manpages', |
| 136 | builder='man', |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 137 | config='docs/conf.py', |
Davide Pesavento | 0da3eab | 2019-01-31 01:10:00 -0500 | [diff] [blame] | 138 | outdir='docs/manpages', |
Davide Pesavento | f75bfda | 2019-11-10 18:34:13 -0500 | [diff] [blame] | 139 | source=bld.path.ant_glob('docs/manpages/*.rst'), |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 140 | install_path='${MANDIR}', |
Davide Pesavento | f75bfda | 2019-11-10 18:34:13 -0500 | [diff] [blame] | 141 | version=VERSION_BASE, |
| 142 | release=VERSION) |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 143 | |
| 144 | def docs(bld): |
| 145 | from waflib import Options |
| 146 | Options.commands = ['doxygen', 'sphinx'] + Options.commands |
| 147 | |
| 148 | def doxygen(bld): |
| 149 | version(bld) |
| 150 | |
| 151 | if not bld.env.DOXYGEN: |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 152 | bld.fatal('Cannot build documentation ("doxygen" not found in PATH)') |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 153 | |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 154 | bld(features='subst', |
| 155 | name='doxygen.conf', |
| 156 | source=['docs/doxygen.conf.in', |
| 157 | 'docs/named_data_theme/named_data_footer-with-analytics.html.in'], |
| 158 | target=['docs/doxygen.conf', |
| 159 | 'docs/named_data_theme/named_data_footer-with-analytics.html'], |
| 160 | VERSION=VERSION, |
Davide Pesavento | 7ae8b08 | 2021-10-12 21:45:47 -0400 | [diff] [blame] | 161 | HAVE_DOT='YES' if bld.env.DOT else 'NO', |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 162 | HTML_FOOTER='../build/docs/named_data_theme/named_data_footer-with-analytics.html' \ |
| 163 | if os.getenv('GOOGLE_ANALYTICS', None) \ |
| 164 | else '../docs/named_data_theme/named_data_footer.html', |
| 165 | GOOGLE_ANALYTICS=os.getenv('GOOGLE_ANALYTICS', '')) |
| 166 | |
| 167 | bld(features='doxygen', |
| 168 | doxyfile='docs/doxygen.conf', |
| 169 | use='doxygen.conf') |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 170 | |
| 171 | def sphinx(bld): |
| 172 | version(bld) |
| 173 | |
| 174 | if not bld.env.SPHINX_BUILD: |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 175 | bld.fatal('Cannot build documentation ("sphinx-build" not found in PATH)') |
| 176 | |
| 177 | bld(features='sphinx', |
| 178 | config='docs/conf.py', |
| 179 | outdir='docs', |
| 180 | source=bld.path.ant_glob('docs/**/*.rst'), |
Davide Pesavento | f75bfda | 2019-11-10 18:34:13 -0500 | [diff] [blame] | 181 | version=VERSION_BASE, |
| 182 | release=VERSION) |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 183 | |
| 184 | def version(ctx): |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 185 | # don't execute more than once |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 186 | if getattr(Context.g_module, 'VERSION_BASE', None): |
| 187 | return |
| 188 | |
| 189 | Context.g_module.VERSION_BASE = Context.g_module.VERSION |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 190 | Context.g_module.VERSION_SPLIT = VERSION_BASE.split('.') |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 191 | |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 192 | # first, try to get a version string from git |
| 193 | gotVersionFromGit = False |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 194 | try: |
| 195 | cmd = ['git', 'describe', '--always', '--match', '%s*' % GIT_TAG_PREFIX] |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 196 | out = subprocess.check_output(cmd, universal_newlines=True).strip() |
| 197 | if out: |
| 198 | gotVersionFromGit = True |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 199 | if out.startswith(GIT_TAG_PREFIX): |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 200 | Context.g_module.VERSION = out.lstrip(GIT_TAG_PREFIX) |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 201 | else: |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 202 | # no tags matched |
| 203 | Context.g_module.VERSION = '%s-commit-%s' % (VERSION_BASE, out) |
Davide Pesavento | a08dc3f | 2018-05-24 00:40:28 -0400 | [diff] [blame] | 204 | except (OSError, subprocess.CalledProcessError): |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 205 | pass |
| 206 | |
Alexander Afanasyev | 96ebd9b | 2020-06-01 19:16:52 -0400 | [diff] [blame] | 207 | versionFile = ctx.path.find_node('VERSION.info') |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 208 | if not gotVersionFromGit and versionFile is not None: |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 209 | try: |
| 210 | Context.g_module.VERSION = versionFile.read() |
| 211 | return |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 212 | except EnvironmentError: |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 213 | pass |
| 214 | |
| 215 | # version was obtained from git, update VERSION file if necessary |
| 216 | if versionFile is not None: |
| 217 | try: |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 218 | if versionFile.read() == Context.g_module.VERSION: |
| 219 | # already up-to-date |
| 220 | return |
| 221 | except EnvironmentError as e: |
| 222 | Logs.warn('%s exists but is not readable (%s)' % (versionFile, e.strerror)) |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 223 | else: |
Alexander Afanasyev | 96ebd9b | 2020-06-01 19:16:52 -0400 | [diff] [blame] | 224 | versionFile = ctx.path.make_node('VERSION.info') |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 225 | |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 226 | try: |
| 227 | versionFile.write(Context.g_module.VERSION) |
Alexander Afanasyev | 67758b1 | 2018-03-06 18:36:44 -0500 | [diff] [blame] | 228 | except EnvironmentError as e: |
| 229 | Logs.warn('%s is not writable (%s)' % (versionFile, e.strerror)) |
Vince Lehman | b722b10 | 2014-08-24 16:33:49 -0500 | [diff] [blame] | 230 | |
| 231 | def dist(ctx): |
| 232 | version(ctx) |
| 233 | |
| 234 | def distcheck(ctx): |
| 235 | version(ctx) |