o
    ­ƒðjÃ  ã                   @   s”   d Z ddlZddlmZ ddlmZ ddlmZ eegef Zdedefd	d
„Z	dedefdd„Z
dedefdd„ZG dd„ dƒZG dd„ dƒZdS )zA
.. codeauthor:: Tsuyoshi Hombashi <tsuyoshi.hombashi@gmail.com>
é    N)Údatetime)ÚCallableé   )ÚValidationErrorÚeÚreturnc                 C   s   t  dt¡ dS )z¤Null value handler that always returns an empty string.

    Args:
        e (ValidationError): A validation error.

    Returns:
        str: An empty string.
    zV'return_null_string' is deprecated. Use 'NullValueHandler.return_null_string' instead.Ú )ÚwarningsÚwarnÚDeprecationWarning©r   © r   ú–/tmp/claude-1000/-var-www-html-academy/3f42efd1-c2b7-4d08-9b05-30d86bb35479/scratchpad/piper/venv/lib/python3.10/site-packages/pathvalidate/handler.pyÚreturn_null_string   s
   
þr   c                 C   s   t  dt¡ tt ¡  ¡ ƒS )zµNull value handler that returns a timestamp of when the function was called.

    Args:
        e (ValidationError): A validation error.

    Returns:
        str: A timestamp.
    zW'return_timestamp' is deprecated. Use 'NullValueHandler.reserved_name_handler' instead.)r	   r
   r   Ústrr   ÚnowÚ	timestampr   r   r   r   Úreturn_timestamp!   s
   
þr   c                 C   s   | ‚)z©Null value handler that always raises an exception.

    Args:
        e (ValidationError): A validation error.

    Raises:
        ValidationError: Always raised.
    r   r   r   r   r   Úraise_error3   s   
r   c                   @   s8   e Zd Zededefdd„ƒZededefdd„ƒZdS )ÚNullValueHandlerr   r   c                 C   s   dS )z¸Null value handler that always returns an empty string.

        Args:
            e (ValidationError): A validation error.

        Returns:
            str: An empty string.
        r   r   ©Úclsr   r   r   r   r   A   s   z#NullValueHandler.return_null_stringc                 C   s   t t ¡  ¡ ƒS )zÉNull value handler that returns a timestamp of when the function was called.

        Args:
            e (ValidationError): A validation error.

        Returns:
            str: A timestamp.
        )r   r   r   r   r   r   r   r   r   N   s   z!NullValueHandler.return_timestampN)Ú__name__Ú
__module__Ú__qualname__Úclassmethodr   r   r   r   r   r   r   r   r   @   s
    r   c                   @   sN   e Zd Zededefdd„ƒZededefdd„ƒZededefdd„ƒZd	S )
ÚReservedNameHandlerr   r   c                 C   s"   |j dv s|jr|j S d|j › �S )zúReserved name handler that adds a leading underscore (``"_"``) to the name
        except for ``"."`` and ``".."``.

        Args:
            e (ValidationError): A reserved name error.

        Returns:
            str: The converted name.
        ©Ú.z..Ú_©Úreserved_nameÚreusable_namer   r   r   r   Úadd_leading_underscore]   ó   z*ReservedNameHandler.add_leading_underscorec                 C   s"   |j dv s|jr|j S |j › d�S )zûReserved name handler that adds a trailing underscore (``"_"``) to the name
        except for ``"."`` and ``".."``.

        Args:
            e (ValidationError): A reserved name error.

        Returns:
            str: The converted name.
        r   r   r    r   r   r   r   Úadd_trailing_underscoren   r$   z+ReservedNameHandler.add_trailing_underscorec                 C   s   |j S )zµReserved name handler that returns the name as is.

        Args:
            e (ValidationError): A reserved name error.

        Returns:
            str: The name as is.
        )r!   r   r   r   r   Úas_is   s   zReservedNameHandler.as_isN)	r   r   r   r   r   r   r#   r%   r&   r   r   r   r   r   \   s    r   )Ú__doc__r	   r   Útypingr   Úerrorr   r   ÚValidationErrorHandlerr   r   r   r   r   r   r   r   r   Ú<module>   s    