API Docs MCP Server

o �I�g�@sZdZd
dl
Z
ddlmZ
ddlmZmZmZmZ
gd�
Z dd�Z edfd d �
Zdd�ZdS) z Commonly useful converters. �N�
)
�_AnnotationExtractor)�NOTHING� Converter�Factory�pipe)�default_if_none�optionalr�to_boolc
s�t�t
�r�f
d
d�}
n�f
dd�}
t��
}|��}|r$tj||
jd<|��}|r2tj||
jd<t�t
�r>t
|
ddd�S|
S) a_
A converter that allows an attribute to be optional. An optional attribute is one which can be set to `None`. Type annotations will be inferred from the wrapped converter's, if it has any. Args: converter (typing.Callable): the converter that is used for non-`None` values. .. versionadded:: 17.1.0 cs|durdS�||
|�S�
N�)�val�inst�field�
� converterr�]C:\Users\apqls\Documents\Github\tkbase\api-docs-mcp\venv\Lib\site-packages\attr/converters.py�optional_converter&s


z$optional.<locals>.optional_converterc

s|durdS�|�
Srr�
r rrrr-s


r �returnT)� takes_selfZtakes_fieldN)� isinstancerrZget_first_param_type�typing�Optional�__annotations__Zget_return_type)rrZxtr�
t�rtrrrr s 




r cs��tur|
d
urd}t
|�
�
�tu
r|
d
u
rd}t
|�
�
|
d
u
r$t|
�
�t�t�r:�jr2d}t|�
�
�f
dd�}|S�f
dd�}|S)a� A converter that allows to replace `None` values by *default* or the result of *factory*. Args: default: Value to be used if `None` is passed. Passing an instance of `attrs.Factory` is supported, however the ``takes_self`` option is *not*. factory (typing.Callable): A callable that takes no parameters whose result is used if `None` is passed. Raises: TypeError: If **neither** *default* or *factory* is passed. TypeError: If **both** *default* and *factory* are passed. ValueError: If an instance of `attrs.Factory` is passed with ``takes_self=True``. .. versionadded:: 18.2.0 Nz(Must pass either `default` or `factory`.z5Must pass either `default` or `factory` but not both.z1`takes_self` is not supported by default_if_none.c

s|du
r|S���Sr)
�factoryr�
�defaultrr�default_if_none_converterls

z2default_if_none.<locals>.default_if_none_converterc

s|du
r|S�Srrrrrrr ts

)r� TypeErrorrrr� ValueError)rr�msgr rrrrBs 







�rc
Cs<t|t
�r |��}|d
vrdS|dvrdSd|��}
t|
�
�
)a�
Convert "boolean" strings (for example, from environment variables) to real booleans. Values mapping to `True`: - ``True`` - ``"true"`` / ``"t"`` - ``"yes"`` / ``"y"`` - ``"on"`` - ``"1"`` - ``1`` Values mapping to `False`: - ``False`` - ``"false"`` / ``"f"`` - ``"no"`` / ``"n"`` - ``"off"`` - ``"0"`` - ``0`` Raises: ValueError: For any other value. .. versionadded:: 21.3.0 )T�truer�yes�
y�on�
1rT)F�false�
f�no�
n�off�
0r
FzCannot convert value to bool: N)r�str�lowerr")r r#rrrr }s 




r ) �__doc__rZ_compatr�_makerrrr�__all__r rr rrrr�<module>
s
-;