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
• Introspecting PyObjC
• Object-graph serialization
• Key-Value Observing and Python
• Objective-C Garbage Collection
• PyObjC metadata system
• PyObjC Tutorials
• “import Quartz” or “import CoreGraphics”
• Examples overview
• Overview of Mac OS X frameworks and their wrappers
• API Notes for PyObjC framework wrappers
• The PyObjC core team
• The release workflow for PyObjC

API documentation

• Python API
  • objc – The PyObjC bridge
  • PyObjCTools – Utilities
• Context Managers for CoreGraphics
• Utility methods for threading
  • Safe replacements for stock NSObject methods
  • Enhanced methods
• API Description for PyObjCTools.AppCategories
  • Introduction
  • Additional methods on NSGraphicsContext
  • Context-manager for NSAnimationContext
• API Description for PyObjCTools.FndCategories
  • Introduction
  • Additional methods on NSAffineTransform

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