= setuptools

[http://peak.telecommunity.com/DevCenter/setuptools setuptools] is a Python module that helps to compile, distribute and install Python packages by wrapping them into "egg"s. Eggs contain additional information to process dependencies, etc. Trac [TracPlugins plugins] can be packaged as eggs since [milestone:0.9]. Starting with [milestone:0.11] Trac itself can also be packaged using setuptools.

Installed setuptools version can be checked with the following commands (should work for other Python packages too):
{{{#!sh
$ python
Python 2.3.5
>>> import setuptools
>>> setuptools.__version__ 
'0.7a1' 
}}}

Setuptools can be installed using bootstrap script from PyPi ([https://pypi.python.org/pypi/setuptools#installation-instructions installation instructions]):
{{{#!sh
$ wget https://bootstrap.pypa.io/ez_setup.py -O - | python
}}}

Notes:
 - if you're using svn 1.6.x and setuptools prior to **0.6c10**, be sure to apply the latest patch in setuptools-issue:64.
 - if you're using Python 2.6 and setuptools prior to **0.6c10**, be sure to also apply the `Python26.warnings.diff` patch from setuptools-issue:56.
 - if you're using setuptools versions **5.4** through **5.6**, the environment variable `PKG_RESOURCES_CACHE_ZIP_MANIFESTS` should be set, otherwise the performance of Trac will be significantly degraded.
  - Linux: `$export PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1`
  - Windows: `>set PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1`


setuptools include "easy_install" script for convenient installation of packages found on [http://pypi.python.org/pypi/setuptools/ Python Package Index] including Trac with all necessary dependencies.

{{{#!sh
$ python -m easy_install Trac
}}}

== Reference Documentation
 - [http://peak.telecommunity.com/DevCenter/setuptools setuptools]
 - [http://peak.telecommunity.com/DevCenter/PkgResources pkg_resources] (setuptools)
 - [http://packages.python.org/distribute/pkg_resources.html pkg_resources] (Distribute)
 - [http://peak.telecommunity.com/DevCenter/EggFormats .egg format]
----
See also: TracDev/Proposals/Setuptools