API: Remove kwargs from GroupBy

Author: topper-123

pandas/core/generic.py

@@ -7830,7 +7830,7 @@ def groupby(
         group_keys=True,
         squeeze=False,
         observed=False,
-        **kwargs
+        mutated=False,
     ):
         """
         Group DataFrame or Series using a mapper or by a Series of columns.
@@ -7875,10 +7875,8 @@ def groupby(
             If False: show all values for categorical groupers.
 
             .. versionadded:: 0.23.0
-
-        **kwargs
-            Optional, only accepts keyword argument 'mutated' and is passed
-            to groupby.
+        mutated : bool, False
+            `mutated` is passed to groupby.
 
         Returns
         -------
@@ -7956,7 +7954,7 @@ def groupby(
             group_keys=group_keys,
             squeeze=squeeze,
             observed=observed,
-            **kwargs
+            mutated=mutated,
         )
 
     def asfreq(self, freq, method=None, how=None, normalize=False, fill_value=None):

pandas/core/groupby/groupby.py

@@ -26,7 +26,6 @@ class providing the base-class of operations.
 from pandas.compat.numpy import function as nv
 from pandas.errors import AbstractMethodError
 from pandas.util._decorators import Appender, Substitution, cache_readonly
-from pandas.util._validators import validate_kwargs
 
 from pandas.core.dtypes.cast import maybe_downcast_to_dtype
 from pandas.core.dtypes.common import (
@@ -349,12 +348,12 @@ def __init__(
         grouper=None,
         exclusions=None,
         selection=None,
-        as_index=True,
-        sort=True,
-        group_keys=True,
-        squeeze=False,
-        observed=False,
-        **kwargs
+        as_index: bool = True,
+        sort: bool = True,
+        group_keys: bool = True,
+        squeeze: bool = False,
+        observed: bool = False,
+        mutated: bool = False,
     ):
 
         self._selection = selection
@@ -376,7 +375,7 @@ def __init__(
         self.group_keys = group_keys
         self.squeeze = squeeze
         self.observed = observed
-        self.mutated = kwargs.pop("mutated", False)
+        self.mutated = mutated
 
         if grouper is None:
             from pandas.core.groupby.grouper import get_grouper
@@ -396,9 +395,6 @@ def __init__(
         self.grouper = grouper
         self.exclusions = set(exclusions) if exclusions else set()
 
-        # we accept no other args
-        validate_kwargs("group", kwargs, {})
-
     def __len__(self):
         return len(self.groups)
 

pandas/tests/window/test_grouper.py

@@ -13,7 +13,7 @@ def setup_method(self, method):
 
     def test_mutated(self):
 
-        msg = r"group\(\) got an unexpected keyword argument 'foo'"
+        msg = r"groupby\(\) got an unexpected keyword argument 'foo'"
         with pytest.raises(TypeError, match=msg):
             self.frame.groupby("A", foo=1)