1 # functions to support bundled libraries
4 import Build
, Options
, Logs
5 from Configure
import conf
6 from samba_utils
import TO_LIST
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
:
56 Options
.options
['BUILTIN_LIBRARIES_DEFAULT'] = builtins
57 Options
.Handler
.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
:
64 Options
.options
['PRIVATE_EXTENSION_DEFAULT'] = extension
65 Options
.options
['PRIVATE_EXTENSION_EXCEPTION'] = noextension
66 Options
.Handler
.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
.BUNDLED_LIBS
:
90 if '!%s' % libname
in conf
.env
.BUNDLED_LIBS
:
92 if 'NONE' in conf
.env
.BUNDLED_LIBS
:
97 def LIB_MUST_BE_BUNDLED(conf
, libname
):
98 if libname
in conf
.env
.BUNDLED_LIBS
:
100 if '!%s' % libname
in conf
.env
.BUNDLED_LIBS
:
102 if 'ALL' in conf
.env
.BUNDLED_LIBS
:
107 def LIB_MUST_BE_PRIVATE(conf
, libname
):
108 return ('ALL' in conf
.env
.PRIVATE_LIBS
or
109 libname
in conf
.env
.PRIVATE_LIBS
)
112 def CHECK_BUNDLED_SYSTEM_PKG(conf
, libname
, minversion
='0.0.0',
113 onlyif
=None, implied_deps
=None, pkg
=None):
114 '''check if a library is available as a system library.
116 This only tries using pkg-config
118 return conf
.CHECK_BUNDLED_SYSTEM(libname
,
119 minversion
=minversion
,
121 implied_deps
=implied_deps
,
125 def CHECK_BUNDLED_SYSTEM(conf
, libname
, minversion
='0.0.0',
126 checkfunctions
=None, headers
=None, checkcode
=None,
127 onlyif
=None, implied_deps
=None,
128 require_headers
=True, pkg
=None, set_target
=True):
129 '''check if a library is available as a system library.
130 this first tries via pkg-config, then if that fails
131 tries by testing for a specified function in the specified lib
133 # We always do a logic validation of 'onlyif' first
136 for l
in TO_LIST(onlyif
):
137 f
= 'FOUND_SYSTEMLIB_%s' % l
138 if not f
in conf
.env
:
139 Logs
.error('ERROR: CHECK_BUNDLED_SYSTEM(%s) - ' % (libname
) +
140 'missing prerequisite check for ' +
141 'system library %s, onlyif=%r' % (l
, onlyif
))
145 found
= 'FOUND_SYSTEMLIB_%s' % libname
146 if found
in conf
.env
:
147 return conf
.env
[found
]
148 if conf
.LIB_MUST_BE_BUNDLED(libname
):
149 conf
.env
[found
] = False
152 # see if the library should only use a system version if another dependent
153 # system version is found. That prevents possible use of mixed library
156 if not conf
.LIB_MAY_BE_BUNDLED(libname
):
157 Logs
.error('ERROR: Use of system library %s depends on missing system library/libraries %r' % (libname
, missing
))
159 conf
.env
[found
] = False
162 def check_functions_headers_code():
163 '''helper function for CHECK_BUNDLED_SYSTEM'''
164 if require_headers
and headers
and not conf
.CHECK_HEADERS(headers
, lib
=libname
):
166 if checkfunctions
is not None:
167 ok
= conf
.CHECK_FUNCS_IN(checkfunctions
, libname
, headers
=headers
,
168 empty_decl
=False, set_target
=False)
171 if checkcode
is not None:
172 define
='CHECK_BUNDLED_SYSTEM_%s' % libname
.upper()
173 ok
= conf
.CHECK_CODE(checkcode
, lib
=libname
,
174 headers
=headers
, local_include
=False,
175 msg
=msg
, define
=define
)
176 conf
.CONFIG_RESET(define
)
181 minversion
= minimum_library_version(conf
, libname
, minversion
)
183 msg
= 'Checking for system %s' % libname
184 if minversion
!= '0.0.0':
185 msg
+= ' >= %s' % minversion
187 uselib_store
=libname
.upper()
191 # try pkgconfig first
192 if (conf
.CHECK_CFG(package
=pkg
,
193 args
='"%s >= %s" --cflags --libs' % (pkg
, minversion
),
194 msg
=msg
, uselib_store
=uselib_store
) and
195 check_functions_headers_code()):
197 conf
.SET_TARGET_TYPE(libname
, 'SYSLIB')
198 conf
.env
[found
] = True
200 conf
.SET_SYSLIB_DEPS(libname
, implied_deps
)
202 if checkfunctions
is not None:
203 if check_functions_headers_code():
204 conf
.env
[found
] = True
206 conf
.SET_SYSLIB_DEPS(libname
, implied_deps
)
208 conf
.SET_TARGET_TYPE(libname
, 'SYSLIB')
210 conf
.env
[found
] = False
211 if not conf
.LIB_MAY_BE_BUNDLED(libname
):
212 Logs
.error('ERROR: System library %s of version %s not found, and bundling disabled' % (libname
, minversion
))
217 def tuplize_version(version
):
218 return tuple([int(x
) for x
in version
.split(".")])
221 def CHECK_BUNDLED_SYSTEM_PYTHON(conf
, libname
, modulename
, minversion
='0.0.0'):
222 '''check if a python module is available on the system and
223 has the specified minimum version.
225 if conf
.LIB_MUST_BE_BUNDLED(libname
):
228 # see if the library should only use a system version if another dependent
229 # system version is found. That prevents possible use of mixed library
231 minversion
= minimum_library_version(conf
, libname
, minversion
)
234 m
= __import__(modulename
)
239 version
= m
.__version
__
240 except AttributeError:
243 found
= tuplize_version(version
) >= tuplize_version(minversion
)
244 if not found
and not conf
.LIB_MAY_BE_BUNDLED(libname
):
245 Logs
.error('ERROR: Python module %s of version %s not found, and bundling disabled' % (libname
, minversion
))
250 def NONSHARED_BINARY(bld
, name
):
251 '''return True if a binary should be built without non-system shared libs'''
252 return target_in_list(name
, bld
.env
.NONSHARED_BINARIES
, False)
253 Build
.BuildContext
.NONSHARED_BINARY
= NONSHARED_BINARY