iSharkFly-Open
/
python-peps
mirror of https://github.com/python/peps.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

minor fixes

This commit is contained in:
Tarek Ziadé 2010-04-26 21:36:54 +00:00
parent 5677f923a6
commit 1dfaf5580f
1 changed files with 13 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
pep-0376.txt
View File

@ -486,15 +486,15 @@ Distutils already provides a very basic way to install a distribution, which
is running the `install` command over the `setup.py` script of the
distribution.
Distutils will provide a very basic ``uninstall`` function, that is added
in ``distutils.util`` and takes the name of the distribution to uninstall
as its argument. ``uninstall`` uses the APIs described earlier and remove all
unique files, as long as their hash didn't change. Then it removes empty
directories left behind.
Distutils2 [#pep262]_ will provide a very basic ``uninstall`` function, that
is added in ``distutils2.util`` and takes the name of the distribution to
uninstall as its argument. ``uninstall`` uses the APIs described earlier and
remove all unique files, as long as their hash didn't change. Then it removes
empty directories left behind.
``uninstall`` returns a list of uninstalled files::
>>> from distutils.util import uninstall
>>> from distutils2.util import uninstall
>>> uninstall('docutils')
['/opt/local/lib/python2.6/site-packages/docutils/core.py',
...
@ -535,7 +535,7 @@ file in the `.dist-info` directory with the name of the installer.
To avoid removing distributions that were installed by another packaging
system, the ``uninstall`` function takes an extra argument ``installer`` which
defaults to ``distutils``.
defaults to ``distutils2``.
When called, ``uninstall`` controls that the ``INSTALLER`` file matches
this argument. If not, it raises a ``DistutilsUninstallError``::
@ -556,9 +556,9 @@ it has to undo at uninstallation time.
Adding an Uninstall script
~~~~~~~~~~~~~~~~~~~~~~~~~~
An `uninstall` script is added in Distutils. and is used like this::
An `uninstall` script is added in Distutils2. and is used like this::
$ python -m distutils.uninstall projectname
$ python -m distutils2.uninstall projectname
Notice that script doesn't control if the removal of a distribution breaks
another distribution. Although it makes sure that all the files it removes
@ -578,7 +578,7 @@ will be implemented in:
- distutils2
The plan is to include the functionality outlined in this PEP in pkgutil for
Python 2.7 and Python 3.2, and in Distutils2.
Python 3.2, and in Distutils2.
Distutils2 will also contain a backport of the new pgkutil, and can be used for
2.4 onward.
@ -595,6 +595,9 @@ References
.. [#distutils]
http://docs.python.org/distutils
.. [#distutils2]
http://hg.python.org/distutils2
.. [#pep262]
http://www.python.org/dev/peps/pep-0262