3
ÌœŸW±  ã               @   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„ | j dƒD ƒ}t|ƒdkrB|d d tdj|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 | ]}|j ƒ ‘qS © )Úrstrip)Ú.0Úliner   r   úX/home/yuhw/wc/wire-cell-python/venv/lib/python3.6/site-packages/mayavi/tools/auto_doc.pyú
<listcomp>   s    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 }| jƒ jƒ }|jdƒ |jdƒ |t|ƒ7 }|S )zO Builds a docstring from the object's docstring, and it's traits
    help.
    Ú__doc__r
   Ú z**Keyword arguments:**Útrait_addedÚtrait_modified)Úhasattrr   r   Úclass_traitsÚcopyÚpopÚ
traits_doc)ÚklassÚdocÚtraitsr   r   r   Úmake_doc   s    


r   c             C   sD   d}t | jƒ ƒ}x.|D ]&}| | }|d dks|t||ƒ7 }qW |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 k	r0|}n†d}|j}|d k	rN||jƒ 7 }|j}|d k	r†t|dƒ sv|jttfkr†|d|j	ƒ  7 }|j
ƒ d }|dkr¶|j r¶|jƒ dt|ƒ  }d	t |ƒ }	x$t||	d
�D ]}
||
7 }||7 }qÐW |S )Nz

    :%s: r
   r   ú r   ÚaTypez Must be %s.z Default: %séK   )Úwidth)r   N)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   
