Mailman 3 October 2021 - Docs-bugs

[issue45198] __set_name__ documentation not clear about its usage with non-descriptor classes
by xitop Oct. 4, 2021

Oct. 4, 2021

New submission from xitop <reg.bugs(a)poti.sk>: The object.__set_name__() function (introduced in Python 3.6 by PEP-487) is mentioned in the "what's new " summary as an extension to the descriptor protocol [1] and documented in the "implementing descriptors" section [2]. However, the PEP itself states that it "adds an __set_name__ initializer for class attributes, especially if they are descriptors.". And it indeed works for plain classes where the descriptor protocol is not used at all (no __get__ or __set__ or __delete__): ---- class NotDescriptor: def __set_name__(self, owner, name): print('__set_name__ called') class SomeClass: attr = NotDescriptor() ---- It is clear that this method is helpful when used in descriptors and that is its intended use, but other valid use-cases probably exist. I suggest to amend the documentation to clarify that (correct me if I'm wrong) the __set_name__ is called for every class used as an attribute in an other class, not only for descriptors. --- URLs: [1]: https://docs.python.org/3/whatsnew/3.6.html#pep-487-descriptor-protocol-enh… [2]: https://docs.python.org/3/reference/datamodel.html#implementing-descriptors ---------- assignee: docs@python components: Documentation messages: 401785 nosy: docs@python, xitop priority: normal severity: normal status: open title: __set_name__ documentation not clear about its usage with non-descriptor classes versions: Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45198> _______________________________________

4 7

[issue30637] Syntax error reported on compile(...), but not on compile(..., ast.PyCF_ONLY_AST)
by Pablo Galindo Salgado Oct. 4, 2021

Oct. 4, 2021

Pablo Galindo Salgado <pablogsal(a)gmail.com> added the comment: New changeset f025ea23210173b42303360aca05132e4ffdfed3 by Pablo Galindo (Miss Islington (bot)) in branch '3.10': bpo-30637: Improve the docs of ast.parse regarding differences with compile() (GH-28459) https://github.com/python/cpython/commit/f025ea23210173b42303360aca05132e4f… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue30637> _______________________________________

1 0

[issue45217] ConfigParser does not accept "No value" reversely to the doc
by sbougnoux Oct. 4, 2021

Oct. 4, 2021

New submission from sbougnoux <bougnoux(a)free.fr>: Just the simple following config crashes """ [Bug] Here """ Hopefully using "Here=" solves the issue, but the doc claims it shall work. https://docs.python.org/3.8/library/configparser.html?highlight=configparse… Save the config in "bug.ini", then write (it will raise an exception) """ from configparser import ConfigParser ConfigParser().read('bug.ini') """ ---------- assignee: docs@python components: Demos and Tools, Documentation, Library (Lib) messages: 401932 nosy: docs@python, sbougnoux priority: normal severity: normal status: open title: ConfigParser does not accept "No value" reversely to the doc type: behavior versions: Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45217> _______________________________________

5 11

[issue28206] signal.Signals not documented
by Julien Palard Oct. 4, 2021

Oct. 4, 2021

Julien Palard <julien+python(a)palard.fr> added the comment: New changeset 9be930f9b169fb3d92693670ae069df902709b83 by Bibo-Joshi in branch 'main': bpo-28206: Document signals Handlers, Sigmasks and Signals enums (GH-28628) https://github.com/python/cpython/commit/9be930f9b169fb3d92693670ae069df902… ---------- nosy: +mdk _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue28206> _______________________________________

1 0

[issue19290] Clarify compile and eval interaction.
by Terry J. Reedy Oct. 4, 2021

Oct. 4, 2021

Change by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- versions: +Python 3.11 -Python 2.7, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue19290> _______________________________________

1 0