1=========================
2Installation Instructions
3=========================
4
5.. :authors: Ronald Oussoren
6
7
8Installation
9------------
10
11PyObjC is installed using distutils and uses the setuptools extension to
12distutils. PyObjC's ``setup.py`` script will download setuptools if it is
13not yet installed.
14
15To install PyObjC::
16
17  $ python setup.py install
18
19This will compile and install the ``pyobjc-core`` package in your Python's
20``site-packages`` directory. When you have multiple versions of Python on 
21your machine this will only install it for the version of python that's first
22in your shell's search-path.
23
24
25Installation using ``easy_install``
26-----------------------------------
27
28It is also possible to install PyObjC using ``easy_install``:
29
30  $ easy_install pyobjc-core
31
32This will install just ``pyobjc-core``. In general you want to use
33the following command instead::
34
35
36  $ easy_install pyobjc
37
38This will install ``pyobjc-core`` as well as a large number of
39framework wrappers.
40
41
42Installation with the system version of Python
43----------------------------------------------
44
45The system version of Python (``/usr/bin/python``) includes a copy of
46PyObjC starting at MacOSX 10.5 ("Leopard"). Installing other versions
47of PyObjC with "/usr/bin/python" on Leopard or later is not supported
48and could break your system.
49