File: //home/arjun/projects/env/lib/python3.10/site-packages/faker/__pycache__/documentor.cpython-310.pyc
o
'we� � @ s� d dl Z d dlZd dlmZmZ d dlmZmZmZm Z m
Z
m Z m Z ddl
mZ ddlmZ ddlmZ G dd � d e�ZG d
d � d �ZdS ) � N)�Enum�auto)�Any�Dict�List�Optional�Tuple�Type�Union� )� Generator)� BaseProvider)�Fakerc @ s e Zd ZdZeZeZdS )� FakerEnumz!Required for faker.providers.enumN)�__name__�
__module__� __qualname__�__doc__r �A�B� r r �I/home/arjun/projects/env/lib/python3.10/site-packages/faker/documentor.pyr s r c @ s� e Zd Zdeeef ddfdd�Z ddee dee e de
de e e e
eef f fd d
�Z dd
e dededede
eef f
dd�Zede defdd��ZdS )�
Documentor� generator�returnNc C s || _ d| _g | _dS )z�
:param generator: a localized Generator with providers filled,
for which to write the documentation
:type generator: faker.Generator()
r N)r � max_name_len�already_generated)�selfr r r r �__init__ s
zDocumentor.__init__�locale�excludes�kwargsc K sx d| _ |d u r g n|d d � | _g }| j�� }|d d d� D ]}|r+|jr+|j|kr+q |�|| j|fi |��f� q |S )Nr ���)r r r �
get_providers�__lang__�append�get_provider_formatters)r r r r! �
formatters� providers�providerr r r �get_formatters s
�zDocumentor.get_formatters�fake.Tr) �prefix� with_args�
with_defaultsc C s� i }t �|t j�D ]�\}}|�d�s|| jv rq g }g } i }
|dkr'd|
d< n |dv r3|
�ddd�� |dkr:tg} |r�t �|�} d d
� | jD �} t | �D ]9\}
}| j
r{|r{z| j
|
}t |t �rft
|�}n|� }|� d |� �}W n tyz Y nw |�|� |d kr� nqM|d kr�| jr�|�d
| j � | jr�|�d| j � |� |� dd�|�� d�}z| jj|g| �R i |
��}W n ttfy� } z
t�t |�� W Y d }~q d }~ww |||< t| jgdd� |�� D ��R � | _| j�|� q |S )N�_�binaryi �length)�zip�tari )�uncompressed_size�
min_file_size�enumc S s g | ]}|d vr|�qS ))r �clsr )�.0�xr r r �
<listcomp>S s z6Documentor.get_provider_formatters.<locals>.<listcomp>�=�first�*z**�(z, �)c s s � | ]}t |�V qd S �N)�len)r8 �partr r r � <genexpr>x s � z5Documentor.get_provider_formatters.<locals>.<genexpr>) �inspect�
getmembers�ismethod�
startswithr �updater �getfullargspec�args� enumerate�defaults�
isinstance�str�repr�
IndexErrorr% �varargs�varkw�joinr �format�AttributeError�
ValueError�warnings�warn�maxr �split)r r) r, r- r. r' �name�method� arguments�
faker_args� faker_kwargs�argspec�lst�i�arg�default� signature�example�er r r r& 0 sh
��
�
� ��"z"Documentor.get_provider_formatters�provider_classc C s | j S r@ )� __provider__)rh r r r �get_provider_name} s z Documentor.get_provider_name)NN)r+ TT)r r r r
r r r r rN r r r r
r r* �boolr& � staticmethodrj r r r r r s: ��
��
������
�Mr )rD rW r6 r r �typingr r r r r r r
r r r( r
�proxyr r r r r r r �<module> s $