Error Handling and Utilities

def failed() -> bool:
    """
    Check if a SPICE error has occurred.
    
    Returns:
    bool: True if SPICE error flag is set
    """

def reset() -> None:
    """
    Reset SPICE error status.
    
    Returns:
    None
    """

def getmsg(option: str, lenout: int) -> str:
    """
    Retrieve SPICE error message.
    
    Parameters:
    - option: str, message type ("SHORT", "EXPLAIN", "LONG")
    - lenout: int, maximum message length
    
    Returns:
    str: error message
    """

def exists(file: str) -> bool:
    """
    Test whether a file exists.
    
    Parameters:
    - file: str, file path
    
    Returns:
    bool: True if file exists
    """

def iswhsp(string: str) -> bool:
    """
    Test whether string is whitespace.
    
    Parameters:
    - string: str, input string
    
    Returns:
    bool: True if string contains only whitespace
    """

def no_found_check():
    """
    Context manager to disable 'found' flag checking.
    
    Usage:
    with spice.no_found_check():
        # SPICE operations that might not find data
        pass
    """

def found_check():
    """
    Context manager to enable 'found' flag checking.
    
    Usage:
    with spice.found_check():
        # SPICE operations with strict error checking
        pass
    """

import spiceypy as spice

# Perform SPICE operation
spice.furnsh("nonexistent.bsp")

# Check for errors
if spice.failed():
    error_msg = spice.getmsg("SHORT", 40)
    print(f"SPICE error: {error_msg}")
    spice.reset()  # Clear error status

from spiceypy.utils.exceptions import SpiceyError

try:
    # SPICE operations
    position, lt = spice.spkpos("MARS", et, "J2000", "NONE", "EARTH")
except SpiceyError as e:
    print(f"SPICE error occurred: {e.short}")
    print(f"Explanation: {e.explain}")