Introduction

The PyObjC project aims to provide a bridge between the Python and Objective-C programming languages. The bridge is intended to be fully bidirectional, allowing the Python programmer to take full advantage of the power provided by various Objective-C based toolkits and the Objective-C programmer transparent access to Python based functionality.

The most important usage of this is writing Cocoa GUI applications on Mac OS X in pure Python. See our tutorial for an example of this.

Release information

PyObjC X.Y was released on YYYY-MM-DD. See the changelog for more information.

General documentation

• Installing PyObjC
• An introduction to PyObjC
• What’s new in PyObjC
• PyObjC protocol support
• PyObjC support for “blocks”
• Converting values between Python and Objective-C
• Support for FSRef and FSSpec
• Generated types for C types
• Key-Value Observing and Python
• Objective-C Garbage Collection
• PyObjC metadata system
• PyObjC Tutorials
• “import Quartz” or “import CoreGraphics”
• Examples overview
• API Notes for PyObjC framework wrappers

API documentation

• Context Managers for CoreGraphics
• Python API
• PyObjCTools – Utilities
• API Description for PyObjCTools.AppCategories
• PyObjCTools.AppHelper – Work with AppKit
• PyObjCTools.Conversion – Convert data structures
• API Description for PyObjCTools.FndCategories
• PyObjCTools.KeyValueCoding – Key-Value Coding API
• PyObjCTools.NibClassBuilder – Magic NIBs
• PyObjCTools.Signals – Debug signal handling
• PyObjCTools.TestSupport – Testing helpers
• objc – The PyObjC bridge
• Utility methods for threading

PyObjC Developement

PyObjC development is hosted at bickbucket, in particular at <https://bitbucket.org/ronaldoussoren/pyobjc/>.

Important resources:

• Issue tracker

• PyObjC-dev mailing list

  A low-volume mailinglist for PyObjC development.

• Mailing list for the PythonMac SIG

  A mailing list for anyone developing with Python on Mac OS X.

• Repository browser

• Creating a checkout of the respository:

  $ hg clone https://bitbucket.org/ronaldoussoren/pyobjc pyobjc
  

  You can then use the “install.py” at the root of the checkout to install this version of PyObjC.

• Coding style for PyObjC
• Structure of the PyObjC package
• How to wrap an Objective-C class library

Indices and tables

• Module Index
• Search Page