refactor(cuda.core): move managed_memory ops to cuda.core.utils

Per Leo's review request (#1775 (comment)),
fold the managed-memory free functions and the Location dataclass into
cuda.core.utils rather than maintaining a dedicated cuda.core.managed_memory
namespace.

- Re-export Location, advise, prefetch, discard, discard_prefetch from
  cuda.core.utils.
- Delete cuda.core.managed_memory module.
- Update cuda.core.__init__ to drop the managed_memory submodule import.
- Update tests to import from cuda.core.utils.
- Update api.rst: drop the dedicated Managed memory section; add the
  managed-memory entries to the Utility functions section.
- Update 1.0.0-notes.rst accordingly.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: rparolin

cuda_core/cuda/core/__init__.py

@@ -28,7 +28,7 @@ def _import_versioned_module():
 del _import_versioned_module
 
 
-from cuda.core import managed_memory, system, utils
+from cuda.core import system, utils
 from cuda.core._device import Device
 from cuda.core._event import Event, EventOptions
 from cuda.core._graphics import GraphicsResource

cuda_core/cuda/core/managed_memory.py

@@ -1,7 +1,14 @@
-# SPDX-FileCopyrightText: Copyright (c) 2024-2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-FileCopyrightText: Copyright (c) 2024-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 #
 # SPDX-License-Identifier: Apache-2.0
 
+from cuda.core._memory._managed_location import Location  # noqa: F401
+from cuda.core._memory._managed_memory_ops import (
+    advise,  # noqa: F401
+    discard,  # noqa: F401
+    discard_prefetch,  # noqa: F401
+    prefetch,  # noqa: F401
+)
 from cuda.core._memoryview import (
     StridedMemoryView,  # noqa: F401
     args_viewable_as_strided_memory,  # noqa: F401

cuda_core/cuda/core/utils.py

@@ -129,24 +129,6 @@ Each subclass exposes attributes unique to its operation type.
    graph.SwitchNode
 
 
-.. module:: cuda.core.managed_memory
-
-Managed memory
---------------
-
-.. autosummary::
-   :toctree: generated/
-
-   Location
-   advise
-   prefetch
-   discard
-   discard_prefetch
-
-.. module:: cuda.core
-   :no-index:
-
-
 Graphics interoperability
 -------------------------
 
@@ -265,7 +247,12 @@ Utility functions
    :toctree: generated/
 
    args_viewable_as_strided_memory
+   advise
+   prefetch
+   discard
+   discard_prefetch
 
    :template: autosummary/cyclass.rst
 
+   Location
    StridedMemoryView

cuda_core/docs/source/api.rst

@@ -16,17 +16,17 @@ Highlights
 New features
 ------------
 
-- Added managed-memory range operations under :mod:`cuda.core.managed_memory`:
-  :class:`~managed_memory.Location`, :func:`~managed_memory.advise`,
-  :func:`~managed_memory.prefetch`, :func:`~managed_memory.discard`, and
-  :func:`~managed_memory.discard_prefetch`. Each operation accepts either a
-  single managed :class:`Buffer` or a sequence; with cuda.bindings 12.8+
-  the N>1 case dispatches to the corresponding ``cuMem*BatchAsync`` driver
-  entry point, addressing the managed-memory portion of #1333. Locations
-  are expressed via the typed :class:`~managed_memory.Location` dataclass
-  (with classmethod constructors ``device``, ``host``, ``host_numa``, and
-  ``host_numa_current``); ``Device`` and ``int`` values are still accepted
-  for ergonomic compatibility.
+- Added managed-memory range operations to :mod:`cuda.core.utils`:
+  :class:`~utils.Location`, :func:`~utils.advise`, :func:`~utils.prefetch`,
+  :func:`~utils.discard`, and :func:`~utils.discard_prefetch`. Each
+  operation accepts either a single managed :class:`Buffer` or a
+  sequence; with cuda.bindings 12.8+ the N>1 case dispatches to the
+  corresponding ``cuMem*BatchAsync`` driver entry point, addressing the
+  managed-memory portion of #1333. Locations are expressed via the typed
+  :class:`~utils.Location` dataclass (with classmethod constructors
+  ``device``, ``host``, ``host_numa``, and ``host_numa_current``);
+  ``Device`` and ``int`` values are still accepted for ergonomic
+  compatibility.
 
 
 Fixes and enhancements