Alexander Afanasyev | 2aa3962 | 2014-01-22 11:51:11 -0800 | [diff] [blame] | 1 | # -*- Mode: python; py-indent-offset: 4; indent-tabs-mode: nil; coding: utf-8; -*- |
Alexander Afanasyev | 9bcbc7c | 2014-04-06 19:37:37 -0700 | [diff] [blame] | 2 | |
| 3 | """ |
| 4 | Copyright (c) 2014 Regents of the University of California, |
| 5 | Arizona Board of Regents, |
| 6 | Colorado State University, |
| 7 | University Pierre & Marie Curie, Sorbonne University, |
| 8 | Washington University in St. Louis, |
| 9 | Beijing Institute of Technology |
| 10 | |
| 11 | This file is part of NFD (Named Data Networking Forwarding Daemon). |
| 12 | See AUTHORS.md for complete list of NFD authors and contributors. |
| 13 | |
| 14 | NFD is free software: you can redistribute it and/or modify it under the terms |
| 15 | of the GNU General Public License as published by the Free Software Foundation, |
| 16 | either version 3 of the License, or (at your option) any later version. |
| 17 | |
| 18 | NFD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; |
| 19 | without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR |
| 20 | PURPOSE. See the GNU General Public License for more details. |
| 21 | |
| 22 | You should have received a copy of the GNU General Public License along with |
| 23 | NFD, e.g., in COPYING.md file. If not, see <http://www.gnu.org/licenses/>. |
| 24 | """ |
Alexander Afanasyev | 2aa3962 | 2014-01-22 11:51:11 -0800 | [diff] [blame] | 25 | |
Junxiao Shi | 6b597e7 | 2014-06-29 23:41:17 -0700 | [diff] [blame] | 26 | VERSION = "0.2.0" |
Alexander Afanasyev | 97e4cac | 2014-03-28 10:55:11 -0700 | [diff] [blame] | 27 | APPNAME = "nfd" |
| 28 | BUGREPORT = "http://redmine.named-data.net/projects/nfd" |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 29 | URL = "http://named-data.net/doc/NFD/" |
Alexander Afanasyev | 48f5a3c | 2014-08-22 22:33:01 -0700 | [diff] [blame] | 30 | GIT_TAG_PREFIX = "NFD-" |
Alexander Afanasyev | 97e4cac | 2014-03-28 10:55:11 -0700 | [diff] [blame] | 31 | |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 32 | from waflib import Logs, Utils, Context |
Alexander Afanasyev | 2075788 | 2014-08-25 22:39:08 -0700 | [diff] [blame^] | 33 | import os |
Alexander Afanasyev | 2aa3962 | 2014-01-22 11:51:11 -0800 | [diff] [blame] | 34 | |
| 35 | def options(opt): |
Alexander Afanasyev | 5cda2e0 | 2014-04-11 13:58:44 -0700 | [diff] [blame] | 36 | opt.load(['compiler_cxx', 'gnu_dirs']) |
Wentao Shang | 53df163 | 2014-04-21 12:01:32 -0700 | [diff] [blame] | 37 | opt.load(['boost', 'unix-socket', 'dependency-checker', 'websocket', |
Alexander Afanasyev | e918621 | 2014-08-23 20:15:48 -0700 | [diff] [blame] | 38 | 'default-compiler-flags', 'coverage', 'pch', 'boost-kqueue', |
Alexander Afanasyev | 5cda2e0 | 2014-04-11 13:58:44 -0700 | [diff] [blame] | 39 | 'doxygen', 'sphinx_build'], |
Alexander Afanasyev | 97e4cac | 2014-03-28 10:55:11 -0700 | [diff] [blame] | 40 | tooldir=['.waf-tools']) |
Alexander Afanasyev | 2aa3962 | 2014-01-22 11:51:11 -0800 | [diff] [blame] | 41 | |
| 42 | nfdopt = opt.add_option_group('NFD Options') |
Alexander Afanasyev | 885a85b | 2014-04-12 21:01:13 -0700 | [diff] [blame] | 43 | opt.addUnixOptions(nfdopt) |
Wentao Shang | 53df163 | 2014-04-21 12:01:32 -0700 | [diff] [blame] | 44 | opt.addWebsocketOptions(nfdopt) |
Alexander Afanasyev | 885a85b | 2014-04-12 21:01:13 -0700 | [diff] [blame] | 45 | opt.addDependencyOptions(nfdopt, 'libpcap') |
| 46 | nfdopt.add_option('--without-libpcap', action='store_true', default=False, |
| 47 | dest='without_libpcap', |
| 48 | help='''Disable libpcap (Ethernet face support will be disabled)''') |
| 49 | |
Alexander Afanasyev | 5cda2e0 | 2014-04-11 13:58:44 -0700 | [diff] [blame] | 50 | opt.addDependencyOptions(nfdopt, 'librt', '(optional)') |
| 51 | opt.addDependencyOptions(nfdopt, 'libresolv', '(optional)') |
| 52 | |
Alexander Afanasyev | 97e4cac | 2014-03-28 10:55:11 -0700 | [diff] [blame] | 53 | nfdopt.add_option('--with-tests', action='store_true', default=False, |
| 54 | dest='with_tests', help='''Build unit tests''') |
Ilya Moiseenko | 96b80bb | 2014-04-05 20:53:27 -0400 | [diff] [blame] | 55 | nfdopt.add_option('--with-other-tests', action='store_true', default=False, |
| 56 | dest='with_other_tests', help='''Build other tests''') |
Steve DiBenedetto | 84da5bf | 2014-03-11 14:51:29 -0600 | [diff] [blame] | 57 | |
Alexander Afanasyev | 2aa3962 | 2014-01-22 11:51:11 -0800 | [diff] [blame] | 58 | def configure(conf): |
Beichuan Zhang | 55b8ed4 | 2014-04-26 22:25:44 -0700 | [diff] [blame] | 59 | conf.load(['compiler_cxx', 'gnu_dirs', |
Alexander Afanasyev | e918621 | 2014-08-23 20:15:48 -0700 | [diff] [blame] | 60 | 'default-compiler-flags', 'pch', 'boost-kqueue', |
Wentao Shang | 53df163 | 2014-04-21 12:01:32 -0700 | [diff] [blame] | 61 | 'boost', 'dependency-checker', 'websocket', |
Beichuan Zhang | 55b8ed4 | 2014-04-26 22:25:44 -0700 | [diff] [blame] | 62 | 'doxygen', 'sphinx_build']) |
Alexander Afanasyev | efea8fe | 2014-03-23 00:00:35 -0700 | [diff] [blame] | 63 | |
Davide Pesavento | f0ae442 | 2014-05-05 16:32:12 +0200 | [diff] [blame] | 64 | conf.find_program('bash', var='BASH') |
| 65 | |
Alexander Afanasyev | 4a77136 | 2014-04-24 21:29:33 -0700 | [diff] [blame] | 66 | conf.check_cfg(package='libndn-cxx', args=['--cflags', '--libs'], |
| 67 | uselib_store='NDN_CXX', mandatory=True) |
Davide Pesavento | 44deacc | 2014-02-19 10:48:07 +0100 | [diff] [blame] | 68 | |
Wentao Shang | 93ef6c9 | 2014-06-19 11:59:17 -0400 | [diff] [blame] | 69 | boost_libs = 'system chrono program_options random' |
Alexander Afanasyev | 2aa3962 | 2014-01-22 11:51:11 -0800 | [diff] [blame] | 70 | if conf.options.with_tests: |
| 71 | conf.env['WITH_TESTS'] = 1 |
Junxiao Shi | 8888449 | 2014-02-15 15:57:43 -0700 | [diff] [blame] | 72 | conf.define('WITH_TESTS', 1); |
Alexander Afanasyev | 97e4cac | 2014-03-28 10:55:11 -0700 | [diff] [blame] | 73 | boost_libs += ' unit_test_framework' |
Alexander Afanasyev | 2aa3962 | 2014-01-22 11:51:11 -0800 | [diff] [blame] | 74 | |
Ilya Moiseenko | 96b80bb | 2014-04-05 20:53:27 -0400 | [diff] [blame] | 75 | if conf.options.with_other_tests: |
| 76 | conf.env['WITH_OTHER_TESTS'] = 1 |
| 77 | |
Alexander Afanasyev | 2aa3962 | 2014-01-22 11:51:11 -0800 | [diff] [blame] | 78 | conf.check_boost(lib=boost_libs) |
Alexander Afanasyev | e1724c4 | 2014-02-26 22:00:54 -0800 | [diff] [blame] | 79 | if conf.env.BOOST_VERSION_NUMBER < 104800: |
Junxiao Shi | ea48d8b | 2014-03-16 13:53:47 -0700 | [diff] [blame] | 80 | Logs.error("Minimum required boost version is 1.48.0") |
| 81 | Logs.error("Please upgrade your distribution or install custom boost libraries" + |
| 82 | " (http://redmine.named-data.net/projects/nfd/wiki/Boost_FAQ)") |
Alexander Afanasyev | 2aa3962 | 2014-01-22 11:51:11 -0800 | [diff] [blame] | 83 | return |
Alexander Afanasyev | c78b141 | 2014-02-19 14:08:26 -0800 | [diff] [blame] | 84 | |
| 85 | conf.load('unix-socket') |
Wentao Shang | 53df163 | 2014-04-21 12:01:32 -0700 | [diff] [blame] | 86 | conf.checkWebsocket(mandatory=True) |
Davide Pesavento | 44deacc | 2014-02-19 10:48:07 +0100 | [diff] [blame] | 87 | |
Alexander Afanasyev | 5cda2e0 | 2014-04-11 13:58:44 -0700 | [diff] [blame] | 88 | conf.checkDependency(name='librt', lib='rt', mandatory=False) |
Alexander Afanasyev | 5cda2e0 | 2014-04-11 13:58:44 -0700 | [diff] [blame] | 89 | conf.checkDependency(name='libresolv', lib='resolv', mandatory=False) |
Davide Pesavento | f0ae442 | 2014-05-05 16:32:12 +0200 | [diff] [blame] | 90 | |
Alexander Afanasyev | 885a85b | 2014-04-12 21:01:13 -0700 | [diff] [blame] | 91 | if not conf.options.without_libpcap: |
Alexander Afanasyev | e918621 | 2014-08-23 20:15:48 -0700 | [diff] [blame] | 92 | conf.check_asio_pcap_support() |
| 93 | if conf.env['HAVE_ASIO_PCAP_SUPPORT']: |
| 94 | conf.checkDependency(name='libpcap', lib='pcap', mandatory=True, |
| 95 | errmsg='not found, but required for Ethernet face support. ' |
| 96 | 'Specify --without-libpcap to disable Ethernet face support.') |
| 97 | else: |
| 98 | Logs.warn('Warning: Ethernet face support is not supported on this platform with Boost libraries version 1.56. ' |
| 99 | 'See http://redmine.named-data.net/issues/1877 for more details') |
Davide Pesavento | f0ae442 | 2014-05-05 16:32:12 +0200 | [diff] [blame] | 100 | if conf.env['HAVE_LIBPCAP']: |
| 101 | conf.check_cxx(function_name='pcap_set_immediate_mode', header_name='pcap/pcap.h', |
| 102 | cxxflags='-Wno-error', use='LIBPCAP', mandatory=False) |
Alexander Afanasyev | efea8fe | 2014-03-23 00:00:35 -0700 | [diff] [blame] | 103 | |
Alexander Afanasyev | 689569b | 2014-02-16 20:20:07 -0800 | [diff] [blame] | 104 | conf.load('coverage') |
| 105 | |
Steve DiBenedetto | fbb40a8 | 2014-03-11 19:40:15 -0600 | [diff] [blame] | 106 | conf.define('DEFAULT_CONFIG_FILE', '%s/ndn/nfd.conf' % conf.env['SYSCONFDIR']) |
Steve DiBenedetto | 2c2b889 | 2014-02-27 11:46:48 -0700 | [diff] [blame] | 107 | |
Alexander Afanasyev | 613e2a9 | 2014-04-15 13:36:58 -0700 | [diff] [blame] | 108 | conf.write_config_header('config.hpp') |
Alexander Afanasyev | 2aa3962 | 2014-01-22 11:51:11 -0800 | [diff] [blame] | 109 | |
Junxiao Shi | 09bf7c4 | 2014-01-31 11:10:25 -0700 | [diff] [blame] | 110 | def build(bld): |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 111 | version(bld) |
| 112 | |
| 113 | bld(features="subst", |
| 114 | name='version', |
| 115 | source='version.hpp.in', |
| 116 | target='version.hpp', |
| 117 | install_path=None, |
| 118 | VERSION_STRING=VERSION_BASE, |
| 119 | VERSION_BUILD=VERSION, |
| 120 | VERSION=int(VERSION_SPLIT[0]) * 1000000 + |
| 121 | int(VERSION_SPLIT[1]) * 1000 + |
| 122 | int(VERSION_SPLIT[2]), |
| 123 | VERSION_MAJOR=VERSION_SPLIT[0], |
| 124 | VERSION_MINOR=VERSION_SPLIT[1], |
| 125 | VERSION_PATCH=VERSION_SPLIT[2], |
| 126 | ) |
| 127 | |
Alexander Afanasyev | 613e2a9 | 2014-04-15 13:36:58 -0700 | [diff] [blame] | 128 | core = bld( |
| 129 | target='core-objects', |
| 130 | name='core-objects', |
Alexander Afanasyev | 58ea458 | 2014-05-30 08:38:56 +0300 | [diff] [blame] | 131 | features='cxx pch', |
Alexander Afanasyev | 613e2a9 | 2014-04-15 13:36:58 -0700 | [diff] [blame] | 132 | source=bld.path.ant_glob(['core/**/*.cpp']), |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 133 | use='version BOOST NDN_CXX LIBRT', |
Alexander Afanasyev | 613e2a9 | 2014-04-15 13:36:58 -0700 | [diff] [blame] | 134 | includes='. core', |
| 135 | export_includes='. core', |
Alexander Afanasyev | 58ea458 | 2014-05-30 08:38:56 +0300 | [diff] [blame] | 136 | headers='common.hpp', |
Alexander Afanasyev | 613e2a9 | 2014-04-15 13:36:58 -0700 | [diff] [blame] | 137 | ) |
| 138 | |
Alexander Afanasyev | c78b141 | 2014-02-19 14:08:26 -0800 | [diff] [blame] | 139 | nfd_objects = bld( |
Alexander Afanasyev | 613e2a9 | 2014-04-15 13:36:58 -0700 | [diff] [blame] | 140 | target='daemon-objects', |
| 141 | name='daemon-objects', |
Alexander Afanasyev | 97e4cac | 2014-03-28 10:55:11 -0700 | [diff] [blame] | 142 | features='cxx', |
| 143 | source=bld.path.ant_glob(['daemon/**/*.cpp'], |
| 144 | excl=['daemon/face/ethernet-*.cpp', |
| 145 | 'daemon/face/unix-*.cpp', |
Wentao Shang | 53df163 | 2014-04-21 12:01:32 -0700 | [diff] [blame] | 146 | 'daemon/face/websocket-*.cpp', |
Alexander Afanasyev | 97e4cac | 2014-03-28 10:55:11 -0700 | [diff] [blame] | 147 | 'daemon/main.cpp']), |
Steve DiBenedetto | ef04f27 | 2014-06-04 14:28:31 -0600 | [diff] [blame] | 148 | use='core-objects WEBSOCKET', |
| 149 | includes='daemon', |
Alexander Afanasyev | 613e2a9 | 2014-04-15 13:36:58 -0700 | [diff] [blame] | 150 | export_includes='daemon', |
Junxiao Shi | 0fcb41e | 2014-01-24 10:29:43 -0700 | [diff] [blame] | 151 | ) |
| 152 | |
Alexander Afanasyev | 885a85b | 2014-04-12 21:01:13 -0700 | [diff] [blame] | 153 | if bld.env['HAVE_LIBPCAP']: |
Davide Pesavento | 44deacc | 2014-02-19 10:48:07 +0100 | [diff] [blame] | 154 | nfd_objects.source += bld.path.ant_glob('daemon/face/ethernet-*.cpp') |
Alexander Afanasyev | 5cda2e0 | 2014-04-11 13:58:44 -0700 | [diff] [blame] | 155 | nfd_objects.use += ' LIBPCAP' |
Davide Pesavento | 44deacc | 2014-02-19 10:48:07 +0100 | [diff] [blame] | 156 | |
Alexander Afanasyev | c78b141 | 2014-02-19 14:08:26 -0800 | [diff] [blame] | 157 | if bld.env['HAVE_UNIX_SOCKETS']: |
Davide Pesavento | 44deacc | 2014-02-19 10:48:07 +0100 | [diff] [blame] | 158 | nfd_objects.source += bld.path.ant_glob('daemon/face/unix-*.cpp') |
Alexander Afanasyev | c78b141 | 2014-02-19 14:08:26 -0800 | [diff] [blame] | 159 | |
Wentao Shang | 53df163 | 2014-04-21 12:01:32 -0700 | [diff] [blame] | 160 | if bld.env['HAVE_WEBSOCKET']: |
| 161 | nfd_objects.source += bld.path.ant_glob('daemon/face/websocket-*.cpp') |
| 162 | |
Alexander Afanasyev | 613e2a9 | 2014-04-15 13:36:58 -0700 | [diff] [blame] | 163 | bld(target='bin/nfd', |
Alexander Afanasyev | 97e4cac | 2014-03-28 10:55:11 -0700 | [diff] [blame] | 164 | features='cxx cxxprogram', |
| 165 | source='daemon/main.cpp', |
Alexander Afanasyev | 613e2a9 | 2014-04-15 13:36:58 -0700 | [diff] [blame] | 166 | use='daemon-objects', |
hilata | 198cadb | 2014-02-15 23:46:19 -0600 | [diff] [blame] | 167 | ) |
Steve DiBenedetto | 84da5bf | 2014-03-11 14:51:29 -0600 | [diff] [blame] | 168 | |
Alexander Afanasyev | 3ecec50 | 2014-04-16 13:42:44 -0700 | [diff] [blame] | 169 | rib_objects = bld( |
| 170 | target='rib-objects', |
| 171 | name='rib-objects', |
| 172 | features='cxx', |
| 173 | source=bld.path.ant_glob(['rib/**/*.cpp'], |
| 174 | excl=['rib/main.cpp']), |
| 175 | use='core-objects', |
| 176 | ) |
| 177 | |
| 178 | bld(target='bin/nrd', |
| 179 | features='cxx cxxprogram', |
| 180 | source='rib/main.cpp', |
| 181 | use='rib-objects', |
| 182 | ) |
| 183 | |
hilata | 198cadb | 2014-02-15 23:46:19 -0600 | [diff] [blame] | 184 | for app in bld.path.ant_glob('tools/*.cpp'): |
| 185 | bld(features=['cxx', 'cxxprogram'], |
Alexander Afanasyev | 97e4cac | 2014-03-28 10:55:11 -0700 | [diff] [blame] | 186 | target='bin/%s' % (str(app.change_ext(''))), |
| 187 | source=['tools/%s' % (str(app))], |
Alexander Afanasyev | 613e2a9 | 2014-04-15 13:36:58 -0700 | [diff] [blame] | 188 | use='core-objects LIBRESOLV', |
hilata | 198cadb | 2014-02-15 23:46:19 -0600 | [diff] [blame] | 189 | ) |
Davide Pesavento | 44deacc | 2014-02-19 10:48:07 +0100 | [diff] [blame] | 190 | |
Alexander Afanasyev | 613e2a9 | 2014-04-15 13:36:58 -0700 | [diff] [blame] | 191 | bld.recurse("tests") |
Ilya Moiseenko | 96b80bb | 2014-04-05 20:53:27 -0400 | [diff] [blame] | 192 | |
Alexander Afanasyev | 97e4cac | 2014-03-28 10:55:11 -0700 | [diff] [blame] | 193 | bld(features="subst", |
| 194 | source='nfd.conf.sample.in', |
| 195 | target='nfd.conf.sample', |
Alexander Afanasyev | 885a85b | 2014-04-12 21:01:13 -0700 | [diff] [blame] | 196 | install_path="${SYSCONFDIR}/ndn", |
Wentao Shang | 53df163 | 2014-04-21 12:01:32 -0700 | [diff] [blame] | 197 | IF_HAVE_LIBPCAP="" if bld.env['HAVE_LIBPCAP'] else "; ", |
| 198 | IF_HAVE_WEBSOCKET="" if bld.env['HAVE_WEBSOCKET'] else "; ") |
Alexander Afanasyev | 35fc2b7 | 2014-02-13 16:56:21 -0800 | [diff] [blame] | 199 | |
Alexander Afanasyev | 49272f7 | 2014-04-06 21:49:46 -0700 | [diff] [blame] | 200 | if bld.env['SPHINX_BUILD']: |
| 201 | bld(features="sphinx", |
| 202 | builder="man", |
| 203 | outdir="docs/manpages", |
| 204 | config="docs/conf.py", |
| 205 | source=bld.path.ant_glob('docs/manpages/**/*.rst'), |
Beichuan Zhang | 55b8ed4 | 2014-04-26 22:25:44 -0700 | [diff] [blame] | 206 | install_path="${MANDIR}/", |
| 207 | VERSION=VERSION) |
Alexander Afanasyev | 49272f7 | 2014-04-06 21:49:46 -0700 | [diff] [blame] | 208 | |
Alexander Afanasyev | 8a09376 | 2014-07-16 18:43:09 -0700 | [diff] [blame] | 209 | for script in bld.path.ant_glob(['tools/*.sh', 'tools/*.py']): |
Junxiao Shi | d71d84c | 2014-04-18 17:22:50 -0700 | [diff] [blame] | 210 | bld(features='subst', |
| 211 | source='tools/%s' % (str(script)), |
| 212 | target='bin/%s' % (str(script.change_ext(''))), |
| 213 | install_path="${BINDIR}", |
Alexander Afanasyev | f7bbe47 | 2014-05-11 19:31:13 -0700 | [diff] [blame] | 214 | chmod=Utils.O755, |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 215 | VERSION=VERSION) |
Junxiao Shi | d71d84c | 2014-04-18 17:22:50 -0700 | [diff] [blame] | 216 | |
Alexander Afanasyev | 8a09376 | 2014-07-16 18:43:09 -0700 | [diff] [blame] | 217 | bld.install_files("${DATAROOTDIR}/ndn", |
| 218 | bld.path.ant_glob('tools/nfd-status-http-server-files/*')) |
| 219 | |
Alexander Afanasyev | 284257b | 2014-04-11 14:16:51 -0700 | [diff] [blame] | 220 | def docs(bld): |
| 221 | from waflib import Options |
| 222 | Options.commands = ['doxygen', 'sphinx'] + Options.commands |
| 223 | |
Alexander Afanasyev | 35fc2b7 | 2014-02-13 16:56:21 -0800 | [diff] [blame] | 224 | def doxygen(bld): |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 225 | version(bld) |
| 226 | |
Alexander Afanasyev | 35fc2b7 | 2014-02-13 16:56:21 -0800 | [diff] [blame] | 227 | if not bld.env.DOXYGEN: |
Beichuan Zhang | 55b8ed4 | 2014-04-26 22:25:44 -0700 | [diff] [blame] | 228 | Logs.error("ERROR: cannot build documentation (`doxygen' is not found in $PATH)") |
| 229 | else: |
| 230 | bld(features="subst", |
| 231 | name="doxygen-conf", |
Alexander Afanasyev | 2075788 | 2014-08-25 22:39:08 -0700 | [diff] [blame^] | 232 | source=["docs/doxygen.conf.in", |
| 233 | "docs/named_data_theme/named_data_footer-with-analytics.html.in"], |
| 234 | target=["docs/doxygen.conf", |
| 235 | "docs/named_data_theme/named_data_footer-with-analytics.html"], |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 236 | VERSION=VERSION_BASE, |
Alexander Afanasyev | 2075788 | 2014-08-25 22:39:08 -0700 | [diff] [blame^] | 237 | HTML_FOOTER="../build/docs/named_data_theme/named_data_footer-with-analytics.html" \ |
| 238 | if os.getenv('GOOGLE_ANALYTICS', None) \ |
| 239 | else "../docs/named_data_theme/named_data_footer.html", |
| 240 | GOOGLE_ANALYTICS=os.getenv('GOOGLE_ANALYTICS', ""), |
Beichuan Zhang | 55b8ed4 | 2014-04-26 22:25:44 -0700 | [diff] [blame] | 241 | ) |
| 242 | |
| 243 | bld(features="doxygen", |
| 244 | doxyfile='docs/doxygen.conf', |
| 245 | use="doxygen-conf") |
Alexander Afanasyev | 49272f7 | 2014-04-06 21:49:46 -0700 | [diff] [blame] | 246 | |
| 247 | def sphinx(bld): |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 248 | version(bld) |
| 249 | |
Beichuan Zhang | 55b8ed4 | 2014-04-26 22:25:44 -0700 | [diff] [blame] | 250 | if not bld.env.SPHINX_BUILD: |
| 251 | bld.fatal("ERROR: cannot build documentation (`sphinx-build' is not found in $PATH)") |
| 252 | else: |
| 253 | bld(features="sphinx", |
| 254 | outdir="docs", |
| 255 | source=bld.path.ant_glob('docs/**/*.rst'), |
| 256 | config="docs/conf.py", |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 257 | VERSION=VERSION_BASE) |
| 258 | |
| 259 | def version(ctx): |
Alexander Afanasyev | 2618153 | 2014-05-07 23:38:51 -0700 | [diff] [blame] | 260 | if getattr(Context.g_module, 'VERSION_BASE', None): |
| 261 | return |
| 262 | |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 263 | Context.g_module.VERSION_BASE = Context.g_module.VERSION |
| 264 | Context.g_module.VERSION_SPLIT = [v for v in VERSION_BASE.split('.')] |
| 265 | |
Alexander Afanasyev | 48f5a3c | 2014-08-22 22:33:01 -0700 | [diff] [blame] | 266 | didGetVersion = False |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 267 | try: |
Alexander Afanasyev | 48f5a3c | 2014-08-22 22:33:01 -0700 | [diff] [blame] | 268 | cmd = ['git', 'describe', '--always', '--match', '%s*' % GIT_TAG_PREFIX] |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 269 | p = Utils.subprocess.Popen(cmd, stdout=Utils.subprocess.PIPE, |
| 270 | stderr=None, stdin=None) |
| 271 | out = p.communicate()[0].strip() |
Alexander Afanasyev | 48f5a3c | 2014-08-22 22:33:01 -0700 | [diff] [blame] | 272 | didGetVersion = (p.returncode == 0 and out != "") |
| 273 | if didGetVersion: |
| 274 | if out.startswith(GIT_TAG_PREFIX): |
| 275 | Context.g_module.VERSION = out[len(GIT_TAG_PREFIX):] |
| 276 | else: |
| 277 | Context.g_module.VERSION = "%s-commit-%s" % (Context.g_module.VERSION_BASE, out) |
| 278 | except OSError: |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 279 | pass |
| 280 | |
Alexander Afanasyev | 48f5a3c | 2014-08-22 22:33:01 -0700 | [diff] [blame] | 281 | versionFile = ctx.path.find_node('VERSION') |
| 282 | |
| 283 | if not didGetVersion and versionFile is not None: |
| 284 | try: |
| 285 | Context.g_module.VERSION = versionFile.read() |
| 286 | return |
| 287 | except (OSError, IOError): |
| 288 | pass |
| 289 | |
| 290 | # version was obtained from git, update VERSION file if necessary |
| 291 | if versionFile is not None: |
| 292 | try: |
| 293 | version = versionFile.read() |
| 294 | if version == Context.g_module.VERSION: |
| 295 | return # no need to update |
| 296 | except (OSError, IOError): |
| 297 | Logs.warn("VERSION file exists, but not readable") |
| 298 | else: |
| 299 | versionFile = ctx.path.make_node('VERSION') |
| 300 | |
| 301 | if versionFile is None: |
| 302 | return |
| 303 | |
| 304 | try: |
| 305 | versionFile.write(Context.g_module.VERSION) |
| 306 | except (OSError, IOError): |
| 307 | Logs.warn("VERSION file is not writeable") |
| 308 | |
Alexander Afanasyev | b47d538 | 2014-05-05 14:35:03 -0700 | [diff] [blame] | 309 | def dist(ctx): |
| 310 | version(ctx) |
| 311 | |
| 312 | def distcheck(ctx): |
| 313 | version(ctx) |