pygmt.grdclip: Remove parameter 'new' (Deprecated since v0.15.0) (#4343)

Author: yvonnefroehlich

pygmt/src/grdclip.py

@@ -10,14 +10,12 @@
 from pygmt.alias import Alias, AliasSystem
 from pygmt.clib import Session
 from pygmt.exceptions import GMTInvalidInput
-from pygmt.helpers import build_arg_list, deprecate_parameter, fmt_docstring
+from pygmt.helpers import build_arg_list, fmt_docstring
 
 __doctest_skip__ = ["grdclip"]
 
 
-# TODO(PyGMT>=0.19.0): Remove the deprecated "new" parameter.
 @fmt_docstring
-@deprecate_parameter("new", "replace", "v0.15.0", remove_version="v0.19.0")
 def grdclip(
     grid: PathLike | xr.DataArray,
     outgrid: PathLike | None = None,

pygmt/tests/test_grdclip.py

@@ -84,12 +84,6 @@ def test_grdclip_replace():
     grid = grdclip(grid=grid, replace=[0, 2])  # Replace 0 with 2
     npt.assert_array_equal(np.unique(grid), [1, 2])
 
-    # Test for the deprecated 'new' parameter
-    # TODO(PyGMT>=0.19.0): Remove this test below for the 'new' parameter
-    with pytest.warns(FutureWarning):
-        grid = grdclip(grid=grid, new=[1, 3])  # Replace 1 with 3
-    npt.assert_array_equal(np.unique(grid), [2, 3])
-
 
 def test_grdclip_between_repeated():
     """