This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: sys.version_info.releaselevel - 'final' or 'release'
Type: Stage: resolved
Components: Documentation Versions: Python 3.7, Python 3.6, Python 3.5, Python 2.7
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: anish.tambe, docs@python, ned.deily, python-dev
Priority: normal Keywords: patch

Created on 2016-11-04 19:17 by anish.tambe, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
releaselevel.patch anish.tambe, 2016-11-04 19:17 patch for releaselevel review
Messages (3)
msg280071 - (view) Author: Anish Tambe (anish.tambe) * Date: 2016-11-04 19:17
help(sys.version_info) suggests releaselevel is one among - 

 |  releaselevel
 |      'alpha', 'beta', 'candidate', or 'release'

Notice that the last one is 'release'.

But the implementation says current value is - 'final'.

$ python
Python 2.7.12 (default, Oct 11 2016, 05:24:00) 
[GCC 4.2.1 Compatible Apple LLVM 8.0.0 (clang-800.0.38)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> sys.version_info
sys.version_info(major=2, minor=7, micro=12, releaselevel='final', serial=0)
>>> 


$ python3
Python 3.5.2 (default, Oct 11 2016, 05:05:28) 
[GCC 4.2.1 Compatible Apple LLVM 8.0.0 (clang-800.0.38)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> sys.version_info
sys.version_info(major=3, minor=5, micro=2, releaselevel='final', serial=0)
>>> 


The documentation (https://docs.python.org/3/library/sys.html#sys.version_info or Doc/library/sys.rst) agrees with the implementation.

The tests also agree with the implementation. 
grep for releaselevel and see - 
Lib/test/test_sys.py:504:        self.assertIn(vi.releaselevel, ("alpha", "beta", "candidate", "final"))

Hence, submitting a patch to change the help documentaion to reflect the correct value for releaselevel.

[Motivation - I tried to print a warning to the user in case my app was not being run on a final release, and I tried to do that by equating releaselevel with 'release' as the help suggested.]
msg280087 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2016-11-04 21:08
New changeset 0b4bcd954554 by Ned Deily in branch '2.7':
Issue #28616: Correct help for sys.version_info releaselevel component.
https://hg.python.org/cpython/rev/0b4bcd954554

New changeset 1390bde4b768 by Ned Deily in branch '3.5':
Issue #28616: Correct help for sys.version_info releaselevel component.
https://hg.python.org/cpython/rev/1390bde4b768

New changeset 048870daf397 by Ned Deily in branch '3.6':
Issue #28616: merge from 3.5
https://hg.python.org/cpython/rev/048870daf397

New changeset 87d76ce01217 by Ned Deily in branch 'default':
Issue #28616: merge from 3.6
https://hg.python.org/cpython/rev/87d76ce01217
msg280088 - (view) Author: Ned Deily (ned.deily) * (Python committer) Date: 2016-11-04 21:10
Thanks for the patch!
History
Date User Action Args
2022-04-11 14:58:39adminsetgithub: 72802
2016-11-04 21:10:17ned.deilysetstatus: open -> closed

versions: - Python 3.3, Python 3.4
nosy: + ned.deily

messages: + msg280088
resolution: fixed
stage: resolved
2016-11-04 21:08:44python-devsetnosy: + python-dev
messages: + msg280087
2016-11-04 19:17:58anish.tambecreate