[docs] [issue28616] sys.version_info.releaselevel - 'final' or 'release'

[Anish Tambe]

New submission from Anish Tambe:

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.]

----------
assignee: docs at python
components: Documentation
files: releaselevel.patch
keywords: patch
messages: 280071
nosy: anish.tambe, docs at python
priority: normal
severity: normal
status: open
title: sys.version_info.releaselevel - 'final' or 'release'
versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7
Added file: http://bugs.python.org/file45356/releaselevel.patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28616>
_______________________________________