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

add Obsoleted-By

This commit is contained in:
Daniel Holth 2013-01-14 21:44:40 -05:00
parent a279669765
commit 1f05458a77
1 changed files with 18 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
pep-0426.txt
View File

@ -24,11 +24,10 @@ Version 1.1 is specified in PEP 314.
Version 1.2 is specified in PEP 345. Version 1.2 is specified in PEP 345.
Version 1.3 of the metadata format adds fields designed to make Version 1.3 of the metadata format adds fields designed to make
third-party packaging of Python Software easier and defines a third-party packaging of Python Software easier and defines a formal
formal extension mechanism. The fields are "Setup-Requires-Dist" extension mechanism. This version also adds the `extra` variable to the
"Provides-Extra", and "Extension". This version also adds the `extra` `environment markers` specification and allows the description to be
variable to the `environment markers` specification and allows the placed into a payload section.
description to be placed into a payload section.
Metadata Files Metadata Files
============== ==============
@ -354,24 +353,23 @@ Examples::
Provides-Dist: virtual_package Provides-Dist: virtual_package
Obsoletes-Dist (multiple use) Obsoleted-By (optional)
::::::::::::::::::::::::::::: :::::::::::::::::::::::
Each entry contains a string describing a distutils project's distribution Indicates that this project is no longer being developed. The named
which this distribution renders obsolete, meaning that the two projects project provides a substitute or replacement.
should not be installed at the same time.
Version declarations can be supplied. Version numbers must be in the A version declaration may be supplied and must follow the rules described
format specified in `Version Specifiers`_. in `Version Specifiers`_.
The most common use of this field will be in case a project name changes, The most common use of this field will be in case a project name changes.
e.g. Gorgon 2.3 gets renamed to Torqued Python 1.0. When you install
Torqued Python, the Gorgon distribution should be removed.
Examples:: Examples::
Obsoletes-Dist: Gorgon Name: BadName
Obsoletes-Dist: OtherProject (<3.0) Obsoleted-By: AcceptableName
Obsoleted-By: AcceptableName (>=4.0.0)
Requires-Python (optional) Requires-Python (optional)
@ -554,7 +552,6 @@ environment.
Here are some example of fields using such markers:: Here are some example of fields using such markers::
Requires-Dist: pywin32 (>1.0); sys.platform == 'win32' Requires-Dist: pywin32 (>1.0); sys.platform == 'win32'
Obsoletes-Dist: pywin31; sys.platform == 'win32'
Requires-Dist: foo (1,!=1.3); platform.machine == 'i386' Requires-Dist: foo (1,!=1.3); platform.machine == 'i386'
Requires-Dist: bar; python_version == '2.4' or python_version == '2.5' Requires-Dist: bar; python_version == '2.4' or python_version == '2.5'
Requires-External: libxslt; 'linux' in sys.platform Requires-External: libxslt; 'linux' in sys.platform
@ -590,7 +587,6 @@ The fields that benefit from this marker are:
- Requires-Dist - Requires-Dist
- Setup-Requires-Dist - Setup-Requires-Dist
- Provides-Dist - Provides-Dist
- Obsoletes-Dist
- Classifier - Classifier
(The `extra` variable is only meaningful for Requires-Dist.) (The `extra` variable is only meaningful for Requires-Dist.)
@ -608,6 +604,8 @@ Summary of Differences From PEP 345
* Most fields are now optional. * Most fields are now optional.
* Removed `Obsoletes-Dist`
* Changed fields: * Changed fields:
- Description - Description
@ -619,6 +617,7 @@ Summary of Differences From PEP 345
- Extension - Extension
- Provides-Extra - Provides-Extra
- Setup-Requires-Dist - Setup-Requires-Dist
- Obsoleted-By
References References
========== ==========