
    df@                        U d Z ddlmZ ddlmZmZ ddlmZmZm	Z	 ddl
mZmZ dZdZded	<    G d
 de      Z G d de      Z G d dee      Z G d dee      ZdZded<    G d dee      Zy)zUsage docs: https://docs.pydantic.dev/2.4/concepts/plugins#build-a-plugin

Plugin interface for Pydantic plugins, and related types.
    )annotations)AnyCallable)
CoreConfig
CoreSchemaValidationError)Protocol	TypeAlias)PydanticPluginProtocolBaseValidateHandlerProtocolValidatePythonHandlerProtocolValidateJsonHandlerProtocolValidateStringsHandlerProtocolNewSchemaReturnsvtuple[ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None]r
   r   c                  (    e Zd ZdZ	 	 	 	 	 	 	 	 ddZy)r   z5Protocol defining the interface for Pydantic plugins.c                    t        d      )az  This 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.
            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)selfschemaconfigplugin_settingss       Q/home/api-vastappli/venv/lib/python3.12/site-packages/pydantic/plugin/__init__.pynew_schema_validatorz+PydanticPluginProtocol.new_schema_validator   s    . ""]^^    N)r   r   r   zCoreConfig | Noner   zdict[str, object]returnr   )__name__
__module____qualname____doc__r    r   r   r   r      s5    ?__ "_ +	_

_r   r   c                  .    e Zd ZU dZded<   	 ddZddZy)	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.
    zCallable[..., None]on_enterc                     y)z{Callback to be notified of successful validation.

        Args:
            result: The result of the validation.
        Nr!   )r   results     r   
on_successz&BaseValidateHandlerProtocol.on_success?        	r   c                     y)znCallback to be notified of validation errors.

        Args:
            error: The validation error.
        Nr!   )r   errors     r   on_errorz$BaseValidateHandlerProtocol.on_errorG   r'   r   N)r%   r   r   None)r)   r   r   r+   )r   r   r   r    __annotations__r&   r*   r!   r   r   r   r   5   s     "!Er   r   c                  :    e Zd ZdZddddd	 	 	 	 	 	 	 	 	 	 	 ddZy)r   z4Event handler for `SchemaValidator.validate_python`.N)strictfrom_attributescontextself_instancec                    y)aT  Callback 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.
        Nr!   )r   inputr.   r/   r0   r1   s         r   r#   z&ValidatePythonHandlerProtocol.on_enterS   s    & 	r   )r3   r   r.   bool | Noner/   r4   r0   dict[str, Any] | Noner1   
Any | Noner   r+   r   r   r   r    r#   r!   r   r   r   r   P   sR    > #'+)-$( 	
 % ' " 
r   r   c                  4    e Zd ZdZdddd	 	 	 	 	 	 	 	 	 ddZy)r   z2Event handler for `SchemaValidator.validate_json`.N)r.   r0   r1   c                    y)a  Callback 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.
        Nr!   )r   r3   r.   r0   r1   s        r   r#   z$ValidateJsonHandlerProtocol.on_enterl   s    " 	r   )
r3   zstr | bytes | bytearrayr.   r4   r0   r5   r1   r6   r   r+   r7   r!   r   r   r   r   i   sE    < #)-$(& 	
 ' " 
r   r   zdict[str, StringInput]StringInputc                  .    e Zd ZdZddd	 	 	 	 	 	 	 ddZy)r   z5Event handler for `SchemaValidator.validate_strings`.N)r.   r0   c                    y)aI  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.
            context: The context to use for validation, this is passed to functional validators.
        Nr!   )r   r3   r.   r0   s       r   r#   z'ValidateStringsHandlerProtocol.on_enter   s     	r   )r3   r:   r.   r4   r0   r5   r   r+   r7   r!   r   r   r   r      s3    ? <@bf
 
-8
J_
	
r   r   N)r    
__future__r   typingr   r   pydantic_corer   r   r   typing_extensionsr	   r
   __all__r   r,   r   r   r   r   r:   r   r!   r   r   <module>rB      s    #   A A 1 W )  W_X _:( 6$? 2"=x . 2Y 1%@( r   