Mailman 3 February 2024 - Python-checkins

gh-114364: Fix awkward wording about mmap.mmap.seekable (#114374)
by terryjreedy Feb. 1, 2024

Feb. 1, 2024

https://github.com/python/cpython/commit/5ce193e65a7e6f239337a8c5305895cf8a… commit: 5ce193e65a7e6f239337a8c5305895cf8a4d2726 branch: main author: technillogue <wisepoison(a)gmail.com> committer: terryjreedy <tjreedy(a)udel.edu> date: 2024-02-01T06:03:58Z summary: gh-114364: Fix awkward wording about mmap.mmap.seekable (#114374) --------- Co-authored-by: Kirill Podoprigora <kirill.bast9(a)mail.ru> Co-authored-by: Terry Jan Reedy <tjreedy(a)udel.edu> Co-authored-by: Erlend E. Aasland <erlend.aasland(a)protonmail.com> files: M Doc/whatsnew/3.13.rst M Misc/NEWS.d/3.13.0a2.rst diff --git a/Doc/whatsnew/3.13.rst b/Doc/whatsnew/3.13.rst index b33203efbb05c0..6b94a3771406fa 100644 --- a/Doc/whatsnew/3.13.rst +++ b/Doc/whatsnew/3.13.rst @@ -259,8 +259,8 @@ mmap ---- * The :class:`mmap.mmap` class now has an :meth:`~mmap.mmap.seekable` method - that can be used where it requires a file-like object with seekable and - the :meth:`~mmap.mmap.seek` method return the new absolute position. + that can be used when a seekable file-like object is required. + The :meth:`~mmap.mmap.seek` method now returns the new absolute position. (Contributed by Donghee Na and Sylvie Liberman in :gh:`111835`.) * :class:`mmap.mmap` now has a *trackfd* parameter on Unix; if it is ``False``, the file descriptor specified by *fileno* will not be duplicated. diff --git a/Misc/NEWS.d/3.13.0a2.rst b/Misc/NEWS.d/3.13.0a2.rst index d4be4fb8a3d3ab..e5841e14c02efb 100644 --- a/Misc/NEWS.d/3.13.0a2.rst +++ b/Misc/NEWS.d/3.13.0a2.rst @@ -565,9 +565,9 @@ part of a :exc:`BaseExceptionGroup`, in addition to the recent support for .. section: Library The :class:`mmap.mmap` class now has an :meth:`~mmap.mmap.seekable` method -that can be used where it requires a file-like object with seekable and the -:meth:`~mmap.mmap.seek` method return the new absolute position. Patch by -Donghee Na. +that can be used when a seekable file-like object is required. +The :meth:`~mmap.mmap.seek` method now returns the new absolute position. +Patch by Donghee Na. ..

1 0

[3.11] gh-114648: Add IndexError exception to tutorial datastructures list.pop entry (GH-114681) (#114842)
by terryjreedy Feb. 1, 2024

Feb. 1, 2024

https://github.com/python/cpython/commit/a9c2801d49de545f6a5bfee46969dc9e20… commit: a9c2801d49de545f6a5bfee46969dc9e20261461 branch: 3.11 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: terryjreedy <tjreedy(a)udel.edu> date: 2024-02-01T03:53:15Z summary: [3.11] gh-114648: Add IndexError exception to tutorial datastructures list.pop entry (GH-114681) (#114842) Remove redundant explanation of optional argument. (cherry picked from commit 57c3e775df5a5ca0982adf15010ed80a158b1b80) Co-authored-by: srinivasan <shivnaren(a)gmail.com> files: M Doc/tutorial/datastructures.rst diff --git a/Doc/tutorial/datastructures.rst b/Doc/tutorial/datastructures.rst index 87614d082a1d4e..de2827461e2f24 100644 --- a/Doc/tutorial/datastructures.rst +++ b/Doc/tutorial/datastructures.rst @@ -48,10 +48,9 @@ objects: :noindex: Remove the item at the given position in the list, and return it. If no index - is specified, ``a.pop()`` removes and returns the last item in the list. (The - square brackets around the *i* in the method signature denote that the parameter - is optional, not that you should type square brackets at that position. You - will see this notation frequently in the Python Library Reference.) + is specified, ``a.pop()`` removes and returns the last item in the list. + It raises an :exc:`IndexError` if the list is empty or the index is + outside the list range. .. method:: list.clear()

1 0

[3.12] gh-114648: Add IndexError exception to tutorial datastructures list.pop entry (GH-114681) (#114841)
by terryjreedy Feb. 1, 2024

Feb. 1, 2024

https://github.com/python/cpython/commit/09b8b14e05557304ab12870137181685c2… commit: 09b8b14e05557304ab12870137181685c2dcbe25 branch: 3.12 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: terryjreedy <tjreedy(a)udel.edu> date: 2024-02-01T03:52:58Z summary: [3.12] gh-114648: Add IndexError exception to tutorial datastructures list.pop entry (GH-114681) (#114841) Remove redundant explanation of optional argument. (cherry picked from commit 57c3e775df5a5ca0982adf15010ed80a158b1b80) Co-authored-by: srinivasan <shivnaren(a)gmail.com> files: M Doc/tutorial/datastructures.rst diff --git a/Doc/tutorial/datastructures.rst b/Doc/tutorial/datastructures.rst index 87614d082a1d4e..de2827461e2f24 100644 --- a/Doc/tutorial/datastructures.rst +++ b/Doc/tutorial/datastructures.rst @@ -48,10 +48,9 @@ objects: :noindex: Remove the item at the given position in the list, and return it. If no index - is specified, ``a.pop()`` removes and returns the last item in the list. (The - square brackets around the *i* in the method signature denote that the parameter - is optional, not that you should type square brackets at that position. You - will see this notation frequently in the Python Library Reference.) + is specified, ``a.pop()`` removes and returns the last item in the list. + It raises an :exc:`IndexError` if the list is empty or the index is + outside the list range. .. method:: list.clear()

1 0

gh-114648: Add IndexError exception to tutorial datastructures list.pop entry (#114681)
by terryjreedy Feb. 1, 2024

Feb. 1, 2024

https://github.com/python/cpython/commit/57c3e775df5a5ca0982adf15010ed80a15… commit: 57c3e775df5a5ca0982adf15010ed80a158b1b80 branch: main author: srinivasan <shivnaren(a)gmail.com> committer: terryjreedy <tjreedy(a)udel.edu> date: 2024-01-31T22:46:49-05:00 summary: gh-114648: Add IndexError exception to tutorial datastructures list.pop entry (#114681) Remove redundant explanation of optional argument. files: M Doc/tutorial/datastructures.rst diff --git a/Doc/tutorial/datastructures.rst b/Doc/tutorial/datastructures.rst index 87614d082a1d4e..de2827461e2f24 100644 --- a/Doc/tutorial/datastructures.rst +++ b/Doc/tutorial/datastructures.rst @@ -48,10 +48,9 @@ objects: :noindex: Remove the item at the given position in the list, and return it. If no index - is specified, ``a.pop()`` removes and returns the last item in the list. (The - square brackets around the *i* in the method signature denote that the parameter - is optional, not that you should type square brackets at that position. You - will see this notation frequently in the Python Library Reference.) + is specified, ``a.pop()`` removes and returns the last item in the list. + It raises an :exc:`IndexError` if the list is empty or the index is + outside the list range. .. method:: list.clear()

1 0

[3.12] gh-67230: Add versionadded notes for QUOTE_NOTNULL and QUOTE_STRINGS (GH-114816) (#114840)
by terryjreedy Feb. 1, 2024

Feb. 1, 2024

https://github.com/python/cpython/commit/c26decab6f96920bfa3a149d93dd50670f… commit: c26decab6f96920bfa3a149d93dd50670fdb5a36 branch: 3.12 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: terryjreedy <tjreedy(a)udel.edu> date: 2024-02-01T03:17:56Z summary: [3.12] gh-67230: Add versionadded notes for QUOTE_NOTNULL and QUOTE_STRINGS (GH-114816) (#114840) As @GPHemsley pointed out, GH-29469 omitted `versionadded` notes for the 2 new items. (cherry picked from commit 586057e9f80d57f16334c0eee8431931e4aa8cff) Co-authored-by: Skip Montanaro <skip.montanaro(a)gmail.com> files: M Doc/library/csv.rst diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst index 66888c22b7cc28..fd62b225fcebb8 100644 --- a/Doc/library/csv.rst +++ b/Doc/library/csv.rst @@ -351,6 +351,8 @@ The :mod:`csv` module defines the following constants: Instructs :class:`reader` objects to interpret an empty (unquoted) field as None and to otherwise behave as :data:`QUOTE_ALL`. + .. versionadded:: 3.12 + .. data:: QUOTE_STRINGS Instructs :class:`writer` objects to always place quotes around fields @@ -360,6 +362,8 @@ The :mod:`csv` module defines the following constants: Instructs :class:`reader` objects to interpret an empty (unquoted) string as ``None`` and to otherwise behave as :data:`QUOTE_NONNUMERIC`. + .. versionadded:: 3.12 + The :mod:`csv` module defines the following exception:

1 0

gh-67230: Add versionadded notes for QUOTE_NOTNULL and QUOTE_STRINGS (#114816)
by terryjreedy Feb. 1, 2024

Feb. 1, 2024

https://github.com/python/cpython/commit/586057e9f80d57f16334c0eee8431931e4… commit: 586057e9f80d57f16334c0eee8431931e4aa8cff branch: main author: Skip Montanaro <skip.montanaro(a)gmail.com> committer: terryjreedy <tjreedy(a)udel.edu> date: 2024-01-31T22:11:16-05:00 summary: gh-67230: Add versionadded notes for QUOTE_NOTNULL and QUOTE_STRINGS (#114816) As @GPHemsley pointed out, #29469 omitted `versionadded` notes for the 2 new items. files: M Doc/library/csv.rst diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst index 66888c22b7cc28..fd62b225fcebb8 100644 --- a/Doc/library/csv.rst +++ b/Doc/library/csv.rst @@ -351,6 +351,8 @@ The :mod:`csv` module defines the following constants: Instructs :class:`reader` objects to interpret an empty (unquoted) field as None and to otherwise behave as :data:`QUOTE_ALL`. + .. versionadded:: 3.12 + .. data:: QUOTE_STRINGS Instructs :class:`writer` objects to always place quotes around fields @@ -360,6 +362,8 @@ The :mod:`csv` module defines the following constants: Instructs :class:`reader` objects to interpret an empty (unquoted) string as ``None`` and to otherwise behave as :data:`QUOTE_NONNUMERIC`. + .. versionadded:: 3.12 + The :mod:`csv` module defines the following exception:

1 0

[3.12] CI: Test on macOS M1 (GH-114766) (#114836)
by gpshead Feb. 1, 2024

Feb. 1, 2024

https://github.com/python/cpython/commit/203106def212f32d4c4c56b6ea7760811c… commit: 203106def212f32d4c4c56b6ea7760811c9ca355 branch: 3.12 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: gpshead <greg(a)krypto.org> date: 2024-02-01T01:57:08Z summary: [3.12] CI: Test on macOS M1 (GH-114766) (#114836) Test on macOS M1 (cherry picked from commit 854e2bc42340b22cdeea5d16ac8b1ef3762c6909) Co-authored-by: Hugo van Kemenade <1324225+hugovk(a)users.noreply.github.com> files: M .github/workflows/reusable-macos.yml diff --git a/.github/workflows/reusable-macos.yml b/.github/workflows/reusable-macos.yml index db42cedd6f9294..ac8fdb8677e2fa 100644 --- a/.github/workflows/reusable-macos.yml +++ b/.github/workflows/reusable-macos.yml @@ -12,20 +12,27 @@ on: jobs: build_macos: name: 'build and test' - runs-on: macos-latest timeout-minutes: 60 env: HOMEBREW_NO_ANALYTICS: 1 HOMEBREW_NO_AUTO_UPDATE: 1 HOMEBREW_NO_INSTALL_CLEANUP: 1 PYTHONSTRICTEXTENSIONBUILD: 1 + strategy: + fail-fast: false + matrix: + os: [ + "macos-14", # M1 + "macos-13", # Intel + ] + runs-on: ${{ matrix.os }} steps: - uses: actions/checkout@v4 - name: Restore config.cache uses: actions/cache@v3 with: path: config.cache - key: ${{ github.job }}-${{ runner.os }}-${{ inputs.config_hash }} + key: ${{ github.job }}-${{ matrix.os }}-${{ inputs.config_hash }} - name: Install Homebrew dependencies run: brew install pkg-config openssl(a)3.0 xz gdbm tcl-tk - name: Configure CPython

1 0

[3.11] CI: Test on macOS M1 (GH-114766) (#114835)
by gpshead Feb. 1, 2024

Feb. 1, 2024

https://github.com/python/cpython/commit/cba5cee0355e3c292791a4714adcf463b3… commit: cba5cee0355e3c292791a4714adcf463b3371825 branch: 3.11 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: gpshead <greg(a)krypto.org> date: 2024-02-01T01:55:45Z summary: [3.11] CI: Test on macOS M1 (GH-114766) (#114835) Test on macOS M1 (cherry picked from commit 854e2bc42340b22cdeea5d16ac8b1ef3762c6909) Co-authored-by: Hugo van Kemenade <1324225+hugovk(a)users.noreply.github.com> files: M .github/workflows/reusable-macos.yml diff --git a/.github/workflows/reusable-macos.yml b/.github/workflows/reusable-macos.yml index db42cedd6f9294..ac8fdb8677e2fa 100644 --- a/.github/workflows/reusable-macos.yml +++ b/.github/workflows/reusable-macos.yml @@ -12,20 +12,27 @@ on: jobs: build_macos: name: 'build and test' - runs-on: macos-latest timeout-minutes: 60 env: HOMEBREW_NO_ANALYTICS: 1 HOMEBREW_NO_AUTO_UPDATE: 1 HOMEBREW_NO_INSTALL_CLEANUP: 1 PYTHONSTRICTEXTENSIONBUILD: 1 + strategy: + fail-fast: false + matrix: + os: [ + "macos-14", # M1 + "macos-13", # Intel + ] + runs-on: ${{ matrix.os }} steps: - uses: actions/checkout@v4 - name: Restore config.cache uses: actions/cache@v3 with: path: config.cache - key: ${{ github.job }}-${{ runner.os }}-${{ inputs.config_hash }} + key: ${{ github.job }}-${{ matrix.os }}-${{ inputs.config_hash }} - name: Install Homebrew dependencies run: brew install pkg-config openssl(a)3.0 xz gdbm tcl-tk - name: Configure CPython

1 0

[3.12] gh-114811: Change '\*' to '*' in warnings.rst (GH-114819) (#114837)
by terryjreedy Feb. 1, 2024

Feb. 1, 2024

https://github.com/python/cpython/commit/3017c27d359a65b60f2ad2523a383a8eca… commit: 3017c27d359a65b60f2ad2523a383a8ecad22460 branch: 3.12 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: terryjreedy <tjreedy(a)udel.edu> date: 2024-02-01T01:54:25Z summary: [3.12] gh-114811: Change '\*' to '*' in warnings.rst (GH-114819) (#114837) Regression in 3.12. (cherry picked from commit ff8939e5abaad7cd87f4d1f07ca7f6d176090f6c) Co-authored-by: Pradyot Ranjan <99216956+prady0t(a)users.noreply.github.com> files: M Doc/library/warnings.rst diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst index 884de08eab1b16..db3534dd632f1d 100644 --- a/Doc/library/warnings.rst +++ b/Doc/library/warnings.rst @@ -396,7 +396,7 @@ Available Functions ------------------- -.. function:: warn(message, category=None, stacklevel=1, source=None, \*, skip_file_prefixes=None) +.. function:: warn(message, category=None, stacklevel=1, source=None, *, skip_file_prefixes=None) Issue a warning, or maybe ignore it or raise an exception. The *category* argument, if given, must be a :ref:`warning category class <warning-categories>`; it

1 0

gh-114811: Change '\*' to '*' in warnings.rst (#114819)
by terryjreedy Feb. 1, 2024

Feb. 1, 2024

https://github.com/python/cpython/commit/ff8939e5abaad7cd87f4d1f07ca7f6d176… commit: ff8939e5abaad7cd87f4d1f07ca7f6d176090f6c branch: main author: Pradyot Ranjan <99216956+prady0t(a)users.noreply.github.com> committer: terryjreedy <tjreedy(a)udel.edu> date: 2024-01-31T20:48:39-05:00 summary: gh-114811: Change '\*' to '*' in warnings.rst (#114819) Regression in 3.12. files: M Doc/library/warnings.rst diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst index a9c469707e8227..500398636e11ae 100644 --- a/Doc/library/warnings.rst +++ b/Doc/library/warnings.rst @@ -396,7 +396,7 @@ Available Functions ------------------- -.. function:: warn(message, category=None, stacklevel=1, source=None, \*, skip_file_prefixes=None) +.. function:: warn(message, category=None, stacklevel=1, source=None, *, skip_file_prefixes=None) Issue a warning, or maybe ignore it or raise an exception. The *category* argument, if given, must be a :ref:`warning category class <warning-categories>`; it

1 0