traversal.{to,from}_numpy: mark deprecated

Author: inducer

arraycontext/__init__.py

@@ -51,7 +51,7 @@
     flat_size_and_dtype,
     flatten,
     freeze,
-    from_numpy,
+    from_numpy,  # pyright: ignore[reportDeprecated]
     map_array_container,
     map_reduce_array_container,
     mapped_over_array_containers,
@@ -66,7 +66,7 @@
     rec_multimap_reduce_array_container,
     stringify_array_container_tree,
     thaw,
-    to_numpy,
+    to_numpy,  # pyright: ignore[reportDeprecated]
     unflatten,
     with_array_context,
 )

arraycontext/container/traversal.py

@@ -106,6 +106,8 @@
 from arraycontext.typing import (
     ArrayContainer,
     ArrayContainerT,
+    NumpyOrContainerOrScalar,
+    ScalarLike,
     is_scalar_like,
     shape_is_int_only,
 )
@@ -1108,11 +1110,14 @@ def _flat_size(subary: ArrayOrContainerOrScalar) -> Array | int | np.integer:
 
 # }}}
 
+
 class _HasOuterBcastTypes(Protocol):
     _outer_bcast_types: ClassVar[Collection[type]]
 
+
 # {{{ numpy conversion
 
+@deprecated("use ArrayContext.from_numpy")
 def from_numpy(
         ary: np.ndarray | ScalarLike,
         actx: ArrayContext) -> ArrayOrContainerOrScalar:
@@ -1128,7 +1133,10 @@ def from_numpy(
     return actx.from_numpy(ary)
 
 
-def to_numpy(ary: ArrayOrContainer, actx: ArrayContext) -> ArrayOrContainer:
+@deprecated("use ArrayContext.to_numpy")
+def to_numpy(
+            ary: ArrayOrContainerOrScalar, actx: ArrayContext
+        ) -> NumpyOrContainerOrScalar:
     """Convert all arrays in the :class:`~arraycontext.ArrayContainer` to
     :mod:`numpy` using the provided :class:`~arraycontext.ArrayContext` *actx*.