MNT: Change default name of ListedColormaps

timhoffm · timhoffm · commit 2dd81752c8a8 · 2025-09-09T00:02:35.000+02:00
from "from_list" to "unnamed", which makes more sense logically.

While technically a breaking change, I anticipate that nobody is relying
 on that default value.
diff --git a/doc/api/next_api_changes/behavior/30532-TH.rst b/doc/api/next_api_changes/behavior/30532-TH.rst
@@ -0,0 +1,4 @@
+Default name of ``ListedColormap``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The default name of `ListedColormap` has changed from "from_list" to "unnamed".
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
@@ -1322,7 +1322,7 @@ class ListedColormap(Colormap):
                 "and will be removed in %(removal)s. Please ensure the list "
                 "of passed colors is the required length instead."
     )
-    def __init__(self, colors, name='from_list', N=None, *,
+    def __init__(self, colors, name='unnamed', N=None, *,
                  bad=None, under=None, over=None):
         if N is None:
             self.colors = colors

Original file line number	Diff line number	Diff line change
`@@ -1322,7 +1322,7 @@ class ListedColormap(Colormap):`
`1322`	`1322`	`"and will be removed in %(removal)s. Please ensure the list "`
`1323`	`1323`	`"of passed colors is the required length instead."`
`1324`	`1324`	`)`
`1325`		`- def __init__(self, colors, name='from_list', N=None, *,`
	`1325`	`+ def __init__(self, colors, name='unnamed', N=None, *,`
`1326`	`1326`	`bad=None, under=None, over=None):`
`1327`	`1327`	`if N is None:`
`1328`	`1328`	`self.colors = colors`