__init__.py

from pathlib import Path

from ..types import StrOrPath
from .clr_error import ClrError
from .coreclr_errors import get_coreclr_error
from .find import find_dotnet_root
from .hostfxr_errors import get_hostfxr_error

__all__ = [
    "check_result",
    "find_dotnet_root",
    "path_as_string",
    "optional_path_as_string",
]


def optional_path_as_string(path: StrOrPath | None) -> str | None:
    if path is None:
        return None
    return path_as_string(path)


def path_as_string(path: StrOrPath) -> str:
    return str(Path(path))


def check_result(err_code: int) -> None:
    """Check the error code of a .NET hosting API function and raise a
    converted exception.

    :raises ClrError: If the error code is `< 0`
    """

    if err_code < 0:
        hresult = err_code & 0xFFFF_FFFF
        error = get_coreclr_error(hresult)
        if not error:
            error = get_hostfxr_error(hresult)
        if not error:
            error = ClrError(hresult)
        raise error