Getting Started

This is a python library that wraps a number of useful OS X frameworks.

Develop

cffi wrappers for various frameworks live in the osx.frameworks modules. Run the osx._corefoundation_cffi_build module to create the osx._corefoundation.so module. That contains the cffi extension module for the wrappers. Each time changes are made to the wrapper modules, re-run the cffi build.

The other modules in osx are Python objects that wrap various CoreFoundation objects to provide implicit CFRetain/CFRelease behavior and also simple data conversion APIs between the CF types and Python types. For example to turn a Python string "s" into a CFStringRef:

cfstr = CFStringRef.fromString(s)

The base Python CFObjectRef class assumes ownership of the underlying CF object and will always release it. If the CF object being passed in has not already been retained, then set the "owned" argument to False.

Install

python setup.py build

Copyright and License

Copyright (c) 2015-2017 Apple Inc. All rights reserved.

This software is licensed under the Apache License, Version 2.0. The Apache License is a well-established open source license, enabling collaborative open source software development.

See the "LICENSE" file for the full text of the license terms.