1#
2# Helper functions for wxWidgets bakefiles
3#
4#
5
6
7import utils
8
9# We use 'CFG' option in places where bakefile doesn't like it, so we must
10# register a substitution function for it that provides additional knowledge
11# about the option (in this case that it does not contain dir separators and
12# so utils.nativePaths() doesn't have to do anything with it):
13
14try:
15    # this fails in 0.1.4 and 0.1.5 has different subst.callbacks signature:
16    utils.checkBakefileVersion('0.1.5')
17    def __noopSubst(name, func, caller):
18        return '$(%s)' % name
19except AttributeError:
20    def __noopSubst(func, name):
21        return '$(%s)' % name
22utils.addSubstituteCallback('CFG', __noopSubst)
23utils.addSubstituteCallback('LIBDIRNAME', __noopSubst)
24utils.addSubstituteCallback('SETUPHDIR', __noopSubst)
25utils.addSubstituteCallback('OBJS', __noopSubst)
26
27
28def mk_wxid(id):
29    """Creates wxWidgets library identifier from bakefile target ID that
30       follows this convention: DLLs end with 'dll', static libraries
31       end with 'lib'. If withPrefix=1, then _wxid is returned instead
32       of wxid."""
33    if id.endswith('dll') or id.endswith('lib'):
34        wxid = id[:-3]
35    else:
36        wxid = id
37    return wxid
38
39
40# All libs that are part of the main library:
41MAIN_LIBS = ['mono', 'base', 'core', 'adv', 'html', 'xml', 'net', 'webview',
42             'media', 'qa', 'xrc', 'aui', 'ribbon', 'propgrid', 'richtext', 'stc']
43# List of library names/ids for categories with different names:
44LIBS_NOGUI = ['xml', 'net']
45LIBS_GUI   = ['core', 'adv', 'html', 'gl', 'qa', 'xrc', 'media',
46              'aui', 'propgrid', 'richtext', 'stc', 'ribbon', 'webview']
47# Additional libraries that must be linked in:
48EXTRALIBS = {
49    'gl' : '$(EXTRALIBS_OPENGL)',
50    'xml' : '$(EXTRALIBS_XML)',
51    'html' : '$(EXTRALIBS_HTML)',
52    'adv' : '$(PLUGIN_ADV_EXTRALIBS)',
53    'media' : '$(EXTRALIBS_MEDIA)',
54    'webview' : '$(EXTRALIBS_WEBVIEW)',
55}
56
57def mkLibName(wxid):
58    """Returns string that can be used as library name, including name
59       suffixes, prefixes, version tags etc. This must be kept in sync
60       with variables defined in common.bkl!"""
61    if wxid == 'mono':
62        return '$(WXNAMEPREFIXGUI)$(WXNAMESUFFIX)$(WXVERSIONTAG)$(HOST_SUFFIX)'
63    if wxid == 'base':
64        return '$(WXNAMEPREFIX)$(WXNAMESUFFIX)$(WXVERSIONTAG)$(HOST_SUFFIX)'
65    if wxid in LIBS_NOGUI:
66        return '$(WXNAMEPREFIX)$(WXNAMESUFFIX)_%s$(WXVERSIONTAG)$(HOST_SUFFIX)' % wxid
67    return '$(WXNAMEPREFIXGUI)$(WXNAMESUFFIX)_%s$(WXVERSIONTAG)$(HOST_SUFFIX)' % wxid
68
69def mkDllName(wxid):
70    """Returns string that can be used as DLL name, including name
71       suffixes, prefixes, version tags etc. This must be kept in sync
72       with variables defined in common.bkl!"""
73    if wxid == 'mono':
74        return '$(WXDLLNAMEPREFIXGUI)$(WXNAMESUFFIX)$(WXCOMPILER)$(VENDORTAG)$(WXDLLVERSIONTAG)'
75    if wxid == 'base':
76        return '$(WXDLLNAMEPREFIX)$(WXNAMESUFFIX)$(WXCOMPILER)$(VENDORTAG)$(WXDLLVERSIONTAG)'
77    if wxid in LIBS_NOGUI:
78        return '$(WXDLLNAMEPREFIX)$(WXNAMESUFFIX)_%s$(WXCOMPILER)$(VENDORTAG)$(WXDLLVERSIONTAG)' % wxid
79    return '$(WXDLLNAMEPREFIXGUI)$(WXNAMESUFFIX)_%s$(WXCOMPILER)$(VENDORTAG)$(WXDLLVERSIONTAG)' % wxid
80
81
82def libToLink(wxlibname):
83    """Returns string to pass to <sys-lib> when linking against 'wxlibname'.
84       For one of main libraries, libToLink('foo') returns '$(WXLIB_FOO)' which
85       must be defined in common.bkl as either nothing (in monolithic build) or
86       mkLibName('foo') (otherwise).
87       """
88    if wxlibname in MAIN_LIBS:
89        return '$(WXLIB_%s)' % wxlibname.upper()
90    else:
91        return mkLibName(wxlibname)
92
93
94def extraLdflags(wxlibname):
95    if wxlibname in EXTRALIBS:
96        return EXTRALIBS[wxlibname]
97    else:
98        return ''
99
100wxVersion = None
101VERSION_FILE = '../../include/wx/version.h'
102
103def getVersion():
104    """Returns wxWidgets version as a tuple: (major,minor,release)."""
105    global wxVersion
106    if wxVersion == None:
107        f = open(VERSION_FILE, 'rt')
108        lines = f.readlines()
109        f.close()
110        major = minor = release = None
111        for l in lines:
112            if not l.startswith('#define'): continue
113            splitline = l.strip().split()
114            if splitline[0] != '#define': continue
115            if len(splitline) < 3: continue
116            name = splitline[1]
117            value = splitline[2]
118            if value == None: continue
119            if name == 'wxMAJOR_VERSION': major = int(value)
120            if name == 'wxMINOR_VERSION': minor = int(value)
121            if name == 'wxRELEASE_NUMBER': release = int(value)
122            if major != None and minor != None and release != None:
123                break
124        wxVersion = (major, minor, release)
125    return wxVersion
126
127def getVersionMajor():
128    return getVersion()[0]
129def getVersionMinor():
130    return getVersion()[1]
131def getVersionRelease():
132    return getVersion()[2]
133
134
135def headersOnly(files):
136    """Filters 'files' so that only headers are left. Used with
137       <msvc-project-files> to add headers to VC++ projects but not files such
138       as arrimpl.cpp."""
139
140    def callback(cond, sources):
141        prf = suf = ''
142        if sources[0].isspace(): prf=' '
143        if sources[-1].isspace(): suf=' '
144        retval = []
145        for s in sources.split():
146            if s.endswith('.h'):
147                retval.append(s)
148        return '%s%s%s' % (prf, ' '.join(retval), suf)
149    return utils.substitute2(files, callback)
150
151
152def makeDspDependency(lib):
153    """Returns suitable entry for <depends-on-dsp> for main libs."""
154    return '%s:$(nativePaths(WXTOPDIR))build\\msw\\wx_%s.dsp' % (lib,lib)
155