Installation Instructions

The recommended way to bootstrap setuptools on any system is to downloadez_setup.py and run it using the target Python environment. Differentoperating systems have different recommended techniques to accomplish thisbasic routine, so below are some examples to get you started.

Setuptools requires Python 2.6 or later. To install setuptoolson Python 2.4 or Python 2.5, use thebootstrap script for Setuptools 1.x.

The link provided to ez_setup.py is a bookmark to bootstrap script for thelatest known stable release.

> (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | python -

> (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | python - --user

> (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | py -3 -

> wget https://bootstrap.pypa.io/ez_setup.py -O - | python

> wget https://bootstrap.pypa.io/ez_setup.py -O - | sudo python

> wget https://bootstrap.pypa.io/ez_setup.py -O - | python - --user

> wget --no-check-certificate https://bootstrap.pypa.io/ez_setup.py> python ez_setup.py --insecure

> curl https://bootstrap.pypa.io/ez_setup.py -o - | python

setuptools-x.x$ python setup.py install --prefix=/opt/setuptools

Using Setuptools and EasyInstall

Here are some of the available manuals, tutorials, and other resources forlearning about Setuptools, Python Eggs, and EasyInstall:

• The EasyInstall user’s guide and reference manual

• The setuptools Developer’s Guide

• The pkg_resources API reference

• The Internal Structure of Python Eggs

Questions, comments, and bug reports should be directed to thedistutils-sigmailing list. If you have written (or know of) any tutorials, documentation,plug-ins, or other resources for setuptools users, please let us know aboutthem there, so this reference list can be updated. If you have working,tested patches to correct problems or add features, you may submit them tothesetuptools bug tracker.

Credits

• The original design for the.egg format and thepkg_resources API wasco-created by Phillip Eby and Bob Ippolito. Bob also implemented the firstversion ofpkg_resources, and supplied the OS X operating system versioncompatibility algorithm.

• Ian Bicking implemented many early “creature comfort” features ofeasy_install, including support for downloading via Sourceforge andSubversion repositories. Ian’s comments on the Web-SIG about WSGIapplication deployment also inspired the concept of “entry points” in eggs,and he has given talks at PyCon and elsewhere to inform and educate thecommunity about eggs and setuptools.

• Jim Fulton contributed time and effort to build automated tests of variousaspects ofeasy_install, and supplied the doctests for the command-line.exe wrappers on Windows.

• Phillip J. Eby is the seminal author of setuptools, andfirst proposed the idea of an importable binary distribution format forPython application plug-ins.

• Significant parts of the implementation of setuptools were funded by the OpenSource Applications Foundation, to provide a plug-in infrastructure for theChandler PIM application. In addition, many OSAF staffers (such as Mike“Code Bear” Taylor) contributed their time and stress as guinea pigs for theuse of eggs and setuptools, even before eggs were “cool”. (Thanks, guys!)

• Tarek Ziadé is the principal author of the Distribute fork, whichre-invigorated the community on the project, encouraged renewed innovation,and addressed many defects.

• Since the merge with Distribute, Jason R. Coombs is themaintainer of setuptools. The project is maintained in coordination withthe Python Packaging Authority (PyPA) and the larger Python community.

10.0

• Issue #313: Removed built-in support for subversion. Projects wishing toretain support for subversion will need to use a third party library. Theextant implementation is being ported tosetuptools_svn.

• Issue #315: Updated setuptools to hide its own loaded modules duringinstallation of another package. This change will enable setuptools toupgrade (or downgrade) itself even when its own metadata and implementationchange.

9.1

• Prefer vendored packaging libraryas recommended.

9.0.1

• Issue #312: Restored presence of pkg_resources API tests (doctest) to sdist.

9.0

• Issue #314: Disabled support forsetup_requires metadata to avoid issuewhere Setuptools was unable to upgrade over earlier versions.

8.4

• Pull Request #106: Now writesetup_requires metadata.

8.3

• Issue #311: Decoupled pkg_resources from setuptools once again.pkg_resources is now a package instead of a module.

8.2.1

• Issue #306: Suppress warnings about Version format except in select scenarios(such as installation).

8.2

• Pull Request #85: Search egg-base when adding egg-info to manifest.

8.1

• Upgradepackaging to 14.5, giving preference to “rc” as designator forrelease candidates over “c”.

• PEP-440 warnings are now raised as their own class,pkg_resources.PEP440Warning, instead of RuntimeWarning.

• Disabled warnings on empty versions.

8.0.4

• Upgradepackaging to 14.4, fixing an error where there is adifferent result for if 2.0.5 is contained within >2.0dev and >2.0.dev eventhough normalization rules should have made them equal.

• Issue #296: Add warning when a version is parsed as legacy. This warning willmake it easier for developers to recognize deprecated version numbers.

8.0.3

• Issue #296: Restored support for__hash__ on parse_version results.

8.0.2

• Issue #296: Restored support for__getitem__ and sort operations onparse_version result.

8.0.1

• Issue #296: Restore support for iteration over parse_version result, butdeprecated that usage with a warning. Fixes failure with buildout.

8.0

• ImplementPEP 440 withinpkg_resources and setuptools. This changedeprecates some version numbers such that they will no longer be installablewithout using the=== escape hatch. Seethe changes to test_resourcesfor specific examples of version numbers and specifiers that are no longersupported. Setuptools now “vendors” thepackaging library.

7.0

• Issue #80,Issue #209: Eggs that are downloaded forsetup_requires,test_requires, etc. are now placed in a./.eggs directory instead ofdirectly in the current directory. This choice of location means the filescan be readily managed (removed, ignored). Additionally,later phases or invocations of setuptools will not detect the package asalready installed and ignore it for permanent install (See#209).

  This change is indicated as backward-incompatible as installations thatdepend on the installation in the current directory will need to account forthe new location. Systems that ignore*.egg will probably need to beadapted to ignore.eggs. The files will need to be manually moved orwill be retrieved again. Most use cases will require no attention.

6.1

• Issue #268: When resolving package versions, a VersionConflict now reportswhich package previously required the conflicting version.

6.0.2

• Issue #262: Fixed regression in pip install due to egg-info directoriesbeing omitted. Re-opensIssue #118.

6.0.1

• Issue #259: Fixed regression with namespace package handling onsingle version, externally managed installs.

6.0

• Issue #100: When building a distribution, Setuptools will no longer matchdefault files using platform-dependent case sensitivity, but rather willonly match the files if their case matches exactly. As a result, on Windowsand other case-insensitive file systems, files with names such as‘readme.txt’ or ‘README.TXT’ will be omitted from the distribution and awarning will be issued indicating that ‘README.txt’ was not found. Otherfilenames affected are:

  • README.rst

  • README

  • setup.cfg

  • setup.py (or the script name)

  • test/test*.py

  Any users producing distributions with filenames that match those abovecase-insensitively, but not case-sensitively, should rename those files intheir repository for better portability.

• Pull Request #72: When usingsingle_version_externally_managed, theexclusion list now includes Python 3.2__pycache__ entries.

• Pull Request #76 andPull Request #78: lines in top_level.txt are nowordered deterministically.

• Issue #118: The egg-info directory is now no longer included in the listof outputs.

• Issue #258: Setuptools now patches distutils msvc9compiler torecognize the specially-packaged compiler package for easy extension modulesupport on Python 2.6, 2.7, and 3.2.

5.8

• Issue #237:pkg_resources now uses explicit detection of Python 2 vs.Python 3, supporting environments where builtins have been patched to makePython 3 look more like Python 2.

5.7

• Issue #240: Based on real-world performance measures against 5.4, zipmanifests are now cached in all circumstances. ThePKG_RESOURCES_CACHE_ZIP_MANIFESTS environment variable is no longerrelevant. The observed “memory increase” referenced in the 5.4 releasenotes and detailed inIssue #154 was likely not an increase over the statusquo, but rather only an increase over not storing the zip info at all.

5.6

• Issue #242: Use absolute imports in svn_utils to avoid issues if theinstalling package adds an xml module to the path.

5.5.1

• Issue #239: Fix typo in 5.5 such that fix did not take.

5.5

• Issue #239: Setuptools now includes the setup_requires directive onDistribution objects and validates the syntax just like install_requiresand tests_require directives.

5.4.2

• Issue #236: Corrected regression in execfile implementation for Python 2.6.

5.4.1

• Python #7776: (ssl_support) Correct usage of host for validation whentunneling for HTTPS.

5.4

• Issue #154:pkg_resources will now cache the zip manifests rather thanre-processing the same file from disk multiple times, but only if theenvironment variablePKG_RESOURCES_CACHE_ZIP_MANIFESTS is set. Clientsthat package many modules in the same zip file will see some improvementin startup time by enabling this feature. This feature is not enabled bydefault because it causes a substantial increase in memory usage.

5.3

• Issue #185: Make svn tagging work on the new style SVN metadata.Thanks cazabon!

• Prune revision control directories (e.g .svn) from base pathas well as sub-directories.

5.2

• Added aDeveloper Guide to the officialdocumentation.

• Some code refactoring and cleanup was done with no intended behavioralchanges.

• During install_egg_info, the generated lines for namespace package .pthfiles are now processed even during a dry run.

5.1

• Issue #202: Implemented more robust cache invalidation for the ZipImporter,building on the work inIssue #168. Special thanks to Jurko Gospodnetic andPJE.

5.0.2

• Issue #220: Restored script templates.

5.0.1

• Renamed script templates to end with .tmpl now that they no longer needto be processed by 2to3. Fixes spurious syntax errors during build/install.

5.0

• Issue #218: Re-release of 3.8.1 to signal that it supersedes 4.x.

• Incidentally, script templates were updated not to include the triple-quoteescaping.

3.7.1 and 3.8.1 and 4.0.1

• Issue #213: Use legacy StringIO behavior for compatibility under pbr.

• Issue #218: Setuptools 3.8.1 superseded 4.0.1, and 4.x was removedfrom the available versions to install.

4.0

• Issue #210:setup.py develop now copies scripts in binary mode ratherthan text mode, matching the behavior of theinstall command.

3.8

• ExtendIssue #197 workaround to include all Python 3 versions prior to3.2.2.

3.7

• Issue #193: Improved handling of Unicode filenames when building manifests.

3.6

• Issue #203: Honor proxy settings for Powershell downloader in the bootstraproutine.

3.5.2

• Issue #168: More robust handling of replaced zip files and stale caches.Fixes ZipImportError complaining about a ‘bad local header’.

3.5.1

• Issue #199: Restoredinstall._install for compatibility with earlierNumPy versions.

3.5

• Issue #195: Follow symbolic links in find_packages (restoring behaviorbroken in 3.4).

• Issue #197: On Python 3.1, PKG-INFO is now saved in a UTF-8 encoding insteadofsys.getpreferredencoding to match the behavior on Python 2.6-3.4.

• Issue #192: Preferred bootstrap location is nowhttps://bootstrap.pypa.io/ez_setup.py (mirrored from former location).

3.4.4

• Issue #184: Correct failure where find_package over-matched packageswhen directory traversal isn’t short-circuited.

3.4.3

• Issue #183: Really fix test command with Python 3.1.

3.4.2

• Issue #183: Fix additional regression in test command on Python 3.1.

3.4.1

• Issue #180: Fix regression in test command not caught by py.test-run tests.

3.4

• Issue #176: Add parameter to the test command to support a custom testrunner: –test-runner or -r.

• Issue #177: Now assume most common invocation to install command onplatforms/environments without stack support (issuing a warning). Setuptoolsnow installs naturally on IronPython. Behavior on CPython should beunchanged.

3.3

• Addinclude parameter tosetuptools.find_packages().

3.2

• Pull Request #39: Add support for C++ targets from Cython.pyx files.

• Issue #162: Update dependency on certifi to 1.0.1.

• Issue #164: Update dependency on wincertstore to 0.2.

3.1

• Issue #161: Restore Features functionality to allow backward compatibility(for Features) until the uses of that functionality is sufficiently removed.

3.0.2

• Correct typo in previous bugfix.

3.0.1

• Issue #157: Restore support for Python 2.6 in bootstrap script wherezipfile.ZipFile does not yet have support for context managers.

3.0

• Issue #125: Prevent Subversion support from creating a ~/.subversiondirectory just for checking the presence of a Subversion repository.

• Issue #12: Namespace packages are now imported lazily. That is, the meredeclaration of a namespace package in an egg onsys.path no longercauses it to be imported whenpkg_resources is imported. Note that thischange means that all of a namespace package’s__init__.py files mustinclude adeclare_namespace() call in order to ensure that they will behandled properly at runtime. In 2.x it was possible to get away withoutincluding the declaration, but only at the cost of forcing namespacepackages to be imported early, which 3.0 no longer does.

• Issue #148: When building (bdist_egg), setuptools no longer adds__init__.py files to namespace packages. Any packages that rely on thisbehavior will need to create__init__.py files and include thedeclare_namespace().

• Issue #7: Setuptools itself is now distributed as a zip archive in addition totar archive. ez_setup.py now uses zip archive. This approach avoids the potentialsecurity vulnerabilities presented by use of tar archives in ez_setup.py.It also leverages the security features added to ZipFile.extract in Python 2.7.4.

• Issue #65: Removed deprecated Features functionality.

• Pull Request #28: Remove backport of_bytecode_filenames which isavailable in Python 2.6 and later, but also has better compatibility withPython 3 environments.

• Issue #156: Fix spelling of __PYVENV_LAUNCHER__ variable.

2.2

• Issue #141: Restored fix for allowing setup_requires dependencies tooverride installed dependencies during setup.

• Issue #128: Fixed issue where only the first dependency link was honoredin a distribution where multiple dependency links were supplied.

2.1.2

• Issue #144: Read long_description using codecs module to avoid errorsinstalling on systems where LANG=C.

2.1.1

• Issue #139: Fix regression in re_finder for CVS repos (and maybe Git reposas well).

2.1

• Issue #129: Suppress inspection of*.whl files when searching for filesin a zip-imported file.

• Issue #131: Fix RuntimeError when constructing an egg fetcher.

2.0.2

• Fix NameError during installation with Python implementations (e.g. Jython)not containing parser module.

• Fix NameError insdist:re_finder.

2.0.1

• Issue #124: Fixed error in list detection in upload_docs.

2.0

• Issue #121: Exempt lib2to3 pickled grammars from DirectorySandbox.

• Issue #41: Dropped support for Python 2.4 and Python 2.5. Clients requiringsetuptools for those versions of Python should use setuptools 1.x.

• Removedsetuptools.command.easy_install.HAS_USER_SITE. Clientsexpecting this boolean variable should usesite.ENABLE_USER_SITEinstead.

• Removedpkg_resources.ImpWrapper. Clients that expected this classshould usepkgutil.ImpImporter instead.

1.4.2

• Issue #116: Correct TypeError when reading a local package index on Python3.

1.4.1

• Issue #114: Usesys.getfilesystemencoding for decoding config inbdist_wininst distributions.

• Issue #105 andIssue #113: Establish a more robust technique fordetermining the terminal encoding:

  1. Try ``getpreferredencoding``2. If that returns US_ASCII or None, try the encoding from   ``getdefaultlocale``. If that encoding was a "fallback" because Python   could not figure it out from the environment or OS, encoding remains   unresolved.3. If the encoding is resolved, then make sure Python actually implements   the encoding.4. On the event of an error or unknown codec, revert to fallbacks   (UTF-8 on Darwin, ASCII on everything else).5. On the encoding is 'mac-roman' on Darwin, use UTF-8 as 'mac-roman' was   a bug on older Python releases.On a side note, it would seem that the encoding only matters for when SVNdoes not yet support ``--xml`` and when getting repository and svn versionnumbers. The ``--xml`` technique should yield UTF-8 according to somemessages on the SVN mailing lists. So if the version numbers are always7-bit ASCII clean, it may be best to only support the file parsing methodsfor legacy SVN releases and support for SVN without the subprocess commandwould simple go away as support for the older SVNs does.

1.4

• Issue #27:easy_install will now use credentials from .pypirc ifpresent for connecting to the package index.

• Pull Request #21: Omit unwanted newlines inpackage_index._encode_authwhen the username/password pair length indicates wrapping.

1.3.2

• Issue #99: Fix filename encoding issues in SVN support.

1.3.1

• Remove exuberant warning in SVN support when SVN is not used.

1.3

• Address security vulnerability in SSL match_hostname check as reported inPython #17997.

• Preferbackports.ssl_match_hostname for backportimplementation if present.

• Correct NameError inssl_support module (socket.error).

1.2

• Issue #26: Add support for SVN 1.7. Special thanks to Philip Thiem for thecontribution.

• Issue #93: Wheels are now distributed with every release. Note that asreported inIssue #108, as of Pip 1.4, scripts aren’t installed properlyfrom wheels. Therefore, if using Pip to install setuptools from a wheel,theeasy_install command will not be available.

• Setuptools “natural” launcher support, introduced in 1.0, is now officiallysupported.

1.1.7

• Fixed behavior of NameError handling in ‘script template (dev).py’ (scriptlauncher for ‘develop’ installs).

• ez_setup.py now ensures partial downloads are cleaned up followinga failed download.

• Distribute #363 andIssue #55: Skip an sdist test that fails on localesother than UTF-8.

1.1.6

• Distribute #349:sandbox.execfile now opens the target file in binarymode, thus honoring a BOM in the file when compiled.

1.1.5

• Issue #69: Second attempt at fix (logic was reversed).

1.1.4

• Issue #77: Fix error in upload command (Python 2.4).

1.1.3

• Fix NameError in previous patch.

1.1.2

• Issue #69: Correct issue where 404 errors are returned for URLs withfragments in them (such as #egg=).

1.1.1

• Issue #75: Add--insecure option to ez_setup.py to accommodateenvironments where a trusted SSL connection cannot be validated.

• Issue #76: Fix AttributeError in upload command with Python 2.4.

1.1

• Issue #71 (Distribute #333): EasyInstall now puts less emphasis on thecondition when a host is blocked via--allow-hosts.

• Issue #72: Restored Python 2.4 compatibility inez_setup.py.

1.0

• Issue #60: On Windows, Setuptools supports deferring to another launcher,such as Vinay Sajip’spylauncher(included with Python 3.3) to launch console and GUI scripts and not installits own launcher executables. This experimental functionality is currentlyonly enabled if theSETUPTOOLS_LAUNCHER environment variable is set to“natural”. In the future, this behavior may become default, but only afterit has matured and seen substantial adoption. TheSETUPTOOLS_LAUNCHERalso accepts “executable” to force the default behavior of creating launcherexecutables.

• Issue #63: Bootstrap script (ez_setup.py) now prefers Powershell, curl, orwget for retrieving the Setuptools tarball for improved security of theinstall. The script will still fall back to a simpleurlopen onplatforms that do not have these tools.

• Issue #65: Deprecated theFeatures functionality.

• Issue #52: InVerifyingHTTPSConn, handle a tunnelled (proxied)connection.

0.9.8

• Issue #53: Fix NameErrors in_vcs_split_rev_from_url.

0.9.7

• Issue #49: Correct AttributeError on PyPy where a hashlib.HASH object doesnot have a.name attribute.

• Issue #34: Documentation now refers to bootstrap script in code repositoryreferenced by bookmark.

• Add underscore-separated keys to environment markers (markerlib).

0.9.6

• Issue #44: Test failure on Python 2.4 when MD5 hash doesn’t have a.nameattribute.

0.9.5

• Python #17980: Fix security vulnerability in SSL certificate validation.

0.9.4

• Issue #43: Fix issue (introduced in 0.9.1) with version resolution whenupgrading over other releases of Setuptools.

0.9.3

• Issue #42: Fix newAttributeError introduced in last fix.

0.9.2

• Issue #42: Fix regression where blank checksums would trigger anAttributeError.

0.9.1

• Distribute #386: Allow other positional and keyword arguments to os.open.

• Corrected dependency on certifi mis-referenced in 0.9.

0.9

• package_index now validates hashes other than MD5 in download links.

0.8

• Code base now runs on Python 2.4 - Python 3.3 without Python 2to3conversion.

0.7.8

• Distribute #375: Yet another fix for yet another regression.

0.7.7

• Distribute #375: Repair AttributeError created in last release (redo).

• Issue #30: Added test for get_cache_path.

0.7.6

• Distribute #375: Repair AttributeError created in last release.

0.7.5

• Issue #21: Restore Python 2.4 compatibility intest_easy_install.

• Distribute #375: Merged additional warning from Distribute 0.6.46.

• Now honor the environment variableSETUPTOOLS_DISABLE_VERSIONED_EASY_INSTALL_SCRIPT in addition to the nowdeprecatedDISTRIBUTE_DISABLE_VERSIONED_EASY_INSTALL_SCRIPT.

0.7.4

• Issue #20: Fix comparison of parsed SVN version on Python 3.

0.7.3

• Issue #1: Disable installation of Windows-specific files on non-Windows systems.

• Use new sysconfig module with Python 2.7 or >=3.2.

0.7.2

• Issue #14: Use markerlib when theparser module is not available.

• Issue #10:ez_setup.py now uses HTTPS to download setuptools from PyPI.

0.7.1

• Fix NameError (Issue #3) again - broken in bad merge.

0.7

• Merged Setuptools and Distribute. See docs/merge.txt for details.

Added several features that were slated for setuptools 0.6c12:

• Index URL now defaults to HTTPS.

• Added experimental environment marker support. Now clients may designate aPEP-426 environment marker for “extra” dependencies. Setuptools uses thisfeature insetup.py for optional SSL and certificate validation supporton older platforms. Based on Distutils-SIG discussions, the syntax issomewhat tentative. There should probably be a PEP with a firmer spec beforethe feature should be considered suitable for use.

• Added support for SSL certificate validation when installing packages froman HTTPS service.

0.7b4

• Issue #3: Fixed NameError in SSL support.

0.6.49

• Move warning check inget_cache_path to follow the directory creationto avoid errors when the cache path does not yet exist. Fixes the errorreported inDistribute #375.

0.6.48

• Correct AttributeError inResourceManager.get_cache_path introduced in0.6.46 (redo).

0.6.47

• Correct AttributeError inResourceManager.get_cache_path introduced in0.6.46.

0.6.46

• Distribute #375: Issue a warning if the PYTHON_EGG_CACHE or otherwisecustomized egg cache location specifies a directory that’s group- orworld-writable.

0.6.45

• Distribute #379:distribute_setup.py now traps VersionConflict as well,restoring ability to upgrade from an older setuptools version.

0.6.44

• distribute_setup.py has been updated to allow Setuptools 0.7 tosatisfy use_setuptools.

0.6.43

• Distribute #378: Restore support for Python 2.4 Syntax (regression in 0.6.42).

0.6.42

• External links finder no longer yields duplicate links.

• Distribute #337: Moved site.py to setuptools/site-patch.py (graft of very oldpatch from setuptools trunk which inspired PR#31).

0.6.41

• Distribute #27: Use public api for loading resources from zip files rather thanthe private method_zip_directory_cache.

• Added a new functioneasy_install.get_win_launcher which may be used bythird-party libraries such as buildout to get a suitable script launcher.

0.6.40

• Distribute #376: brought back cli.exe and gui.exe that were deleted in theprevious release.

0.6.39

• Add support for console launchers on ARM platforms.

• Fix possible issue in GUI launchers where the subsystem was not supplied tothe linker.

• Launcher build script now refactored for robustness.

• Distribute #375: Resources extracted from a zip egg to the file system now alsocheck the contents of the file against the zip contents during eachinvocation of get_resource_filename.

0.6.38

• Distribute #371: The launcher manifest file is now installed properly.

0.6.37

• Distribute #143: Launcher scripts, including easy_install itself, are nowaccompanied by a manifest on 32-bit Windows environments to avoid theInstaller Detection Technology and thus undesirable UAC elevation describedinthis Microsoft article.

0.6.36

• Pull Request #35: InBuildout #64, it was reported thatunder Python 3, installation of distutils scripts could attempt to copythe__pycache__ directory as a file, causing an error, apparently onlyunder Windows. Easy_install now skips all directories when processingmetadata scripts.

0.6.35

Note this release is backward-incompatible with distribute 0.6.23-0.6.34 inhow it parses version numbers.

• Distribute #278: Restored compatibility with distribute 0.6.22 and setuptools0.6. Updated the documentation to match more closely with the versionparsing as intended in setuptools 0.6.

0.6.34

• Distribute #341: 0.6.33 fails to build under Python 2.4.

0.6.33

• Fix 2 errors with Jython 2.5.

• Fix 1 failure with Jython 2.5 and 2.7.

• Disable workaround for Jython scripts on Linux systems.

• Distribute #336:setup.py no longer masks failure exit code when tests fail.

• Fix issue in pkg_resources where try/except around a platform-dependentimport would trigger hook load failures on Mercurial. See pull request 32for details.

• Distribute #341: Fix a ResourceWarning.

0.6.32

• Fix test suite with Python 2.6.

• Fix some DeprecationWarnings and ResourceWarnings.

• Distribute #335: Backed outsetup_requires superceding installed requirementsuntil regression can be addressed.

0.6.31

• Distribute #303: Make sure the manifest only ever contains UTF-8 in Python 3.

• Distribute #329: Properly close files created by tests for compatibility withJython.

• Work aroundJython #1980 andJython #1981.

• Distribute #334: Provide workaround for packages that referencesys.__stdout__such as numpy does. This change should addressvirtualenv `#359 <https://github.com/pypa/virtualenv/issues/359>`_ as longas the system encoding is UTF-8 or the IO encoding is specified in theenvironment, i.e.:

  PYTHONIOENCODING=utf8 pip install numpy

• Fix for encoding issue when installing from Windows executable on Python 3.

• Distribute #323: Allowsetup_requires requirements to supercede installedrequirements. Added some new keyword arguments to existing pkg_resourcesmethods. Also had to updated how __path__ is handled for namespace packagesto ensure that when a new egg distribution containing a namespace package isplaced on sys.path, the entries in __path__ are found in the same order theywould have been in had that egg been on the path when pkg_resources wasfirst imported.

0.6.30

• Distribute #328: Clean up temporary directories in distribute_setup.py.

• Fix fatal bug in distribute_setup.py.

0.6.29

• Pull Request #14: Honor file permissions in zip files.

• Distribute #327: Merged pull request#24 to fix a dependency problem with pip.

• Merged pull request#23 to fixhttps://github.com/pypa/virtualenv/issues/301.

• If Sphinx is installed, theupload_docs command now runsbuild_sphinxto produce uploadable documentation.

• Distribute #326:upload_docs provided mangled auth credentials under Python 3.

• Distribute #320: Fix check for “createable” in distribute_setup.py.

• Distribute #305: Remove a warning that was triggered during normal operations.

• Distribute #311: Print metadata in UTF-8 independent of platform.

• Distribute #303: Read manifest file with UTF-8 encoding under Python 3.

• Distribute #301: Allow to run tests of namespace packages when using 2to3.

• Distribute #304: Prevent import loop in site.py under Python 3.3.

• Distribute #283: Reenable scanning of*.pyc /*.pyo files on Python 3.3.

• Distribute #299: The develop command didn’t work on Python 3, when using 2to3,as the egg link would go to the Python 2 source. Linking to the 2to3’d codein build/lib makes it work, although you will have to rebuild the modulebefore testing it.

• Distribute #306: Even if 2to3 is used, we build in-place under Python 2.

• Distribute #307: Prints the full path when .svn/entries is broken.

• Distribute #313: Support for sdist subcommands (Python 2.7)

• Distribute #314: test_local_index() would fail an OS X.

• Distribute #310: Non-ascii characters in a namespace __init__.py causes errors.

• Distribute #218: Improved documentation on behavior ofpackage_data andinclude_package_data. Files indicated bypackage_data are now includedin the manifest.

• distribute_setup.py now allows a–download-base argument for retrievingdistribute from a specified location.

0.6.28

• Distribute #294: setup.py can now be invoked from any directory.

• Scripts are now installed honoring the umask.

• Added support for .dist-info directories.

• Distribute #283: Fix and disable scanning of*.pyc /*.pyo files onPython 3.3.

0.6.27

• Support current snapshots of CPython 3.3.

• Distribute now recognizes README.rst as a standard, default readme file.

• Exclude ‘encodings’ modules when removing modules from sys.modules.Workaround for#285.

• Distribute #231: Don’t fiddle with system python when used with buildout(bootstrap.py)

0.6.26

• Distribute #183: Symlinked files are now extracted from source distributions.

• Distribute #227: Easy_install fetch parameters are now passed during theinstallation of a source distribution; now fulfillment of setup_requiresdependencies will honor the parameters passed to easy_install.

0.6.25

• Distribute #258: Workaround a cache issue

• Distribute #260: distribute_setup.py now accepts the –user parameter forPython 2.6 and later.

• Distribute #262: package_index.open_with_auth no longer throws LookupErroron Python 3.

• Distribute #269: AttributeError when an exception occurs reading Manifest.inon late releases of Python.

• Distribute #272: Prevent TypeError when namespace package names are unicodeand single-install-externally-managed is used. Also fixes PIP issue449.

• Distribute #273: Legacy script launchers now install with Python2/3 support.

0.6.24

• Distribute #249: Added options to exclude 2to3 fixers

0.6.23

• Distribute #244: Fixed a test

• Distribute #243: Fixed a test

• Distribute #239: Fixed a test

• Distribute #240: Fixed a test

• Distribute #241: Fixed a test

• Distribute #237: Fixed a test

• Distribute #238: easy_install now uses 64bit executable wrappers on 64bit Python

• Distribute #208: Fixed parsed_versions, it now honors post-releases as noted in the documentation

• Distribute #207: Windows cli and gui wrappers pass CTRL-C to child python process

• Distribute #227: easy_install now passes its arguments to setup.py bdist_egg

• Distribute #225: Fixed a NameError on Python 2.5, 2.4

0.6.21

• Distribute #225: FIxed a regression on py2.4

0.6.20

• Distribute #135: Include url in warning when processing URLs in package_index.

• Distribute #212: Fix issue where easy_instal fails on Python 3 on windows installer.

• Distribute #213: Fix typo in documentation.

0.6.19

• Distribute #206: AttributeError: ‘HTTPMessage’ object has no attribute ‘getheaders’

0.6.18

• Distribute #210: Fixed a regression introduced byDistribute #204 fix.

0.6.17

• Support ‘DISTRIBUTE_DISABLE_VERSIONED_EASY_INSTALL_SCRIPT’ environmentvariable to allow to disable installation of easy_install-${version} script.

• Support Python >=3.1.4 and >=3.2.1.

• Distribute #204: Don’t try to import the parent of a namespace package indeclare_namespace

• Distribute #196: Tolerate responses with multiple Content-Length headers

• Distribute #205: Sandboxing doesn’t preserve working_set. Leads to setup_requiresproblems.

0.6.16

• Builds sdist gztar even on Windows (avoidingDistribute #193).

• Distribute #192: Fixed metadata omitted on Windows when package_dirspecified with forward-slash.

• Distribute #195: Cython build support.

• Distribute #200: Issues with recognizing 64-bit packages on Windows.

0.6.15

• Fixed typo in bdist_egg

• Several issues under Python 3 has been solved.

• Distribute #146: Fixed missing DLL files after easy_install of windows exe package.

0.6.14

• Distribute #170: Fixed unittest failure. Thanks to Toshio.

• Distribute #171: Fixed race condition in unittests cause deadlocks in test suite.

• Distribute #143: Fixed a lookup issue with easy_install.Thanks to David and Zooko.

• Distribute #174: Fixed the edit mode when its used with setuptools itself

0.6.13

• Distribute #160: 2.7 gives ValueError(“Invalid IPv6 URL”)

• Distribute #150: Fixed using ~/.local even in a –no-site-packages virtualenv

• Distribute #163: scan index links before external links, and don’t use the md5 whencomparing two distributions

0.6.12

• Distribute #149: Fixed various failures on 2.3/2.4

0.6.11

• Found another case of SandboxViolation - fixed

• Distribute #15 andDistribute #48: Introduced a socket timeout of 15 seconds on url openings

• Added indexsidebar.html into MANIFEST.in

• Distribute #108: Fixed TypeError with Python3.1

• Distribute #121: Fixed –help install command trying to actually install.

• Distribute #112: Added an os.makedirs so that Tarek’s solution will work.

• Distribute #133: Added –no-find-links to easy_install

• Added easy_install –user

• Distribute #100: Fixed develop –user not taking ‘.’ in PYTHONPATH into account

• Distribute #134: removed spurious UserWarnings. Patch by VanLindberg

• Distribute #138: cant_write_to_target error when setup_requires is used.

• Distribute #147: respect the sys.dont_write_bytecode flag

0.6.10

• Reverted change made for the DistributionNotFound exception becausezc.buildout uses the exception message to get the name of thedistribution.

0.6.9

• Distribute #90: unknown setuptools version can be added in the working set

• Distribute #87: setupt.py doesn’t try to convert distribute_setup.py anymoreInitial Patch by arfrever.

• Distribute #89: added a side bar with a download link to the doc.

• Distribute #86: fixed missing sentence in pkg_resources doc.

• Added a nicer error message when a DistributionNotFound is raised.

• Distribute #80: test_develop now works with Python 3.1

• Distribute #93: upload_docs now works if there is an empty sub-directory.

• Distribute #70: exec bit on non-exec files

• Distribute #99: now the standalone easy_install command doesn’t uses a“setup.cfg” if any exists in the working directory. It will use itonly if triggered byinstall_requires from a setup.py call(install, develop, etc).

• Distribute #101: Allowingos.devnull in Sandbox

• Distribute #92: Fixed the “no eggs” found error with MacPort(platform.mac_ver() fails)

• Distribute #103: test_get_script_header_jython_workaround not runanymore under py3 with C or POSIX local. Contributed by Arfrever.

• Distribute #104: remvoved the assertion when the installation fails,with a nicer message for the end user.

• Distribute #100: making sure there’s no SandboxViolation whenthe setup script patches setuptools.

0.6.8

• Added “check_packages” in dist. (added in Setuptools 0.6c11)

• Fixed the DONT_PATCH_SETUPTOOLS state.

0.6.7

• Distribute #58: Added –user support to the develop command

• Distribute #11: Generated scripts now wrap their call to the script entry pointin the standard “if name == ‘main’”

• Added the ‘DONT_PATCH_SETUPTOOLS’ environment variable, so virtualenvcan drive an installation that doesn’t patch a global setuptools.

• Reviewed unladen-swallow specific change fromhttp://code.google.com/p/unladen-swallow/source/detail?spec=svn875&r=719and determined that it no longer applies. Distribute should work fine withUnladen Swallow 2009Q3.

• Distribute #21: Allow PackageIndex.open_url to gracefully handle all cases of ahttplib.HTTPException instead of just InvalidURL and BadStatusLine.

• Removed virtual-python.py from this distribution and updated documentationto point to the actively maintained virtualenv instead.

• Distribute #64: use_setuptools no longer rebuilds the distribute egg everytime it is run

• use_setuptools now properly respects the requested version

• use_setuptools will no longer try to import a distribute egg for thewrong Python version

• Distribute #74: no_fake should be True by default.

• Distribute #72: avoid a bootstrapping issue with easy_install -U

0.6.6

• Unified the bootstrap file so it works on both py2.x and py3k without 2to3(patch by Holger Krekel)

0.6.5

• Distribute #65: cli.exe and gui.exe are now generated at build time,depending on the platform in use.

• Distribute #67: Fixed doc typo (PEP 381/382)

• Distribute no longer shadows setuptools if we require a 0.7-seriessetuptools. And an error is raised when installing a 0.7 setuptools withdistribute.

• When run from within buildout, no attempt is made to modify an existingsetuptools egg, whether in a shared egg directory or a system setuptools.

• Fixed a hole in sandboxing allowing builtin file to write outside ofthe sandbox.

0.6.4

• Added the generation ofdistribute_setup_3k.py during the release.This closesDistribute #52.

• Added an upload_docs command to easily upload project documentation toPyPI’shttps://pythonhosted.org. This close issueDistribute #56.

• Fixed a bootstrap bug on the use_setuptools() API.

0.6.3

0.6.2

0.6.1

0.6

0.6c9

• Fixed a missing files problem when using Windows source distributions onnon-Windows platforms, due to distutils not handling manifest file lineendings correctly.

• Updated Pyrex support to work with Pyrex 0.9.6 and higher.

• Minor changes for Jython compatibility, including skipping tests that can’twork on Jython.

• Fixed not installing eggs ininstall_requires if they were also used forsetup_requires ortests_require.

• Fixed not fetching eggs ininstall_requires when running tests.

• Allowez_setup.use_setuptools() to upgrade existing setuptoolsinstallations when called from a standalonesetup.py.

• Added a warning if a namespace package is declared, but its parent packageis not also declared as a namespace.

• Support Subversion 1.5

• Removed use of deprecatedmd5 module ifhashlib is available

• Fixedbdist_wininst upload trying to upload the.exe twice

• Fixedbdist_egg putting anative_libs.txt in the source package’s.egg-info, when it should only be in the built egg’sEGG-INFO.

• Ensure that _full_name is set on all shared libs before extensions arechecked for shared lib usage. (Fixes a bug in the experimental sharedlibrary build support.)

• Fix to allow unpacked eggs containing native libraries to fail moregracefully under Google App Engine (with anImportError loading theC-based module, instead of getting aNameError).

0.6c7

• Fixeddistutils.filelist.findall() crashing on broken symlinks, andegg_info command failing on new, uncommitted SVN directories.

• Fix import problems with nested namespace packages installed via--root or--single-version-externally-managed, due to theparent package not having the child package as an attribute.

0.6c6

• Added--egg-path option todevelop command, allowing you to force.egg-link files to use relative paths (allowing them to be shared acrossplatforms on a networked drive).

• Fix not building binary RPMs correctly.

• Fix “eggsecutables” (such as setuptools’ own egg) only being runnable withbash-compatible shells.

• Fix#! parsing problems in Windows.exe script wrappers, when therewas whitespace inside a quoted argument or at the end of the#! line(a regression introduced in 0.6c4).

• Fixtest command possibly failing if an older version of the projectbeing tested was installed onsys.path ahead of the test sourcedirectory.

• Fixfind_packages() treatingez_setup and directories with. intheir names as packages.

0.6c5

• Fix uploadedbdist_rpm packages being described asbdist_eggpackages under Python versions less than 2.5.

• Fix uploadedbdist_wininst packages being described as suitable for“any” version by Python 2.5, even if a--target-version was specified.

0.6c4

• Overhauled Windows script wrapping to supportbdist_wininst better.Scripts installed withbdist_wininst will always use#!python.exe or#!pythonw.exe as the executable name (even when built on non-Windowsplatforms!), and the wrappers will look for the executable in the script’sparent directory (which should find the right version of Python).

• Fixupload command not uploading files built bybdist_rpm orbdist_wininst under Python 2.3 and 2.4.

• Add support for “eggsecutable” headers: a#!/bin/sh script that isprepended to an.egg file to allow it to be run as a script on Unix-ishplatforms. (This is mainly so that setuptools itself can have a single-fileinstaller on Unix, without doing multiple downloads, dealing with firewalls,etc.)

• Fix problem with empty revision numbers in Subversion 1.4entries files

• Use cross-platform relative paths ineasy-install.pth when doingdevelop and the source directory is a subdirectory of the installationtarget directory.

• Fix a problem installing eggs with a system packaging tool if the projectcontained an implicit namespace package; for example if thesetup()listed a namespace packagefoo.bar without explicitly listingfooas a namespace package.

0.6c3

• Fixed breakages caused by Subversion 1.4’s new “working copy” format

0.6c2

• Theez_setup module displays the conflicting version of setuptools (andits installation location) when a script requests a version that’s notavailable.

• Runningsetup.py develop on a setuptools-using project will now installsetuptools if needed, instead of only downloading the egg.

0.6c1

• FixedAttributeError when trying to download asetup_requiresdependency when a distribution lacks adependency_links setting.

• Madezip-safe andnot-zip-safe flag files contain a single byte, soas to play better with packaging tools that complain about zero-lengthfiles.

• Madesetup.py develop respect the--no-deps option, which itpreviously was ignoring.

• Supportextra_path option tosetup() wheninstall is run inbackward-compatibility mode.

• Source distributions now always include asetup.cfg file that explicitlysetsegg_info options such that they produce an identical version numberto the source distribution’s version number. (Previously, the defaultversion number could be different due to the use of--tag-date, or ifthe version was overridden on the command line that built the sourcedistribution.)

0.6b4

• Fixregister not obeying name/version set byegg_info command, ifegg_info wasn’t explicitly run first on the same command line.

• Added--no-date and--no-svn-revision options toegg_infocommand, to allow suppressing tags configured insetup.cfg.

• Fixed redundant warnings about missingREADME file(s); it should nowappear only if you are actually a source distribution.

0.6b3

• Fixbdist_egg not including files in subdirectories of.egg-info.

• Allow.py files found by theinclude_package_data option to beautomatically included. Remove duplicate data file matches if bothinclude_package_data andpackage_data are used to refer to the samefiles.

0.6b1

• Stripmodule from the end of compiled extension modules when computingthe name of a.py loader/wrapper. (Python’s import machinery ignoresthis suffix when searching for an extension module.)

0.6a11

• Addedtest_loader keyword to support custom test loaders

• Addedsetuptools.file_finders entry point group to allow implementingrevision control plugins.

• Added--identity option toupload command.

• Addeddependency_links to allow specifying URLs for--find-links.

• Enhanced test loader to scan packages as well as modules, and calladditional_tests() if present to get non-unittest tests.

• Support namespace packages in conjunction with system packagers, by omittingthe installation of any__init__.py files for namespace packages, andadding a special.pth file to create a working package insys.modules.

• Made--single-version-externally-managed automatic when--root isused, so that most system packagers won’t require special support forsetuptools.

• Fixedsetup_requires,tests_require, etc. not usingsetup.cfg orother configuration files for their option defaults when installing, andalso made the install use--multi-version mode so that the projectdirectory doesn’t need to support .pth files.

• MANIFEST.in is now forcibly closed when any errors occur while readingit. Previously, the file could be left open and the actual error would bemasked by problems trying to remove the open file on Windows systems.

0.6a10

• Fixed thedevelop command ignoring--find-links.

0.6a9

• Thesdist command no longer uses the traditionalMANIFEST file tocreate source distributions.MANIFEST.in is still read and processed,as are the standard defaults and pruning. But the manifest is built insidethe project’s.egg-info directory asSOURCES.txt, and it is rebuiltevery time theegg_info command is run.

• Added theinclude_package_data keyword tosetup(), allowing you toautomatically include any package data listed in revision control orMANIFEST.in

• Added theexclude_package_data keyword tosetup(), allowing you totrim back files included via thepackage_data andinclude_package_data options.

• Fixed--tag-svn-revision not working when run from a sourcedistribution.

• Added warning for namespace packages with missingdeclare_namespace()

• Addedtests_require keyword tosetup(), so that e.g. packagesrequiringnose to run unit tests can make this dependency optionalunless thetest command is run.

• Made all commands that useeasy_install respect its configurationoptions, as this was causing some problems withsetup.py install.

• Added anunpack_directory() driver tosetuptools.archive_util, sothat you can process a directory tree through a processing filter as if itwere a zipfile or tarfile.

• Added an internalinstall_egg_info command to use as part of old-styleinstall operations, that installs an.egg-info directory with thepackage.

• Added a--single-version-externally-managed option to theinstallcommand so that you can more easily wrap a “flat” egg in a system package.

• Enhancedbdist_rpm so that it installs single-version eggs thatdon’t rely on a.pth file. The--no-egg option has been removed,since all RPMs are now built in a more backwards-compatible format.

• Support full roundtrip translation of eggs to and frombdist_wininstformat. Runningbdist_wininst on a setuptools-based package wraps theegg in an .exe that will safely install it as an egg (i.e., with metadataand entry-point wrapper scripts), andeasy_install can turn the .exeback into an.egg file or directory and install it as such.

0.6a8

• Fixed some problems building extensions when Pyrex was installed, especiallywith Python 2.4 and/or packages using SWIG.

• Madedevelop command accept all the same options aseasy_install,and use theeasy_install command’s configuration settings as defaults.

• Madeegg_info--tag-svn-revision fall back to extracting the revisionnumber fromPKG-INFO in case it is being run on a source distribution ofa snapshot taken from a Subversion-based project.

• Automatically detect.dll,.so and.dylib files that are beinginstalled as data, adding them tonative_libs.txt automatically.

• Fixed some problems with fresh checkouts of projects that don’t include.egg-info/PKG-INFO under revision control and put the project’s sourcecode directly in the project directory. If such a package had anyrequirements that get processed before theegg_info command can be run,the setup scripts would fail with a “Missing ‘Version:’ header and/orPKG-INFO file” error, because the egg runtime interpreted the unbuiltmetadata in a directory onsys.path (i.e. the current directory) asbeing a corrupted egg. Setuptools now monkeypatches the distributionmetadata cache to pretend that the egg has valid version information, untilit has a chance to make it actually be so (via theegg_info command).

0.6a5

• Fixed missing gui/cli .exe files in distribution. Fixed bugs in tests.

0.6a3

• Addedgui_scripts entry point group to allow installing GUI scriptson Windows and other platforms. (The special handling is only for Windows;other platforms are treated the same as forconsole_scripts.)

0.6a2

• Addedconsole_scripts entry point group to allow installing scriptswithout the need to create separate script files. On Windows, consolescripts get an.exe wrapper so you can just type their name. On otherplatforms, the scripts are written without a file extension.

0.6a1

• Added support for building “old-style” RPMs that don’t install an egg forthe target package, using a--no-egg option.

• Thebuild_ext command now works better when using the--inplaceoption and multiple Python versions. It now makes sure that all extensionsmatch the current Python version, even if newer copies were built for adifferent Python version.

• Theupload command no longer attaches an extra.zip when uploadingeggs, as PyPI now supports egg uploads without trickery.

• Theez_setup script/module now displays a warning before downloadingthe setuptools egg, and attempts to check the downloaded egg against aninternal MD5 checksum table.

• Fixed the--tag-svn-revision option ofegg_info not finding thelatest revision number; it was using the revision number of the directorycontainingsetup.py, not the highest revision number in the project.

• Addedeager_resources setup argument

• Thesdist command now recognizes Subversion “deleted file” entries anddoes not include them in source distributions.

• setuptools now embeds itself more thoroughly into the distutils, so thatother distutils extensions (e.g. py2exe, py2app) will subclass setuptools’versions of things, rather than the native distutils ones.

• Addedentry_points andsetup_requires arguments tosetup();setup_requires allows you to automatically find and download packagesthat are needed in order tobuild your project (as opposed to running it).

• setuptools now finds its commands,setup() argument validators, andmetadata writers using entry points, so that they can be extended bythird-party packages. SeeCreating distutils Extensionsfor more details.

• The vestigialdepends command has been removed. It was never finishedor documented, and never would have worked without EasyInstall - which itpre-dated and was never compatible with.

0.5a12

• The zip-safety scanner now checks for modules that might be used withpython-m, and marks them as unsafe for zipping, since Python 2.4 can’thandle-m on zipped modules.

0.5a11

• Fix breakage of the “develop” command that was caused by the addition of--always-unzip to theeasy_install command.

0.5a9

• Includesvn:externals directories in source distributions as well asnormal subversion-controlled files and directories.

• Addedexclude=patternlist option tosetuptools.find_packages()

• Changed –tag-svn-revision to include an “r” in front of the revision numberfor better readability.

• Added ability to build eggs without including source files (except for anyscripts, of course), using the--exclude-source-files option tobdist_egg.

• setup.py install now automatically detects when an “unmanaged” packageor module is going to be onsys.path ahead of a package being installed,thereby preventing the newer version from being imported. If this occurs,a warning message is output tosys.stderr, but installation proceedsanyway. The warning message informs the user what files or directoriesneed deleting, and advises them they can also use EasyInstall (with the--delete-conflicting option) to do it automatically.

• Theegg_info command now adds atop_level.txt file to the metadatadirectory that lists all top-level modules and packages in the distribution.This is used by theeasy_install command to find possibly-conflicting“unmanaged” packages when installing the distribution.

• Addedzip_safe andnamespace_packages arguments tosetup().Added package analysis to determine zip-safety if thezip_safe flagis not given, and advise the author regarding what code might need changing.

• Fixed the swapped-d and-b options ofbdist_egg.

0.5a8

• The “egg_info” command now always sets the distribution metadata to “safe”forms of the distribution name and version, so that distribution files willbe generated with parseable names (i.e., ones that don’t include ‘-’ in thename or version). Also, this means that if you use the various--tagoptions of “egg_info”, any distributions generated will use the tags in theversion, not just egg distributions.

• Added support for defining command aliases in distutils configuration files,under the “[aliases]” section. To prevent recursion and to allow aliases tocall the command of the same name, a given alias can be expanded only onceper command-line invocation. You can define new aliases with the “alias”command, either for the local, global, or per-user configuration.

• Added “rotate” command to delete old distribution files, given a set ofpatterns to match and the number of files to keep. (Keeps the mostrecently-modified distribution files matching each pattern.)

• Added “saveopts” command that saves all command-line options for the currentinvocation to the local, global, or per-user configuration file. Useful forsetting defaults without having to hand-edit a configuration file.

• Added a “setopt” command that sets a single option in a specified distutilsconfiguration file.

0.5a7

• Added “upload” support for egg and source distributions, including a bugfix for “upload” and a temporary workaround for lack of .egg support inPyPI.

0.5a6

• Beefed up the “sdist” command so that if you don’t have a MANIFEST.in, itwill include all files under revision control (CVS or Subversion) in thecurrent directory, and it will regenerate the list every time you create asource distribution, not just when you tell it to. This should make thedefault “do what you mean” more often than the distutils’ default behaviordid, while still retaining the old behavior in the presence of MANIFEST.in.

• Fixed the “develop” command always updating .pth files, even if youspecified-n or--dry-run.

• Slightly changed the format of the generated version when you use--tag-build on the “egg_info” command, so that you can make taggedrevisions comparelower than the version specified in setup.py (e.g. byusing--tag-build=dev).

0.5a5

• Addeddevelop command tosetuptools-based packages. This commandinstalls an.egg-link pointing to the package’s source directory, andscript wrappers thatexecfile() the source versions of the package’sscripts. This lets you put your development checkout(s) on sys.path withouthaving to actually install them. (To uninstall the link, useusesetup.py develop--uninstall.)

• Addedegg_info command tosetuptools-based packages. This commandjust creates or updates the “projectname.egg-info” directory, withoutbuilding an egg. (It’s used by thebdist_egg,test, anddevelopcommands.)

• Enhanced thetest command so that it doesn’t install the package, butinstead builds any C extensions in-place, updates the.egg-infometadata, adds the source directory tosys.path, and runs the testsdirectly on the source. This avoids an “unmanaged” installation of thepackage tosite-packages or elsewhere.

• Madeeasy_install a standardsetuptools command, moving it fromtheeasy_install module tosetuptools.command.easy_install. Notethat if you were importing or extending it, you must now change your importsaccordingly.easy_install.py is still installed as a script, but not asa module.

0.5a4

• Setup scripts using setuptools can now list their dependencies directly inthe setup.py file, without having to manually create adepends.txt file.Theinstall_requires andextras_require arguments tosetup()are used to create a dependencies file automatically. If you are manuallycreatingdepends.txt right now, please switch to using these setuparguments as soon as practical, becausedepends.txt support will beremoved in the 0.6 release cycle. For documentation on the new arguments,see thesetuptools.dist.Distribution class.

• Setup scripts using setuptools now always install usingeasy_installinternally, for ease of uninstallation and upgrading.

0.5a1

• Added support for “self-installation” bootstrapping. Packages can nowincludeez_setup.py in their source distribution, and add the followingto theirsetup.py, in order to automatically bootstrap installation ofsetuptools as part of their setup process:

  from ez_setup import use_setuptoolsuse_setuptools()from setuptools import setup# etc...

0.4a2

• Addedez_setup.py installer/bootstrap script to make initial setuptoolsinstallation easier, and to allow distributions using setuptools to avoidhaving to include setuptools in their source distribution.

• All downloads are now managed by thePackageIndex class (which is nowsubclassable and replaceable), so that embedders can more easily overridedownload logic, give download progress reports, etc. The class has alsobeen moved to the newsetuptools.package_index module.

• TheInstaller class no longer handles downloading, manages a temporarydirectory, or tracks thezip_ok option. Downloading is now handledbyPackageIndex, andInstaller has become aneasy_installcommand class based onsetuptools.Command.

• There is a newsetuptools.sandbox.run_setup() API to invoke a setupscript in a directory sandbox, and a newsetuptools.archive_util modulewith anunpack_archive() API. These were split out of EasyInstall toallow reuse by other tools and applications.

• setuptools.Command now supports reinitializing commands using keywordarguments to set/reset options. Also,Command subclasses can now settheircommand_consumes_arguments attribute toTrue in order toreceive anargs option containing the rest of the command line.

0.3a2

• Added new options tobdist_egg to allow tagging the egg’s version numberwith a subversion revision number, the current date, or an explicit tagvalue. Runsetup.py bdist_egg--help to get more information.

• Misc. bug fixes

0.3a1

• Initial release.