diff --git a/Doc/library/types.rst b/Doc/library/types.rst index 38a77119769d724..f061e3f51f3995f 100644 --- a/Doc/library/types.rst +++ b/Doc/library/types.rst @@ -390,6 +390,18 @@ Standard names are defined for the following types: signifying (respectively) the types of the underlying mapping's keys and values. + .. note:: + + There are important differences between ``MappingProxyType`` + and :class:`frozendict`. + + ``MappingProxyType`` is a wrapper around a mapping that renders + the mapping immutable to the viewer of the proxy + without affecting the underlying container. + ``MappingProxyType`` can expose its internal mutable mapping in some rare cases. + + On the other hand, ``frozendict`` is a concrete immutable mapping. + .. versionadded:: 3.3 .. versionchanged:: 3.9