Mailman 3 January 2025 - Python-checkins

gh-127553: Remove outdated TODO comment in _pydatetime (#127564)
by erlend-aasland 04 Jan '25

04 Jan '25

https://github.com/python/cpython/commit/e8b6b39ff707378da654e15ccddde9c28c… commit: e8b6b39ff707378da654e15ccddde9c28cefdd30 branch: main author: Beomsoo Kim <beoms424(a)gmail.com> committer: erlend-aasland <erlend.aasland(a)protonmail.com> date: 2025-01-04T23:38:49+01:00 summary: gh-127553: Remove outdated TODO comment in _pydatetime (#127564) files: M Lib/_pydatetime.py diff --git a/Lib/_pydatetime.py b/Lib/_pydatetime.py index ed01670cfece43..be90c9b1315d53 100644 --- a/Lib/_pydatetime.py +++ b/Lib/_pydatetime.py @@ -2392,7 +2392,6 @@ def __reduce__(self): def _isoweek1monday(year): # Helper to calculate the day number of the Monday starting week 1 - # XXX This could be done more efficiently THURSDAY = 3 firstday = _ymd2ord(year, 1, 1) firstweekday = (firstday + 6) % 7 # See weekday() above

1 0

[3.12] gh-127954: Document PyObject_DelItemString (GH-127986) (#128497)
by erlend-aasland 04 Jan '25

04 Jan '25

https://github.com/python/cpython/commit/e1a20910dc6857df558bb9fb7e49c75405… commit: e1a20910dc6857df558bb9fb7e49c75405b09f06 branch: 3.12 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: erlend-aasland <erlend.aasland(a)protonmail.com> date: 2025-01-04T20:54:56Z summary: [3.12] gh-127954: Document PyObject_DelItemString (GH-127986) (#128497) (cherry picked from commit 8ade15343d5daec3bf79ff7c47f03726fb2bcadf) Co-authored-by: RUANG (James Roy) <rruuaanng(a)outlook.com> files: M Doc/c-api/object.rst diff --git a/Doc/c-api/object.rst b/Doc/c-api/object.rst index cefd384fd35a1f..b7f1a54972e587 100644 --- a/Doc/c-api/object.rst +++ b/Doc/c-api/object.rst @@ -393,6 +393,13 @@ Object Protocol on failure. This is equivalent to the Python statement ``del o[key]``. +.. c:function:: int PyObject_DelItemString(PyObject *o, const char *key) + + This is the same as :c:func:`PyObject_DelItem`, but *key* is + specified as a :c:expr:`const char*` UTF-8 encoded bytes string, + rather than a :c:expr:`PyObject*`. + + .. c:function:: PyObject* PyObject_Dir(PyObject *o) This is equivalent to the Python expression ``dir(o)``, returning a (possibly

1 0

[3.13] gh-127954: Document PyObject_DelItemString (GH-127986) (#128496)
by erlend-aasland 04 Jan '25

04 Jan '25

https://github.com/python/cpython/commit/5ed2b7649e47a8a22bb161c5107d9de96c… commit: 5ed2b7649e47a8a22bb161c5107d9de96c99b091 branch: 3.13 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: erlend-aasland <erlend.aasland(a)protonmail.com> date: 2025-01-04T20:53:30Z summary: [3.13] gh-127954: Document PyObject_DelItemString (GH-127986) (#128496) (cherry picked from commit 8ade15343d5daec3bf79ff7c47f03726fb2bcadf) Co-authored-by: RUANG (James Roy) <rruuaanng(a)outlook.com> files: M Doc/c-api/object.rst diff --git a/Doc/c-api/object.rst b/Doc/c-api/object.rst index ce6cb0496139f7..8bb392af01fcd2 100644 --- a/Doc/c-api/object.rst +++ b/Doc/c-api/object.rst @@ -493,6 +493,13 @@ Object Protocol on failure. This is equivalent to the Python statement ``del o[key]``. +.. c:function:: int PyObject_DelItemString(PyObject *o, const char *key) + + This is the same as :c:func:`PyObject_DelItem`, but *key* is + specified as a :c:expr:`const char*` UTF-8 encoded bytes string, + rather than a :c:expr:`PyObject*`. + + .. c:function:: PyObject* PyObject_Dir(PyObject *o) This is equivalent to the Python expression ``dir(o)``, returning a (possibly

1 0

gh-127954: Document PyObject_DelItemString (#127986)
by erlend-aasland 04 Jan '25

04 Jan '25

https://github.com/python/cpython/commit/8ade15343d5daec3bf79ff7c47f03726fb… commit: 8ade15343d5daec3bf79ff7c47f03726fb2bcadf branch: main author: RUANG (James Roy) <rruuaanng(a)outlook.com> committer: erlend-aasland <erlend.aasland(a)protonmail.com> date: 2025-01-04T21:48:20+01:00 summary: gh-127954: Document PyObject_DelItemString (#127986) files: M Doc/c-api/object.rst diff --git a/Doc/c-api/object.rst b/Doc/c-api/object.rst index a137688fe07545..3a434a4173eafa 100644 --- a/Doc/c-api/object.rst +++ b/Doc/c-api/object.rst @@ -493,6 +493,13 @@ Object Protocol on failure. This is equivalent to the Python statement ``del o[key]``. +.. c:function:: int PyObject_DelItemString(PyObject *o, const char *key) + + This is the same as :c:func:`PyObject_DelItem`, but *key* is + specified as a :c:expr:`const char*` UTF-8 encoded bytes string, + rather than a :c:expr:`PyObject*`. + + .. c:function:: PyObject* PyObject_Dir(PyObject *o) This is equivalent to the Python expression ``dir(o)``, returning a (possibly

1 0

[3.12] Docs: amend json.dump() post gh-128482 (GH-128489) (#128494)
by erlend-aasland 04 Jan '25

04 Jan '25

https://github.com/python/cpython/commit/e3e4852fe08a158b4e5ec7a98516fba825… commit: e3e4852fe08a158b4e5ec7a98516fba82598d9dd branch: 3.12 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: erlend-aasland <erlend.aasland(a)protonmail.com> date: 2025-01-04T19:04:13Z summary: [3.12] Docs: amend json.dump() post gh-128482 (GH-128489) (#128494) (cherry picked from commit 87ee76062a7eb9c0fa2b94e36cfed21d86ae90ac) Co-authored-by: Erlend E. Aasland <erlend(a)python.org> files: M Doc/library/json.rst diff --git a/Doc/library/json.rst b/Doc/library/json.rst index aa33b175659b56..eff8808a440528 100644 --- a/Doc/library/json.rst +++ b/Doc/library/json.rst @@ -143,10 +143,6 @@ Basic Usage :term:`file-like object`) using this :ref:`Python-to-JSON conversion table <py-to-json-table>`. - To use a custom :class:`JSONEncoder` subclass (for example, one that overrides the - :meth:`~JSONEncoder.default` method to serialize additional types), specify it with the - *cls* keyword argument; otherwise :class:`JSONEncoder` is used. - .. note:: Unlike :mod:`pickle` and :mod:`marshal`, JSON is not a framed protocol, @@ -186,6 +182,13 @@ Basic Usage If ``True`` (the default), their JavaScript equivalents (``NaN``, ``Infinity``, ``-Infinity``) are used. + :param cls: + If set, a custom JSON encoder with the + :meth:`~JSONEncoder.default` method overridden, + for serializing into custom datatypes. + If ``None`` (the default), :class:`!JSONEncoder` is used. + :type cls: a :class:`JSONEncoder` subclass + :param indent: If a positive integer or string, JSON array elements and object members will be pretty-printed with that indent level. @@ -212,7 +215,7 @@ Basic Usage If ``None`` (the default), :exc:`!TypeError` is raised. :type default: :term:`callable` | None - :param sort_keys: + :param bool sort_keys: If ``True``, dictionaries will be outputted sorted by key. Default ``False``.

1 0

[3.13] Docs: amend json.dump() post gh-128482 (GH-128489) (#128493)
by erlend-aasland 04 Jan '25

04 Jan '25

https://github.com/python/cpython/commit/62b4ca0d53f7b273e42b55c5307d46be33… commit: 62b4ca0d53f7b273e42b55c5307d46be33596b35 branch: 3.13 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: erlend-aasland <erlend.aasland(a)protonmail.com> date: 2025-01-04T19:03:01Z summary: [3.13] Docs: amend json.dump() post gh-128482 (GH-128489) (#128493) (cherry picked from commit 87ee76062a7eb9c0fa2b94e36cfed21d86ae90ac) Co-authored-by: Erlend E. Aasland <erlend(a)python.org> files: M Doc/library/json.rst diff --git a/Doc/library/json.rst b/Doc/library/json.rst index ce0e652ee58f7f..21f36cb38f1193 100644 --- a/Doc/library/json.rst +++ b/Doc/library/json.rst @@ -154,10 +154,6 @@ Basic Usage :term:`file-like object`) using this :ref:`Python-to-JSON conversion table <py-to-json-table>`. - To use a custom :class:`JSONEncoder` subclass (for example, one that overrides the - :meth:`~JSONEncoder.default` method to serialize additional types), specify it with the - *cls* keyword argument; otherwise :class:`JSONEncoder` is used. - .. note:: Unlike :mod:`pickle` and :mod:`marshal`, JSON is not a framed protocol, @@ -197,6 +193,13 @@ Basic Usage If ``True`` (the default), their JavaScript equivalents (``NaN``, ``Infinity``, ``-Infinity``) are used. + :param cls: + If set, a custom JSON encoder with the + :meth:`~JSONEncoder.default` method overridden, + for serializing into custom datatypes. + If ``None`` (the default), :class:`!JSONEncoder` is used. + :type cls: a :class:`JSONEncoder` subclass + :param indent: If a positive integer or string, JSON array elements and object members will be pretty-printed with that indent level. @@ -223,7 +226,7 @@ Basic Usage If ``None`` (the default), :exc:`!TypeError` is raised. :type default: :term:`callable` | None - :param sort_keys: + :param bool sort_keys: If ``True``, dictionaries will be outputted sorted by key. Default ``False``.

1 0

Docs: amend json.dump() post gh-128482 (#128489)
by erlend-aasland 04 Jan '25

04 Jan '25

https://github.com/python/cpython/commit/87ee76062a7eb9c0fa2b94e36cfed21d86… commit: 87ee76062a7eb9c0fa2b94e36cfed21d86ae90ac branch: main author: Erlend E. Aasland <erlend(a)python.org> committer: erlend-aasland <erlend.aasland(a)protonmail.com> date: 2025-01-04T19:57:59+01:00 summary: Docs: amend json.dump() post gh-128482 (#128489) files: M Doc/library/json.rst diff --git a/Doc/library/json.rst b/Doc/library/json.rst index f11109fb0ecfed..169291f74f44a5 100644 --- a/Doc/library/json.rst +++ b/Doc/library/json.rst @@ -154,10 +154,6 @@ Basic Usage :term:`file-like object`) using this :ref:`Python-to-JSON conversion table <py-to-json-table>`. - To use a custom :class:`JSONEncoder` subclass (for example, one that overrides the - :meth:`~JSONEncoder.default` method to serialize additional types), specify it with the - *cls* keyword argument; otherwise :class:`JSONEncoder` is used. - .. note:: Unlike :mod:`pickle` and :mod:`marshal`, JSON is not a framed protocol, @@ -197,6 +193,13 @@ Basic Usage If ``True`` (the default), their JavaScript equivalents (``NaN``, ``Infinity``, ``-Infinity``) are used. + :param cls: + If set, a custom JSON encoder with the + :meth:`~JSONEncoder.default` method overridden, + for serializing into custom datatypes. + If ``None`` (the default), :class:`!JSONEncoder` is used. + :type cls: a :class:`JSONEncoder` subclass + :param indent: If a positive integer or string, JSON array elements and object members will be pretty-printed with that indent level. @@ -223,7 +226,7 @@ Basic Usage If ``None`` (the default), :exc:`!TypeError` is raised. :type default: :term:`callable` | None - :param sort_keys: + :param bool sort_keys: If ``True``, dictionaries will be outputted sorted by key. Default ``False``.

1 0

[3.12] gh-126719: Clarify math.fmod docs (GH-127741) (#128492)
by erlend-aasland 04 Jan '25

04 Jan '25

https://github.com/python/cpython/commit/98d3f2bc6e2b944f5fba1e16b0ca7f6445… commit: 98d3f2bc6e2b944f5fba1e16b0ca7f64459aa5e5 branch: 3.12 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: erlend-aasland <erlend.aasland(a)protonmail.com> date: 2025-01-04T17:45:19Z summary: [3.12] gh-126719: Clarify math.fmod docs (GH-127741) (#128492) (cherry picked from commit f28d471fbe99f9eaac05d60ed40da47b0b56fe86) Co-authored-by: Stan Ulbrych <89152624+StanFromIreland(a)users.noreply.github.com> Co-authored-by: Bénédikt Tran <10796600+picnixz(a)users.noreply.github.com> files: M Doc/library/math.rst diff --git a/Doc/library/math.rst b/Doc/library/math.rst index fb8527128a2555..0648293bfa7b89 100644 --- a/Doc/library/math.rst +++ b/Doc/library/math.rst @@ -84,7 +84,8 @@ Number-theoretic and representation functions .. function:: fmod(x, y) - Return ``fmod(x, y)``, as defined by the platform C library. Note that the + Return the floating-point remainder of ``x / y``, + as defined by the platform C library function ``fmod(x, y)``. Note that the Python expression ``x % y`` may not return the same result. The intent of the C standard is that ``fmod(x, y)`` be exactly (mathematically; to infinite precision) equal to ``x - n*y`` for some integer *n* such that the result has

1 0

[3.13] gh-126719: Clarify math.fmod docs (GH-127741) (#128491)
by erlend-aasland 04 Jan '25

04 Jan '25

https://github.com/python/cpython/commit/65fd75809873456664c0b14a0d147b6676… commit: 65fd75809873456664c0b14a0d147b6676f1bbb0 branch: 3.13 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: erlend-aasland <erlend.aasland(a)protonmail.com> date: 2025-01-04T17:44:36Z summary: [3.13] gh-126719: Clarify math.fmod docs (GH-127741) (#128491) (cherry picked from commit f28d471fbe99f9eaac05d60ed40da47b0b56fe86) Co-authored-by: Stan Ulbrych <89152624+StanFromIreland(a)users.noreply.github.com> Co-authored-by: Bénédikt Tran <10796600+picnixz(a)users.noreply.github.com> files: M Doc/library/math.rst diff --git a/Doc/library/math.rst b/Doc/library/math.rst index 68878806749f28..25886da908f9a2 100644 --- a/Doc/library/math.rst +++ b/Doc/library/math.rst @@ -248,7 +248,8 @@ Floating point arithmetic .. function:: fmod(x, y) - Return ``fmod(x, y)``, as defined by the platform C library. Note that the + Return the floating-point remainder of ``x / y``, + as defined by the platform C library function ``fmod(x, y)``. Note that the Python expression ``x % y`` may not return the same result. The intent of the C standard is that ``fmod(x, y)`` be exactly (mathematically; to infinite precision) equal to ``x - n*y`` for some integer *n* such that the result has

1 0

gh-126719: Clarify math.fmod docs (#127741)
by erlend-aasland 04 Jan '25

04 Jan '25

https://github.com/python/cpython/commit/f28d471fbe99f9eaac05d60ed40da47b0b… commit: f28d471fbe99f9eaac05d60ed40da47b0b56fe86 branch: main author: Stan Ulbrych <89152624+StanFromIreland(a)users.noreply.github.com> committer: erlend-aasland <erlend.aasland(a)protonmail.com> date: 2025-01-04T18:38:57+01:00 summary: gh-126719: Clarify math.fmod docs (#127741) Co-authored-by: Bénédikt Tran <10796600+picnixz(a)users.noreply.github.com> files: M Doc/library/math.rst diff --git a/Doc/library/math.rst b/Doc/library/math.rst index bf79b23a72bbf9..c78b313db5152d 100644 --- a/Doc/library/math.rst +++ b/Doc/library/math.rst @@ -248,7 +248,8 @@ Floating point arithmetic .. function:: fmod(x, y) - Return ``fmod(x, y)``, as defined by the platform C library. Note that the + Return the floating-point remainder of ``x / y``, + as defined by the platform C library function ``fmod(x, y)``. Note that the Python expression ``x % y`` may not return the same result. The intent of the C standard is that ``fmod(x, y)`` be exactly (mathematically; to infinite precision) equal to ``x - n*y`` for some integer *n* such that the result has

1 0