https://github.com/python/cpython/commit/52794cba13801f24c228c8e1d95a4ef25a62b4e3
commit: 52794cba13801f24c228c8e1d95a4ef25a62b4e3
branch: main
author: Donghee Na <[email protected]>
committer: corona10 <[email protected]>
date: 2026-02-19T12:48:57Z
summary:
gh-141510: Update Whats News for frozendict (gh-144961)
files:
M Doc/whatsnew/3.15.rst
diff --git a/Doc/whatsnew/3.15.rst b/Doc/whatsnew/3.15.rst
index 62ce7121424651..feccc496fad0e0 100644
--- a/Doc/whatsnew/3.15.rst
+++ b/Doc/whatsnew/3.15.rst
@@ -188,14 +188,33 @@ raise :exc:`SyntaxError`).
:pep:`814`: Add frozendict built-in type
----------------------------------------
-A new public immutable type :class:`frozendict` is added to the :mod:`builtins`
-module. It is not a ``dict`` subclass but inherits directly from ``object``.
-
-A ``frozendict`` can be hashed with ``hash(frozendict)`` if all keys and values
-can be hashed.
+A new :term:`immutable` type, :class:`frozendict`, is added to the
:mod:`builtins` module.
+It does not allow modification after creation. A ``frozendict`` is not a
subclass of ``dict``;
+it inherits directly from ``object``. A ``frozendict`` is :term:`hashable`
+as long as all of its keys and values are hashable. A ``frozendict`` preserves
+insertion order, but comparison does not take order into account.
+
+For example::
+
+ >>> a = frozendict(x=1, y=2)
+ >>> a
+ frozendict({'x': 1, 'y': 2})
+ >>> a['z'] = 3
+ Traceback (most recent call last):
+ File "<python-input-2>", line 1, in <module>
+ a['z'] = 3
+ ~^^^^^
+ TypeError: 'frozendict' object does not support item assignment
+ >>> b = frozendict(y=2, x=1)
+ >>> hash(a) == hash(b)
+ True
+ >>> a == b
+ True
.. seealso:: :pep:`814` for the full specification and rationale.
+(Contributed by Victor Stinner and Donghee Na in :gh:`141510`.)
+
.. _whatsnew315-profiling-package:
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
