A bridge between an Objective C runtime environment and Python.
Project description
Rubicon-ObjC is a bridge between Objective C and Python. It enables you to:
Use Python to instantiate objects defined in Objective C
Use Python to invoke methods on objects defined in Objective C
Subclass and extend Objective C classes in Python
It also includes wrappers of the some key data types from the Core Foundation framework (e.g., NSString).
Quickstart
Rubicon uses a combination of ctypes, plus Objective-C’s own reflection APIs, to enable Objective C objects to be referenced in a Python process.
To install Rubicon, use pip:
$ pip install rubicon-objc
Then, in a Python shell:
>>> from ctypes import cdll >>> from ctypes import util >>> from rubicon.objc import ObjCClass, ObjCSubclass, at, to_str # Use ctypes to import a framework into the Python process >>> cdll.LoadLibrary(util.find_library('Foundation')) # Wrap an Objective C class contained in the framework >>> NSURL = ObjCClass("NSURL") # Then instantiate the Objective C class, using the API # that is exposed through Objective C. The Python method name # is the concatenated version of the Objective C method descriptor, # with colons replaced with underscores. So, the equivalent of # [NSURL URLWithString:@"http://pybee.org"]; # would be: >>> NSURL.URLWithString_("http://pybee.org/") # To create a new Objective C class, define a Python class that # has the methods you want to define: >>> class Handler_impl(object): ... Handler = ObjCSubclass('NSObject', 'Handler') ... ... @Handler.method('@i') ... def initWithValue_(self, value): ... # You can't store attributes directly on the object - ... # you need to put them manually on the Python object ... self.__dict__['value'] = value ... return self ... ... @Handler.method('vi') ... def pokeWithValue_(self, value): ... print ("Poking with", value) # Then, create a wrapper for that class... >>> Handler = ObjCClass('Handler') # ...and use it: >>> my_handler = Handler.alloc().initWithValue_(42) >>> my_handler.pokeWithValue_(37)
Community
Rubicon is part of the BeeWare suite. You can talk to the community through:
The BeeWare Users Mailing list, for questions about how to use the BeeWare suite.
The BeeWare Developers Mailing list, for discussing the development of new features in the BeeWare suite, and ideas for new tools for the suite.
Contributing
If you experience problems with this backend, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for rubicon_objc-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1f7cc1d2f8176ed55a37076aece27df8da09777ffc701aa2ae587a2d97e6db42 |
|
MD5 | bdca7f6e31587756bdcb489db5f72cb0 |
|
BLAKE2b-256 | e1c328ff8e94bc627c0263ca2f00806fbe02c26192f8e46e5b6ea2927b4543b9 |