=========================

Installation Instructions
=========================
.. :authors: Ronald Oussoren
Installation
-----------PyObjC is installed using distutils and uses the setuptools extension to
distutils. PyObjC's ``setup.py`` script will download setuptools if it is
not yet installed.
To install PyObjC::
$ python setup.py install
This will compile and install the ``pyobjc-core`` package in your Python's
``site-packages`` directory. When you have multiple versions of Python on
your machine this will only install it for the version of python that's first
in your shell's search-path.
Installation using ``easy_install``
----------------------------------It is also possible to install PyObjC using ``easy_install``:
$ easy_install pyobjc-core
This will install just ``pyobjc-core``. In general you want to use
the following command instead::
$ easy_install pyobjc
This will install ``pyobjc-core`` as well as a large number of
framework wrappers.
Installation with the system version of Python
---------------------------------------------The system version of Python (``/usr/bin/python``) includes a copy of
PyObjC starting at MacOSX 10.5 ("Leopard"). Installing other versions
of PyObjC with "/usr/bin/python" on Leopard or later is not supported
and could break your system.