pyobjc / Doc / index.txt

The branch 'pyobjc-ancient' does not exist.
PyObjC documentation index

PyObjC is a bridge between Python and Objective-C. It allows you to write
Python scripts that use and extend existing Objective-C class libraries,
most importantly the `Cocoa libraries`_ by `Apple`_.

More information can be found on `our website <>`_

.. _`Apple`:

.. _`Cocoa libraries`: 

.. _`our website <>`:

General user documentation

The following documents are useful when you're interested in developing
Cocoa applications in Python.

* `An introduction to PyObjC`_

  An overview of the PyObjC package and how to use it. Read this before
  you start using the package, it will help you to avoid some surprises.

* `Python classes and Objective-C code`_

  Another older overview of PyObjC. 

* `Notes on supported APIs and classes on MacOS X`_

  This document lists the methods and classes that are not fully supported,
  or supported in an 'unexpected' way.


* `Creating your first PyObjC application (tutorial)`_

  This tutorial guides you though creating a Python based Cocoa application.

* `Adding Python code to an existing ObjC application`_

  This tutorial teaches you how to extend you existing Objective-C based
  Cocoa application using Python.


The source tree includes a number of examples, see the `list of examples`__ for
more information.

.. __: ../Examples/00ReadMe.html

Technical documentation

These documents are only relevant if you want to modify PyObjC, not if
you want to write Cocoa programs in Python.

* `Coding style for PyObjC`_

  Rules for formatting code and documentation.

* `PyObjC Architecture`_

  An overview of the PyObjC architecture. This document is out of date.

* `Structure of the PyObjC package`_

  Another overview of the PyObjC package.

* `How to wrap an Objective-C class library`_

  This explains how you can provide a python wrapper for an existing 
  Objective-C class library.

* `Project Builder Python Support`_

  Describes the Python support for Project Builder, including a TODO list for
  future versions.

.. _`Project Builder Python Support`: ProjectBuilder-SyntaxHighlighting.html

.. _`An introduction to PyObjC`: intro.html

.. _`Python classes and Objective-C code`: classes.html

.. _`Coding style for PyObjC`: coding-style.html

.. _`Using LibFFI with PyObjC`: libffi.html

.. _`PyObjC Architecture`: architecture.html

.. _`Structure of the PyObjC package`: structure.html

.. _`How to wrap an Objective-C class library`: wrapping.html

.. _`Creating your first PyObjC application (tutorial)`: tutorial/tutorial.html

.. _`Adding Python code to an existing ObjC application`: tutorial_embed/extending_objc_with_python.html

.. _`Notes on supported APIs and classes on MacOS X`: api-notes-macosx.html