h5%SrSSKJr SSKJrJrJrJr SSKJ r J r J r SSK J r Jr SrSrS\S '"S S \5r\S rS\S '"SS\ 5r"SS\ 5r"SS\\ 5r"SS\\ 5rSrS\S'"SS\\ 5rg)z!!! abstract "Usage Documentation" [Build a Plugin](../concepts/plugins.md#build-a-plugin) Plugin interface for Pydantic plugins, and related types. ) annotations)AnyCallableLiteral NamedTuple) CoreConfig CoreSchemaValidationError)Protocol TypeAlias)PydanticPluginProtocolBaseValidateHandlerProtocolValidatePythonHandlerProtocolValidateJsonHandlerProtocolValidateStringsHandlerProtocolNewSchemaReturnsSchemaTypePath SchemaKindvtuple[ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None]r rc.\rSrSr%SrS\S'S\S'Srg)rzQPath defining where `schema_type` was defined, or where `TypeAdapter` was called.strmodulenameN)__name__ __module__ __qualname____firstlineno____doc____annotations____static_attributes__rJ/var/www/html/env/lib/python3.13/site-packages/pydantic/plugin/__init__.pyrrs[ K Ir#r) BaseModel TypeAdapter dataclass create_model validate_callrc>\rSrSrSrSSjrSrg)r &z5Protocol defining the interface for Pydantic plugins.c[S5e)aThis method is called for each plugin every time a new [`SchemaValidator`][pydantic_core.SchemaValidator] is created. It should return an event handler for each of the three validation methods, or `None` if the plugin does not implement that method. Args: schema: The schema to validate against. schema_type: The original type which the schema was created from, e.g. the model class. schema_type_path: Path defining where `schema_type` was defined, or where `TypeAdapter` was called. schema_kind: The kind of schema to validate against. config: The config to use for validation. plugin_settings: Any plugin settings. Returns: A tuple of optional event handlers for each of the three validation methods - `validate_python`, `validate_json`, `validate_strings`. z9Pydantic plugins should implement `new_schema_validator`.)NotImplementedError)selfschema schema_typeschema_type_path schema_kindconfigplugin_settingss r$new_schema_validator+PydanticPluginProtocol.new_schema_validator)s:""]^^r#rN)r/r r0rr1rr2rr3zCoreConfig | Noner4zdict[str, object]returnr)rrrrr r5r"rr#r$r r &sV?___) _  _ " _+_ _r#r cD\rSrSr%SrS\S'S SjrS SjrS SjrSr g ) rIzBase class for plugin callbacks protocols. You shouldn't implement this protocol directly, instead use one of the subclasses with adds the correctly typed `on_error` method. zCallable[..., None]on_entercg)zcCallback to be notified of successful validation. Args: result: The result of the validation. Nr)r.results r$ on_success&BaseValidateHandlerProtocol.on_successS r#cg)zVCallback to be notified of validation errors. Args: error: The validation error. Nr)r.errors r$on_error$BaseValidateHandlerProtocol.on_error[r?r#cg)zpCallback to be notified of validation exceptions. Args: exception: The exception raised during validation. Nr)r. exceptions r$ on_exception(BaseValidateHandlerProtocol.on_exceptioncr?r#rN)r<rr7None)rAr r7rH)rE Exceptionr7rH) rrrrr r!r=rBrFr"rr#r$rrIs! "!Er#rcR\rSrSrSrSSSSSSS.SSjjrSrg)rlz4Event handler for `SchemaValidator.validate_python`.N)strictfrom_attributescontext self_instanceby_aliasby_namecg)aCallback to be notified of validation start, and create an instance of the event handler. Args: input: The input to be validated. strict: Whether to validate the object in strict mode. from_attributes: Whether to validate objects as inputs by extracting attributes. context: The context to use for validation, this is passed to functional validators. self_instance: An instance of a model to set attributes on from validation, this is used when running validation from the `__init__` method of a model. by_alias: Whether to use the field's alias to match the input data to an attribute. by_name: Whether to use the field's name to match the input data to an attribute. Nr)r.inputrLrMrNrOrPrQs r$r:&ValidatePythonHandlerProtocol.on_enteros. r#r)rSrrL bool | NonerMrUrNdict[str, Any] | NonerO Any | NonerPrUrQrUr7rHrrrrr r:r"rr#r$rrlsq> #'+)-$( $#    %  '  "      r#rcL\rSrSrSrSSSSSS.SSjjrSrg)rz2Event handler for `SchemaValidator.validate_json`.N)rLrNrOrPrQcg)aqCallback to be notified of validation start, and create an instance of the event handler. Args: input: The JSON data to be validated. strict: Whether to validate the object in strict mode. context: The context to use for validation, this is passed to functional validators. self_instance: An instance of a model to set attributes on from validation, this is used when running validation from the `__init__` method of a model. by_alias: Whether to use the field's alias to match the input data to an attribute. by_name: Whether to use the field's name to match the input data to an attribute. Nr)r.rSrLrNrOrPrQs r$r:$ValidateJsonHandlerProtocol.on_enters* r#r)rSzstr | bytes | bytearrayrLrUrNrVrOrWrPrUrQrUr7rHrXrr#r$rrsd< #)-$( $# &   '  "       r#rzdict[str, StringInput] StringInputcF\rSrSrSrSSSSS.SSjjrSrg)rz5Event handler for `SchemaValidator.validate_strings`.N)rLrNrPrQcg)aCallback to be notified of validation start, and create an instance of the event handler. Args: input: The string data to be validated. strict: Whether to validate the object in strict mode. context: The context to use for validation, this is passed to functional validators. by_alias: Whether to use the field's alias to match the input data to an attribute. by_name: Whether to use the field's name to match the input data to an attribute. Nr)r.rSrLrNrPrQs r$r:'ValidateStringsHandlerProtocol.on_enters$ r#r) rSr]rLrUrNrVrPrUrQrUr7rHrXrr#r$rrsW? #)- $#    '        r#rN)r __future__rtypingrrrr pydantic_corerr r typing_extensionsr r __all__rr!rrr rrrr]rrr#r$rgs #55AA1 W)WZ hi Ii _X _F ( F $? : "=x 62 Y1 %@( r#