Mailman 3 January 2020 - docs

[issue39269] Descriptor how-to guide wanting update for 3.6+ features
by wim glenn 08 Jan '20

08 Jan '20

New submission from wim glenn <wim.glenn(a)gmail.com>: https://docs.python.org/3/howto/descriptor.html Current descriptor how-to guide, above, has no mention about API features added since Python 3.6 (see __set_name__ in PEP 487) It's an important and useful piece of using descriptors effectively and the guide could be updated to include some info about that. There's some info in datamodel.html (e.g. 3.3.3.6. Creating the class object) but a mention in the how-to guide would be welcome too. ---------- assignee: docs@python components: Documentation messages: 359642 nosy: docs@python, wim.glenn priority: normal severity: normal status: open title: Descriptor how-to guide wanting update for 3.6+ features versions: Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39269> _______________________________________

3 3

[issue28617] Why isn't "in" called a comparison operation?
by wim glenn 08 Jan '20

08 Jan '20

New submission from wim glenn: Regarding https://docs.python.org/3/library/stdtypes.html#comparisons There is a line at the bottom claiming: > Two more operations with the same syntactic priority, in and not in, are supported only by sequence types (below). The claim is incorrect because `in` and `not in` are also supported by non-sequence types such as sets, mappings, etc for membership testing. Is there any good reason why we don't include them in the table of comparison operations, and say that there are ten comparison operations in python? They do support comparison chaining in the same way: >>> 'x' in 'xy' in 'xyz' True >>> 0 in {0} in [{0}] True ---------- assignee: docs@python components: Documentation files: patch.diff keywords: patch messages: 280080 nosy: docs@python, wim.glenn priority: normal severity: normal status: open title: Why isn't "in" called a comparison operation? type: enhancement 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/file45359/patch.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28617> _______________________________________

8 19

[issue39267] Fix dict's __missing__ documentation
by Bar Harel 08 Jan '20

08 Jan '20

New submission from Bar Harel <bzvi7919(a)gmail.com>: Continuing bpo-39264, and according to the mailing list discussion at Python-Dev. Fixing dict's __missing__ documentation. Clarify .get() does not call __missing__, and move __missing__ from the data model to dict's section as it's not a general object or ABC method but a dict-only implementation. ---------- assignee: docs@python components: Documentation messages: 359639 nosy: bar.harel, docs@python priority: normal severity: normal status: open title: Fix dict's __missing__ documentation type: enhancement versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39267> _______________________________________

1 1

[issue38623] Python documentation should mention how to find site-packages
by Peter Bittner 08 Jan '20

08 Jan '20

New submission from Peter Bittner <peter.bittner(a)gmx.net>: A popular question on StackOverflow is, "How do I find the location of my Python site-packages directory?" [1] While this may hint at a deeper problem that needs to be solved, a user suggested [2] the accepted answer to be added to Python's official documentation. The most appropriate place I could find to add related information is ``Doc/tutorial/modules.rst``. [1] https://stackoverflow.com/questions/122327/how-do-i-find-the-location-of-my… [2] https://stackoverflow.com/questions/122327/how-do-i-find-the-location-of-my… ---------- assignee: docs@python components: Documentation messages: 355599 nosy: bittner, docs@python priority: normal severity: normal status: open title: Python documentation should mention how to find site-packages type: enhancement versions: Python 2.7, Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38623> _______________________________________

6 17

[issue21995] Idle: pseudofiles have no buffer attribute.
by Terry J. Reedy 07 Jan '20

07 Jan '20

New submission from Terry J. Reedy: sys.stdin on 3.4.1 is also 'missing' (among public names) 'line_buffering' (True) and 'mode' ('r'). It seems that these could be trivially added, so the focus of this issue is 'buffer'. The associated .detach method is a no-op, (It is also a bit dangerous for interactive operation.) 3.4.1 Console interpreter: >>> import sys; b = sys.stdin.buffer.readline() a line >>> b b'a line\r\n' 3.4.1 Idle: >>> import sys; b = sys.stdin.buffer.readline() Traceback (most recent call last): File "<pyshell#2>", line 1, in <module> import sys; b = sys.stdin.buffer.readline() AttributeError: 'PseudoInputFile' object has no attribute 'buffer' https://docs.python.org/3/library/sys.html#sys.stdin presents the idiom. It also warns (too narrowly -- 'if you are writing a library ...') that it might not. As far as I could find, the Idle doc does not mention the standard streams, let alone Idle specific limitations. I intentionally wrote the title as a statement of a problematical situation, rather than as a proposed solution, as there are two: change code and change doc. Code: add .buffer as a bytes-oriented Pseudofile. Doc: at least mention that standard streams are replaced by objects that ship text between processes, and use gui for input and display, and the consiquences of this. ---------- assignee: docs@python components: Documentation, IDLE messages: 223292 nosy: docs@python, terry.reedy priority: normal severity: normal stage: test needed status: open title: Idle: pseudofiles have no buffer attribute. type: enhancement versions: Python 2.7, Python 3.4, Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21995> _______________________________________

3 6

[issue39158] ast.literal_eval() doesn't support empty sets
by Pablo Galindo Salgado 06 Jan '20

06 Jan '20

Pablo Galindo Salgado <pablogsal(a)gmail.com> added the comment: > "Safe" means safe from user input to literal_eval(). Yup, apologies. I had something in mind and I realized after writing my initial comment. That is why I said afterwards: > and the security concern is non-existent. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39158> _______________________________________

1 0

[issue39158] ast.literal_eval() doesn't support empty sets
by Raymond Hettinger 06 Jan '20

06 Jan '20

Raymond Hettinger <raymond.hettinger(a)gmail.com> added the comment: > The function literal_eval is not safe anymore as the > constructor can be intercepted "Safe" means safe from user input to literal_eval(). If a person can already write arbitrary code that redefines a builtin, then they can already do anything they want. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39158> _______________________________________

1 0

[issue39224] HTTPConnection.timeout None support
by Daniel Farley 05 Jan '20

05 Jan '20

New submission from Daniel Farley <danfarley93(a)gmail.com>: HTTPConnection's `timeout` argument is passed down to `socket.settimeout()` which supports `None` and puts the socket in blocking mode. This isn't documented on the `http.client` page. Otherwise it should not be allowed. ---------- assignee: docs@python components: Documentation messages: 359371 nosy: Daniel Farley, docs@python priority: normal severity: normal status: open title: HTTPConnection.timeout None support type: behavior _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39224> _______________________________________

1 1

[issue39210] Sorting falls back to use __gt__ when __lt__ is not present
by Yan Mitrofanov 04 Jan '20

04 Jan '20

New submission from Yan Mitrofanov <mmxlviii(a)mail.ru>: Sorting documentation claims that sorting algorithm is only using < comparisons https://docs.python.org/3/howto/sorting.html#odd-and-ends https://docs.python.org/3/library/stdtypes.html#list.sort When __lt__ implementation is missing, you get an exception class Foo: pass sorted([Foo(), Foo(), Foo()]) TypeError: '<' not supported between instances of 'Foo' and 'Foo' However, if implement __gt__ method, you doesn't get an exception class Foo: def __gt__(self, other): return False sorted([Foo(), Foo(), Foo()]) # ok Is it supposed to work like this? Or is it lack of documentation? ---------- assignee: docs@python components: Documentation messages: 359293 nosy: docs@python, yanmitrofanov priority: normal severity: normal status: open title: Sorting falls back to use __gt__ when __lt__ is not present versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39210> _______________________________________

4 6

[issue39158] ast.literal_eval() doesn't support empty sets
by Pablo Galindo Salgado 04 Jan '20

04 Jan '20

Pablo Galindo Salgado <pablogsal(a)gmail.com> added the comment: > And if add support of non-literals, where should we stop? Should we support also frozenset() and bytearray()? inf and nan? infj and nanj? complex()? Ellipsis? __debug__? Then the name of the function would be a bit misleading (for frozenset() and bytearray()), no? I think the set() change is somehow inconsistent already with the function name. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39158> _______________________________________

1 0

docs January 2020