1. Ronald Oussoren
  2. pyobjc


pyobjc / Doc / index.txt

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 <http://pyobjc.sf.net>`_

.. _`Apple`: http://www.apple.com/

.. _`Cocoa libraries`: http://developer.apple.com/documentation/Cocoa/Cocoa.html

.. _`our website <http://pyobjc.sf.net>`: http://pyobjc.sf.net/

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 Mac OS X`_

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

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

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


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

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

* `Adding Python code to an existing Objective-C 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.

* `Structure of the PyObjC package`_

  An overview of the implementation of PyObjC.

* `Xcode Python templates`_

  Describes the PyObjC Xcode templates.

.. _`Xcode Python templates`: Xcode-Templates.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 Objective-C application`: tutorial_embed/extending_objc_with_python.html

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