4 Summary: Download, build, install, upgrade, and uninstall Python packages -- easily! (zetuptoolz fork)
5 Home-page: http://pypi.python.org/pypi/setuptools
7 Author-email: distutils-sig@python.org
9 Description: ======================
10 This is not Setuptools
11 ======================
13 This is the ``zetuptoolz`` fork of setuptools, which is used to install
14 `Tahoe-LAFS`_. It has a `darcs source repository`_ and `issue tracker`_.
16 For a list of differences between this fork and setuptools, see zetuptoolz.txt.
18 Note that, to avoid interfering with any setuptools installation, zetuptoolz
19 does not install a script called ``easy_install``. There is an ``easy_install_z``
20 script, but that is intended only for developers to test differences between
21 setuptools and zetuptoolz.
23 .. _Tahoe-LAFS: http://tahoe-lafs.org/
24 .. _darcs source repository: http://tahoe-lafs.org/source/zetuptoolz/trunk
25 .. _issue tracker: http://tahoe-lafs.org/trac/zetuptoolz
28 --------------------------------
29 Using Setuptools and EasyInstall
30 --------------------------------
32 Here are some of the available manuals, tutorials, and other resources for
33 learning about Setuptools, Python Eggs, and EasyInstall:
35 * `The EasyInstall user's guide and reference manual`_
36 * `The setuptools Developer's Guide`_
37 * `The pkg_resources API reference`_
38 * `Package Compatibility Notes`_ (user-maintained)
39 * `The Internal Structure of Python Eggs`_
41 Questions, comments, and bug reports should be directed to the `distutils-sig
42 mailing list`_. If you have written (or know of) any tutorials, documentation,
43 plug-ins, or other resources for setuptools users, please let us know about
44 them there, so this reference list can be updated. If you have working,
45 *tested* patches to correct problems or add features, you may submit them to
46 the `setuptools bug tracker`_.
48 .. _setuptools bug tracker: http://bugs.python.org/setuptools/
49 .. _Package Compatibility Notes: http://peak.telecommunity.com/DevCenter/PackageNotes
50 .. _The Internal Structure of Python Eggs: http://peak.telecommunity.com/DevCenter/EggFormats
51 .. _The setuptools Developer's Guide: http://peak.telecommunity.com/DevCenter/setuptools
52 .. _The pkg_resources API reference: http://peak.telecommunity.com/DevCenter/PkgResources
53 .. _The EasyInstall user's guide and reference manual: http://peak.telecommunity.com/DevCenter/EasyInstall
54 .. _distutils-sig mailing list: http://mail.python.org/pipermail/distutils-sig/
61 * The original design for the ``.egg`` format and the ``pkg_resources`` API was
62 co-created by Phillip Eby and Bob Ippolito. Bob also implemented the first
63 version of ``pkg_resources``, and supplied the OS X operating system version
64 compatibility algorithm.
66 * Ian Bicking implemented many early "creature comfort" features of
67 easy_install, including support for downloading via Sourceforge and
68 Subversion repositories. Ian's comments on the Web-SIG about WSGI
69 application deployment also inspired the concept of "entry points" in eggs,
70 and he has given talks at PyCon and elsewhere to inform and educate the
71 community about eggs and setuptools.
73 * Jim Fulton contributed time and effort to build automated tests of various
74 aspects of ``easy_install``, and supplied the doctests for the command-line
75 ``.exe`` wrappers on Windows.
77 * Phillip J. Eby is the principal author and maintainer of setuptools, and
78 first proposed the idea of an importable binary distribution format for
79 Python application plug-ins.
81 * Significant parts of the implementation of setuptools were funded by the Open
82 Source Applications Foundation, to provide a plug-in infrastructure for the
83 Chandler PIM application. In addition, many OSAF staffers (such as Mike
84 "Code Bear" Taylor) contributed their time and stress as guinea pigs for the
85 use of eggs and setuptools, even before eggs were "cool". (Thanks, guys!)
89 Keywords: CPAN PyPI distutils eggs package management
91 Classifier: Development Status :: 3 - Alpha
92 Classifier: Intended Audience :: Developers
93 Classifier: License :: OSI Approved :: Python Software Foundation License
94 Classifier: License :: OSI Approved :: Zope Public License
95 Classifier: Operating System :: OS Independent
96 Classifier: Programming Language :: Python
97 Classifier: Topic :: Software Development :: Libraries :: Python Modules
98 Classifier: Topic :: System :: Archiving :: Packaging
99 Classifier: Topic :: System :: Systems Administration
100 Classifier: Topic :: Utilities