Source code for py_hla_match.exceptions

class MalformedHLAStringError(Exception):
    """
    Error raised when an HLA string is malformed or cannot be parsed.
    """
    def __init__(self, message, details=None):
        """
        :param message: Error message.
        :param details: Optional additional details about the error.
        """
        super().__init__(message)
        self.details = details

    def __str__(self):
        base_message = super().__str__()
        if self.details:
            return f"{base_message} (Details: {self.details})"
        return base_message





class EmptyHLAStringError(MalformedHLAStringError):
    """
    Error raised when an HLA string is empty.
    """
    def __init__(self, message, details=None):
        """
        :param message: Error message.
        :param details: Optional additional details about the error.
        """
        super().__init__(message)
        self.details = details

    def __str__(self):
        base_message = super().__str__()
        if self.details:
            return f"{base_message} (Details: {self.details})"
        return base_message





class InvalidLocusComparisonError(Exception):
    """
    Exception raised when attempting to compare alleles from different loci.
    """
    def __init__(self, locus1, locus2):
        message = (
            f"Invalid locus comparison between '{locus1}' and '{locus2}'."
        )
        super().__init__(message)
        self.locus1 = locus1
        self.locus2 = locus2

    def __str__(self):
        return super().__str__()





class MalformedHLADataSourceError(Exception):
    """
    Error raised when an HLA data source is malformed or cannot be parsed.
    """
    def __init__(self, message, details=None):
        """
        :param message: Error message.
        :param details: Optional additional details about the error.
        """
        super().__init__(message)
        self.details = details

    def __str__(self):
        base_message = super().__str__()
        if self.details:
            return f"{base_message} (Details: {self.details})"
        return base_message





class ARDMatchRefinementError(Exception):
    """
    Error raised during refinement of ARD matched HLA alleles.
    """
    def __init__(self, message, details=None):
        super().__init__(message)
        self.details = details

    def __str__(self):
        base_message = super().__str__()
        if self.details:
            return f"{base_message} (Details: {self.details})"
        return base_message





class PyardLibraryError(Exception):
    """
    Error raised when the external 'pyard' library fails unexpectedly.
    """
    def __init__(self, message, details=None):
        """
        :param message: Error message describing the failure.
        :param details: Optional additional context or traceback details.
        """
        super().__init__(f"pyard error: {message}")
        self.details = details

    def __str__(self):
        base_message = super().__str__()
        if self.details:
            return f"{base_message} (Details: {self.details})"
        return base_message