+ 7*ics,a0t$Rt^RIHt^RIHtHtHtHt^RI H t H t H t ^RI HtHt^RIHtRtRtR]R &!RR ]4t]R,tR]R &!RR]4t!RR]4t!RR]]4t!RR ]]4tRtR]R&!RR ]]4tR#)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) ExtraValuesPydanticPluginProtocolBaseValidateHandlerProtocolValidatePythonHandlerProtocolValidateJsonHandlerProtocolValidateStringsHandlerProtocolNewSchemaReturnsSchemaTypePath SchemaKindvtuple[ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None]r cs0]tRt^t$RtR]R&R]R&RtR#)rzQPath defining where `schema_type` was defined, or where `TypeAdapter` was called.ZstrZmoduleZnameN)__name__ __module__ __qualname____firstlineno____doc____annotations____static_attributes__r=/usr/lib/python3.14/site-packages/pydantic/plugin/__init__.pyrrs[ K Ircs&]tRt^(tRtRRltRtR#)r z5Protocol defining the interface for Pydantic plugins.cs4V^8dQhRRRRRRRRR R R R R R/#)schemar schema_typerschema_type_pathr schema_kindrconfigzCoreConfig | Noneplugin_settingszdict[str, object]returnrrZformat"r __annotate__Z#PydanticPluginProtocol.__annotate__+sY____) _  _ " _+_ _rc s\R4h)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`.)ZNotImplementedError)selfrr r!r"r#r$s&&&&&&&rnew_schema_validatorZ+PydanticPluginProtocol.new_schema_validator+s:""]^^rrN)rrrrrr*rrrrr r (s?__rcsL]tRt^Kt$RtR]R&RRltRRltRR ltR t R #) r zBase 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_enterc V^8dQhRRRR/#)rresultrr%Nonerr&r'rr((BaseValidateHandlerProtocol.__annotate__Usrc R#)zcCallback to be notified of successful validation. Args: result: The result of the validation. Nr)r)r-&&r on_successZ&BaseValidateHandlerProtocol.on_successU rcr,)rerrorrr%r.rr&r'rr(r/]so$rc r0)zVCallback to be notified of validation errors. Args: error: The validation error. Nr)r)r4r1ron_errorZ$BaseValidateHandlerProtocol.on_error]r3rcr,)r exceptionZ Exceptionr%r.rr&r'rr(r/esiDrc r0)zpCallback to be notified of validation exceptions. Args: exception: The exception raised during validation. Nr)r)r6r1r on_exceptionZ(BaseValidateHandlerProtocol.on_exceptioner3rrN) rrrrrrr2r5r7rrrrr r Ks& "!ErcsF]tRt^ntRtRRRRRRRRRRRRR R/R R lltR tR#) r z4Event handler for `SchemaValidator.validate_python`.strictNextrafrom_attributescontext self_instanceby_aliasby_namecs<V^8dQhRRRRRRRRRR R R R RR RR R/ #)rinputrr8 bool | Noner9ExtraValues | Noner:r; Any | Noner<r=r>r%r.rr&r'rr(Z*ValidatePythonHandlerProtocol.__annotate__qsd     "  %   "     rc r0)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. extra: Whether to ignore, allow, or forbid extra data during model validation. 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)r?r8r9r:r;r<r=r>s &&$$$$$$$rr+Z&ValidatePythonHandlerProtocol.on_enterqrrrrrrrr+rrrrr r nsU> #  %)  (,  # %) !%  $  rc sB]tRt^tRtRRRRRRRRRRRR/R R lltR tR#) rz2Event handler for `SchemaValidator.validate_json`.r8Nr9r;r<r=r>cs8V^8dQhRRRRRRRRR RR RR RR R /#)rr?zstr | bytes | bytearrayr8r@r9rAr;rBr<r=r>r%r.rr&r'rr(Z(ValidateJsonHandlerProtocol.__annotate__sZ  &   "    "     rc r0)aCallback 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. extra: Whether to ignore, allow, or forbid extra data during model validation. 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)r?r8r9r;r<r=r>s&&$$$$$$rr+Z$ValidateJsonHandlerProtocol.on_enterrCrrrDrrrrrsK< #  %)  #  %) !%  $  rzdict[str, StringInput] StringInputc s>]tRt^tRtRRRRRRRRRR/RR lltR tR#) rz5Event handler for `SchemaValidator.validate_strings`.r8Nr9r;r=r>cs4V^8dQhRRRRRRRRR RR RR R /#) rr?rEr8r@r9rAr;rBr=r>r%r.rr&r'rr(Z+ValidateStringsHandlerProtocol.__annotate__sP     "        rc r0)a"Callback 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. extra: Whether to ignore, allow, or forbid extra data during model validation. 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)r?r8r9r;r=r>s&&$$$$$rr+Z'ValidateStringsHandlerProtocol.on_enterrCrrrDrrrrrsA? #  %)  #  !%  $  rN)r r r rrrrr)Z BaseModelZ TypeAdapterZ dataclassZ create_modelZ validate_call)__conditional_annotations__rZ __future__rZtypingrrrrZ pydantic_corerrrZtyping_extensionsrr Zpydantic.configr Z__all__rrrrr r r rrEr)rFs@rrGs #55AA1' W)WZ hi Ii _X _F ( F $? < "=x 82 Y1 %@( r