config

def default_logging():
    """Add a formatted stream handler to the `navis` logger.

    Called by default when navis is imported for the first time.
    To prevent this behaviour, set an environment variable:
    `NAVIS_SKIP_LOG_SETUP=True`.
    """
    logger.setLevel(logging.INFO)
    if len(logger.handlers) == 0:
        sh = logging.StreamHandler()
        sh.setLevel(logging.DEBUG)
        # Create formatter and add it to the handlers
        formatter = logging.Formatter(
            '%(levelname)-5s : %(message)s (%(name)s)')
        sh.setFormatter(formatter)
        logger.addHandler(sh)

def get_logger(name: str):
    if skip_log_setup:
        return logging.getLogger(name)
    return logger

def is_jupyter():
    """Test if navis is run in a Jupyter notebook."""
    return _type_of_script() == 'jupyter'

def remove_log_handlers():
    """Remove all handlers from the `navis` logger.

    It may be preferable to skip navis' default log handler being added in the
    first place.
    Do this by setting an environment variable before the first import:
    `NAVIS_SKIP_LOG_SETUP=True`.
    """
    logger.handlers.clear()