From: Raymond Hettinger <rhettinger@users.noreply.github.com>
Date: Sun, 21 Jul 2024 05:53:26 +0000 (-0500)
Subject: gh-121977: Add tips for handling unhashable data (#122075)
X-Git-Tag: v3.14.0a1~1042
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ebc18abbf34ff248764bda1a02db7f1c783b71e3;p=thirdparty%2FPython%2Fcpython.git

gh-121977: Add tips for handling unhashable data (#122075)
---

diff --git a/Doc/library/statistics.rst b/Doc/library/statistics.rst
index f7051ae2c80e..614f5b905a4a 100644
--- a/Doc/library/statistics.rst
+++ b/Doc/library/statistics.rst
@@ -485,6 +485,12 @@ However, for reading convenience, most of the examples show sorted sequences.
       >>> mode(["red", "blue", "blue", "red", "green", "red", "red"])
       'red'
 
+   Only hashable inputs are supported.  To handle type :class:`set`,
+   consider casting to :class:`frozenset`.  To handle type :class:`list`,
+   consider casting to :class:`tuple`.  For mixed or nested inputs, consider
+   using this slower quadratic algorithm that only depends on equality tests:
+   ``max(data, key=data.count)``.
+
    .. versionchanged:: 3.8
       Now handles multimodal datasets by returning the first mode encountered.
       Formerly, it raised :exc:`StatisticsError` when more than one mode was