summaryrefslogtreecommitdiffstats
path: root/Mac/Modules/cf/cfscan.py
blob: b8ccb316c75675c1362604692349ee581e892dd6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
# Scan an Apple header file, generating a Python file of generator calls.

import sys
import os
BGENDIR=os.path.join(sys.prefix, ':Tools:bgen:bgen')
sys.path.append(BGENDIR)
from scantools import Scanner_OSX
from bgenlocations import TOOLBOXDIR

LONG = "CoreFoundation"
SHORT = "cf"
OBJECTS = ("CFTypeRef", 
		"CFArrayRef", "CFMutableArrayRef",
		"CFDataRef", "CFMutableDataRef",
		"CFDictionaryRef", "CFMutableDictionaryRef",
		"CFStringRef", "CFMutableStringRef",
		"CFURLRef",
		)
# ADD object typenames here

def main():
	input = [
		"CFBase.h",
		"CFArray.h",
##		"CFBag.h",
##		"CFBundle.h",
##		"CFCharacterSet.h",
		"CFData.h",
##		"CFDate.h",
		"CFDictionary.h",
##		"CFNumber.h",
##		"CFPlugIn.h",
##		"CFPreferences.h",
##		"CFPropertyList.h",
##		"CFSet.h",
		"CFString.h",
##		"CFStringEncodingExt.h",
##		"CFTimeZone.h",
		"CFURL.h",
		]
	output = SHORT + "gen.py"
	defsoutput = TOOLBOXDIR + LONG + ".py"
	scanner = MyScanner(input, output, defsoutput)
	scanner.scan()
	scanner.gentypetest(SHORT+"typetest.py")
	scanner.close()
	print "=== Done scanning and generating, now importing the generated code... ==="
	exec "import " + SHORT + "support"
	print "=== Done.  It's up to you to compile it now! ==="

class MyScanner(Scanner_OSX):

	def destination(self, type, name, arglist):
		classname = "Function"
		listname = "functions"
		if arglist:
			t, n, m = arglist[0]
			if t in OBJECTS and m == "InMode":
				classname = "Method"
				listname = t + "_methods"
			# Special case for the silly first AllocatorRef argument
			if t == 'CFAllocatorRef' and m == 'InMode' and len(arglist) > 1:
				t, n, m = arglist[1]
				if t in OBJECTS and m == "InMode":
					classname = "MethodSkipArg1"
					listname = t + "_methods"
		return classname, listname

	def writeinitialdefs(self):
		self.defsfile.write("def FOUR_CHAR_CODE(x): return x\n")

	def makeblacklistnames(self):
		return [
			# Memory allocator functions
			"CFAllocatorGetDefault",
			"CFAllocatorSetDefault",
			"CFAllocatorAllocate",
			"CFAllocatorReallocate",
			"CFAllocatorDeallocate",
			"CFGetAllocator",
			# Array functions we skip for now.
			"CFArrayGetValueAtIndex",
			# Data pointer functions. Skip for now.
			"CFDataGetBytePtr",
			"CFDataGetMutableBytePtr",
			"CFDataGetBytes",   # XXXX Should support this one
			# String functions
			"CFStringGetPascalString", # Use the C-string methods.
			"CFStringGetPascalStringPtr", # TBD automatically
			"CFStringGetCStringPtr", 
			"CFStringGetCharactersPtr",
			"CFStringGetCString", 
			"CFStringGetCharacters",
			"CFURLCreateStringWithFileSystemPath", # Gone in later releases
			]

	def makegreylist(self):
		return []

	def makeblacklisttypes(self):
		return [
			"CFComparatorFunction", # Callback function pointer
			"CFAllocatorContext", # Not interested in providing our own allocator
			"void_ptr_ptr",  # Tricky. This is the initializer for arrays...
			"void_ptr", # Ditto for various array lookup methods
			"CFArrayApplierFunction", # Callback function pointer
			"CFDictionaryApplierFunction", # Callback function pointer
			"UniChar_ptr", # XXXX To be done
			"const_UniChar_ptr", # XXXX To be done
			"UniChar", # XXXX To be done
			"va_list", # For printf-to-a-cfstring. Use Python.
			"const_CFStringEncoding_ptr", # To be done, I guess
			]

	def makerepairinstructions(self):
		return [
			# Buffers in CF seem to be passed as UInt8 * normally.
			([("UInt8_ptr", "*", "InMode"), ("CFIndex", "*", "InMode")],
			 [("UcharInBuffer", "*", "*")]),
			 
			# Some functions return a const char *. Don't worry, we won't modify it.
			([("const_char_ptr", "*", "ReturnMode")],
			 [("return_stringptr", "*", "*")]),
			 
			# base URLs are optional (pass None for NULL)
			([("CFURLRef", "baseURL", "InMode")],
			 [("OptionalCFURLRef", "*", "*")]),
			 
			]
			
if __name__ == "__main__":
	main()