.. SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
.. SPDX-License-Identifier: Apache-2.0

.. py:currentmodule:: cuda.pathfinder

``cuda-pathfinder`` 1.3.0 Release notes
=======================================

Released on Sep 29, 2025

Important update to the ``load_nvidia_dynamic_lib`` documentation
-----------------------------------------------------------------

The documentation for :func:`cuda.pathfinder.load_nvidia_dynamic_lib` now calls out
an important behavior:

* **Do not close** the OS handle returned (``LoadedDL._handle_uint``). Avoid
  ``dlclose`` (Linux) and ``FreeLibrary`` (Windows).

* **Reason:** the function's result is cached (``functools.cache``) and shared across
  the process. Closing the handle can unload the module while other code still holds
  a reference, which may cause crashes or latent errors.

This note is documentation‑only; there is no API change in 1.3.0. See issue #1011
for background and discussion:
https://github.com/NVIDIA/cuda-python/issues/1011

Highlights
----------

* Add a Conda-specific search into ``load_nvidia_dynamic_lib()``.
  This makes the search more intuitive and predictable.
  (`PR #1003 <https://github.com/NVIDIA/cuda-python/pull/1003>`_)
