========================== 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`: http://www.apple.com/ .. _`Cocoa libraries`: http://developer.apple.com/documentation/Cocoa/Cocoa.html .. _`our website `: 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. * `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. Tutorials ......... * `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. Examples ........ 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 .. _`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