Deprecate positional out argument in dpnp.minimum

Author: vlad-perevezentsev

dpnp/dpnp_iface_mathematical.py

@@ -47,6 +47,7 @@
 
 import builtins
 import warnings
+from functools import wraps
 
 import dpctl.tensor as dpt
 import dpctl.tensor._tensor_elementwise_impl as ti
@@ -3344,14 +3345,31 @@ def interp(x, xp, fp, left=None, right=None, period=None):
 array(-inf)
 """
 
-minimum = DPNPBinaryFunc(
+_minimum_impl = DPNPBinaryFunc(
     "minimum",
     ti._minimum_result_type,
     ti._minimum,
     _MINIMUM_DOCSTRING,
 )
 
 
+@wraps(_minimum_impl)
+def minimum(*args, **kwargs):
+    """
+    Wrapper around `_minimum_impl` that emits a DeprecationWarning
+    when `out` is passed positionally.
+
+    """
+    if len(args) >= 3 and "out" not in kwargs:
+        warnings.warn(
+            "Positional `out` argument to `dpnp.minimum` is deprecated. "
+            "Please use the keyword form, e.g. `dpnp.minimum(a, b, out=c)`.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+    return _minimum_impl(*args, **kwargs)
+
+
 def modf(x1, **kwargs):
     """
     Return the fractional and integral parts of an array, element-wise.