a
    «ˆc±  ã                   @   sD   d Z ddlmZmZ ddlZeZdd„ Zdd„ Zdd	„ Zd
d„ ZdS )z/
Automatic documentation from traited objects.
é    )ÚwrapÚdedentNc                 C   sJ   dd„ |   d¡D ƒ}t|ƒdkrB|d d td |dd… ¡ƒ S | S dS )ze Removes as much indentation as possible from some text, but does
    not modify the first line.
    c                 S   s   g | ]}|  ¡ ‘qS © )Úrstrip)Ú.0Úliner   r   úX/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/mayavi/tools/auto_doc.pyÚ
<listcomp>   ó    zdedent.<locals>.<listcomp>Ú
r   é   N)ÚsplitÚlenÚ
old_dedentÚjoin)ÚtextZ
text_linesr   r   r   r      s    ÿr   c                 C   sZ   t | dƒrt| jƒd }nd}|tdƒ7 }|  ¡  ¡ }| d¡ | d¡ |t|ƒ7 }|S )zO Builds a docstring from the object's docstring, and it's traits
    help.
    Ú__doc__r   Ú z**Keyword arguments:**Ztrait_addedZtrait_modified)Úhasattrr   r   Zclass_traitsÚcopyÚpopÚ
traits_doc)ÚklassÚdocÚtraitsr   r   r   Úmake_doc   s    


r   c                 C   s@   d}t |  ¡ ƒ}|D ]&}| | }|d dks|t||ƒ7 }q|S )Nr   r   Ú_)ÚsortedÚkeysÚformat_argument)r   r   Ztraits_namesÚ
trait_nameÚ	trait_objr   r   r   r   +   s    r   c                 C   sä   d|  }dt |ƒd d  }|j}|d ur0|}n‚d}|j}|d urN|| ¡ 7 }|j}|d ur„t|dƒrt|jttfvr„|d| 	¡  7 }| 
¡ d }|dvr²|js²| ¡ d	t|ƒ  }d
t |ƒ }	t||	d�D ]}
||
7 }||7 }qÊ|S )Nz

    :%s: r   r   ú r   ÚaTypez Must be %s.)r   Nz Default: %séK   )Úwidth)r   ÚhelpÚdescr   Úhandlerr   r#   ÚintÚfloatÚinfoÚdefault_valueÚarrayÚstrr   )r    r!   r   Úpadr&   Zarg_descr'   r(   ÚdefaultZ
desc_widthr   r   r   r   r   5   s.    
ÿ
r   )	r   Útextwrapr   r   Útypesr   r   r   r   r   r   r   r   Ú<module>   s   
