DEPR: enforce deprecation of non-standard argument to take

doc/source/whatsnew/v3.0.0.rst

@@ -202,6 +202,7 @@ Removal of prior version deprecations/changes
 - Enforced deprecation of :meth:`.DataFrameGroupBy.get_group` and :meth:`.SeriesGroupBy.get_group` allowing the ``name`` argument to be a non-tuple when grouping by a list of length 1 (:issue:`54155`)
 - Enforced deprecation of :meth:`Series.interpolate` and :meth:`DataFrame.interpolate` for object-dtype (:issue:`57820`)
 - Enforced deprecation of ``axis=None`` acting the same as ``axis=0`` in the DataFrame reductions ``sum``, ``prod``, ``std``, ``var``, and ``sem``, passing ``axis=None`` will now reduce over both axes; this is particularly the case when doing e.g. ``numpy.sum(df)`` (:issue:`21597`)
+- Enforced deprecation of non-standard (``np.ndarray``, :class:`ExtensionArray`, :class:`Index`, or :class:`Series`) argument to :func:`api.extensions.take` (:issue:`52981`)
 - Enforced deprecation of parsing system timezone strings to ``tzlocal``, which depended on system timezone, pass the 'tz' keyword instead (:issue:`50791`)
 - Enforced deprecation of passing a dictionary to :meth:`SeriesGroupBy.agg` (:issue:`52268`)
 - Enforced deprecation of string ``AS`` denoting frequency in :class:`YearBegin` and strings ``AS-DEC``, ``AS-JAN``, etc. denoting annual frequencies with various fiscal year starts (:issue:`57793`)

pandas/core/algorithms.py

@@ -1180,12 +1180,9 @@ def take(
     """
     if not isinstance(arr, (np.ndarray, ABCExtensionArray, ABCIndex, ABCSeries)):
         # GH#52981
-        warnings.warn(
-            "pd.api.extensions.take accepting non-standard inputs is deprecated "
-            "and will raise in a future version. Pass either a numpy.ndarray, "
-            "ExtensionArray, Index, or Series instead.",
-            FutureWarning,
-            stacklevel=find_stack_level(),
+        raise TypeError(
+            "pd.api.extensions.take requires a numpy.ndarray, "
+            f"ExtensionArray, Index, or Series, got {type(arr).__name__}."
         )
 
     if not is_array_like(arr):

pandas/tests/test_take.py

@@ -299,9 +299,11 @@ def test_take_na_empty(self):
         tm.assert_numpy_array_equal(result, expected)
 
     def test_take_coerces_list(self):
+        # GH#52981 coercing is deprecated, disabled in 3.0
         arr = [1, 2, 3]
-        msg = "take accepting non-standard inputs is deprecated"
-        with tm.assert_produces_warning(FutureWarning, match=msg):
-            result = algos.take(arr, [0, 0])
-        expected = np.array([1, 1])
-        tm.assert_numpy_array_equal(result, expected)
+        msg = (
+            "pd.api.extensions.take requires a numpy.ndarray, ExtensionArray, "
+            "Index, or Series, got list"
+        )
+        with pytest.raises(TypeError, match=msg):
+            algos.take(arr, [0, 0])