blob: 76c39a8a9eeb6e7a899451bc1358e5a12413230c [file] [log] [blame]
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -08001# -*- Mode: python; py-indent-offset: 4; indent-tabs-mode: nil; coding: utf-8; -*-
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -08002
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -07003from waflib import Logs, Utils, Context
4import os
Alexander Afanasyeva06fdda2014-04-29 19:15:00 -07005
Alexander Afanasyev2e52d7c2016-03-24 13:13:11 -07006VERSION = "0.4.1"
Alexander Afanasyev766cea72014-04-24 19:16:42 -07007APPNAME = "ndn-cxx"
8PACKAGE_BUGREPORT = "http://redmine.named-data.net/projects/ndn-cxx"
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -07009PACKAGE_URL = "http://named-data.net/doc/ndn-cxx/"
Alexander Afanasyev6c632302014-10-31 12:34:11 -070010GIT_TAG_PREFIX = "ndn-cxx-"
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -070011
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -080012def options(opt):
Alexander Afanasyev1160baa2014-04-10 18:50:29 -070013 opt.load(['compiler_cxx', 'gnu_dirs', 'c_osx'])
14 opt.load(['default-compiler-flags', 'coverage', 'osx-security', 'pch',
Yingdi Yub3015bd2015-06-23 23:21:53 -070015 'boost', 'cryptopp', 'sqlite3', 'openssl',
Junxiao Shi8d71fdb2014-12-07 21:55:19 -070016 'doxygen', 'sphinx_build', 'type_traits', 'compiler-features'],
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -070017 tooldir=['.waf-tools'])
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -080018
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -070019 opt = opt.add_option_group('Library Options')
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -080020
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -070021 opt.add_option('--with-tests', action='store_true', default=False, dest='with_tests',
Alexander Afanasyev224044f2016-07-18 10:45:08 +020022 help='''Build unit tests''')
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -080023
Yingdi Yue6bfab22014-02-06 16:01:19 -080024 opt.add_option('--without-tools', action='store_false', default=True, dest='with_tools',
25 help='''Do not build tools''')
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -080026
Alexander Afanasyevc8bcd452014-05-12 17:58:47 -070027 opt.add_option('--with-examples', action='store_true', default=False, dest='with_examples',
28 help='''Build examples''')
29
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -070030 opt.add_option('--without-sqlite-locking', action='store_false', default=True,
31 dest='with_sqlite_locking',
32 help='''Disable filesystem locking in sqlite3 database '''
33 '''(use unix-dot locking mechanism instead). '''
Alexander Afanasyevf5df8e62014-02-16 19:56:21 -080034 '''This option may be necessary if home directory is hosted on NFS.''')
Alexander Afanasyev5519cc72015-03-01 14:25:03 -080035
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -070036 opt.add_option('--without-osx-keychain', action='store_false', default=True,
37 dest='with_osx_keychain',
Alexander Afanasyev3e08d5d2014-02-12 19:24:28 -080038 help='''On Darwin, do not use OSX keychain as a default TPM''')
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -080039
Spyridon Mastorakis5ebfda62015-07-21 20:57:40 -070040 opt.add_option('--enable-static', action='store_true', default=False,
41 dest='enable_static', help='''Build static library (disabled by default)''')
42 opt.add_option('--disable-static', action='store_false', default=False,
43 dest='enable_static', help='''Do not build static library (disabled by default)''')
Alexander Afanasyev5519cc72015-03-01 14:25:03 -080044
Spyridon Mastorakis5ebfda62015-07-21 20:57:40 -070045 opt.add_option('--enable-shared', action='store_true', default=True,
46 dest='enable_shared', help='''Build shared library (enabled by default)''')
47 opt.add_option('--disable-shared', action='store_false', default=True,
48 dest='enable_shared', help='''Do not build shared library (enabled by default)''')
Alexander Afanasyev5519cc72015-03-01 14:25:03 -080049
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -080050def configure(conf):
Alexander Afanasyev5519cc72015-03-01 14:25:03 -080051 conf.start_msg('Building static library')
52 if conf.options.enable_static:
53 conf.end_msg('yes')
54 else:
55 conf.end_msg('no', color='YELLOW')
56 conf.env.enable_static = conf.options.enable_static
57
58 conf.start_msg('Building shared library')
59 if conf.options.enable_shared:
60 conf.end_msg('yes')
61 else:
62 conf.end_msg('no', color='YELLOW')
63 conf.env.enable_shared = conf.options.enable_shared
64
65 if not conf.options.enable_shared and not conf.options.enable_static:
66 conf.fatal("Either static library or shared library must be enabled")
67
Davide Pesavento9a8bae52016-02-24 20:33:08 +010068 conf.load(['compiler_cxx', 'gnu_dirs', 'c_osx', 'default-compiler-flags',
Yingdi Yub3015bd2015-06-23 23:21:53 -070069 'osx-security', 'pch', 'boost', 'cryptopp', 'sqlite3', 'openssl',
Davide Pesavento9a8bae52016-02-24 20:33:08 +010070 'type_traits', 'compiler-features', 'doxygen', 'sphinx_build'])
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -080071
Alexander Afanasyev1160baa2014-04-10 18:50:29 -070072 conf.env['WITH_TESTS'] = conf.options.with_tests
73 conf.env['WITH_TOOLS'] = conf.options.with_tools
Alexander Afanasyevc8bcd452014-05-12 17:58:47 -070074 conf.env['WITH_EXAMPLES'] = conf.options.with_examples
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -080075
Alexander Afanasyev95de62e2014-04-11 18:26:33 -070076 conf.find_program('sh', var='SH', mandatory=True)
77
Alexander Afanasyevfff47d62014-05-11 19:24:46 -070078 conf.check_cxx(lib='pthread', uselib_store='PTHREAD', define_name='HAVE_PTHREAD',
79 mandatory=False)
80 conf.check_cxx(lib='rt', uselib_store='RT', define_name='HAVE_RT', mandatory=False)
Alexander Afanasyev3188c40f2015-01-28 14:49:42 -080081 conf.check_cxx(msg='Checking for function getpass', mandatory=False,
82 define_name='HAVE_GETPASS', fragment='''
83#include <unistd.h>
84int
85main(int, char**)
86{
87 char* pass = getpass("test prompt");
88 (void)(pass);
89 return 0;
90}
91''')
Alexander Afanasyevfff47d62014-05-11 19:24:46 -070092
Alexander Afanasyev7b3080f2015-01-28 21:21:01 -080093 conf.check_cxx(msg='Checking for rtnetlink', mandatory=False,
94 define_name='HAVE_RTNETLINK',
95 header_name=['netinet/in.h', 'linux/netlink.h', 'linux/rtnetlink.h', 'net/if.h'])
96
Alexander Afanasyev1160baa2014-04-10 18:50:29 -070097 conf.check_osx_security(mandatory=False)
Yingdi Yue6bfab22014-02-06 16:01:19 -080098
Alexander Afanasyev1160baa2014-04-10 18:50:29 -070099 conf.check_sqlite3(mandatory=True)
Alexander Afanasyevfff47d62014-05-11 19:24:46 -0700100 conf.check_cryptopp(mandatory=True, use='PTHREAD')
Yingdi Yub3015bd2015-06-23 23:21:53 -0700101 conf.check_openssl(mandatory=True, atleast_version=0x10001000) # 1.0.1
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800102
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -0700103 USED_BOOST_LIBS = ['system', 'filesystem', 'date_time', 'iostreams',
Junxiao Shi7d054272016-08-04 17:00:41 +0000104 'regex', 'program_options', 'chrono', 'random',
105 'thread', 'log', 'log_setup']
106
Alexander Afanasyevdafdc372014-03-03 15:58:44 +0000107 if conf.env['WITH_TESTS']:
108 USED_BOOST_LIBS += ['unit_test_framework']
Yingdi Yuf56c68f2014-04-24 21:50:13 -0700109 conf.define('HAVE_TESTS', 1)
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800110
Junxiao Shi7d054272016-08-04 17:00:41 +0000111 conf.check_boost(lib=USED_BOOST_LIBS, mandatory=True, mt=True)
Davide Pesaventoe6e6fde2016-04-16 14:44:45 +0200112 if conf.env.BOOST_VERSION_NUMBER < 105400:
113 Logs.error("Minimum required boost version is 1.54.0")
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -0700114 Logs.error("Please upgrade your distribution or install custom boost libraries" +
Alexander Afanasyevdafdc372014-03-03 15:58:44 +0000115 " (http://redmine.named-data.net/projects/nfd/wiki/Boost_FAQ)")
116 return
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800117
Alexander Afanasyev5b60f702014-02-07 12:55:24 -0800118 if not conf.options.with_sqlite_locking:
119 conf.define('DISABLE_SQLITE3_FS_LOCKING', 1)
Alexander Afanasyevf5df8e62014-02-16 19:56:21 -0800120
Alexander Afanasyev59d67a52014-04-03 16:09:31 -0700121 if conf.env['HAVE_OSX_SECURITY']:
Alexander Afanasyev3e08d5d2014-02-12 19:24:28 -0800122 conf.env['WITH_OSX_KEYCHAIN'] = conf.options.with_osx_keychain
123 if conf.options.with_osx_keychain:
124 conf.define('WITH_OSX_KEYCHAIN', 1)
125 else:
126 conf.env['WITH_OSX_KEYCHAIN'] = False
Alexander Afanasyevf5df8e62014-02-16 19:56:21 -0800127
Alexander Afanasyev1160baa2014-04-10 18:50:29 -0700128 # Loading "late" to prevent tests to be compiled with profiling flags
129 conf.load('coverage')
Alexander Afanasyevf5df8e62014-02-16 19:56:21 -0800130
Steve DiBenedettoc07b3a22014-03-19 12:32:52 -0600131 conf.define('SYSCONFDIR', conf.env['SYSCONFDIR'])
132
Alexander Afanasyev224044f2016-07-18 10:45:08 +0200133 if not conf.env.enable_static:
134 # If there happens to be a static library, waf will put the corresponding -L flags
135 # before dynamic library flags. This can result in compilation failure when the
136 # system has a different version of the ndn-cxx library installed.
137 conf.env['STLIBPATH'] = ['.'] + conf.env['STLIBPATH']
138
Alexander Afanasyev3e7d2ac2015-02-10 19:39:28 -0800139 # config file will contain all defines that were added using conf.define('xxx'...)
140 # Everything that was added directly to conf.env['DEFINES'] will not appear in the
141 # config file and will be added using compiler directives in the command line.
Alexander Afanasyev766cea72014-04-24 19:16:42 -0700142 conf.write_config_header('src/ndn-cxx-config.hpp', define_prefix='NDN_CXX_')
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800143
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -0700144def build(bld):
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -0700145 version(bld)
146
147 bld(features="subst",
148 name='version',
149 source='src/version.hpp.in',
150 target='src/version.hpp',
151 install_path=None,
152 VERSION_STRING=VERSION_BASE,
153 VERSION_BUILD=VERSION,
154 VERSION=int(VERSION_SPLIT[0]) * 1000000 +
155 int(VERSION_SPLIT[1]) * 1000 +
156 int(VERSION_SPLIT[2]),
157 VERSION_MAJOR=VERSION_SPLIT[0],
158 VERSION_MINOR=VERSION_SPLIT[1],
159 VERSION_PATCH=VERSION_SPLIT[2],
160 )
161
Alexander Afanasyev5519cc72015-03-01 14:25:03 -0800162 libndn_cxx = dict(
Alexander Afanasyev766cea72014-04-24 19:16:42 -0700163 target="ndn-cxx",
164 name="ndn-cxx",
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -0700165 source=bld.path.ant_glob('src/**/*.cpp',
Davide Pesavento9a8bae52016-02-24 20:33:08 +0100166 excl=['src/security/**/*-osx.cpp',
167 'src/**/*-sqlite3.cpp']),
Alexander Afanasyev8b1674a2014-05-15 00:58:43 -0700168 headers='src/common-pch.hpp',
Yingdi Yub3015bd2015-06-23 23:21:53 -0700169 use='version BOOST CRYPTOPP OPENSSL SQLITE3 RT PTHREAD',
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -0700170 includes=". src",
171 export_includes="src",
172 install_path='${LIBDIR}',
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800173 )
174
Alexander Afanasyev59d67a52014-04-03 16:09:31 -0700175 if bld.env['HAVE_OSX_SECURITY']:
Davide Pesavento9a8bae52016-02-24 20:33:08 +0100176 libndn_cxx['source'] += bld.path.ant_glob('src/security/**/*-osx.cpp')
Alexander Afanasyev5519cc72015-03-01 14:25:03 -0800177 libndn_cxx['mac_app'] = True
178 libndn_cxx['use'] += " OSX_COREFOUNDATION OSX_SECURITY"
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800179
Alexander Afanasyev1e0a0772014-01-28 20:07:07 -0800180 # In case we want to make it optional later
Alexander Afanasyev5519cc72015-03-01 14:25:03 -0800181 libndn_cxx['source'] += bld.path.ant_glob('src/**/*-sqlite3.cpp')
182
183 if bld.env.enable_shared:
184 bld(features=['pch', 'cxx', 'cxxshlib'],
185 vnum=VERSION_BASE,
186 cnum=VERSION_BASE,
187 **libndn_cxx)
188
189 if bld.env.enable_static:
190 bld(features=['pch', 'cxx', 'cxxstlib'],
191 **libndn_cxx)
Alexander Afanasyevd409d592014-01-28 18:36:38 -0800192
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -0700193 # Prepare flags that should go to pkgconfig file
Alexander Afanasyev200dd6f2014-01-28 19:04:25 -0800194 pkgconfig_libs = []
195 pkgconfig_ldflags = []
Alexander Afanasyevf5df8e62014-02-16 19:56:21 -0800196 pkgconfig_linkflags = []
Alexander Afanasyev200dd6f2014-01-28 19:04:25 -0800197 pkgconfig_includes = []
Alexander Afanasyevf5df8e62014-02-16 19:56:21 -0800198 pkgconfig_cxxflags = []
Alexander Afanasyev5519cc72015-03-01 14:25:03 -0800199 for lib in Utils.to_list(libndn_cxx['use']):
Alexander Afanasyev200dd6f2014-01-28 19:04:25 -0800200 if bld.env['LIB_%s' % lib]:
201 pkgconfig_libs += Utils.to_list(bld.env['LIB_%s' % lib])
202 if bld.env['LIBPATH_%s' % lib]:
203 pkgconfig_ldflags += Utils.to_list(bld.env['LIBPATH_%s' % lib])
204 if bld.env['INCLUDES_%s' % lib]:
205 pkgconfig_includes += Utils.to_list(bld.env['INCLUDES_%s' % lib])
Alexander Afanasyevf5df8e62014-02-16 19:56:21 -0800206 if bld.env['LINKFLAGS_%s' % lib]:
207 pkgconfig_linkflags += Utils.to_list(bld.env['LINKFLAGS_%s' % lib])
208 if bld.env['CXXFLAGS_%s' % lib]:
209 pkgconfig_cxxflags += Utils.to_list(bld.env['CXXFLAGS_%s' % lib])
Alexander Afanasyev200dd6f2014-01-28 19:04:25 -0800210
Alexander Afanasyev84cf4292014-01-29 22:16:27 -0800211 EXTRA_FRAMEWORKS = "";
Alexander Afanasyev59d67a52014-04-03 16:09:31 -0700212 if bld.env['HAVE_OSX_SECURITY']:
Alexander Afanasyev84cf4292014-01-29 22:16:27 -0800213 EXTRA_FRAMEWORKS = "-framework CoreFoundation -framework Security"
Alexander Afanasyevf5df8e62014-02-16 19:56:21 -0800214
Alexander Afanasyev200dd6f2014-01-28 19:04:25 -0800215 def uniq(alist):
216 set = {}
217 return [set.setdefault(e,e) for e in alist if e not in set]
Alexander Afanasyevf5df8e62014-02-16 19:56:21 -0800218
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -0700219 pkconfig = bld(features="subst",
Alexander Afanasyev766cea72014-04-24 19:16:42 -0700220 source="libndn-cxx.pc.in",
221 target="libndn-cxx.pc",
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -0700222 install_path="${LIBDIR}/pkgconfig",
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -0700223 VERSION=VERSION_BASE,
Alexander Afanasyev200dd6f2014-01-28 19:04:25 -0800224
225 # This probably not the right thing to do, but to simplify life of apps
226 # that use the library
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -0700227 EXTRA_LIBS=" ".join([('-l%s' % i) for i in uniq(pkgconfig_libs)]),
228 EXTRA_LDFLAGS=" ".join([('-L%s' % i) for i in uniq(pkgconfig_ldflags)]),
229 EXTRA_LINKFLAGS=" ".join(uniq(pkgconfig_linkflags)),
230 EXTRA_INCLUDES=" ".join([('-I%s' % i) for i in uniq(pkgconfig_includes)]),
231 EXTRA_CXXFLAGS=" ".join(uniq(pkgconfig_cxxflags)),
232 EXTRA_FRAMEWORKS=EXTRA_FRAMEWORKS,
Alexander Afanasyevd409d592014-01-28 18:36:38 -0800233 )
Alexander Afanasyevf5df8e62014-02-16 19:56:21 -0800234
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800235 # Unit tests
236 if bld.env['WITH_TESTS']:
Alexander Afanasyevd409d592014-01-28 18:36:38 -0800237 bld.recurse('tests')
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800238
Yingdi Yue6bfab22014-02-06 16:01:19 -0800239 if bld.env['WITH_TOOLS']:
Alexander Afanasyevc8bcd452014-05-12 17:58:47 -0700240 bld.recurse("tools")
241
242 if bld.env['WITH_EXAMPLES']:
Yingdi Yue6bfab22014-02-06 16:01:19 -0800243 bld.recurse("examples")
Alexander Afanasyevf5df8e62014-02-16 19:56:21 -0800244
Davide Pesavento9a8bae52016-02-24 20:33:08 +0100245 headers = bld.path.ant_glob('src/**/*.hpp',
246 excl=['src/security/**/*-osx.hpp',
247 'src/detail/**/*',
248 'src/util/detail/**/*'])
Junxiao Shie30aaea2014-12-03 20:48:34 -0700249 if bld.env['HAVE_OSX_SECURITY']:
Davide Pesavento9a8bae52016-02-24 20:33:08 +0100250 headers += bld.path.ant_glob('src/security/**/*-osx.hpp')
Junxiao Shie30aaea2014-12-03 20:48:34 -0700251
Alexander Afanasyev766cea72014-04-24 19:16:42 -0700252 bld.install_files("%s/ndn-cxx" % bld.env['INCLUDEDIR'], headers,
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -0700253 relative_trick=True, cwd=bld.path.find_node('src'))
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800254
Alexander Afanasyev766cea72014-04-24 19:16:42 -0700255 bld.install_files("%s/ndn-cxx" % bld.env['INCLUDEDIR'],
256 bld.path.find_resource('src/ndn-cxx-config.hpp'))
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800257
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -0700258 bld.install_files("%s/ndn-cxx" % bld.env['INCLUDEDIR'],
259 bld.path.find_resource('src/version.hpp'))
260
Steve DiBenedettoc07b3a22014-03-19 12:32:52 -0600261 bld.install_files("${SYSCONFDIR}/ndn", "client.conf.sample")
262
Alexander Afanasyev7c6aeb02014-04-10 19:59:19 -0700263 if bld.env['SPHINX_BUILD']:
264 bld(features="sphinx",
265 builder="man",
266 outdir="docs/manpages",
267 config="docs/conf.py",
268 source=bld.path.ant_glob('docs/manpages/**/*.rst'),
Alexander Afanasyeva06fdda2014-04-29 19:15:00 -0700269 install_path="${MANDIR}/",
270 VERSION=VERSION)
Alexander Afanasyev7c6aeb02014-04-10 19:59:19 -0700271
272def docs(bld):
273 from waflib import Options
274 Options.commands = ['doxygen', 'sphinx'] + Options.commands
275
Alexander Afanasyev401a2362014-03-02 00:03:11 +0000276def doxygen(bld):
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -0700277 version(bld)
278
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800279 if not bld.env.DOXYGEN:
Alexander Afanasyev7c6aeb02014-04-10 19:59:19 -0700280 Logs.error("ERROR: cannot build documentation (`doxygen' is not found in $PATH)")
281 else:
Alexander Afanasyeva06fdda2014-04-29 19:15:00 -0700282 bld(features="subst",
283 name="doxygen-conf",
Alexander Afanasyev9b0e1142014-05-08 00:17:34 -0700284 source=["docs/doxygen.conf.in",
285 "docs/named_data_theme/named_data_footer-with-analytics.html.in"],
286 target=["docs/doxygen.conf",
287 "docs/named_data_theme/named_data_footer-with-analytics.html"],
Alexander Afanasyeva06fdda2014-04-29 19:15:00 -0700288 VERSION=VERSION,
Alexander Afanasyev9b0e1142014-05-08 00:17:34 -0700289 HTML_FOOTER="../build/docs/named_data_theme/named_data_footer-with-analytics.html" \
290 if os.getenv('GOOGLE_ANALYTICS', None) \
291 else "../docs/named_data_theme/named_data_footer.html",
292 GOOGLE_ANALYTICS=os.getenv('GOOGLE_ANALYTICS', ""),
Alexander Afanasyeva06fdda2014-04-29 19:15:00 -0700293 )
294
Alexander Afanasyev7c6aeb02014-04-10 19:59:19 -0700295 bld(features="doxygen",
Alexander Afanasyeva06fdda2014-04-29 19:15:00 -0700296 doxyfile='docs/doxygen.conf',
297 use="doxygen-conf")
Alexander Afanasyeva1ae0a12014-01-28 15:21:02 -0800298
Alexander Afanasyev5e1288e2014-03-28 11:11:48 -0700299def sphinx(bld):
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -0700300 version(bld)
301
Alexander Afanasyev1160baa2014-04-10 18:50:29 -0700302 if not bld.env.SPHINX_BUILD:
303 bld.fatal("ERROR: cannot build documentation (`sphinx-build' is not found in $PATH)")
Alexander Afanasyev7c6aeb02014-04-10 19:59:19 -0700304 else:
305 bld(features="sphinx",
306 outdir="docs",
307 source=bld.path.ant_glob("docs/**/*.rst"),
Alexander Afanasyeva06fdda2014-04-29 19:15:00 -0700308 config="docs/conf.py",
309 VERSION=VERSION)
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -0700310
311
312def version(ctx):
313 if getattr(Context.g_module, 'VERSION_BASE', None):
314 return
315
316 Context.g_module.VERSION_BASE = Context.g_module.VERSION
317 Context.g_module.VERSION_SPLIT = [v for v in VERSION_BASE.split('.')]
318
Alexander Afanasyev6c632302014-10-31 12:34:11 -0700319 didGetVersion = False
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -0700320 try:
Alexander Afanasyev6c632302014-10-31 12:34:11 -0700321 cmd = ['git', 'describe', '--always', '--match', '%s*' % GIT_TAG_PREFIX]
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -0700322 p = Utils.subprocess.Popen(cmd, stdout=Utils.subprocess.PIPE,
323 stderr=None, stdin=None)
Alexander Afanasyev6c632302014-10-31 12:34:11 -0700324 out = str(p.communicate()[0].strip())
325 didGetVersion = (p.returncode == 0 and out != "")
326 if didGetVersion:
327 if out.startswith(GIT_TAG_PREFIX):
328 Context.g_module.VERSION = out[len(GIT_TAG_PREFIX):]
329 else:
330 Context.g_module.VERSION = "%s-commit-%s" % (Context.g_module.VERSION_BASE, out)
331 except OSError:
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -0700332 pass
333
Alexander Afanasyev6c632302014-10-31 12:34:11 -0700334 versionFile = ctx.path.find_node('VERSION')
335
336 if not didGetVersion and versionFile is not None:
337 try:
338 Context.g_module.VERSION = versionFile.read()
339 return
340 except (OSError, IOError):
341 pass
342
343 # version was obtained from git, update VERSION file if necessary
344 if versionFile is not None:
345 try:
346 version = versionFile.read()
347 if version == Context.g_module.VERSION:
348 return # no need to update
349 except (OSError, IOError):
350 Logs.warn("VERSION file exists, but not readable")
351 else:
352 versionFile = ctx.path.make_node('VERSION')
353
354 if versionFile is None:
355 return
356
357 try:
358 versionFile.write(Context.g_module.VERSION)
359 except (OSError, IOError):
360 Logs.warn("VERSION file is not writeable")
361
Alexander Afanasyevcfe0b062014-05-08 18:26:50 -0700362def dist(ctx):
363 version(ctx)
364
365def distcheck(ctx):
366 version(ctx)