more notes and details for BoF work
This commit is contained in:
parent
93d51f0bb6
commit
dc0a70fa9b
36
pep-0376.txt
36
pep-0376.txt
|
@ -218,6 +218,8 @@ Let's use it with our `zlib` example::
|
||||||
Adding an install and an uninstall script
|
Adding an install and an uninstall script
|
||||||
=========================================
|
=========================================
|
||||||
|
|
||||||
|
XXX decide wheter we include these scripts.
|
||||||
|
|
||||||
`easy_install` and `pip` does basically the same work, besides other features
|
`easy_install` and `pip` does basically the same work, besides other features
|
||||||
that are not discussed here.
|
that are not discussed here.
|
||||||
|
|
||||||
|
@ -226,19 +228,49 @@ that are not discussed here.
|
||||||
- they install it inside the site-packages directory
|
- they install it inside the site-packages directory
|
||||||
- they add an entry in a .pth file
|
- they add an entry in a .pth file
|
||||||
|
|
||||||
|
Distutils will provide two simple reference scripts, that are just able
|
||||||
|
to do the features mentioned. Third party packages will be able to fetch
|
||||||
|
dependencies.
|
||||||
|
|
||||||
|
Install script
|
||||||
|
--------------
|
||||||
|
|
||||||
A new script called `install.py` is added in a new directory called `scripts`
|
A new script called `install.py` is added in a new directory called `scripts`
|
||||||
in Distutils, and lets people run an installation using::
|
in Distutils, and lets people run an installation using::
|
||||||
|
|
||||||
$ python -m distutils.scripts.install zlib
|
$ python -m distutils.scripts.install zlib
|
||||||
|
|
||||||
|
Where `zlib` can be:
|
||||||
|
- the name of the package
|
||||||
|
- an url of an archive
|
||||||
|
- a path
|
||||||
|
|
||||||
|
The install script process is done in 3 steps:
|
||||||
|
|
||||||
|
1. it looks for the package at PyPI if it's a package name
|
||||||
|
XXX explain here how (easy_install code)
|
||||||
|
2. it downloads it in a temporary directory (or copy it if it's a path)
|
||||||
|
3. it runs the install command, with the --record option
|
||||||
|
XXX explains here how (see pip code)
|
||||||
|
|
||||||
|
The install script takes several options :
|
||||||
|
|
||||||
|
Uninstall script
|
||||||
|
----------------
|
||||||
|
|
||||||
An uninstall command is added as well that removes the files recorded
|
An uninstall command is added as well that removes the files recorded
|
||||||
in the RECORD file. This removal will warn on files that no longer exist
|
in the RECORD file. This removal will warn on files that no longer exist
|
||||||
and will not take care of side effects, like the removal of a file
|
and will not take care of side effects, like the removal of a file
|
||||||
used by another element of the system.
|
used by another element of the system.
|
||||||
|
|
||||||
XXX work to be done here : specification of the two commands
|
$ python -m distutils.scripts.uninstall zlib
|
||||||
(probably a mix of easy_install and pip)
|
|
||||||
|
|
||||||
|
XXX work to be done here : detail specification of the uninstall process
|
||||||
|
|
||||||
|
Aknowledgments
|
||||||
|
==============
|
||||||
|
|
||||||
|
Jim Fulton, Ian Bicking, Phillip Eby, and many people at Pycon and Distutils-SIG.
|
||||||
|
|
||||||
Copyright
|
Copyright
|
||||||
=========
|
=========
|
||||||
|
|
Loading…
Reference in New Issue