Mailman 3 May 2018 - docs

[issue33583] PyObject_GC_Resize() doesn't relink GCHead
by INADA Naoki May 20, 2018

May 20, 2018

Change by INADA Naoki <songofacandy(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python versions: +Python 2.7, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33583> _______________________________________

1 0

[issue26103] Contradiction in definition of "data descriptor" between (dotted lookup behavior/datamodel documentation) and (inspect lib/descriptor how-to)
by Serhiy Storchaka May 20, 2018

May 20, 2018

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: New changeset 4054b172ab59054715a2aaf4979bd84ac23e3ada by Serhiy Storchaka (Aaron Hall, MBA) in branch 'master': bpo-26103: Fix inspect.isdatadescriptor() and a data descriptor definition. (GH-1959) https://github.com/python/cpython/commit/4054b172ab59054715a2aaf4979bd84ac2… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue26103> _______________________________________

1 0

[issue33479] Document tkinter and threads
by Ivan Pozdeev May 19, 2018

May 19, 2018

Ivan Pozdeev <ivan_pozdeev(a)mail.ru> added the comment: I'm currently rewriting the docs, too, according to the plan @ #msg316492. WIP @ https://github.com/native-api/cpython/tree/tkinter_docs . You PR lines up fine though is made redundant by https://github.com/native-api/cpython/commit/79b195a9028fd7bf6e8186dfced0fa… -- instead of removing Doc\library\tk.rst, I reduced it to a summary of chapter content without any claims about it whatsoever, like other chapter head pages. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33479> _______________________________________

1 0

[issue33479] Document tkinter and threads
by Terry J. Reedy May 19, 2018

May 19, 2018

Change by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- keywords: +patch pull_requests: +6642 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33479> _______________________________________

1 0

[issue33430] Import secrets module in secrets examples
by Daniel Chimeno May 19, 2018

May 19, 2018

New submission from Daniel Chimeno <daniel(a)chimeno.me>: In the secrets module documentation, the examples in `15.3.4. Recipes and best practices` need change things, I think this examples must run after a copy & paste into user terminal. Options for first example: 1: ```` import string from secrets import choice alphabet = string.ascii_letters + string.digits password = ''.join(choice(alphabet) for i in range(8)) ```` 2: ``` import string import secrets alphabet = string.ascii_letters + string.digits password = ''.join(secrets.choice(alphabet) for i in range(8)) ```` I've looked in the devguide, but I haven't found what's the standard approach here. First issue here, be nice :) ---------- assignee: docs@python components: Documentation messages: 316200 nosy: dchimeno, docs@python priority: normal severity: normal status: open title: Import secrets module in secrets examples type: enhancement versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33430> _______________________________________

2 4

[issue33448] Output_Typo_Error
by Mark Dickinson May 19, 2018

May 19, 2018

Change by Mark Dickinson <dickinsm(a)gmail.com>: ---------- stage: -> resolved status: pending -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33448> _______________________________________

1 0

[issue19950] Document that unittest.TestCase.__init__ is called once per test
by Claudiu.Popa May 18, 2018

May 18, 2018

New submission from Claudiu.Popa: I was surprised that in the following __init__ is actually called once per test function, although nothing in documentation implied so. a.py ------ import unittest class A(unittest.TestCase): def __init__(self, *args, **kwargs): print('called only once!') super().__init__(*args, **kwargs) def test(self): self.assertEqual(1, 1) def test2(self): self.assertEqual(2, 2) if __name__ == '__main__': unittest.main() $ python a.py called only once! called only once! .. ---------------------------------------------------------------------- Ran 2 tests in 0.001s OK The attached patch adds a note regarding this behaviour for the TestCase class. ---------- assignee: docs@python components: Documentation files: unittest_init.patch keywords: patch messages: 205864 nosy: Claudiu.Popa, docs@python, michael.foord priority: normal severity: normal status: open title: Document that unittest.TestCase.__init__ is called once per test type: enhancement versions: Python 3.4 Added file: http://bugs.python.org/file33086/unittest_init.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19950> _______________________________________

8 15

[issue33572] Better document mixed-type comparison of set items, dict keys
by Terry J. Reedy May 18, 2018

May 18, 2018

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: With Tim's addition >>> from fractions import Fraction as F >>> from decimal import Decimal as D >>> s = {0, 1, 0.0, 1.0, F(0,1), F(1, 1), D(0), D(1), False, True} >>> s {0, 1} I think we should consider moving the main discussion of the general comparison and hashing principle and example to the set entry. (Sets ars simpler and are when people new to Python already know about.) Point out that for displays, the first of equals is kept and not replaced (this is also true of dicts). Then, in the dict entry, say that dict keys are treated like set items, give an equivalent dict example, and link to the discussion of set items. >>> x = None >>> d = {0:x, 1:x, 0.0:x, 1.0:x, F(0,1):x, F(1, 1):x, D(0):x, D(1):x, False:x, True:x} >>> d {0: None, 1: None} >>> ---------- title: False/True as dictionary keys treated as integers -> Better document mixed-type comparison of set items, dict keys _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33572> _______________________________________

1 0

[issue33572] False/True as dictionary keys treated as integers
by Terry J. Reedy May 18, 2018

May 18, 2018

Change by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- assignee: -> docs@python components: +Documentation -Interpreter Core nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33572> _______________________________________

1 0