Mailman 3 October 2020 - docs

[issue40833] Clarify docstring of Path.rename
by Ram Rachum Oct. 5, 2020

Oct. 5, 2020

New submission from Ram Rachum <ram(a)rachum.com>: Writing the PR now. ---------- assignee: docs@python components: Documentation messages: 370459 nosy: brandtbucher, cool-RR, docs@python priority: normal severity: normal status: open title: Clarify docstring of Path.rename type: enhancement versions: Python 3.10, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40833> _______________________________________

4 9

[issue41946] Add concrete examples to os.path documentation
by Stargirl Flowers Oct. 5, 2020

Oct. 5, 2020

New submission from Stargirl Flowers <me(a)thea.codes>: Presently the documentation for os.path (https://docs.python.org/3.8/library/os.path.html) doesn't contain any concrete examples of the input and outputs of the various path manipulation functions. Contrast this to the Node.js documentation for similar functionality (https://nodejs.org/api/path.html) We could add replesque examples such as: >> os.path.abspath("example.py") "/full/path/to/example.py" ... >> os.path.basename("example.py") "example" & so on. I believe it would be useful for us to have concrete examples here and I'm happy to contribute this. If anyone feels differently, let me know. ---------- assignee: docs@python components: Documentation messages: 378043 nosy: docs@python, theacodes priority: normal severity: normal status: open title: Add concrete examples to os.path documentation type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41946> _______________________________________

1 0

[issue30578] Misleading example in sys.set_coroutine_wrapper docs
by Nick Coghlan Oct. 5, 2020

Oct. 5, 2020

New submission from Nick Coghlan: In issue 24342, the invocation of coroutine wrappers specified via sys.set_coroutine_wrapper was fixed to catch and report the case of infinite recursion, where the wrapper attempts to instantiate a nested coroutine (which would call the wrapper, which would attempt to instantiate the coroutine, etc, etc) The docs for sys.set_coroutine_wrapper include an example of this failure case: https://docs.python.org/3/library/sys.html#sys.set_coroutine_wrapper However, if you're not reading carefully, it looks like an example of how to *use* sys.set_coroutine_wrapper, rather than an example of a case that won't work. It would be better to include an example that either doesn't wrap the coroutine at all, or else uses one of the non-native coroutine emulations to avoid the infinite recursion problem: ``` import asyncio, sys def wrapper(coro): @asyncio.coroutine def wrap(coro): print("Coroutine started") result = yield from coro print("Coroutine finished") return result return wrap(coro) sys.set_coroutine_wrapper(wrapper) async def foo(): print("Coroutine running") return "Coroutine result" import asyncio asyncio.get_event_loop().run_until_complete(foo()) ``` Also related: I discovered in writing this that "sys.set_coroutine_wrapper(None)" doesn't actually turn off coroutine wrapping. Instead, you still get this exception when attempting to recursively define an unwrapped one: RuntimeError: coroutine wrapper <NULL> attempted to recursively wrap <code object wrap at 0x7eff31fbde40, file "<stdin>", line 2>) That error was produced as follows: ``` import sys, contextlib @contextlib.contextmanager def disable_coroutine_wrapping(): wrapper = sys.get_coroutine_wrapper() sys.set_coroutine_wrapper(None) try: yield finally: sys.set_coroutine_wrapper(wrapper) def wrapper(coro): async def wrap(coro): print("Coroutine started") result = await coro print("Coroutine finished") return result with disable_coroutine_wrapping(): return wrap(coro) sys.set_coroutine_wrapper(wrapper) async def foo(): print("Coroutine running") return "Coroutine result" import asyncio asyncio.get_event_loop().run_until_complete(foo()) ``` ---------- assignee: docs@python components: Documentation messages: 295231 nosy: docs@python, giampaolo.rodola, haypo, ncoghlan, yselivanov priority: normal severity: normal stage: needs patch status: open title: Misleading example in sys.set_coroutine_wrapper docs type: enhancement versions: Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30578> _______________________________________

3 2

[issue41892] use both "for in" and "ElementTree.remove" has a index bug
by Stefan Behnel Oct. 5, 2020

Oct. 5, 2020

Stefan Behnel <stefan_ml(a)behnel.de> added the comment: Closing since this works as designed. Users are responsible for avoiding concurrent tree modifications during iteration. ---------- resolution: -> not a bug stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41892> _______________________________________

1 0

[issue41892] use both "for in" and "ElementTree.remove" has a index bug
by Ned Deily Oct. 4, 2020

Oct. 4, 2020

Ned Deily <nad(a)python.org> added the comment: New changeset d5719247ba32b3ac700454bad9a9e2cc7edeac6a by Miss Skeleton (bot) in branch '3.9': bpo-41892: Clarify that an example in the ElementTree docs explicitly avoids modifying an XML tree while iterating over it. (GH-22464) (GH-22554) https://github.com/python/cpython/commit/d5719247ba32b3ac700454bad9a9e2cc7e… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41892> _______________________________________

1 0

[issue41892] use both "for in" and "ElementTree.remove" has a index bug
by miss-islington Oct. 4, 2020

Oct. 4, 2020

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset 6bd058e0ff5d4a63fb35f6d45161cdf51cb68c58 by Miss Skeleton (bot) in branch '3.8': bpo-41892: Clarify that an example in the ElementTree docs explicitly avoids modifying an XML tree while iterating over it. (GH-22464) https://github.com/python/cpython/commit/6bd058e0ff5d4a63fb35f6d45161cdf51c… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41892> _______________________________________

1 0

[issue41892] use both "for in" and "ElementTree.remove" has a index bug
by miss-islington Oct. 4, 2020

Oct. 4, 2020

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- pull_requests: +21552 pull_request: https://github.com/python/cpython/pull/22554 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41892> _______________________________________

1 0

[issue41892] use both "for in" and "ElementTree.remove" has a index bug
by miss-islington Oct. 4, 2020

Oct. 4, 2020

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- nosy: +miss-islington nosy_count: 7.0 -> 8.0 pull_requests: +21551 pull_request: https://github.com/python/cpython/pull/22553 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41892> _______________________________________

1 0

[issue41892] use both "for in" and "ElementTree.remove" has a index bug
by Ned Deily Oct. 4, 2020

Oct. 4, 2020

Ned Deily <nad(a)python.org> added the comment: New changeset 40db798692ca783fc2163656f196ac77e8b9e792 by scoder in branch 'master': bpo-41892: Clarify that an example in the ElementTree docs explicitly avoids modifying an XML tree while iterating over it. (GH-22464) https://github.com/python/cpython/commit/40db798692ca783fc2163656f196ac77e8… ---------- nosy: +ned.deily _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41892> _______________________________________

1 0

Documentation for accessible software development with Python
by info＠marlem-software.de Oct. 4, 2020

Oct. 4, 2020

Hello, i am physically disabled and an expert in accessibility in IT. I'm looking for documentation, tutorials, learning videos for barrier-free software development with Python. The reason for this mail is as follows: With the Java programming language, the size of the system font and the high color contrast can be adopted by the operating system. How can I use these two operating system settings with the Python programming language? accessible greetings Markus Lemcke --- /** * @IT-Experte Markus Lemcke * @job Barrierefreies Webdesign HTML,CSS + Wordpress * @job Barrierefreie Softwareentwicklung mit Java + C# * @job Barrierefreiheit bei Windows, Android, IOS und Ubuntu * @job Autor von IT-Fachartikel über barrierefreie Informatik * @job Dozent an Hochschulen * @email info(a)marlem-software.de * @Webseite https://www.marlem-software.de * @Adresse Bahnhofstrasse 17, 72144 Dußlingen, Germany * @Tel. 07072/1278463 */

1 0