Source code for mantidimaging.core.utility.optional_imports

# Copyright (C) 2022 ISIS Rutherford Appleton Laboratory UKRI
# SPDX - License - Identifier: GPL-3.0-or-later
"""
A place for availability checking and import logic for optional dependencies to
live.
"""

import importlib
import traceback
import warnings

from io import StringIO
from logging import getLogger




def safe_import(name):
    """
    Try to import an optional library that may not be present.

    Will fail gracefully by returning None if the library is not available.
    """
    try:
        module = importlib.import_module(name)

    except ImportError:
        warnings.warn('Failed to import optional module "{}"'.format(name))

        o = StringIO()
        traceback.print_stack(file=o)
        getLogger(__name__).debug('Module import stack trace: {}'.format(o.getvalue()))

        module = None

    return module





def check_availability(name):
    return safe_import(name) is not None





def tomopy_available():
    return check_availability('tomopy')