+ NV-j,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 c0]tRt^t$RtR]R&R]R&RtR#)rzQPath defining where `schema_type` was defined, or where `TypeAdapter` was called.strmodulenameN)__name__ __module__ __qualname____firstlineno____doc____annotations____static_attributes__ri/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/pydantic/plugin/__init__.pyrrs[ K Ir"c&]tRt^(tRtRRltRtR#)r z5Protocol defining the interface for Pydantic plugins.c4V^8dQhRRRRRRRRR R R R R R/#)schemar schema_typerschema_type_pathr schema_kindrconfigzCoreConfig | Noneplugin_settingszdict[str, object]returnrr)formats"r# __annotate__#PydanticPluginProtocol.__annotate__+sY____) _  _ " _+_ _r"c \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`.)NotImplementedError)selfr'r(r)r*r+r,s&&&&&&&r#new_schema_validator+PydanticPluginProtocol.new_schema_validator+s:""]^^r"rN)rrrrrr4r!rr"r#r r (s?__r"cL]tRt^Kt$RtR]R&RRltRRltRR ltR t R #) rzBase 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/#)r&resultrr-Noner)r.s"r#r/(BaseValidateHandlerProtocol.__annotate__Usr"c R#)zcCallback to be notified of successful validation. Args: result: The result of the validation. Nr)r3r9s&&r# on_success&BaseValidateHandlerProtocol.on_successU r"c V^8dQhRRRR/#)r&errorr r-r:r)r.s"r#r/r;]so$r"c R#)zVCallback to be notified of validation errors. Args: error: The validation error. Nr)r3rAs&&r#on_error$BaseValidateHandlerProtocol.on_error]r?r"c V^8dQhRRRR/#)r& exception Exceptionr-r:r)r.s"r#r/r;esiDr"c R#)zpCallback to be notified of validation exceptions. Args: exception: The exception raised during validation. Nr)r3rFs&&r# on_exception(BaseValidateHandlerProtocol.on_exceptioner?r"rN) rrrrrr r=rCrIr!rr"r#rrKs& "!Er"cF]tRt^ntRtRRRRRRRRRRRRR R/R R lltR tR#) rz4Event handler for `SchemaValidator.validate_python`.strictNextrafrom_attributescontext self_instanceby_aliasby_namec<V^8dQhRRRRRRRRRR R R R RR RR R/ #)r&inputrrL bool | NonerMExtraValues | NonerNrO Any | NonerPrQrRr-r:r)r.s"r#r/*ValidatePythonHandlerProtocol.__annotate__qsd     "  %   "     r"c R#)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) r3rTrLrMrNrOrPrQrRs &&$$$$$$$r#r7&ValidatePythonHandlerProtocol.on_enterqr"rrrrrrr7r!rr"r#rrnsU> #  %)  (,  # %) !%  $  r"c B]tRt^tRtRRRRRRRRRRRR/R R lltR tR#) rz2Event handler for `SchemaValidator.validate_json`.rLNrMrOrPrQrRc8V^8dQhRRRRRRRRR RR RR RR R /#)r&rTzstr | bytes | bytearrayrLrUrMrVrOrWrPrQrRr-r:r)r.s"r#r/(ValidateJsonHandlerProtocol.__annotate__sZ  &   "    "     r"c R#)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)r3rTrLrMrOrPrQrRs&&$$$$$$r#r7$ValidateJsonHandlerProtocol.on_enterr[r"rr\rr"r#rrsK< #  %)  #  %) !%  $  r"zdict[str, StringInput] StringInputc >]tRt^tRtRRRRRRRRRR/RR lltR tR#) rz5Event handler for `SchemaValidator.validate_strings`.rLNrMrOrQrRc4V^8dQhRRRRRRRRR RR RR R /#) r&rTrbrLrUrMrVrOrWrQrRr-r:r)r.s"r#r/+ValidateStringsHandlerProtocol.__annotate__sP     "        r"c R#)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)r3rTrLrMrOrQrRs&&$$$$$r#r7'ValidateStringsHandlerProtocol.on_enterr[r"rr\rr"r#rrsA? #  %)  #  !%  $  r"N)r rrrrrrr) BaseModel TypeAdapter dataclass create_model validate_call)__conditional_annotations__r __future__rtypingrrrr pydantic_corerrr typing_extensionsr r pydantic.configr __all__rr rrr rrrrbr)rms@r#rts #55AA1' W)WZ hi Ii _X _F ( F $? < "=x 82 Y1 %@( r"