1 # functions to support bundled libraries
4 from waflib
import Build
, Options
, Logs
5 from waflib
.Configure
import conf
6 from wafsamba
import samba_utils
8 def PRIVATE_NAME(bld
, name
, private_extension
, private_library
):
9 '''possibly rename a library to include a bundled extension'''
11 if not private_library
:
14 # we now use the same private name for libraries as the public name.
15 # see http://git.samba.org/?p=tridge/junkcode.git;a=tree;f=shlib for a
16 # demonstration that this is the right thing to do
17 # also see http://lists.samba.org/archive/samba-technical/2011-January/075816.html
21 extension
= bld
.env
.PRIVATE_EXTENSION
23 if extension
and name
.startswith('%s' % extension
):
26 if extension
and name
.endswith('%s' % extension
):
29 return "%s-%s" % (name
, extension
)
32 def target_in_list(target
, lst
, default
):
45 def BUILTIN_LIBRARY(bld
, name
):
46 '''return True if a library should be builtin
47 instead of being built as a shared lib'''
48 return target_in_list(name
, bld
.env
.BUILTIN_LIBRARIES
, False)
49 Build
.BuildContext
.BUILTIN_LIBRARY
= BUILTIN_LIBRARY
52 def BUILTIN_DEFAULT(opt
, builtins
):
53 '''set a comma separated default list of builtin libraries for this package'''
54 if 'BUILTIN_LIBRARIES_DEFAULT' in Options
.options
.__dict
__:
56 Options
.options
.__dict
__['BUILTIN_LIBRARIES_DEFAULT'] = builtins
57 Options
.OptionsContext
.BUILTIN_DEFAULT
= BUILTIN_DEFAULT
60 def PRIVATE_EXTENSION_DEFAULT(opt
, extension
, noextension
=''):
61 '''set a default private library extension'''
62 if 'PRIVATE_EXTENSION_DEFAULT' in Options
.options
.__dict
__:
64 Options
.options
.__dict
__['PRIVATE_EXTENSION_DEFAULT'] = extension
65 Options
.options
.__dict
__['PRIVATE_EXTENSION_EXCEPTION'] = noextension
66 Options
.OptionsContext
.PRIVATE_EXTENSION_DEFAULT
= PRIVATE_EXTENSION_DEFAULT
69 def minimum_library_version(conf
, libname
, default
):
70 '''allow override of mininum system library version'''
72 minlist
= Options
.options
.MINIMUM_LIBRARY_VERSION
76 for m
in minlist
.split(','):
79 Logs
.error("Bad syntax for --minimum-library-version of %s" % m
)
87 def LIB_MAY_BE_BUNDLED(conf
, libname
):
88 if libname
in conf
.env
.SYSTEM_LIBS
:
90 if libname
in conf
.env
.BUNDLED_LIBS
:
92 if '!%s' % libname
in conf
.env
.BUNDLED_LIBS
:
94 if 'NONE' in conf
.env
.BUNDLED_LIBS
:
99 def LIB_MUST_BE_BUNDLED(conf
, libname
):
100 if libname
in conf
.env
.BUNDLED_LIBS
:
102 if '!%s' % libname
in conf
.env
.BUNDLED_LIBS
:
104 if 'ALL' in conf
.env
.BUNDLED_LIBS
:
109 def LIB_MUST_BE_PRIVATE(conf
, libname
):
110 return ('ALL' in conf
.env
.PRIVATE_LIBS
or
111 libname
in conf
.env
.PRIVATE_LIBS
)
114 def CHECK_BUNDLED_SYSTEM_PKG(conf
, libname
, minversion
='0.0.0',
115 maxversion
=None, version_blacklist
=[],
116 onlyif
=None, implied_deps
=None, pkg
=None):
117 '''check if a library is available as a system library.
119 This only tries using pkg-config
121 return conf
.CHECK_BUNDLED_SYSTEM(libname
,
122 minversion
=minversion
,
123 maxversion
=maxversion
,
124 version_blacklist
=version_blacklist
,
126 implied_deps
=implied_deps
,
130 def CHECK_BUNDLED_SYSTEM(conf
, libname
, minversion
='0.0.0',
131 maxversion
=None, version_blacklist
=[],
132 checkfunctions
=None, headers
=None, checkcode
=None,
133 onlyif
=None, implied_deps
=None,
134 require_headers
=True, pkg
=None, set_target
=True):
135 '''check if a library is available as a system library.
136 this first tries via pkg-config, then if that fails
137 tries by testing for a specified function in the specified lib
139 # We always do a logic validation of 'onlyif' first
142 for l
in samba_utils
.TO_LIST(onlyif
):
143 f
= 'FOUND_SYSTEMLIB_%s' % l
144 if not f
in conf
.env
:
145 Logs
.error('ERROR: CHECK_BUNDLED_SYSTEM(%s) - ' % (libname
) +
146 'missing prerequisite check for ' +
147 'system library %s, onlyif=%r' % (l
, onlyif
))
151 found
= 'FOUND_SYSTEMLIB_%s' % libname
152 if found
in conf
.env
:
153 return conf
.env
[found
]
154 if conf
.LIB_MUST_BE_BUNDLED(libname
):
155 conf
.env
[found
] = False
158 # see if the library should only use a system version if another dependent
159 # system version is found. That prevents possible use of mixed library
162 if not conf
.LIB_MAY_BE_BUNDLED(libname
):
163 Logs
.error('ERROR: Use of system library %s depends on missing system library/libraries %r' % (libname
, missing
))
165 conf
.env
[found
] = False
168 def check_functions_headers_code():
169 '''helper function for CHECK_BUNDLED_SYSTEM'''
170 if require_headers
and headers
and not conf
.CHECK_HEADERS(headers
, lib
=libname
):
172 if checkfunctions
is not None:
173 ok
= conf
.CHECK_FUNCS_IN(checkfunctions
, libname
, headers
=headers
,
174 empty_decl
=False, set_target
=False)
177 if checkcode
is not None:
178 define
='CHECK_BUNDLED_SYSTEM_%s' % libname
.upper()
179 ok
= conf
.CHECK_CODE(checkcode
, lib
=libname
,
180 headers
=headers
, local_include
=False,
181 msg
=msg
, define
=define
)
182 conf
.CONFIG_RESET(define
)
187 minversion
= minimum_library_version(conf
, libname
, minversion
)
189 msg
= 'Checking for system %s' % libname
191 if minversion
!= '0.0.0':
192 msg_ver
.append('>=%s' % minversion
)
193 if maxversion
is not None:
194 msg_ver
.append('<=%s' % maxversion
)
195 for v
in version_blacklist
:
196 msg_ver
.append('!=%s' % v
)
198 msg
+= " (%s)" % (" ".join(msg_ver
))
200 uselib_store
=libname
.upper()
204 version_checks
= '%s >= %s' % (pkg
, minversion
)
205 if maxversion
is not None:
206 version_checks
+= ' %s <= %s' % (pkg
, maxversion
)
208 version_checks
+= "".join(' %s != %s' % (pkg
, v
) for v
in version_blacklist
)
210 # try pkgconfig first
211 if (conf
.CHECK_CFG(package
=pkg
,
212 args
='"%s" --cflags --libs' % (version_checks
),
213 msg
=msg
, uselib_store
=uselib_store
) and
214 check_functions_headers_code()):
216 conf
.SET_TARGET_TYPE(libname
, 'SYSLIB')
217 conf
.env
[found
] = True
219 conf
.SET_SYSLIB_DEPS(libname
, implied_deps
)
221 if checkfunctions
is not None:
222 if check_functions_headers_code():
223 conf
.env
[found
] = True
225 conf
.SET_SYSLIB_DEPS(libname
, implied_deps
)
227 conf
.SET_TARGET_TYPE(libname
, 'SYSLIB')
229 conf
.env
[found
] = False
230 if not conf
.LIB_MAY_BE_BUNDLED(libname
):
231 Logs
.error('ERROR: System library %s of version %s not found, and bundling disabled' % (libname
, minversion
))
236 def tuplize_version(version
):
237 return tuple([int(x
) for x
in version
.split(".")])
240 def CHECK_BUNDLED_SYSTEM_PYTHON(conf
, libname
, modulename
, minversion
='0.0.0'):
241 '''check if a python module is available on the system and
242 has the specified minimum version.
244 if conf
.LIB_MUST_BE_BUNDLED(libname
):
247 # see if the library should only use a system version if another dependent
248 # system version is found. That prevents possible use of mixed library
250 minversion
= minimum_library_version(conf
, libname
, minversion
)
253 m
= __import__(modulename
)
258 version
= m
.__version
__
259 except AttributeError:
262 found
= tuplize_version(version
) >= tuplize_version(minversion
)
263 if not found
and not conf
.LIB_MAY_BE_BUNDLED(libname
):
264 Logs
.error('ERROR: Python module %s of version %s not found, and bundling disabled' % (libname
, minversion
))
269 def NONSHARED_BINARY(bld
, name
):
270 '''return True if a binary should be built without non-system shared libs'''
271 return target_in_list(name
, bld
.env
.NONSHARED_BINARIES
, False)
272 Build
.BuildContext
.NONSHARED_BINARY
= NONSHARED_BINARY