Mailman 3 April 2022 - Docs-bugs

[issue45317] Document the removal the usage of the C stack in Python to Python calls
by Mark Shannon April 4, 2022

April 4, 2022

New submission from Mark Shannon <mark(a)hotpy.org>: Assuming that issue 45256 is implemented, we will need to document it. I'm opening a separate issue, so this doesn't get lost in the midst of 45256. We need to: Document the changes to gdb. Possibly at https://wiki.python.org/moin/DebuggingWithGdb, or in the main docs. Add a "what's new" entry explaining what the impact of this change is. ---------- assignee: docs@python components: Documentation messages: 402850 nosy: Mark.Shannon, docs@python priority: release blocker severity: normal status: open title: Document the removal the usage of the C stack in Python to Python calls type: enhancement versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45317> _______________________________________

2 5

[issue39090] Document various options for getting the absolute path from pathlib.Path objects
by Barney Gale April 4, 2022

April 4, 2022

Barney Gale <barney.gale(a)gmail.com> added the comment: The docs for PurePath.is_absolute() say: > A path is considered absolute if it has both a root and (if the flavour allows) a drive This does not preclude it from having ".." segments. PurePath.absolute() is documented as of bpo-29688 / 3.11, see: https://docs.python.org/3.11/library/pathlib.html#pathlib.Path.absolute The documentation for the absolute() method is deliberately placed alongside resolve() for ease of comparison. Both methods make a path absolute, but resolve() also follows symlinks, and consequently is able to safely elide ".." segments. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39090> _______________________________________

1 0

[issue47209] Documentation for asserting values of `unittest.mock.Mock.call_args_list`
by himkt April 3, 2022

April 3, 2022

New submission from himkt <himkt(a)klis.tsukuba.ac.jp>: Currently documentation says we can check call_args_list by providing a list of tuples of arguments. ``` >>> expected = [(), ((3, 4),), ({'key': 'fish', 'next': 'w00t!'},)] >>> mock.call_args_list == expected True ``` (from https://docs.python.org/3.11/library/unittest.mock.html#unittest.mock.Mock.…) However, I think we have to wrap all arguments with `call`. I'd happy to send a patch if it should be fixed. ### Reproduce: ``` import time from unittest.mock import call from unittest.mock import patch with patch("time.sleep") as mock_obj: time.sleep(1) time.sleep(2) print("mock_obj.call_args_list") print(mock_obj.call_args_list) print("mock_obj.call_args_list == [(1,), (2,)]") print(mock_obj.call_args_list == [(1,), (2,)]) print("mock_obj.call_args_list == [call(1,), call(2,)]") print(mock_obj.call_args_list == [call(1,), call(2,)]) ``` ``` > python demo.py 2022-04-04 12:03:18 mock_obj.call_args_list [call(1), call(2)] mock_obj.call_args_list == [(1,), (2,)] False mock_obj.call_args_list == [call(1,), call(2,)] True ``` ### Links - Documentation in repo: https://github.com/python/cpython/blob/4216dce04b7d3f329beaaafc82a77c4ac6cf… - Documentation in page: https://docs.python.org/3.11/library/unittest.mock.html#unittest.mock.Mock.… ---------- assignee: docs@python components: Documentation messages: 416650 nosy: docs@python, himkt priority: normal severity: normal status: open title: Documentation for asserting values of `unittest.mock.Mock.call_args_list` type: behavior versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47209> _______________________________________

1 2

[issue46337] urllib.parse: Allow more flexibility in schemes and URL resolution behavior
by Ned Deily April 3, 2022

April 3, 2022

Change by Ned Deily <nad(a)python.org>: ---------- hgrepos: -414 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46337> _______________________________________

1 0

[issue46337] urllib.parse: Allow more flexibility in schemes and URL resolution behavior
by Ned Deily April 3, 2022

April 3, 2022

Change by Ned Deily <nad(a)python.org>: Removed file: https://bugs.python.org/file50716/mitre_f188eec1268fd49bdc7375fc5b77ded657c… _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46337> _______________________________________

1 0

[issue46337] urllib.parse: Allow more flexibility in schemes and URL resolution behavior
by qweqwe4844m April 3, 2022

April 3, 2022

Change by qweqwe4844m <hn7n1(a)hotmail.com>: ---------- assignee: -> docs@python components: +2to3 (2.x to 3.x conversion tool), Argument Clinic, Build, C API, Cross-Build, Demos and Tools, Documentation, Extension Modules, FreeBSD, Interpreter Core, Parser, Regular Expressions, SSL, Tests, Unicode, Windows, XML, ctypes, email, macOS hgrepos: +414 nosy: +barry, docs@python, ezio.melotti, koobs, larry, lys.nikolaou, mrabarnett, ned.deily, pablogsal, paul.moore, r.david.murray, ronaldoussoren, steve.dower, tim.golden, vstinner, zach.ware versions: +Python 3.7 Added file: https://bugs.python.org/file50716/mitre_f188eec1268fd49bdc7375fc5b77ded657c… _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46337> _______________________________________

1 0

[issue30964] Mention ensurepip in package installation docs
by Sam Ezeh April 3, 2022

April 3, 2022

Change by Sam Ezeh <sam.z.ezeh(a)gmail.com>: ---------- pull_requests: -30352 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue30964> _______________________________________

1 0

[issue30964] Mention ensurepip in package installation docs
by Sam Ezeh April 3, 2022

April 3, 2022

Change by Sam Ezeh <sam.z.ezeh(a)gmail.com>: ---------- nosy: +sam_ezeh nosy_count: 3.0 -> 4.0 pull_requests: +30352 pull_request: https://github.com/python/cpython/pull/32291 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue30964> _______________________________________

1 0

[issue26792] docstrings of runpy.run_{module,path} are rather sparse
by Antony Lee April 3, 2022

April 3, 2022

Change by Antony Lee <anntzer.lee(a)gmail.com>: ---------- nosy: -Antony.Lee _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue26792> _______________________________________

1 0

[issue47142] Document importlib.resources.abc.Traversable
by Petr Viktorin April 3, 2022

April 3, 2022

New submission from Petr Viktorin <encukou(a)gmail.com>: importlib.resources.files is documented [0] as returning importlib.resources.abc.Traversable, which is an undocumented class (dead link) now. It should be documented. The [source] has helpful docstrings, but is missing some details. I'd like to know these before writing some docs: - Can the argument to `joinpath` contain path separators? - Are the methods expected to raise specific exception types (e.g. if a resource is missing, or you call iterdir on a “file”)? This seems quite important for people who implement the protocol. [0]: https://docs.python.org/dev/library/importlib.resources.html#importlib.reso… [source]: https://github.com/python/cpython/blob/main/Lib/importlib/resources/abc.py#… ---------- assignee: docs@python components: Documentation messages: 416164 nosy: docs@python, jaraco, petr.viktorin priority: normal severity: normal status: open title: Document importlib.resources.abc.Traversable _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47142> _______________________________________

2 4