+
    O(i                         R t ^ RIt^ RIHt ^ RIHt ^RIHt ]].]3,          tR R lt	R R lt
R	 R
 lt ! R R4      t ! R R4      tR# )zA
.. codeauthor:: Tsuyoshi Hombashi <tsuyoshi.hombashi@gmail.com>
N)datetime)Callable)ValidationErrorc                0    V ^8  d   QhR\         R\        /#    ereturnr   str)formats   "Z/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/pathvalidate/handler.py__annotate__r      s      / c     c                <    \         P                  ! R\        4       R# )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   s   &r   return_null_stringr      s     MM`
 r   c                0    V ^8  d   QhR\         R\        /# r   r
   )r   s   "r   r   r   !   s     + + +C +r   c                    \         P                  ! R\        4       \        \        P
                  ! 4       P                  4       4      # )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   r   r   now	timestampr   s   &r   return_timestampr   !   s2     MMa
 x||~'')**r   c                0    V ^8  d   QhR\         R\        /# r   r
   )r   s   "r   r   r   3   s     
 
? 
s 
r   c                    V h)zNull value handler that always raises an exception.

Args:
    e (ValidationError): A validation error.

Raises:
    ValidationError: Always raised.
 r   s   &r   raise_errorr!   3   s	     Gr   c                   X   a  ] tR t^@t o ]V 3R lR l4       t]V 3R lR l4       tRtV tR# )NullValueHandlerc                &   < V ^8  d   QhRS[ RS[/# r   r
   )r   __classdict__s   "r   r   NullValueHandler.__annotate__B   s     
 
? 
s 
r   c                    R# )r   r   r    clsr   s   &&r   r   #NullValueHandler.return_null_stringA   s     r   c                &   < V ^8  d   QhRS[ RS[/# r   r
   )r   r%   s   "r   r   r&   O   s     
/ 
/ 
/S 
/r   c                Z    \        \        P                  ! 4       P                  4       4      # )r   )r   r   r   r   r(   s   &&r   r   !NullValueHandler.return_timestampN   s     8<<>++-..r   r    N)	__name__
__module____qualname____firstlineno__classmethodr   r   __static_attributes____classdictcell__r%   s   @r   r#   r#   @   s+     
 
 
/ 
/r   r#   c                   t   a  ] tR t^\t o ]V 3R lR l4       t]V 3R lR l4       t]V 3R lR l4       tRtV t	R# )	ReservedNameHandlerc                &   < V ^8  d   QhRS[ RS[/# r   r
   )r   r%   s   "r   r    ReservedNameHandler.__annotate__^   s     % % %3 %r   c                ~    VP                   R9   g   VP                  '       d   VP                   # RVP                    2# )zReserved 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(   s   &&r   add_leading_underscore*ReservedNameHandler.add_leading_underscore]   s4     ??k)Q___??"1??#$$r   c                &   < V ^8  d   QhRS[ RS[/# r   r
   )r   r%   s   "r   r   r9   o   s     % % %C %r   c                ~    VP                   R9   g   VP                  '       d   VP                   # VP                    R2# )zReserved 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(   s   &&r   add_trailing_underscore+ReservedNameHandler.add_trailing_underscoren   s4     ??k)Q___??"//"!$$r   c                &   < V ^8  d   QhRS[ RS[/# r   r
   )r   r%   s   "r   r   r9      s     
 
o 
# 
r   c                    VP                   # )zReserved name handler that returns the name as is.

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

Returns:
    str: The name as is.
)r?   r(   s   &&r   as_isReservedNameHandler.as_is   s     r   r    N)
r.   r/   r0   r1   r2   rA   rE   rI   r3   r4   r5   s   @r   r7   r7   \   s?     % %  % %  
 
r   r7   )__doc__r   r   typingr   errorr   r   ValidationErrorHandlerr   r   r!   r#   r7   r    r   r   <module>rO      sP       " "?"3S"89 $+$
/ /8. .r   