Módulos de las bibliotecas de Macintosh

Anterior: 2.14.1 Objetos AEServer Niv. superior: 2. Módulos MacPython Siguiente: 2.16 aetypes

---

2.15 aepack -- Conversión entre variables de Python y contenedores de datos AppleEvent

Availability: Macintosh.

El módulo aepack define funciones para convertir (empaquetar) variables de Python en descriptores AppleEvent y viceversa. Dentro de Python, el descriptor de AppleEvent se gestiona mediante objetos Python del tipo interno AEDesc, definido en el módulo AE.

El módulo aepack define las siguientes funciones:

pack (x[, forcetype])

Devuelve un objeto AEDesc que contiene una conversión del valor Python x. Si se proporciona forcetype especifica el tipo del descriptor del resultado. En caso contrario, se utiliza la siguiente correspondencia predefinida entre los tipos de Python y tipos de descriptor de AppleEvent:

Tipo de Python	tipo de descriptor
FSSpec	typeFSS
Alias	typeAlias
integer	typeLong (32 bit integer)
float	typeFloat (64 bit floating point)
string	typeText
list	typeAEList
dictionary	typeAERecord
instance	vea más adelante

FSSpec y Alias son tipos de objetos internos definidos en el módulo macfs.

Si x es una instancia de Python esta función intenta llamar al método __aepack__(). Debería devolver un objeto AE.AEDesc.

Si no está definida la conversión x, esta función devuelve la representación textual en Python de un valor (la función repr()) codificada como descriptor de texto.

unpack (x)

x debe ser un objeto de tipo AEDesc. Esta función devuelve una representación como objeto de Python de los datos del descriptor x. Los tipos de datos AppleEvent simples se devuelven según su correspondencia evidente, las listas de eventos se devuelven como listas de Python y se desempaquetan recursivamente los elementos de las listas. Las referencias a objetos (ej. line 3 of document 1) se devuelven como instancias de aetypes.ObjectSpecifier. Los descriptores AppleEvent con un tipo de descriptor typeFSS se devuelven como objetos FSSpec. Los descriptores de registros (records) AppleEvent se devuelven como diccionarios de Python, desempaquetándose recursivamente las claves de tipo ? y los elementos.

---

Módulos de las bibliotecas de Macintosh

Anterior: 2.14.1 Objetos AEServer Niv. superior: 2. Módulos MacPython Siguiente: 2.16 aetypes