Python Bindings for the SAF-AIS APIs 5.18.2011

Python Bindings for the SAF-AIS APIs Currie Reid Linux Product Division Wind River

Outline of Presentation• Requirements• What is Python?• Mapping Python to Requirements• Demo setup• How Python bindings are implemented• Demonstration• Future Works

Requirements• Enable testing in all phases of the software lifecycle.• Simplify development across different architectures.• Simplify presentation to developers and engineers.• Quickly create tools that make it easy to investigate and monitor the system.• Make it easy to create and modify prototypes.

What is Python?• General purpose, high-level, interpreted language.• Design philosophy emphasizes code readability.• Large, comprehensive standard library.• Supports object-oriented, imperative, and (lesser degree) functional programming paradigms.• Dynamic type system, automatic memory management.• Free, open-source, many 3rd party packages.

Enable testing in all phases of softwarelifecycle• Test coverage more complete if easy to write tests; test-driven development encouraged!• Tests are portable across architectures.• Built-in modules for testing include unittest and doctest.• Modules available for unit testing, mock testing, fuzz testing, web testing, gui testing, etc.• i.e.: nose, py.test, zope.testing.

Simplify development across differentarchitectures• Python scripts are portable across different architectures.• Edit-compile-run cycle is greatly reduced.• Python code can be edited on the target system if required.• Huge collection of native and 3rd-party bindings available to aid/speed development.

Simplify presentation to developers andengineers• Python syntax reads like pseudo-code.• Most Python programs much smaller than lower- level implementations.• Easier to examine the problem domain when you abstract-away programming details and challenges associated with the machine.

Make it easy to create and modifyprototypes• Components and applications can be rapidly prototyped in Python.• Designs can then be hardened in another implementation language.• Ideal glue language.• Working code can be developed much faster than lower-level languages.

What Will be Demonstrated• Unit tests written for every interface except SMF.• AMF demo component written in Python.• Admin-commands written in Python.• Server implemented in Python: receives NTF notifications, queries IMM and updates web- client.• Alarms resulting from admin-commands.• Logging from AMF demo component.

Explanation of Demonstration System• Virtual appliance; 2 system controllers• OpenSAF framework• Amf_demo: saAmf, saLog• Immwebsocket: saImmOm, saNtf• Immwebclient: HTML5 websockets, CSS, Javascript, JSON

Ctypes module: Wrap Libraries in Python• Advanced FFI (Foreign Function Interface) for Python 2.3 and higher.• Included in Python 2.5.• Call functions from DLLs (shared libraries).• Create, access and manipulate simple and complicated C data types in Python.• Enables C callbacks to be implemented in Python.

Python Implementation• Conversion of SAF types to ctypes• Definition of Const• Definition of Enumeration• Definition of Structs• Definition of Unions• Dynamic Loading of Libraries and CDLL• Definition of Functions• Definition of callbacks and CFUNCTYPE

Conversion of SAF types to ctypesSaInt8T = c_charSaInt16T = c_shortSaInt32T = c_intSaInt64T = c_longlongSaUint8T = c_ubyteSaUint16T = c_ushortSaUint32T = c_uintSaUint64T = c_ulonglong...myuint = SaUint64T(12)

Definition of ConstsaAis = Const()saAis.SA_TIME_END = 0x7FFFFFFFFFFFFFFFsaAis.SA_TIME_BEGIN = 0x0saAis.SA_TIME_UNKNOWN = 0x8000000000000000time_start = saAis.SA_TIME_BEGINsaAis.SA_TIME_BEGIN = 5 #ERROR: EXCEPTION

Definition of EnumerationSaDispatchFlagsT = SaEnumTeSaDispatchFlagsT = Enumeration(( (SA_DISPATCH_ONE, 1), (SA_DISPATCH_ALL, 2), (SA_DISPATCH_BLOCKING, 3),))flag = eSaDispatchFlagsT.SA_DISPATCH_ALLflag_str = eSaDispatchFlagsT.whatis(flag)

Definition of Structsclass SaNameT(Structure): _fields_ = [(length, SaUint16T), (value,(SaInt8T*saAis.SA_MAX_NAME_LENGTH))] def __init__(self, name=): super(SaNameT, self).__init__(len(name), name)dn = SaNameT(‘safApp=OpenSAF’)

Definition of Unionsclass SaLimitValueT(Union): _fields_ = [(int64Value, SaInt64T), (uint64Value, SaUint64T), (timeValue, SaTimeT), (floatValue, SaFloatT), (doubleValue, SaDoubleT)]un = SaLimitValueT()un.timeValue = 5000000000

Dynamic Loading of Libraries and CDLLamfdll = CDLL(libSaAmf.so.0)amfHandle = SaAmfHandleT()amfCallbacks = Noneversion = SaVersionT(‘B’, 1, 1)rc = saAmfInitialize(amfHandle, amfCallbacks, version)

Definition of Functionsdef saAmfInitialize(amfHandle, amfCallbacks, version): return amfdll.saAmfInitialize( BYREF(amfHandle), BYREF(amfCallbacks), BYREF(version))

Definition of callbacks and CFUNCTYPESaAmfCSISetCallbackT = CFUNCTYPE(None, SaInvocationT, POINTER(SaNameT), SaAmfHAStateT, SaAmfCSIDescriptorT)def myCSISetCallback(invoc, comp, hastate, descr): …callbacks = SaAmfCallbacksT()callbacks.saAmfCSISetCallbackT( SaAmfCSISetCallbackT(myCSISetCallback))

Concluding Demonstations• Unit tests written for every interface except SMF.• AMF demo component written in Python.• Admin-commands written in Python.• Server implemented in Python: receives NTF notification, queries IMM and updates web- client.• Alarms resulting from admin-commands.• Logging from AMF demo component.

Future Work• Complete unit tests for all interfaces.• Bind Python admin-commands into CLI.• Complete SMF bindings.• Create more tools to enhance system useability.• Consider Pythonic interfaces, similar as what was done for Java.• Consider code-generation for Python bindings.• Consider compiled Python: Cython, Psyco, etc.

Questions?

http://www.opensaf.org	688
http://opensaf.org	303
url_unknown	8
http://translate.googleusercontent.com	1

Python Bindings for the SAF-AIS APIs 5.18.2011

by OpenSAF Foundation on Jun 15, 2011

Accessibility

Upload Details

Usage Rights

4 Embeds 1,000

Statistics

Python Bindings for the SAF-AIS APIs 5.18.2011 — Webinar Transcript