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 macOS in pure Python. See our tutorial for an example of this.

Release information

PyObjC 5.1 was released on 2018-10-16. See the changelog for more information.

Supported platforms

PyObjC is regularly tested with Python 2.7, 3.4, 3.5 and 3.6. PyObjC does not support other python implementation such as PyPy and Jython.

PyObjC is regularly tested on macOS 10.13 and should work on macOS 10.5 or later for the i386, x86_64 and ppc architectures. PPC64 (64-bit on PowerMac G5 or iMac G5 systems) is not supported at all.

Note

PPC support, and support for versions of macOS before 10.9 is no longer actively developed and may be removed in future versions of PyObjC.

Warning

Platform Removal

PyObjC 6, which will be released in 2019, will drop support for the following platforms:

• Python 2.7
• Python 3.4
• PowerPC

General documentation

• Installing PyObjC
• What’s new in PyObjC
• An introduction to PyObjC
• PyObjC protocol support
• PyObjC support for “blocks”
• PyObjC support for vector/SIMD types
• 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
• (Historical) Objective-C Garbage Collection
• PyObjC metadata system
• PyObjC Tutorials
• “import Quartz” or “import CoreGraphics”
• Examples overview
• Overview of macOS frameworks and their wrappers
• API Notes for PyObjC framework wrappers
• Dealing with API deprecations
• The PyObjC core team
• The release workflow for PyObjC
• PyObjC with InterfaceBuilder

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 macOS.

• 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
• Developer Documentation
• Structure of the PyObjC package
• How to wrap an Objective-C class library

Indices and tables

• Module Index
• Search Page