diff options
author | PJ Eby <distutils-sig@python.org> | 2005-07-10 04:49:31 +0000 |
---|---|---|
committer | PJ Eby <distutils-sig@python.org> | 2005-07-10 04:49:31 +0000 |
commit | 451377d0e877fc610d1bdf8181ba70a90e4c14cc (patch) | |
tree | 89e0ecc02b8040a747eee92971c0166e63e9e6b2 /setuptools.txt | |
parent | 74f597fec6a91b8305177461e7c25bb231999e61 (diff) | |
download | external_python_setuptools-451377d0e877fc610d1bdf8181ba70a90e4c14cc.tar.gz external_python_setuptools-451377d0e877fc610d1bdf8181ba70a90e4c14cc.tar.bz2 external_python_setuptools-451377d0e877fc610d1bdf8181ba70a90e4c14cc.zip |
Detect and handle conflicts with "unmanaged" packages when installing
packages managed by EasyInstall. Also, add an option to exclude source
files from .egg distributions.
--HG--
branch : setuptools
extra : convert_revision : svn%3A6015fed2-1504-0410-9fe1-9d1591cc4771/sandbox/trunk/setuptools%4041109
Diffstat (limited to 'setuptools.txt')
-rwxr-xr-x | setuptools.txt | 36 |
1 files changed, 33 insertions, 3 deletions
diff --git a/setuptools.txt b/setuptools.txt index ae6a7c26..00affdbe 100755 --- a/setuptools.txt +++ b/setuptools.txt @@ -570,7 +570,7 @@ the new egg file's metadata directory, for use by the egg runtime system or by any applications or frameworks that use that metadata. You won't usually need to specify any special options for this command; just -use ``bdist_egg`` and you're done. But there are a couple of options that may +use ``bdist_egg`` and you're done. But there are a few options that may be occasionally useful: ``--dist-dir=DIR, -d DIR`` @@ -590,6 +590,19 @@ be occasionally useful: cross-compiling or doing some other unusual things, you might find a use for this option. +``--exclude-source-files`` + Don't include any modules' ``.py`` files in the egg, just compiled Python, + C, and data files. (Note that this doesn't affect any ``.py`` files in the + EGG-INFO directory or its subdirectories, since for example there may be + scripts with a ``.py`` extension which must still be retained.) We don't + recommend that you use this option except for packages that are being + bundled for proprietary end-user applications, or for "embedded" scenarios + where space is at an absolute premium. On the other hand, if your package + is going to be installed and used in compressed form, you might as well + exclude the source because Python's ``traceback`` module doesn't currently + understand how to display zipped source code anyway, or how to deal with + files that are in a different place from where their code was compiled. + There are also some options you will probably never need, but which are there because they were copied from similar ``bdist`` commands used as an example for creating this one. They may be useful for testing and debugging, however, @@ -726,8 +739,8 @@ to temporarily change the project's version string. The following options can be used to modify the project's version string for all remaining commands on the setup command line. The options are processed -in the order shown, so if you use more than one, the request tags will be added -in the following order: +in the order shown, so if you use more than one, the requested tags will be +added in the following order: ``--tag-build=NAME, -b NAME`` Append NAME to the project's version string. Due to the way setuptools @@ -1049,6 +1062,23 @@ Release Notes/Change History * Changed --tag-svn-revision to include an "r" in front of the revision number for better readability. + * Added ability to build eggs without including source files (except for any + scripts, of course), using the ``--exclude-source-files`` option to + ``bdist_egg``. + + * ``setup.py install`` now automatically detects when an "unmanaged" package + or module is going to be on ``sys.path`` ahead of a package being installed, + thereby preventing the newer version from being imported. If this occurs, + a warning message is output to ``sys.stderr``, but installation proceeds + anyway. The warning message informs the user what files or directories + need deleting, and advises them they can also use EasyInstall (with the + ``--delete-conflicting`` option) to do it automatically. + + * The ``egg_info`` command now adds a ``top_level.txt`` file to the metadata + directory that lists all top-level modules and packages in the distribution. + This is used by the ``easy_install`` command to find possibly-conflicting + "unmanaged" packages when installing the distribution. + 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 will |