o ڭj@sUdZddlmZddlmZmZmZmZddlm Z m Z m Z ddl m Z mZddlmZdZdZd ed <Gd d d eZed Zd ed<Gddde ZGddde ZGdddee ZGdddee ZdZd ed<Gdddee ZdS)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) ExtraValues)PydanticPluginProtocolBaseValidateHandlerProtocolValidatePythonHandlerProtocolValidateJsonHandlerProtocolValidateStringsHandlerProtocolNewSchemaReturnsSchemaTypePath SchemaKindvtuple[ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None]r rc@s"eZdZUdZded<ded<dS)rzQPath defining where `schema_type` was defined, or where `TypeAdapter` was called.strmodulenameN)__name__ __module__ __qualname____doc____annotations__rrU/var/www/html/CropPilot/venv/lib/python3.10/site-packages/pydantic/plugin/__init__.pyrs  r) BaseModel TypeAdapter dataclass create_model validate_callrc@seZdZdZdddZdS)r z5Protocol defining the interface for Pydantic plugins.schemar schema_typerschema_type_pathr schema_kindrconfigCoreConfig | Noneplugin_settingsdict[str, object]returnrcCstd)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+rrrnew_schema_validator+sz+PydanticPluginProtocol.new_schema_validatorN)r%rr&rr'rr(rr)r*r+r,r-r)rrrrr0rrrrr (sr c@s:eZdZUdZded< ddd Zdd d ZdddZdS)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_enterresultrr-NonecCdS)z{Callback to be notified of successful validation. Args: result: The result of the validation. Nr)r/r2rrr on_successUz&BaseValidateHandlerProtocol.on_successerrorr cCr4)znCallback to be notified of validation errors. Args: error: The validation error. Nr)r/r7rrron_error]r6z$BaseValidateHandlerProtocol.on_error exception ExceptioncCr4)zCallback to be notified of validation exceptions. Args: exception: The exception raised during validation. Nr)r/r9rrr on_exceptioner6z(BaseValidateHandlerProtocol.on_exceptionN)r2rr-r3)r7r r-r3)r9r:r-r3)rrrrrr5r8r;rrrrrKs   rc@s,eZdZdZdddddddddddZdS)rz4Event handler for `SchemaValidator.validate_python`.N)strictextrafrom_attributescontext self_instanceby_aliasby_nameinputrr< bool | Noner=ExtraValues | Noner>r? Any | Noner@rArBr-r3c Cr4)amCallback 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/rCr<r=r>r?r@rArBrrrr1qz&ValidatePythonHandlerProtocol.on_enter)rCrr<rDr=rEr>rDr?rFr@rFrArDrBrDr-r3rrrrr1rrrrrnsrc@s*eZdZdZddddddddddZdS)rz2Event handler for `SchemaValidator.validate_json`.N)r<r=r?r@rArBrCstr | bytes | bytearrayr<rDr=rEr?rFr@rArBr-r3cCr4)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/rCr<r=r?r@rArBrrrr1rGz$ValidateJsonHandlerProtocol.on_enter)rCrIr<rDr=rEr?rFr@rFrArDrBrDr-r3rHrrrrrsrzdict[str, StringInput] StringInputc@s(eZdZdZdddddddddZdS)rz5Event handler for `SchemaValidator.validate_strings`.N)r<r=r?rArBrCrJr<rDr=rEr?rFrArBr-r3cCr4)abCallback 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/rCr<r=r?rArBrrrr1rGz'ValidateStringsHandlerProtocol.on_enter)rCrJr<rDr=rEr?rFrArDrBrDr-r3rHrrrrrsrN)r __future__rtypingrrrr pydantic_corerrr typing_extensionsr r pydantic.configr __all__rrrrr rrrrJrrrrrs    ##