Skip to content

Errors

Pydantic-specific errors.

PydanticErrorMixin

PydanticErrorMixin(
    message: str, *, code: PydanticErrorCodes | None
)

A mixin class for common functionality shared by all Pydantic-specific errors.

Attributes:

Name Type Description
message

A message describing the error.

code

An optional error code from PydanticErrorCodes enum.

Source code in pydantic/errors.py
79
80
81
def __init__(self, message: str, *, code: PydanticErrorCodes | None) -> None:
    self.message = message
    self.code = code

PydanticUserError

PydanticUserError(
    message: str, *, code: PydanticErrorCodes | None
)

Bases: PydanticErrorMixin, TypeError

An error raised due to incorrect use of Pydantic.

Source code in pydantic/errors.py
79
80
81
def __init__(self, message: str, *, code: PydanticErrorCodes | None) -> None:
    self.message = message
    self.code = code

PydanticUndefinedAnnotation

PydanticUndefinedAnnotation(name: str, message: str)

Bases: PydanticErrorMixin, NameError

A subclass of NameError raised when handling undefined annotations during CoreSchema generation.

Attributes:

Name Type Description
name

Name of the error.

message

Description of the error.

Source code in pydantic/errors.py
102
103
104
def __init__(self, name: str, message: str) -> None:
    self.name = name
    super().__init__(message=message, code='undefined-annotation')

from_name_error classmethod

from_name_error(name_error: NameError) -> Self

Convert a NameError to a PydanticUndefinedAnnotation error.

Parameters:

Name Type Description Default
name_error NameError

NameError to be converted.

required

Returns:

Type Description
Self

Converted PydanticUndefinedAnnotation error.

Source code in pydantic/errors.py
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
@classmethod
def from_name_error(cls, name_error: NameError) -> Self:
    """Convert a `NameError` to a `PydanticUndefinedAnnotation` error.

    Args:
        name_error: `NameError` to be converted.

    Returns:
        Converted `PydanticUndefinedAnnotation` error.
    """
    try:
        name = name_error.name  # type: ignore  # python > 3.10
    except AttributeError:
        name = re.search(r".*'(.+?)'", str(name_error)).group(1)  # type: ignore[union-attr]
    return cls(name=name, message=str(name_error))

PydanticImportError

PydanticImportError(message: str)

Bases: PydanticErrorMixin, ImportError

An error raised when an import fails due to module changes between V1 and V2.

Attributes:

Name Type Description
message

Description of the error.

Source code in pydantic/errors.py
130
131
def __init__(self, message: str) -> None:
    super().__init__(message, code='import-error')

PydanticSchemaGenerationError

PydanticSchemaGenerationError(message: str)

Bases: PydanticUserError

An error raised during failures to generate a CoreSchema for some type.

Attributes:

Name Type Description
message

Description of the error.

Source code in pydantic/errors.py
141
142
def __init__(self, message: str) -> None:
    super().__init__(message, code='schema-for-unknown-type')

PydanticInvalidForJsonSchema

PydanticInvalidForJsonSchema(message: str)

Bases: PydanticUserError

An error raised during failures to generate a JSON schema for some CoreSchema.

Attributes:

Name Type Description
message

Description of the error.

Source code in pydantic/errors.py
152
153
def __init__(self, message: str) -> None:
    super().__init__(message, code='invalid-for-json-schema')