Merge pull request matplotlib#11204 from anntzer/boilerplate-test

TST: Test that boilerplate.py is correctly run.

Author: tacaswell

lib/matplotlib/pyplot.py

@@ -2259,8 +2259,12 @@ def axvspan(xmin, xmax, ymin=0, ymax=1, **kwargs):
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy_dedent(Axes.bar)
-def bar(*args, data=None, **kwargs):
-    return gca().bar(*args, data=data, **kwargs)
+def bar(
+        x, height, width=0.8, bottom=None, *, align='center',
+        data=None, **kwargs):
+    return gca().bar(
+        x=x, height=height, width=width, bottom=bottom, align=align,
+        data=data, **kwargs)
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy_dedent(Axes.barbs)
@@ -2269,8 +2273,10 @@ def barbs(*args, data=None, **kw):
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy_dedent(Axes.barh)
-def barh(*args, **kwargs):
-    return gca().barh(*args, **kwargs)
+def barh(y, width, height=0.8, left=None, *, align='center', **kwargs):
+    return gca().barh(
+        y=y, width=width, height=height, left=left, align=align,
+        **kwargs)
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy_dedent(Axes.boxplot)
@@ -2496,8 +2502,8 @@ def magnitude_spectrum(
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy_dedent(Axes.margins)
-def margins(*args, **kw):
-    return gca().margins(*args, **kw)
+def margins(*margins, x=None, y=None, tight=True):
+    return gca().margins(*margins, x=x, y=y, tight=tight)
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy_dedent(Axes.minorticks_off)
@@ -2511,15 +2517,25 @@ def minorticks_on():
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @_autogen_docstring(Axes.pcolor)
-def pcolor(*args, data=None, **kwargs):
-    __ret = gca().pcolor(*args, data=data, **kwargs)
+def pcolor(
+        *args, alpha=None, norm=None, cmap=None, vmin=None,
+        vmax=None, data=None, **kwargs):
+    __ret = gca().pcolor(
+        *args, alpha=alpha, norm=norm, cmap=cmap, vmin=vmin,
+        vmax=vmax, data=data, **kwargs)
     sci(__ret)
     return __ret
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @_autogen_docstring(Axes.pcolormesh)
-def pcolormesh(*args, data=None, **kwargs):
-    __ret = gca().pcolormesh(*args, data=data, **kwargs)
+def pcolormesh(
+        *args, alpha=None, norm=None, cmap=None, vmin=None,
+        vmax=None, shading='flat', antialiased=False, data=None,
+        **kwargs):
+    __ret = gca().pcolormesh(
+        *args, alpha=alpha, norm=norm, cmap=cmap, vmin=vmin,
+        vmax=vmax, shading=shading, antialiased=antialiased,
+        data=data, **kwargs)
     sci(__ret)
     return __ret
 
@@ -2550,8 +2566,9 @@ def pie(
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy_dedent(Axes.plot)
-def plot(*args, data=None, **kwargs):
-    return gca().plot(*args, data=data, **kwargs)
+def plot(*args, scalex=True, scaley=True, data=None, **kwargs):
+    return gca().plot(
+        *args, scalex=scalex, scaley=scaley, data=data, **kwargs)
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy_dedent(Axes.plot_date)
@@ -2642,13 +2659,19 @@ def stackplot(x, *args, data=None, **kwargs):
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy_dedent(Axes.stem)
-def stem(*args, data=None, **kwargs):
-    return gca().stem(*args, data=data, **kwargs)
+def stem(
+        *args, linefmt=None, markerfmt=None, basefmt=None, bottom=0,
+        label=None, data=None):
+    return gca().stem(
+        *args, linefmt=linefmt, markerfmt=markerfmt, basefmt=basefmt,
+        bottom=bottom, label=label, data=data)
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy_dedent(Axes.step)
-def step(x, y, *args, data=None, **kwargs):
-    return gca().step(x=x, y=y, *args, data=data, **kwargs)
+def step(x, y, *args, where='pre', linestyle='', data=None, **kwargs):
+    return gca().step(
+        x=x, y=y, *args, where=where, linestyle=linestyle, data=data,
+        **kwargs)
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @_autogen_docstring(Axes.streamplot)
@@ -2685,8 +2708,13 @@ def tick_params(axis='both', **kwargs):
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy_dedent(Axes.ticklabel_format)
-def ticklabel_format(**kwargs):
-    return gca().ticklabel_format(**kwargs)
+def ticklabel_format(
+        *, axis='both', style='', scilimits=None, useOffset=None,
+        useLocale=None, useMathText=None):
+    return gca().ticklabel_format(
+        axis=axis, style=style, scilimits=scilimits,
+        useOffset=useOffset, useLocale=useLocale,
+        useMathText=useMathText)
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @_autogen_docstring(Axes.tricontour)

lib/matplotlib/tests/test_pyplot.py

@@ -0,0 +1,21 @@
+import subprocess
+import sys
+from pathlib import Path
+
+import pytest
+
+import matplotlib as mpl
+from matplotlib import pyplot as plt
+
+
+def test_pyplot_up_to_date():
+    gen_script = Path(mpl.__file__).parents[2] / "tools/boilerplate.py"
+    if not gen_script.exists():
+        pytest.skip("boilerplate.py not found")
+    orig_contents = Path(plt.__file__).read_text()
+    try:
+        subprocess.run([sys.executable, str(gen_script)], check=True)
+        new_contents = Path(plt.__file__).read_text()
+        assert orig_contents == new_contents
+    finally:
+        Path(plt.__file__).write_text(orig_contents)