DOC: fix pr02 errors in docstrings - plot.bar, plot.barh, plot.line, plot.pie (pandas-dev#57266)

* bring "color" out of kwargs in bar,barh,line function signatures to match docstring

* bring "y" out of kwargs in pie function signatures to match docstring

* update code_checks for fixed docstrings

* change typehint from np Arraylike to Sequence to avoid dependence on np typing

* Use "IndexLabel" instead of generics

* rebundle args into kwargs before calling self to avoid "cannot use foo arg with bar arg" errors

Author: nkasing

ci/code_checks.sh

@@ -87,15 +87,7 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
         pandas.Series.cat.remove_categories\
         pandas.Series.cat.set_categories\
         pandas.Series.plot\
-        pandas.Series.plot.bar\
-        pandas.Series.plot.barh\
-        pandas.Series.plot.line\
-        pandas.Series.plot.pie\
         pandas.DataFrame.plot\
-        pandas.DataFrame.plot.bar\
-        pandas.DataFrame.plot.barh\
-        pandas.DataFrame.plot.line\
-        pandas.DataFrame.plot.pie\
         pandas.tseries.offsets.DateOffset\
         pandas.tseries.offsets.BusinessDay\
         pandas.tseries.offsets.BDay\

pandas/plotting/_core.py

@@ -1089,14 +1089,20 @@ def __call__(self, *args, **kwargs):
     @Substitution(kind="line")
     @Appender(_bar_or_line_doc)
     def line(
-        self, x: Hashable | None = None, y: Hashable | None = None, **kwargs
+        self,
+        x: Hashable | None = None,
+        y: Hashable | None = None,
+        color: str | Sequence[str] | dict | None = None,
+        **kwargs,
     ) -> PlotAccessor:
         """
         Plot Series or DataFrame as lines.
 
         This function is useful to plot lines using DataFrame's values
         as coordinates.
         """
+        if color is not None:
+            kwargs["color"] = color
         return self(kind="line", x=x, y=y, **kwargs)
 
     @Appender(
@@ -1178,7 +1184,11 @@ def line(
     @Substitution(kind="bar")
     @Appender(_bar_or_line_doc)
     def bar(  # pylint: disable=disallowed-name
-        self, x: Hashable | None = None, y: Hashable | None = None, **kwargs
+        self,
+        x: Hashable | None = None,
+        y: Hashable | None = None,
+        color: str | Sequence[str] | dict | None = None,
+        **kwargs,
     ) -> PlotAccessor:
         """
         Vertical bar plot.
@@ -1189,6 +1199,8 @@ def bar(  # pylint: disable=disallowed-name
         axis of the plot shows the specific categories being compared, and the
         other axis represents a measured value.
         """
+        if color is not None:
+            kwargs["color"] = color
         return self(kind="bar", x=x, y=y, **kwargs)
 
     @Appender(
@@ -1266,7 +1278,11 @@ def bar(  # pylint: disable=disallowed-name
     @Substitution(kind="bar")
     @Appender(_bar_or_line_doc)
     def barh(
-        self, x: Hashable | None = None, y: Hashable | None = None, **kwargs
+        self,
+        x: Hashable | None = None,
+        y: Hashable | None = None,
+        color: str | Sequence[str] | dict | None = None,
+        **kwargs,
     ) -> PlotAccessor:
         """
         Make a horizontal bar plot.
@@ -1277,6 +1293,8 @@ def barh(
         axis of the plot shows the specific categories being compared, and the
         other axis represents a measured value.
         """
+        if color is not None:
+            kwargs["color"] = color
         return self(kind="barh", x=x, y=y, **kwargs)
 
     def box(self, by: IndexLabel | None = None, **kwargs) -> PlotAccessor:
@@ -1602,7 +1620,7 @@ def area(
         """
         return self(kind="area", x=x, y=y, stacked=stacked, **kwargs)
 
-    def pie(self, **kwargs) -> PlotAccessor:
+    def pie(self, y: IndexLabel | None = None, **kwargs) -> PlotAccessor:
         """
         Generate a pie plot.
 
@@ -1649,6 +1667,8 @@ def pie(self, **kwargs) -> PlotAccessor:
 
             >>> plot = df.plot.pie(subplots=True, figsize=(11, 6))
         """
+        if y is not None:
+            kwargs["y"] = y
         if (
             isinstance(self._parent, ABCDataFrame)
             and kwargs.get("y", None) is None