__init__.py

"""
Module that deals with HSA in a high level way
"""
import os
import numba.testing
from .api import *
from .stubs import atomic

def is_available():
    """Returns a boolean to indicate the availability of a HSA runtime.

    This will force initialization of the driver if it hasn't been
    initialized. It also checks that a toolchain is present.
    """
    from .hsadrv.driver import hsa

    from .hlc import hlc, libhlc
    has_a_toolchain = False

    try:
       libhlc.HLC()
       has_a_toolchain = True
    except:
        try:
            cmd = hlc.CmdLine().check_tooling()
            has_a_toolchain = True
        except:
            pass

    return hsa.is_available and has_a_toolchain

if is_available():
    from .hsadrv.driver import hsa
    agents = list(hsa.agents)
else:
    agents = []

# sugon: adapt for numba-0.58, refer to numba/cuda/initialize.py, shoule move to numba/roc/initialize.py.
# TODO: suppot ROCmDispatcher completely.
def initialize_all():

    from numba.roc.decorators import jit
    from numba.core import dispatcher
    from numba.roc.descriptor import HSATargetDesc
    from numba.core.target_extension import (target_registry,
                                             dispatcher_registry,
                                             jit_registry)

    class ROCmDispatcher(dispatcher.Dispatcher):
        targetdescr = HSATargetDesc('ROCm')
    roc_target = target_registry["ROCm"]
    jit_registry[roc_target] = jit
    dispatcher_registry[roc_target] = ROCmDispatcher
initialize_all()

def test(*args, **kwargs):
    if not is_available():
        raise RuntimeError("HSA is not detected")

    return numba.testing.test("numba.hsa.tests", *args, **kwargs)