• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1-------------------------
2Development on Setuptools
3-------------------------
4
5Setuptools is maintained by the Python community under the Python Packaging
6Authority (PyPA) and led by Jason R. Coombs.
7
8This document describes the process by which Setuptools is developed.
9This document assumes the reader has some passing familiarity with
10*using* setuptools, the ``pkg_resources`` module, and EasyInstall.  It
11does not attempt to explain basic concepts like inter-project
12dependencies, nor does it contain detailed lexical syntax for most
13file formats.  Neither does it explain concepts like "namespace
14packages" or "resources" in any detail, as all of these subjects are
15covered at length in the setuptools developer's guide and the
16``pkg_resources`` reference manual.
17
18Instead, this is **internal** documentation for how those concepts and
19features are *implemented* in concrete terms.  It is intended for people
20who are working on the setuptools code base, who want to be able to
21troubleshoot setuptools problems, want to write code that reads the file
22formats involved, or want to otherwise tinker with setuptools-generated
23files and directories.
24
25Note, however, that these are all internal implementation details and
26are therefore subject to change; stick to the published API if you don't
27want to be responsible for keeping your code from breaking when
28setuptools changes.  You have been warned.
29
30.. toctree::
31   :maxdepth: 1
32
33   developer-guide
34   formats
35   releases
36