Mailman 3 May 2020 - docs

[issue40419] timeit CLI docs still mention old power sequence
by Sander van Rijn 02 May '20

02 May '20

New submission from Sander van Rijn <svr003(a)gmail.com>: The docs for the `timeit` CLI (https://docs.python.org/3/library/timeit.html#cmdoption-timeit-h) still mention that successive powers of 10 are tried. However, as this also uses the `timeit.Timer.autorange()` function, it uses the new sequence 1, 2, 5, 10, 20, 50, ... instead. ---------- assignee: docs@python components: Documentation messages: 367517 nosy: Sander van Rijn, docs@python priority: normal severity: normal status: open title: timeit CLI docs still mention old power sequence type: enhancement versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40419> _______________________________________

5 8

[issue39435] pickle: inconsistent arguments pickle.py vs _pickle.c vs docs
by Guido Imperiale 02 May '20

02 May '20

New submission from Guido Imperiale <crusaderky(a)gmail.com>: (1) In the documentation for loads(), the name for the first argument of loads is 'bytes_object'. The actual signature, both in pickle.py and _pickle.c, it is instead 'data'. (2) In the documentation and in pickle.py, the default value for the 'buffers' parameter is None. However, in _pickle.c, it is an empty tuple (); this is also reflected by running the interpreter: In [1]: inspect.signature(pickle.loads).parameters['buffers'] Out[1]: <Parameter "buffers=()"> Thanks to @hauntsaninja for spotting these in https://github.com/python/typeshed/pull/3636 ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 360569 nosy: crusaderky, docs@python priority: normal severity: normal status: open title: pickle: inconsistent arguments pickle.py vs _pickle.c vs docs versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39435> _______________________________________

6 14

max() fn has a bug, maybe
by Sami 01 May '20

01 May '20

April 30 2020 Hello, I hope you and your loved ones are doing well during these tough times which is affecting us all globally. I am independently learning python language and I seemed to have come across a bug. The following is my code: # SWAPPING ELEMENTS i = [10, 3, 8, 7, 4, 12, 6] i [ 0 ] , i [ i.index ( max ( i )) ] = i [ i.index ( max ( i ))] , i [ 0 ] print( i ) i [ -1 ] , i [ i.index ( min ( i ))] = i [ i.index ( min ( i ))] , i [ -1 ] print( i ) # Lines 4 & 5 don't result in a swap even though they're executed. # The same code is written on line 6 & 7 and it gives perfect results # please solve this issue and provide explanation as to why # this occurs. I the above code I intend to swap the largest element in the given list with the first element in the list and similarly the smallest magnitude element with the last element in the given list. Expected result is that the above code will swap on max(i) with i[0] but this does not occur. Surprisingly min(i) and i[-1] works absolutely fine. I am aware that there are ways around it but this seemed intuitive to me and was not resulting in the desired solution, so I decided to mention it to you folks. Stay safe and healthy, Regards, Sami

2 1

[issue40382] Make 'rt' the default for open in docs
by Facundo Batista 01 May '20

01 May '20

New submission from Facundo Batista <facundo(a)taniquetil.com.ar>: This is mostly a confusion about 'r' being a synonym of 'rt', while it's more explicit if we consider 'r' as one default, and 't' as other (as other parts of the documentation do). Doing `help(open)` we get: mode is an optional string that specifies the mode in which the file is opened. It defaults to 'r' which means open for reading in text mode. Later in the same text it's stated: The default mode is 'rt' (open for reading text). Which reflects the wording I want to have, but is confusing that initially it said a different thing. If we get the html docs, it says "The default mode is 'r' (open for reading text, synonym of 'rt')." Why not just stating that the default mode is 'rt'? ---------- assignee: docs@python components: Documentation messages: 367219 nosy: docs@python, facundobatista priority: normal severity: normal stage: needs patch status: open title: Make 'rt' the default for open in docs type: enhancement versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40382> _______________________________________

2 1

[issue39691] Allow passing Pathlike objects to io.open_code
by Steve Dower 01 May '20

01 May '20

Change by Steve Dower <steve.dower(a)python.org>: ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39691> _______________________________________

1 0

[issue39691] Allow passing Pathlike objects to io.open_code
by miss-islington 01 May '20

01 May '20

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset c9d7d32b6dc6140f7fcbf1ae1120df6d59fc28d0 by Miss Islington (bot) in branch '3.8': bpo-39691: Clarify io.open_code behavior (GH-19824) https://github.com/python/cpython/commit/c9d7d32b6dc6140f7fcbf1ae1120df6d59… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39691> _______________________________________

1 0

[issue39691] Allow passing Pathlike objects to io.open_code
by miss-islington 01 May '20

01 May '20

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- nosy: +miss-islington nosy_count: 4.0 -> 5.0 pull_requests: +19158 pull_request: https://github.com/python/cpython/pull/19840 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39691> _______________________________________

1 0

[issue39691] Allow passing Pathlike objects to io.open_code
by Steve Dower 01 May '20

01 May '20

Steve Dower <steve.dower(a)python.org> added the comment: New changeset 831d58d7865cb98fa09227dc614f4f3ce6af968b by Shantanu in branch 'master': bpo-39691: Clarify io.open_code behavior (GH-19824) https://github.com/python/cpython/commit/831d58d7865cb98fa09227dc614f4f3ce6… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39691> _______________________________________

1 0

[issue40434] Update of reasoning why there is no case statement
by Ama Aje My Fren 01 May '20

01 May '20

New submission from Ama Aje My Fren <amaajemyfren(a)gmail.com>: The design and history FAQ (https://docs.python.org/dev/faq/design.html#why-isn-t-there-a-switch-or-cas…) explains why there is no case statement referencing PEP 275(https://www.python.org/dev/peps/pep-0275/). For Python 3 there is, however, PEP 3103(https://www.python.org/dev/peps/pep-3103/) which rejected the proposal for a switch statement. ---------- assignee: docs@python components: Documentation messages: 367633 nosy: amaajemyfren, docs@python priority: normal severity: normal status: open title: Update of reasoning why there is no case statement versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40434> _______________________________________

2 5