Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 1 | # -*- Mode: python; py-indent-offset: 4; indent-tabs-mode: nil; coding: utf-8; -*- |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 2 | |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 3 | from waflib import Logs, Utils, Context |
| 4 | import os |
Alexander Afanasyev | a06fdda | 2014-04-29 19:15:00 -0700 | [diff] [blame] | 5 | |
Alexander Afanasyev | d36dd55 | 2014-06-30 12:42:46 -0700 | [diff] [blame] | 6 | VERSION = "0.2.0" |
Alexander Afanasyev | 766cea7 | 2014-04-24 19:16:42 -0700 | [diff] [blame] | 7 | APPNAME = "ndn-cxx" |
| 8 | PACKAGE_BUGREPORT = "http://redmine.named-data.net/projects/ndn-cxx" |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 9 | PACKAGE_URL = "http://named-data.net/doc/ndn-cxx/" |
Alexander Afanasyev | 6c63230 | 2014-10-31 12:34:11 -0700 | [diff] [blame] | 10 | GIT_TAG_PREFIX = "ndn-cxx-" |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 11 | |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 12 | def options(opt): |
Alexander Afanasyev | 1160baa | 2014-04-10 18:50:29 -0700 | [diff] [blame] | 13 | opt.load(['compiler_cxx', 'gnu_dirs', 'c_osx']) |
| 14 | opt.load(['default-compiler-flags', 'coverage', 'osx-security', 'pch', |
| 15 | 'boost', 'openssl', 'cryptopp', 'sqlite3', |
Junxiao Shi | c97d5d4 | 2014-11-27 09:33:37 -0700 | [diff] [blame^] | 16 | 'doxygen', 'sphinx_build', 'type_traits'], |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 17 | tooldir=['.waf-tools']) |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 18 | |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 19 | opt = opt.add_option_group('Library Options') |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 20 | |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 21 | opt.add_option('--with-tests', action='store_true', default=False, dest='with_tests', |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 22 | help='''build unit tests''') |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 23 | |
Yingdi Yu | e6bfab2 | 2014-02-06 16:01:19 -0800 | [diff] [blame] | 24 | opt.add_option('--without-tools', action='store_false', default=True, dest='with_tools', |
| 25 | help='''Do not build tools''') |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 26 | |
Alexander Afanasyev | c8bcd45 | 2014-05-12 17:58:47 -0700 | [diff] [blame] | 27 | opt.add_option('--with-examples', action='store_true', default=False, dest='with_examples', |
| 28 | help='''Build examples''') |
| 29 | |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 30 | 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 Afanasyev | f5df8e6 | 2014-02-16 19:56:21 -0800 | [diff] [blame] | 34 | '''This option may be necessary if home directory is hosted on NFS.''') |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 35 | opt.add_option('--without-osx-keychain', action='store_false', default=True, |
| 36 | dest='with_osx_keychain', |
Alexander Afanasyev | 3e08d5d | 2014-02-12 19:24:28 -0800 | [diff] [blame] | 37 | help='''On Darwin, do not use OSX keychain as a default TPM''') |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 38 | |
| 39 | def configure(conf): |
Alexander Afanasyev | 1160baa | 2014-04-10 18:50:29 -0700 | [diff] [blame] | 40 | conf.load(['compiler_cxx', 'gnu_dirs', 'c_osx', |
| 41 | 'default-compiler-flags', 'osx-security', 'pch', |
| 42 | 'boost', 'openssl', 'cryptopp', 'sqlite3', |
Junxiao Shi | c97d5d4 | 2014-11-27 09:33:37 -0700 | [diff] [blame^] | 43 | 'doxygen', 'sphinx_build', 'type_traits']) |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 44 | |
Alexander Afanasyev | 1160baa | 2014-04-10 18:50:29 -0700 | [diff] [blame] | 45 | conf.env['WITH_TESTS'] = conf.options.with_tests |
| 46 | conf.env['WITH_TOOLS'] = conf.options.with_tools |
Alexander Afanasyev | c8bcd45 | 2014-05-12 17:58:47 -0700 | [diff] [blame] | 47 | conf.env['WITH_EXAMPLES'] = conf.options.with_examples |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 48 | |
Alexander Afanasyev | 95de62e | 2014-04-11 18:26:33 -0700 | [diff] [blame] | 49 | conf.find_program('sh', var='SH', mandatory=True) |
| 50 | |
Alexander Afanasyev | fff47d6 | 2014-05-11 19:24:46 -0700 | [diff] [blame] | 51 | conf.check_cxx(lib='pthread', uselib_store='PTHREAD', define_name='HAVE_PTHREAD', |
| 52 | mandatory=False) |
| 53 | conf.check_cxx(lib='rt', uselib_store='RT', define_name='HAVE_RT', mandatory=False) |
Alexander Afanasyev | 8b1674a | 2014-05-15 00:58:43 -0700 | [diff] [blame] | 54 | conf.check_cxx(cxxflags=['-fPIC'], uselib_store='PIC', mandatory=False) |
Alexander Afanasyev | fff47d6 | 2014-05-11 19:24:46 -0700 | [diff] [blame] | 55 | |
Alexander Afanasyev | 1160baa | 2014-04-10 18:50:29 -0700 | [diff] [blame] | 56 | conf.check_osx_security(mandatory=False) |
Yingdi Yu | e6bfab2 | 2014-02-06 16:01:19 -0800 | [diff] [blame] | 57 | |
Alexander Afanasyev | 1160baa | 2014-04-10 18:50:29 -0700 | [diff] [blame] | 58 | conf.check_openssl(mandatory=True) |
| 59 | conf.check_sqlite3(mandatory=True) |
Alexander Afanasyev | fff47d6 | 2014-05-11 19:24:46 -0700 | [diff] [blame] | 60 | conf.check_cryptopp(mandatory=True, use='PTHREAD') |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 61 | |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 62 | USED_BOOST_LIBS = ['system', 'filesystem', 'date_time', 'iostreams', |
Alexander Afanasyev | 7508867 | 2014-07-14 11:58:30 -0700 | [diff] [blame] | 63 | 'regex', 'program_options', 'chrono', 'random'] |
Alexander Afanasyev | dafdc37 | 2014-03-03 15:58:44 +0000 | [diff] [blame] | 64 | if conf.env['WITH_TESTS']: |
| 65 | USED_BOOST_LIBS += ['unit_test_framework'] |
Yingdi Yu | f56c68f | 2014-04-24 21:50:13 -0700 | [diff] [blame] | 66 | conf.define('HAVE_TESTS', 1) |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 67 | |
Alexander Afanasyev | dafdc37 | 2014-03-03 15:58:44 +0000 | [diff] [blame] | 68 | conf.check_boost(lib=USED_BOOST_LIBS, mandatory=True) |
| 69 | if conf.env.BOOST_VERSION_NUMBER < 104800: |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 70 | Logs.error("Minimum required boost version is 1.48.0") |
| 71 | Logs.error("Please upgrade your distribution or install custom boost libraries" + |
Alexander Afanasyev | dafdc37 | 2014-03-03 15:58:44 +0000 | [diff] [blame] | 72 | " (http://redmine.named-data.net/projects/nfd/wiki/Boost_FAQ)") |
| 73 | return |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 74 | |
Alexander Afanasyev | 5b60f70 | 2014-02-07 12:55:24 -0800 | [diff] [blame] | 75 | if not conf.options.with_sqlite_locking: |
| 76 | conf.define('DISABLE_SQLITE3_FS_LOCKING', 1) |
Alexander Afanasyev | f5df8e6 | 2014-02-16 19:56:21 -0800 | [diff] [blame] | 77 | |
Alexander Afanasyev | 59d67a5 | 2014-04-03 16:09:31 -0700 | [diff] [blame] | 78 | if conf.env['HAVE_OSX_SECURITY']: |
Alexander Afanasyev | 3e08d5d | 2014-02-12 19:24:28 -0800 | [diff] [blame] | 79 | conf.env['WITH_OSX_KEYCHAIN'] = conf.options.with_osx_keychain |
| 80 | if conf.options.with_osx_keychain: |
| 81 | conf.define('WITH_OSX_KEYCHAIN', 1) |
| 82 | else: |
| 83 | conf.env['WITH_OSX_KEYCHAIN'] = False |
Alexander Afanasyev | f5df8e6 | 2014-02-16 19:56:21 -0800 | [diff] [blame] | 84 | |
Alexander Afanasyev | 1160baa | 2014-04-10 18:50:29 -0700 | [diff] [blame] | 85 | # Loading "late" to prevent tests to be compiled with profiling flags |
| 86 | conf.load('coverage') |
Alexander Afanasyev | f5df8e6 | 2014-02-16 19:56:21 -0800 | [diff] [blame] | 87 | |
Steve DiBenedetto | c07b3a2 | 2014-03-19 12:32:52 -0600 | [diff] [blame] | 88 | conf.define('SYSCONFDIR', conf.env['SYSCONFDIR']) |
| 89 | |
Alexander Afanasyev | 766cea7 | 2014-04-24 19:16:42 -0700 | [diff] [blame] | 90 | conf.write_config_header('src/ndn-cxx-config.hpp', define_prefix='NDN_CXX_') |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 91 | |
Junxiao Shi | f4f541f | 2014-11-04 20:58:32 -0700 | [diff] [blame] | 92 | # disable assertions in release builds |
| 93 | # This must appear after write_config_header, because otherwise all projects |
| 94 | # using a ndn-cxx release build would be compiled without assertions. |
| 95 | if not conf.options.debug: |
| 96 | conf.define('NDEBUG', 1) |
| 97 | |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 98 | def build(bld): |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 99 | version(bld) |
| 100 | |
| 101 | bld(features="subst", |
| 102 | name='version', |
| 103 | source='src/version.hpp.in', |
| 104 | target='src/version.hpp', |
| 105 | install_path=None, |
| 106 | VERSION_STRING=VERSION_BASE, |
| 107 | VERSION_BUILD=VERSION, |
| 108 | VERSION=int(VERSION_SPLIT[0]) * 1000000 + |
| 109 | int(VERSION_SPLIT[1]) * 1000 + |
| 110 | int(VERSION_SPLIT[2]), |
| 111 | VERSION_MAJOR=VERSION_SPLIT[0], |
| 112 | VERSION_MINOR=VERSION_SPLIT[1], |
| 113 | VERSION_PATCH=VERSION_SPLIT[2], |
| 114 | ) |
| 115 | |
Alexander Afanasyev | 766cea7 | 2014-04-24 19:16:42 -0700 | [diff] [blame] | 116 | libndn_cxx = bld( |
Alexander Afanasyev | 8b1674a | 2014-05-15 00:58:43 -0700 | [diff] [blame] | 117 | features=['pch', 'cxx', 'cxxstlib'], # 'cxxshlib', |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 118 | # vnum=VERSION, |
Alexander Afanasyev | 766cea7 | 2014-04-24 19:16:42 -0700 | [diff] [blame] | 119 | target="ndn-cxx", |
| 120 | name="ndn-cxx", |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 121 | source=bld.path.ant_glob('src/**/*.cpp', |
| 122 | excl=['src/**/*-osx.cpp', 'src/**/*-sqlite3.cpp']), |
Alexander Afanasyev | 8b1674a | 2014-05-15 00:58:43 -0700 | [diff] [blame] | 123 | headers='src/common-pch.hpp', |
Alexander Afanasyev | fc7d33a | 2014-05-12 18:04:51 -0700 | [diff] [blame] | 124 | use='version BOOST OPENSSL CRYPTOPP SQLITE3 RT PIC PTHREAD', |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 125 | includes=". src", |
| 126 | export_includes="src", |
| 127 | install_path='${LIBDIR}', |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 128 | ) |
| 129 | |
Alexander Afanasyev | 59d67a5 | 2014-04-03 16:09:31 -0700 | [diff] [blame] | 130 | if bld.env['HAVE_OSX_SECURITY']: |
Alexander Afanasyev | 766cea7 | 2014-04-24 19:16:42 -0700 | [diff] [blame] | 131 | libndn_cxx.source += bld.path.ant_glob('src/**/*-osx.cpp') |
| 132 | libndn_cxx.mac_app = True |
| 133 | libndn_cxx.use += " OSX_COREFOUNDATION OSX_SECURITY" |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 134 | |
Alexander Afanasyev | 1e0a077 | 2014-01-28 20:07:07 -0800 | [diff] [blame] | 135 | # In case we want to make it optional later |
Alexander Afanasyev | 766cea7 | 2014-04-24 19:16:42 -0700 | [diff] [blame] | 136 | libndn_cxx.source += bld.path.ant_glob('src/**/*-sqlite3.cpp') |
Alexander Afanasyev | d409d59 | 2014-01-28 18:36:38 -0800 | [diff] [blame] | 137 | |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 138 | # Prepare flags that should go to pkgconfig file |
Alexander Afanasyev | 200dd6f | 2014-01-28 19:04:25 -0800 | [diff] [blame] | 139 | pkgconfig_libs = [] |
| 140 | pkgconfig_ldflags = [] |
Alexander Afanasyev | f5df8e6 | 2014-02-16 19:56:21 -0800 | [diff] [blame] | 141 | pkgconfig_linkflags = [] |
Alexander Afanasyev | 200dd6f | 2014-01-28 19:04:25 -0800 | [diff] [blame] | 142 | pkgconfig_includes = [] |
Alexander Afanasyev | f5df8e6 | 2014-02-16 19:56:21 -0800 | [diff] [blame] | 143 | pkgconfig_cxxflags = [] |
Alexander Afanasyev | 766cea7 | 2014-04-24 19:16:42 -0700 | [diff] [blame] | 144 | for lib in Utils.to_list(libndn_cxx.use): |
Alexander Afanasyev | 200dd6f | 2014-01-28 19:04:25 -0800 | [diff] [blame] | 145 | if bld.env['LIB_%s' % lib]: |
| 146 | pkgconfig_libs += Utils.to_list(bld.env['LIB_%s' % lib]) |
| 147 | if bld.env['LIBPATH_%s' % lib]: |
| 148 | pkgconfig_ldflags += Utils.to_list(bld.env['LIBPATH_%s' % lib]) |
| 149 | if bld.env['INCLUDES_%s' % lib]: |
| 150 | pkgconfig_includes += Utils.to_list(bld.env['INCLUDES_%s' % lib]) |
Alexander Afanasyev | f5df8e6 | 2014-02-16 19:56:21 -0800 | [diff] [blame] | 151 | if bld.env['LINKFLAGS_%s' % lib]: |
| 152 | pkgconfig_linkflags += Utils.to_list(bld.env['LINKFLAGS_%s' % lib]) |
| 153 | if bld.env['CXXFLAGS_%s' % lib]: |
| 154 | pkgconfig_cxxflags += Utils.to_list(bld.env['CXXFLAGS_%s' % lib]) |
Alexander Afanasyev | 200dd6f | 2014-01-28 19:04:25 -0800 | [diff] [blame] | 155 | |
Alexander Afanasyev | 84cf429 | 2014-01-29 22:16:27 -0800 | [diff] [blame] | 156 | EXTRA_FRAMEWORKS = ""; |
Alexander Afanasyev | 59d67a5 | 2014-04-03 16:09:31 -0700 | [diff] [blame] | 157 | if bld.env['HAVE_OSX_SECURITY']: |
Alexander Afanasyev | 84cf429 | 2014-01-29 22:16:27 -0800 | [diff] [blame] | 158 | EXTRA_FRAMEWORKS = "-framework CoreFoundation -framework Security" |
Alexander Afanasyev | f5df8e6 | 2014-02-16 19:56:21 -0800 | [diff] [blame] | 159 | |
Alexander Afanasyev | 200dd6f | 2014-01-28 19:04:25 -0800 | [diff] [blame] | 160 | def uniq(alist): |
| 161 | set = {} |
| 162 | return [set.setdefault(e,e) for e in alist if e not in set] |
Alexander Afanasyev | f5df8e6 | 2014-02-16 19:56:21 -0800 | [diff] [blame] | 163 | |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 164 | pkconfig = bld(features="subst", |
Alexander Afanasyev | 766cea7 | 2014-04-24 19:16:42 -0700 | [diff] [blame] | 165 | source="libndn-cxx.pc.in", |
| 166 | target="libndn-cxx.pc", |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 167 | install_path="${LIBDIR}/pkgconfig", |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 168 | VERSION=VERSION_BASE, |
Alexander Afanasyev | 200dd6f | 2014-01-28 19:04:25 -0800 | [diff] [blame] | 169 | |
| 170 | # This probably not the right thing to do, but to simplify life of apps |
| 171 | # that use the library |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 172 | EXTRA_LIBS=" ".join([('-l%s' % i) for i in uniq(pkgconfig_libs)]), |
| 173 | EXTRA_LDFLAGS=" ".join([('-L%s' % i) for i in uniq(pkgconfig_ldflags)]), |
| 174 | EXTRA_LINKFLAGS=" ".join(uniq(pkgconfig_linkflags)), |
| 175 | EXTRA_INCLUDES=" ".join([('-I%s' % i) for i in uniq(pkgconfig_includes)]), |
| 176 | EXTRA_CXXFLAGS=" ".join(uniq(pkgconfig_cxxflags)), |
| 177 | EXTRA_FRAMEWORKS=EXTRA_FRAMEWORKS, |
Alexander Afanasyev | d409d59 | 2014-01-28 18:36:38 -0800 | [diff] [blame] | 178 | ) |
Alexander Afanasyev | f5df8e6 | 2014-02-16 19:56:21 -0800 | [diff] [blame] | 179 | |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 180 | # Unit tests |
| 181 | if bld.env['WITH_TESTS']: |
Alexander Afanasyev | d409d59 | 2014-01-28 18:36:38 -0800 | [diff] [blame] | 182 | bld.recurse('tests') |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 183 | |
Yingdi Yu | e6bfab2 | 2014-02-06 16:01:19 -0800 | [diff] [blame] | 184 | if bld.env['WITH_TOOLS']: |
Alexander Afanasyev | c8bcd45 | 2014-05-12 17:58:47 -0700 | [diff] [blame] | 185 | bld.recurse("tools") |
| 186 | |
| 187 | if bld.env['WITH_EXAMPLES']: |
Yingdi Yu | e6bfab2 | 2014-02-06 16:01:19 -0800 | [diff] [blame] | 188 | bld.recurse("examples") |
Alexander Afanasyev | f5df8e6 | 2014-02-16 19:56:21 -0800 | [diff] [blame] | 189 | |
Alexander Afanasyev | 1950885 | 2014-01-29 01:01:51 -0800 | [diff] [blame] | 190 | headers = bld.path.ant_glob(['src/**/*.hpp']) |
Alexander Afanasyev | 766cea7 | 2014-04-24 19:16:42 -0700 | [diff] [blame] | 191 | bld.install_files("%s/ndn-cxx" % bld.env['INCLUDEDIR'], headers, |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 192 | relative_trick=True, cwd=bld.path.find_node('src')) |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 193 | |
Alexander Afanasyev | 766cea7 | 2014-04-24 19:16:42 -0700 | [diff] [blame] | 194 | bld.install_files("%s/ndn-cxx" % bld.env['INCLUDEDIR'], |
| 195 | bld.path.find_resource('src/ndn-cxx-config.hpp')) |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 196 | |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 197 | bld.install_files("%s/ndn-cxx" % bld.env['INCLUDEDIR'], |
| 198 | bld.path.find_resource('src/version.hpp')) |
| 199 | |
Steve DiBenedetto | c07b3a2 | 2014-03-19 12:32:52 -0600 | [diff] [blame] | 200 | bld.install_files("${SYSCONFDIR}/ndn", "client.conf.sample") |
| 201 | |
Alexander Afanasyev | 7c6aeb0 | 2014-04-10 19:59:19 -0700 | [diff] [blame] | 202 | if bld.env['SPHINX_BUILD']: |
| 203 | bld(features="sphinx", |
| 204 | builder="man", |
| 205 | outdir="docs/manpages", |
| 206 | config="docs/conf.py", |
| 207 | source=bld.path.ant_glob('docs/manpages/**/*.rst'), |
Alexander Afanasyev | a06fdda | 2014-04-29 19:15:00 -0700 | [diff] [blame] | 208 | install_path="${MANDIR}/", |
| 209 | VERSION=VERSION) |
Alexander Afanasyev | 7c6aeb0 | 2014-04-10 19:59:19 -0700 | [diff] [blame] | 210 | |
| 211 | def docs(bld): |
| 212 | from waflib import Options |
| 213 | Options.commands = ['doxygen', 'sphinx'] + Options.commands |
| 214 | |
Alexander Afanasyev | 401a236 | 2014-03-02 00:03:11 +0000 | [diff] [blame] | 215 | def doxygen(bld): |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 216 | version(bld) |
| 217 | |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 218 | if not bld.env.DOXYGEN: |
Alexander Afanasyev | 7c6aeb0 | 2014-04-10 19:59:19 -0700 | [diff] [blame] | 219 | Logs.error("ERROR: cannot build documentation (`doxygen' is not found in $PATH)") |
| 220 | else: |
Alexander Afanasyev | a06fdda | 2014-04-29 19:15:00 -0700 | [diff] [blame] | 221 | bld(features="subst", |
| 222 | name="doxygen-conf", |
Alexander Afanasyev | 9b0e114 | 2014-05-08 00:17:34 -0700 | [diff] [blame] | 223 | source=["docs/doxygen.conf.in", |
| 224 | "docs/named_data_theme/named_data_footer-with-analytics.html.in"], |
| 225 | target=["docs/doxygen.conf", |
| 226 | "docs/named_data_theme/named_data_footer-with-analytics.html"], |
Alexander Afanasyev | a06fdda | 2014-04-29 19:15:00 -0700 | [diff] [blame] | 227 | VERSION=VERSION, |
Alexander Afanasyev | 9b0e114 | 2014-05-08 00:17:34 -0700 | [diff] [blame] | 228 | HTML_FOOTER="../build/docs/named_data_theme/named_data_footer-with-analytics.html" \ |
| 229 | if os.getenv('GOOGLE_ANALYTICS', None) \ |
| 230 | else "../docs/named_data_theme/named_data_footer.html", |
| 231 | GOOGLE_ANALYTICS=os.getenv('GOOGLE_ANALYTICS', ""), |
Alexander Afanasyev | a06fdda | 2014-04-29 19:15:00 -0700 | [diff] [blame] | 232 | ) |
| 233 | |
Alexander Afanasyev | 7c6aeb0 | 2014-04-10 19:59:19 -0700 | [diff] [blame] | 234 | bld(features="doxygen", |
Alexander Afanasyev | a06fdda | 2014-04-29 19:15:00 -0700 | [diff] [blame] | 235 | doxyfile='docs/doxygen.conf', |
| 236 | use="doxygen-conf") |
Alexander Afanasyev | a1ae0a1 | 2014-01-28 15:21:02 -0800 | [diff] [blame] | 237 | |
Alexander Afanasyev | 5e1288e | 2014-03-28 11:11:48 -0700 | [diff] [blame] | 238 | def sphinx(bld): |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 239 | version(bld) |
| 240 | |
Alexander Afanasyev | 1160baa | 2014-04-10 18:50:29 -0700 | [diff] [blame] | 241 | if not bld.env.SPHINX_BUILD: |
| 242 | bld.fatal("ERROR: cannot build documentation (`sphinx-build' is not found in $PATH)") |
Alexander Afanasyev | 7c6aeb0 | 2014-04-10 19:59:19 -0700 | [diff] [blame] | 243 | else: |
| 244 | bld(features="sphinx", |
| 245 | outdir="docs", |
| 246 | source=bld.path.ant_glob("docs/**/*.rst"), |
Alexander Afanasyev | a06fdda | 2014-04-29 19:15:00 -0700 | [diff] [blame] | 247 | config="docs/conf.py", |
| 248 | VERSION=VERSION) |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 249 | |
| 250 | |
| 251 | def version(ctx): |
| 252 | if getattr(Context.g_module, 'VERSION_BASE', None): |
| 253 | return |
| 254 | |
| 255 | Context.g_module.VERSION_BASE = Context.g_module.VERSION |
| 256 | Context.g_module.VERSION_SPLIT = [v for v in VERSION_BASE.split('.')] |
| 257 | |
Alexander Afanasyev | 6c63230 | 2014-10-31 12:34:11 -0700 | [diff] [blame] | 258 | didGetVersion = False |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 259 | try: |
Alexander Afanasyev | 6c63230 | 2014-10-31 12:34:11 -0700 | [diff] [blame] | 260 | cmd = ['git', 'describe', '--always', '--match', '%s*' % GIT_TAG_PREFIX] |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 261 | p = Utils.subprocess.Popen(cmd, stdout=Utils.subprocess.PIPE, |
| 262 | stderr=None, stdin=None) |
Alexander Afanasyev | 6c63230 | 2014-10-31 12:34:11 -0700 | [diff] [blame] | 263 | out = str(p.communicate()[0].strip()) |
| 264 | didGetVersion = (p.returncode == 0 and out != "") |
| 265 | if didGetVersion: |
| 266 | if out.startswith(GIT_TAG_PREFIX): |
| 267 | Context.g_module.VERSION = out[len(GIT_TAG_PREFIX):] |
| 268 | else: |
| 269 | Context.g_module.VERSION = "%s-commit-%s" % (Context.g_module.VERSION_BASE, out) |
| 270 | except OSError: |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 271 | pass |
| 272 | |
Alexander Afanasyev | 6c63230 | 2014-10-31 12:34:11 -0700 | [diff] [blame] | 273 | versionFile = ctx.path.find_node('VERSION') |
| 274 | |
| 275 | if not didGetVersion and versionFile is not None: |
| 276 | try: |
| 277 | Context.g_module.VERSION = versionFile.read() |
| 278 | return |
| 279 | except (OSError, IOError): |
| 280 | pass |
| 281 | |
| 282 | # version was obtained from git, update VERSION file if necessary |
| 283 | if versionFile is not None: |
| 284 | try: |
| 285 | version = versionFile.read() |
| 286 | if version == Context.g_module.VERSION: |
| 287 | return # no need to update |
| 288 | except (OSError, IOError): |
| 289 | Logs.warn("VERSION file exists, but not readable") |
| 290 | else: |
| 291 | versionFile = ctx.path.make_node('VERSION') |
| 292 | |
| 293 | if versionFile is None: |
| 294 | return |
| 295 | |
| 296 | try: |
| 297 | versionFile.write(Context.g_module.VERSION) |
| 298 | except (OSError, IOError): |
| 299 | Logs.warn("VERSION file is not writeable") |
| 300 | |
Alexander Afanasyev | cfe0b06 | 2014-05-08 18:26:50 -0700 | [diff] [blame] | 301 | def dist(ctx): |
| 302 | version(ctx) |
| 303 | |
| 304 | def distcheck(ctx): |
| 305 | version(ctx) |