Mailman 3 May 2020 - docs

[issue40731] CWI url's protocol on LICENSE file from http to https
by Vinicius Henrique Silva Bastos May 22, 2020

May 22, 2020

New submission from Vinicius Henrique Silva Bastos <bastosvinicius(a)live.com>: CWI url's protocol on LICENSE file from http to https from: http://www.cwi.nl to: https://www.cwi.nl Obs.: Learning about pull requests and how it works. ---------- assignee: docs@python components: Documentation files: LICENSE hgrepos: 388 messages: 369610 nosy: bastosvinicius, docs@python priority: normal severity: normal status: open title: CWI url's protocol on LICENSE file from http to https type: enhancement versions: Python 3.10 Added file: https://bugs.python.org/file49181/LICENSE _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40731> _______________________________________

3 3

[issue40730] Odd sentence in 3.9 What's New
by Eric V. Smith May 22, 2020

May 22, 2020

New submission from Eric V. Smith <eric(a)trueblade.com>: https://docs.python.org/3.9/whatsnew/3.9.html#optimizations has this sentence: "Unlike to the := operator this idiom does not leak a variable to the outer scope.". I'm not exactly sure what it should be. Probably the first "to" should be deleted? ---------- assignee: docs@python components: Documentation messages: 369607 nosy: docs@python, eric.smith priority: normal severity: normal status: open title: Odd sentence in 3.9 What's New versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40730> _______________________________________

3 7

[issue23738] Clarify documentation of positional-only default values
by Martin Panter May 22, 2020

May 22, 2020

New submission from Martin Panter: This patch adds the PEP 457 positional-only slash “/” indicator to some function signatures in the documentation. I only looked at the the os, builtin, binascii, zlib and fcntl modules, and their functions where the documentation incorrectly suggests that they accept keyword arguments. For example, I changed eval(expression, globals=None, locals=None) to eval(expression, globals=None, locals=None, /) References: * Issue 22832: “fcntl” module changed to look like accepting keyword arguments * Ongoing discussion: <https://mail.python.org/pipermail/python-dev/2015-March/138847.html> There are many more instances where square brackets are used, or the arguments are mandatory. See the PEP for examples, but I do not think it is so important to “fix” them. I also fixed parameter name mismatches that I discovered for a quite a few functions that do take keyword arguments. One more thing I noticed, that I do not know how to fix, is the Argument Clinic signatures list invalid default values for zlib.compressobj(zdict=None) and os.utime(ns=None): >>> zlib.compressobj(zdict=None) Traceback (most recent call last): File "<stdin>", line 1, in <module> TypeError: 'NoneType' does not support the buffer interface >>> os.utime("dummy", ns=None) Traceback (most recent call last): File "<stdin>", line 1, in <module> TypeError: utime: 'ns' must be a tuple of two ints ---------- assignee: docs@python components: Documentation files: pos-defaults.patch keywords: patch messages: 238890 nosy: docs@python, serhiy.storchaka, vadmium priority: normal severity: normal status: open title: Clarify documentation of positional-only default values versions: Python 3.4, Python 3.5 Added file: http://bugs.python.org/file38632/pos-defaults.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23738> _______________________________________

6 18

[issue40579] Second argument to iterator.next not described
by Andrew Black May 22, 2020

May 22, 2020

New submission from Andrew Black <apblack(a)pdx.edu>: The documentation for the built-in function next (which calls the __next__ method on an iterator) discusses its behavior when the iterator is exhausted. It talks about the StopIteration exception. However, it does not say anything about calling next with two arguments. See the library documentation at https://docs.python.org/3/library/stdtypes.html#iterator-types My impression was that the presence of the second argument would suppress the StopIteration exception; instead next would return the value of the second argument. That is the way that list iterators behave, for example. This behavior should be documented. ---------- assignee: docs@python components: Documentation messages: 368525 nosy: Andrew Black, docs@python priority: normal severity: normal status: open title: Second argument to iterator.next not described type: behavior versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40579> _______________________________________

4 4

[issue40717] pl.python.org has expired cert and links to nonexistent django.pl page
by Hanno Boeck May 21, 2020

May 21, 2020

New submission from Hanno Boeck <hanno(a)hboeck.de>: I'm not sure if this is a good place to report this, but I haven't found a separate bug tracker or feedback contact for the webpages. https://pl.python.org/ has an expired certificate and it contains a prominent link to django.pl, which itself returns a DNS SERVFAIL error. ---------- assignee: docs@python components: Documentation messages: 369531 nosy: docs@python, hanno priority: normal severity: normal status: open title: pl.python.org has expired cert and links to nonexistent django.pl page _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40717> _______________________________________

3 4

[issue40651] class:`OrderedDict` Examples: LRU implementation has a bug.
by Dongfang Qu May 21, 2020

May 21, 2020

New submission from Dongfang Qu <qudongfang(a)gmail.com>: class:`OrderedDict` Examples: LRU implementation has a bug. Details: The calls to the `__setitem__` method should also count as usages. ---------- assignee: docs@python components: Documentation messages: 369083 nosy: Dongfang Qu, docs@python priority: normal severity: normal status: open title: class:`OrderedDict` Examples: LRU implementation has a bug. _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40651> _______________________________________

3 6

Python Documentation
by Wesley, Jimmy May 20, 2020

May 20, 2020

Hello, I am looking for the Python System Requirements and Security Whitesheets, as these will both need to be reviewed by our IT and security team prior to being able to utilize the software. Are you able to provide these documents? I could not locate them. Thank you, Jimmy Wesley | Continuous Improvement Manager/LSS Black Belt| Client Engagement Center Owens & Minor |Riverfront Plaza, 951 East Byrd Street | Richmond, VA 23129 t 804.718.6363 |m 434-941-5006 james.wesley(a)owens-minor.com<mailto:james.wesley@owens-minor.com> | owens-minor.com

2 1

[issue39976] Add "**other_popen_kwargs" to subprocess API signatures in docs
by Nick Coghlan May 19, 2020

May 19, 2020

New submission from Nick Coghlan <ncoghlan(a)gmail.com>: Two of my colleagues missed the "The arguments shown above are merely the most common ones, ..." caveat on the subprocess.run documentation, and assumed that Python 3.5 only supported the "cwd" option in the low level Popen API, and not any of the higher level APIs. Something we could potential do is include a "**other_popen_kwargs" placeholder in the affected API signatures (run, call, check_call, check_output) that makes it clear there are more options beyond the explicitly listed ones. ---------- assignee: docs@python components: Documentation messages: 364295 nosy: docs@python, ncoghlan priority: normal severity: normal stage: needs patch status: open title: Add "**other_popen_kwargs" to subprocess API signatures in docs type: enhancement versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39976> _______________________________________

4 7

[issue40620] Range tutorial shorthand could be made clearer
by Rahul Kumaresan May 18, 2020

May 18, 2020

Change by Rahul Kumaresan <kayrahul(a)gmail.com>: ---------- nosy: +rahul-kumi _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40620> _______________________________________

1 0

[issue39705] Tutorial, 5.6 Looping Techniques, sorted() example
by Mirwi May 18, 2020

May 18, 2020

New submission from Mirwi <mirwi(a)binary-kitchen.de>: >>> basket = ['apple', 'orange', 'apple', 'pear', 'orange', 'banana'] >>> for f in sorted(set(basket)): ... print(f) ... apple banana orange pear Shouldn't 'apple' appear two times as basket is a list that allows duplicates, not a set? I'm just doing my first steps into Python and may be mislead. In that case, sorry for the fuzz. ---------- assignee: docs@python components: Documentation messages: 362395 nosy: docs@python, mirwi priority: normal severity: normal status: open title: Tutorial, 5.6 Looping Techniques, sorted() example type: enhancement versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39705> _______________________________________

4 7