Guido van Rossum | 3155923 | 1995-02-05 16:59:27 +0000 | [diff] [blame] | 1 | """Tools for use in AppleEvent clients and servers. |
| 2 | |
| 3 | pack(x) converts a Python object to an AEDesc object |
| 4 | unpack(desc) does the reverse |
| 5 | |
| 6 | packevent(event, parameters, attributes) sets params and attrs in an AEAppleEvent record |
| 7 | unpackevent(event) returns the parameters and attributes from an AEAppleEvent record |
| 8 | |
| 9 | Plus... Lots of classes and routines that help representing AE objects, |
| 10 | ranges, conditionals, logicals, etc., so you can write, e.g.: |
| 11 | |
| 12 | x = Character(1, Document("foobar")) |
| 13 | |
| 14 | and pack(x) will create an AE object reference equivalent to AppleScript's |
| 15 | |
| 16 | character 1 of document "foobar" |
| 17 | |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 18 | Some of the stuff that appears to be exported from this module comes from other |
| 19 | files: the pack stuff from aepack, the objects from aetypes. |
| 20 | |
Guido van Rossum | 3155923 | 1995-02-05 16:59:27 +0000 | [diff] [blame] | 21 | """ |
| 22 | |
| 23 | |
Guido van Rossum | 3155923 | 1995-02-05 16:59:27 +0000 | [diff] [blame] | 24 | from types import * |
Guido van Rossum | 17448e2 | 1995-01-30 11:53:55 +0000 | [diff] [blame] | 25 | import AE |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 26 | import AppleEvents |
Guido van Rossum | 17448e2 | 1995-01-30 11:53:55 +0000 | [diff] [blame] | 27 | import MacOS |
Jack Jansen | 20989e8 | 1998-01-16 14:40:10 +0000 | [diff] [blame] | 28 | import sys |
Guido van Rossum | 17448e2 | 1995-01-30 11:53:55 +0000 | [diff] [blame] | 29 | |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 30 | from aetypes import * |
| 31 | from aepack import pack, unpack, coerce, AEDescType |
Guido van Rossum | 3155923 | 1995-02-05 16:59:27 +0000 | [diff] [blame] | 32 | |
Jack Jansen | c46f56e | 1996-09-20 15:28:28 +0000 | [diff] [blame] | 33 | Error = 'aetools.Error' |
| 34 | |
Guido van Rossum | 3155923 | 1995-02-05 16:59:27 +0000 | [diff] [blame] | 35 | # Special code to unpack an AppleEvent (which is *not* a disguised record!) |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 36 | # Note by Jack: No??!? If I read the docs correctly it *is*.... |
Guido van Rossum | 3155923 | 1995-02-05 16:59:27 +0000 | [diff] [blame] | 37 | |
Guido van Rossum | 17448e2 | 1995-01-30 11:53:55 +0000 | [diff] [blame] | 38 | aekeywords = [ |
| 39 | 'tran', |
| 40 | 'rtid', |
| 41 | 'evcl', |
| 42 | 'evid', |
| 43 | 'addr', |
| 44 | 'optk', |
| 45 | 'timo', |
| 46 | 'inte', # this attribute is read only - will be set in AESend |
| 47 | 'esrc', # this attribute is read only |
| 48 | 'miss', # this attribute is read only |
| 49 | 'from' # new in 1.0.1 |
| 50 | ] |
| 51 | |
| 52 | def missed(ae): |
| 53 | try: |
| 54 | desc = ae.AEGetAttributeDesc('miss', 'keyw') |
| 55 | except AE.Error, msg: |
| 56 | return None |
| 57 | return desc.data |
| 58 | |
| 59 | def unpackevent(ae): |
| 60 | parameters = {} |
| 61 | while 1: |
| 62 | key = missed(ae) |
| 63 | if not key: break |
| 64 | parameters[key] = unpack(ae.AEGetParamDesc(key, '****')) |
| 65 | attributes = {} |
| 66 | for key in aekeywords: |
| 67 | try: |
| 68 | desc = ae.AEGetAttributeDesc(key, '****') |
| 69 | except (AE.Error, MacOS.Error), msg: |
Jack Jansen | 20989e8 | 1998-01-16 14:40:10 +0000 | [diff] [blame] | 70 | if msg[0] != -1701 and msg[0] != -1704: |
Guido van Rossum | 17448e2 | 1995-01-30 11:53:55 +0000 | [diff] [blame] | 71 | raise sys.exc_type, sys.exc_value |
| 72 | continue |
| 73 | attributes[key] = unpack(desc) |
| 74 | return parameters, attributes |
| 75 | |
| 76 | def packevent(ae, parameters = {}, attributes = {}): |
| 77 | for key, value in parameters.items(): |
| 78 | ae.AEPutParamDesc(key, pack(value)) |
| 79 | for key, value in attributes.items(): |
| 80 | ae.AEPutAttributeDesc(key, pack(value)) |
| 81 | |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 82 | # |
| 83 | # Support routine for automatically generated Suite interfaces |
Jack Jansen | 8426477 | 1995-10-03 14:35:58 +0000 | [diff] [blame] | 84 | # These routines are also useable for the reverse function. |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 85 | # |
| 86 | def keysubst(arguments, keydict): |
| 87 | """Replace long name keys by their 4-char counterparts, and check""" |
| 88 | ok = keydict.values() |
| 89 | for k in arguments.keys(): |
| 90 | if keydict.has_key(k): |
| 91 | v = arguments[k] |
| 92 | del arguments[k] |
| 93 | arguments[keydict[k]] = v |
| 94 | elif k != '----' and k not in ok: |
| 95 | raise TypeError, 'Unknown keyword argument: %s'%k |
| 96 | |
| 97 | def enumsubst(arguments, key, edict): |
| 98 | """Substitute a single enum keyword argument, if it occurs""" |
| 99 | if not arguments.has_key(key): |
| 100 | return |
| 101 | v = arguments[key] |
| 102 | ok = edict.values() |
| 103 | if edict.has_key(v): |
| 104 | arguments[key] = edict[v] |
| 105 | elif not v in ok: |
| 106 | raise TypeError, 'Unknown enumerator: %s'%v |
| 107 | |
| 108 | def decodeerror(arguments): |
| 109 | """Create the 'best' argument for a raise MacOS.Error""" |
| 110 | errn = arguments['errn'] |
Jack Jansen | 756a69f | 1997-08-08 15:00:03 +0000 | [diff] [blame] | 111 | err_a1 = errn |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 112 | if arguments.has_key('errs'): |
Jack Jansen | 756a69f | 1997-08-08 15:00:03 +0000 | [diff] [blame] | 113 | err_a2 = arguments['errs'] |
| 114 | else: |
| 115 | err_a2 = MacOS.GetErrorString(errn) |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 116 | if arguments.has_key('erob'): |
Jack Jansen | 756a69f | 1997-08-08 15:00:03 +0000 | [diff] [blame] | 117 | err_a3 = arguments['erob'] |
| 118 | else: |
| 119 | err_a3 = None |
| 120 | |
| 121 | return (err_a1, err_a2, err_a3) |
Guido van Rossum | 3155923 | 1995-02-05 16:59:27 +0000 | [diff] [blame] | 122 | |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 123 | class TalkTo: |
| 124 | """An AE connection to an application""" |
| 125 | |
Jack Jansen | 20989e8 | 1998-01-16 14:40:10 +0000 | [diff] [blame] | 126 | def __init__(self, signature, start=0, timeout=0): |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 127 | """Create a communication channel with a particular application. |
| 128 | |
| 129 | Addressing the application is done by specifying either a |
| 130 | 4-byte signature, an AEDesc or an object that will __aepack__ |
| 131 | to an AEDesc. |
| 132 | """ |
Jack Jansen | c46f56e | 1996-09-20 15:28:28 +0000 | [diff] [blame] | 133 | self.target_signature = None |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 134 | if type(signature) == AEDescType: |
| 135 | self.target = signature |
| 136 | elif type(signature) == InstanceType and hasattr(signature, '__aepack__'): |
| 137 | self.target = signature.__aepack__() |
Jack Jansen | 7874b5d | 1995-07-29 15:31:10 +0000 | [diff] [blame] | 138 | elif type(signature) == StringType and len(signature) == 4: |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 139 | self.target = AE.AECreateDesc(AppleEvents.typeApplSignature, signature) |
Jack Jansen | c46f56e | 1996-09-20 15:28:28 +0000 | [diff] [blame] | 140 | self.target_signature = signature |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 141 | else: |
| 142 | raise TypeError, "signature should be 4-char string or AEDesc" |
| 143 | self.send_flags = AppleEvents.kAEWaitReply |
| 144 | self.send_priority = AppleEvents.kAENormalPriority |
Jack Jansen | 20989e8 | 1998-01-16 14:40:10 +0000 | [diff] [blame] | 145 | if timeout: |
| 146 | self.send_timeout = timeout |
| 147 | else: |
| 148 | self.send_timeout = AppleEvents.kAEDefaultTimeout |
Jack Jansen | c46f56e | 1996-09-20 15:28:28 +0000 | [diff] [blame] | 149 | if start: |
| 150 | self.start() |
| 151 | |
| 152 | def start(self): |
| 153 | """Start the application, if it is not running yet""" |
Jack Jansen | 20989e8 | 1998-01-16 14:40:10 +0000 | [diff] [blame] | 154 | _launch(self.target_signature) |
Jack Jansen | c46f56e | 1996-09-20 15:28:28 +0000 | [diff] [blame] | 155 | |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 156 | def newevent(self, code, subcode, parameters = {}, attributes = {}): |
| 157 | """Create a complete structure for an apple event""" |
| 158 | |
| 159 | event = AE.AECreateAppleEvent(code, subcode, self.target, |
| 160 | AppleEvents.kAutoGenerateReturnID, AppleEvents.kAnyTransactionID) |
| 161 | packevent(event, parameters, attributes) |
| 162 | return event |
| 163 | |
| 164 | def sendevent(self, event): |
| 165 | """Send a pre-created appleevent, await the reply and unpack it""" |
| 166 | |
| 167 | reply = event.AESend(self.send_flags, self.send_priority, |
| 168 | self.send_timeout) |
| 169 | parameters, attributes = unpackevent(reply) |
| 170 | return reply, parameters, attributes |
| 171 | |
| 172 | def send(self, code, subcode, parameters = {}, attributes = {}): |
| 173 | """Send an appleevent given code/subcode/pars/attrs and unpack the reply""" |
| 174 | return self.sendevent(self.newevent(code, subcode, parameters, attributes)) |
| 175 | |
Jack Jansen | 7e156a7 | 1996-01-29 15:45:09 +0000 | [diff] [blame] | 176 | # |
| 177 | # The following events are somehow "standard" and don't seem to appear in any |
| 178 | # suite... |
| 179 | # |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 180 | def activate(self): |
| 181 | """Send 'activate' command""" |
| 182 | self.send('misc', 'actv') |
Jack Jansen | 7e156a7 | 1996-01-29 15:45:09 +0000 | [diff] [blame] | 183 | |
Jack Jansen | 756a69f | 1997-08-08 15:00:03 +0000 | [diff] [blame] | 184 | def _get(self, _object, as=None, _attributes={}): |
| 185 | """_get: get data from an object |
Jack Jansen | 7e156a7 | 1996-01-29 15:45:09 +0000 | [diff] [blame] | 186 | Required argument: the object |
| 187 | Keyword argument _attributes: AppleEvent attribute dictionary |
| 188 | Returns: the data |
| 189 | """ |
| 190 | _code = 'core' |
| 191 | _subcode = 'getd' |
| 192 | |
| 193 | _arguments = {'----':_object} |
Jack Jansen | 756a69f | 1997-08-08 15:00:03 +0000 | [diff] [blame] | 194 | if as: |
| 195 | _arguments['rtyp'] = mktype(as) |
Jack Jansen | 7e156a7 | 1996-01-29 15:45:09 +0000 | [diff] [blame] | 196 | |
| 197 | _reply, _arguments, _attributes = self.send(_code, _subcode, |
| 198 | _arguments, _attributes) |
| 199 | if _arguments.has_key('errn'): |
Jack Jansen | c46f56e | 1996-09-20 15:28:28 +0000 | [diff] [blame] | 200 | raise Error, decodeerror(_arguments) |
Jack Jansen | 7e156a7 | 1996-01-29 15:45:09 +0000 | [diff] [blame] | 201 | |
| 202 | if _arguments.has_key('----'): |
| 203 | return _arguments['----'] |
Jack Jansen | 20989e8 | 1998-01-16 14:40:10 +0000 | [diff] [blame] | 204 | |
| 205 | # Tiny Finder class, for local use only |
| 206 | |
| 207 | class _miniFinder(TalkTo): |
| 208 | def open(self, _object, _attributes={}, **_arguments): |
| 209 | """open: Open the specified object(s) |
| 210 | Required argument: list of objects to open |
| 211 | Keyword argument _attributes: AppleEvent attribute dictionary |
| 212 | """ |
| 213 | _code = 'aevt' |
| 214 | _subcode = 'odoc' |
| 215 | |
| 216 | if _arguments: raise TypeError, 'No optional args expected' |
| 217 | _arguments['----'] = _object |
| 218 | |
| 219 | |
| 220 | _reply, _arguments, _attributes = self.send(_code, _subcode, |
| 221 | _arguments, _attributes) |
| 222 | if _arguments.has_key('errn'): |
| 223 | raise aetools.Error, aetools.decodeerror(_arguments) |
| 224 | # XXXX Optionally decode result |
| 225 | if _arguments.has_key('----'): |
| 226 | return _arguments['----'] |
| 227 | #pass |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 228 | |
Jack Jansen | 20989e8 | 1998-01-16 14:40:10 +0000 | [diff] [blame] | 229 | _finder = _miniFinder('MACS') |
| 230 | |
| 231 | def _launch(appfile): |
| 232 | """Open a file thru the finder. Specify file by name or fsspec""" |
| 233 | _finder.open(_application_file(('ID ', appfile))) |
| 234 | |
| 235 | |
| 236 | class _application_file(ComponentItem): |
| 237 | """application file - An application's file on disk""" |
| 238 | want = 'appf' |
| 239 | |
| 240 | _application_file._propdict = { |
| 241 | } |
| 242 | _application_file._elemdict = { |
| 243 | } |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 244 | |
Guido van Rossum | 3155923 | 1995-02-05 16:59:27 +0000 | [diff] [blame] | 245 | # Test program |
Jack Jansen | 40775ba | 1995-07-17 11:42:23 +0000 | [diff] [blame] | 246 | # XXXX Should test more, really... |
Guido van Rossum | 3155923 | 1995-02-05 16:59:27 +0000 | [diff] [blame] | 247 | |
Guido van Rossum | 17448e2 | 1995-01-30 11:53:55 +0000 | [diff] [blame] | 248 | def test(): |
Jack Jansen | 20989e8 | 1998-01-16 14:40:10 +0000 | [diff] [blame] | 249 | target = AE.AECreateDesc('sign', 'quil') |
Guido van Rossum | 17448e2 | 1995-01-30 11:53:55 +0000 | [diff] [blame] | 250 | ae = AE.AECreateAppleEvent('aevt', 'oapp', target, -1, 0) |
| 251 | print unpackevent(ae) |
Guido van Rossum | 3155923 | 1995-02-05 16:59:27 +0000 | [diff] [blame] | 252 | raw_input(":") |
| 253 | ae = AE.AECreateAppleEvent('core', 'getd', target, -1, 0) |
| 254 | obj = Character(2, Word(1, Document(1))) |
| 255 | print obj |
| 256 | print repr(obj) |
| 257 | packevent(ae, {'----': obj}) |
| 258 | params, attrs = unpackevent(ae) |
| 259 | print params['----'] |
| 260 | raw_input(":") |
Guido van Rossum | 17448e2 | 1995-01-30 11:53:55 +0000 | [diff] [blame] | 261 | |
| 262 | if __name__ == '__main__': |
| 263 | test() |
Jack Jansen | 20989e8 | 1998-01-16 14:40:10 +0000 | [diff] [blame] | 264 | sys.exit(1) |