Remove dpnp.asfarray()

Author: vlad-perevezentsev

doc/reference/array-manipulation.rst

@@ -72,7 +72,6 @@ Changing kind of array
    dpnp.asarray
    dpnp.asanyarray
    dpnp.asnumpy
-   dpnp.asfarray
    dpnp.asfortranarray
    dpnp.ascontiguousarray
    dpnp.asarray_chkfinite

dpnp/dpnp_iface_arraycreation.py

@@ -510,8 +510,7 @@ def asanyarray(
     See Also
     --------
     :obj:`dpnp.asarray` : Similar function which always returns ndarrays.
-    :obj:`dpnp.ascontiguousarray` : Convert input to a contiguous array.
-    :obj:`dpnp.asfarray` : Convert input to a floating point ndarray.
+    :obj:`dpnp.ascontiguousarray` : Convert input to a contiguous array.ы
     :obj:`dpnp.asfortranarray` : Convert input to an ndarray with column-major
                                  memory order.
     :obj:`dpnp.asarray_chkfinite` : Similar function which checks input
@@ -624,7 +623,6 @@ def asarray(
     --------
     :obj:`dpnp.asanyarray` : Similar function which passes through subclasses.
     :obj:`dpnp.ascontiguousarray` : Convert input to a contiguous array.
-    :obj:`dpnp.asfarray` : Convert input to a floating point ndarray.
     :obj:`dpnp.asfortranarray` : Convert input to an ndarray with column-major
                                  memory order.
     :obj:`dpnp.asarray_chkfinite` : Similar function which checks input

dpnp/dpnp_iface_manipulation.py

@@ -102,7 +102,6 @@ class UniqueInverseResult(NamedTuple):
     "append",
     "array_split",
     "asarray_chkfinite",
-    "asfarray",
     "atleast_1d",
     "atleast_2d",
     "atleast_3d",
@@ -845,79 +844,6 @@ def asarray_chkfinite(
     return a
 
 
-def asfarray(a, dtype=None, *, device=None, usm_type=None, sycl_queue=None):
-    """
-    Return an array converted to a float type.
-
-    For full documentation refer to :obj:`numpy.asfarray`.
-
-    Parameters
-    ----------
-    a : array_like
-        Input data, in any form that can be converted to an array.
-        This includes an instance of :class:`dpnp.ndarray` or
-        :class:`dpctl.tensor.usm_ndarray`, an object representing
-        SYCL USM allocation and implementing `__sycl_usm_array_interface__`
-        protocol, an instance of :class:`numpy.ndarray`, an object supporting
-        Python buffer protocol, a Python scalar, or a (possibly nested)
-        sequence of Python scalars.
-    dtype : {None, str, dtype object}, optional
-        Float type code to coerce input array `a`.  If `dtype` is ``None``,
-        :obj:`dpnp.bool` or one of the `int` dtypes, it is replaced with
-        the default floating type (:obj:`dpnp.float64` if a device supports it,
-        or :obj:`dpnp.float32` type otherwise).
-
-        Default: ``None``.
-    device : {None, string, SyclDevice, SyclQueue, Device}, optional
-        An array API concept of device where the output array is created.
-        `device` can be ``None``, a oneAPI filter selector string, an instance
-        of :class:`dpctl.SyclDevice` corresponding to a non-partitioned SYCL
-        device, an instance of :class:`dpctl.SyclQueue`, or a
-        :class:`dpctl.tensor.Device` object returned by
-        :attr:`dpnp.ndarray.device`.
-
-        Default: ``None``.
-    usm_type : {None, "device", "shared", "host"}, optional
-        The type of SYCL USM allocation for the output array.
-
-        Default: ``None``.
-    sycl_queue : {None, SyclQueue}, optional
-        A SYCL queue to use for output array allocation and copying. The
-        `sycl_queue` can be passed as ``None`` (the default), which means
-        to get the SYCL queue from `device` keyword if present or to use
-        a default queue.
-
-        Default: ``None``.
-
-    Returns
-    -------
-    out : dpnp.ndarray
-        The input `a` as a float ndarray.
-
-    Examples
-    --------
-    >>> import dpnp as np
-    >>> np.asfarray([2, 3])
-    array([2.,  3.])
-    >>> np.asfarray([2, 3], dtype=dpnp.float32)
-    array([2., 3.], dtype=float32)
-    >>> np.asfarray([2, 3], dtype=dpnp.int32)
-    array([2.,  3.])
-
-    """
-
-    _sycl_queue = dpnp.get_normalized_queue_device(
-        a, sycl_queue=sycl_queue, device=device
-    )
-
-    if dtype is None or not dpnp.issubdtype(dtype, dpnp.inexact):
-        dtype = dpnp.default_float_type(sycl_queue=_sycl_queue)
-
-    return dpnp.asarray(
-        a, dtype=dtype, usm_type=usm_type, sycl_queue=_sycl_queue
-    )
-
-
 def atleast_1d(*arys):
     """
     Convert inputs to arrays with at least one dimension.

dpnp/tests/test_arraymanipulation.py

@@ -10,38 +10,6 @@
 from .third_party.cupy import testing
 
 
-class TestAsfarray:
-    @testing.with_requires("numpy<2.0")
-    @pytest.mark.parametrize("dtype", get_all_dtypes())
-    @pytest.mark.parametrize(
-        "data", [[1, 2, 3], [1.0, 2.0, 3.0]], ids=["[1, 2, 3]", "[1., 2., 3.]"]
-    )
-    def test_asfarray1(self, dtype, data):
-        expected = numpy.asfarray(data, dtype)
-        result = dpnp.asfarray(data, dtype)
-        assert_array_equal(result, expected)
-
-    @testing.with_requires("numpy<2.0")
-    @pytest.mark.usefixtures("suppress_complex_warning")
-    @pytest.mark.parametrize("dtype", get_all_dtypes())
-    @pytest.mark.parametrize("data", [[1.0, 2.0, 3.0]], ids=["[1., 2., 3.]"])
-    @pytest.mark.parametrize("data_dtype", get_all_dtypes(no_none=True))
-    def test_asfarray2(self, dtype, data, data_dtype):
-        expected = numpy.asfarray(numpy.array(data, dtype=data_dtype), dtype)
-        result = dpnp.asfarray(dpnp.array(data, dtype=data_dtype), dtype)
-        assert_array_equal(result, expected)
-
-    # This is only for coverage with NumPy 2.0 and above
-    def test_asfarray_coverage(self):
-        expected = dpnp.array([1.0, 2.0, 3.0])
-        result = dpnp.asfarray([1, 2, 3])
-        assert_array_equal(result, expected)
-
-        expected = dpnp.array([1.0, 2.0, 3.0], dtype=dpnp.float32)
-        result = dpnp.asfarray([1, 2, 3], dtype=dpnp.float32)
-        assert_array_equal(result, expected)
-
-
 class TestAtleast1d:
     def test_0D_array(self):
         a = dpnp.array(1)

dpnp/tests/test_sycl_queue.py

@@ -1001,7 +1001,6 @@ def test_invalid_stream(self, stream):
         "asarray_chkfinite",
         "asanyarray",
         "ascontiguousarray",
-        "asfarray",
         "asfortranarray",
     ],
 )

dpnp/tests/test_usm_type.py

@@ -286,7 +286,6 @@ def test_copy_operation(usm_type):
         "asarray_chkfinite",
         "asanyarray",
         "ascontiguousarray",
-        "asfarray",
         "asfortranarray",
     ],
 )