Mailman 3 December 2019 - docs

[issue39037] Wrong trial order of __exit__ and __enter__ in the with statement
by Géry Dec. 14, 2019

Dec. 14, 2019

Change by Géry <gery.ogam(a)gmail.com>: ---------- keywords: +patch pull_requests: +17078 stage: needs patch -> patch review pull_request: https://github.com/python/cpython/pull/17608 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39037> _______________________________________

1 0

[issue39037] Wrong trial order of __exit__ and __enter__ in the with statement
by Brett Cannon Dec. 13, 2019

Dec. 13, 2019

Brett Cannon <brett(a)python.org> added the comment: @Gery please do open a documentation PR! :) ---------- nosy: +brett.cannon _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39037> _______________________________________

1 0

[issue39037] Wrong trial order of __exit__ and __enter__ in the with statement
by Serhiy Storchaka Dec. 13, 2019

Dec. 13, 2019

Change by Serhiy Storchaka <storchaka+cpython(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation -Interpreter Core keywords: +easy nosy: +docs@python stage: -> needs patch _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39037> _______________________________________

1 0

[issue39034] Documentation: Coroutines
by Rustam Agakishiev Dec. 13, 2019

Dec. 13, 2019

New submission from Rustam Agakishiev <agakishy(a)gmail.com>: Here: https://docs.python.org/3/library/asyncio-task.html it says:"To actually run a coroutine, asyncio provides three main mechanisms:" and a few pages down it gives you a fourth mechanism: "awaitable asyncio.gather(*aws, loop=None, return_exceptions=False) Run awaitable objects in the aws sequence concurrently." And it really runs awaitables: future = asyncio.gather(*awslist) # aws are run... ... … [View More]

3 2

[issue19038] Fix sort order in Misc/ACKS.
by Tae-Wong SEO Dec. 12, 2019

Dec. 12, 2019

New submission from Tae-Wong SEO: This patch fixes sort order in file Misc/ACKS. ---------- assignee: docs@python components: Documentation files: ACKS messages: 197945 nosy: docs@python, taewong.seo priority: normal severity: normal status: open title: Fix sort order in Misc/ACKS. type: enhancement Added file: http://bugs.python.org/file31803/ACKS _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19038> _______________________________________

8 18

Re: Documents Server appears to be down
by Julien Palard Dec. 11, 2019

Dec. 11, 2019

Hi John, thanks for reporting! Were you trying to download a PDF of the documentation? If you were trying to download a PDF, it's fixed by now and the bug is known and tracked here: https://github.com/python/docsbuild-scripts/issues/68 If you had the issue on another page, like the home page as your screenshot indicates, please let me know. -- Julien Palard https://mdk.fr

1 0

[issue38594] importlib.metadata documentation deficiencies
by Gregory Szorc Dec. 11, 2019

Dec. 11, 2019

New submission from Gregory Szorc <gregory.szorc(a)gmail.com>: As I was attempting to implement the find_distributions() interface for PyOxidizer, I got confused by importlib.metadata's documentation. The documentation for this module states: ``` What this means in practice is that to support finding distribution package metadata in locations other than the file system, you should derive from ``Distribution`` and implement the ``load_metadata()`` method. Then from your finder, return … [View More]instances of this derived ``Distribution`` in the ``find_distributions()`` method. ``` The reference to `load_metadata()` is the only occurrence of the string `load_metadata` in the CPython and importlib_metadata code bases. I therefore believe the documentation in both CPython and the importlib_metadata standalone package are wrong because they are referring to a method that is never implemented nor called. Looking at the documentation and source code for importlib.metadata, I'm also a bit confused about how exactly I'm supposed to implement a custom Distribution which isn't based on filesystems. For example, I see that certain APIs return Path-like objects (which I will need to implement). But it isn't clear exactly which attributes are mandated to exist! Am I expected to implement the full pathlib.Path interface or just a subset? Regarding how find_distributions() is called, I also don't understand why the Context is optional and how Context could be used in some situations. For example, the implementation of discover() can construct Context instances with no arguments, which is then fed into find_distributions(). So I guess context=None or context.name=None implies "return Distribution's for every known package?" If so, this behavior is undocumented. I'm also not sure what Context.path is for. I /think/ it is only used for the path-based finder/distribution. But the way it is documented implies it should always exist, which doesn't seem appropriate for cases like PyOxidizer which will retrieve metadata from in-memory without filesystem I/O. I think what I'm trying to say is that the existing documentation for importlib.metadata is not sufficient to robustly implement a custom find_distributions() + Distribution type. I would kindly request that a domain expert revise the documentation such that a 3rd party can implement a custom solution. My preferred solution would be for there to be formal interfaces in importlib.abc like there are for everything else in the importlib realm. (The interfaces for finders and loaders are super useful when implementing a finder/loader from scratch.) FWIW I think I like the new metadata API and I think it is flexible enough to allow tools like PyOxidizer to do crazy things like divorce resources from the filesystem! But it is hard to say for sure since the interfaces aren't clearly defined at present. ---------- assignee: docs@python components: Documentation messages: 355402 nosy: barry, docs@python, indygreg, jaraco priority: normal severity: normal status: open title: importlib.metadata documentation deficiencies type: enhancement versions: Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38594> _______________________________________ [View Less]

3 9

[issue35827] C API dictionary views type checkers are not documented
by Ori Avtalion Dec. 10, 2019

Dec. 10, 2019

New submission from Ori Avtalion <ori(a)avtalion.name>: dictobject.h defines several helpers to ease checking of dictionary view types. If they are meant to be part of the API, they should be documented. PyDictKeys_Check PyDictItems_Check PyDictValues_Check PyDictViewSet_Check Should they be added to dict.rst, or a separate file? ---------- assignee: docs@python components: Documentation messages: 334355 nosy: docs@python, salty-horse priority: normal severity: normal status: open … [View More]

3 2

[issue39002] Small typo in Lib/test/test_statistics.py: tranlation -> translation
by Tim Gates Dec. 10, 2019

Dec. 10, 2019

New submission from Tim Gates <tim.gates(a)iress.com>: There is a small typo in Lib/test/test_statistics.py. Should read translation rather than tranlation. ---------- assignee: docs@python components: Documentation messages: 358063 nosy: docs@python, timgates42 priority: normal pull_requests: 16995 severity: normal status: open title: Small typo in Lib/test/test_statistics.py: tranlation -> translation type: enhancement versions: Python 3.9 _______________________________________ … [View More]

3 4

[issue38975] Add direct anchors to regex syntax documentation
by Baptiste Mispelon Dec. 9, 2019

Dec. 9, 2019

New submission from Baptiste Mispelon <bmispelon(a)gmail.com>: While writing documentation about regexps for a project I help maintain, I wanted to link to some specific aspects of Python's implementation (in my case, non-capturing groups) which are described on https://docs.python.org/3/library/re.html. There are no visible ¶ anchors for the items in the "Regular Expression Syntax" section. Inspecting the generated HTML, there does seem to be auto-generated ids (like `#index-16` for … [View More]

4 4