Coverage for cuda/pathfinder/_dynamic_libs/load_dl_common.py: 100.00%

1# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. 

2# SPDX-License-Identifier: Apache-2.0 

3 

4from __future__ import annotations (empty)

5 

6from collections.abc import Callable (empty)

7from dataclasses import dataclass (empty)

8from typing import TYPE_CHECKING (empty)

9 

10if TYPE_CHECKING: (empty)

11 from cuda.pathfinder._dynamic_libs.lib_descriptor import LibDescriptor 

12 

13 

14class DynamicLibNotFoundError(RuntimeError): (empty)

15 pass (empty)

16 

17 

18class DynamicLibNotAvailableError(DynamicLibNotFoundError): (empty)

19 pass (empty)

20 

21 

22class DynamicLibUnknownError(DynamicLibNotFoundError): (empty)

23 pass (empty)

24 

25 

26@dataclass (empty)

27class LoadedDL: (empty)

28 abs_path: str | None (empty)

29 was_already_loaded_from_elsewhere: bool (empty)

30 _handle_uint: int # Platform-agnostic unsigned pointer value (empty)

31 found_via: str # "CUDA_PATH" covers both CUDA_PATH and CUDA_HOME env vars (empty)

32 

33 

34def load_dependencies(desc: LibDescriptor, load_func: Callable[[str], LoadedDL]) -> None: (empty)

35 """Load required dependencies, then best-effort runtime dependencies. 

36 

37 A plain ``DynamicLibNotFoundError`` from an optional dependency is 

38 suppressed. More specific contract errors and failures while loading a 

39 dependency that was found remain errors. 

40 """ 

41 for dep in desc.dependencies: 9 ctx1aheifbcgd

42 load_func(dep) 3 ctx1ifd

43 for dep in desc.optional_dependencies: 8 ctx1ahefbcgd

44 try: 6 ctx1efbcgd

45 load_func(dep) 6 ctx1efbcgd

46 except DynamicLibNotFoundError as exc: 5 ctx1ebcgd

47 # Both public contract errors inherit DynamicLibNotFoundError, but 

48 # neither an unknown descriptor nor platform incompatibility means 

49 # that an optional runtime component is simply absent. 

50 if type(exc) is not DynamicLibNotFoundError: 4 ctx1ebcd

51 raise 2 ctx1bc