3
I4W^ã  ã            
   @   s0  d dl mZ d dl mZ d dl mZ d dl mZ d dlZd dlZd dlmZm	Z	 d dl
mZ d dlmZmZ e	jjZG d	d
„ d
eƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZedk�r,ejdd�Zejdedd� ejƒ Zeejdƒ�(Z eeƒ eƒ ƒZ!e!j"ƒ  e j#e!j$ƒ W dQ R X dS )é    )Úabsolute_import)Údivision)Úprint_function)Úunicode_literalsN)ÚcoreÚ	workspace)ÚMarkdown)Ú	viewitemsÚ
viewvaluesc               @   s   e Zd Zdd„ Zdd„ ZdS )ÚDocUploaderc             C   s   d S )N© )Úselfr   r   ú=/tmp/pip-build-e66j97b2/torch/caffe2/python/docs/generator.pyÚ__init__   s    zDocUploader.__init__c             C   s   d S )Nr   )r   Útextr   r   r   Úupload   s    zDocUploader.uploadN)Ú__name__Ú
__module__Ú__qualname__r   r   r   r   r   r   r      s   r   c               @   s$   e Zd Zdd„ Zdd„ Zdd„ ZdS )ÚDocGeneratorc             C   s   || _ || _d| _d S )NÚ )Ú	formatterÚuploaderÚcontent_body)r   r   r   r   r   r   r      s    zDocGenerator.__init__c             C   s   d S )Nr   )r   r   r   r   Úcreate_body   s    zDocGenerator.create_bodyc             C   s   | j j| jƒ d S )N)r   r   r   )r   r   r   r   Úupdate!   s    zDocGenerator.updateN)r   r   r   r   r   r   r   r   r   r   r      s   r   c               @   s,   e Zd Zdd„ Zdd„ Zdd„ Zdd„ Zd	S )
ÚOpDocGeneratorc             C   s   t |||ƒS )N)ÚOperatorDoc)r   ÚnameÚschemaÚpriorityr   r   r   ÚgetOperatorDoc&   s    zOpDocGenerator.getOperatorDocc             C   s   t |ƒS )N)ÚOperatorEngine)r   r   r   r   r   ÚgetOperatorEngine)   s    z OpDocGenerator.getOperatorEnginec             C   s  i | _ i | _dd„ }xªtjƒ D ]ž}tj|ƒ}|r\|tjj|j	ƒƒ}| j
|||ƒ}|| j |< q|jdƒd	kr¤| j|ƒ}|j| jkr”| j|j j|ƒ q¼|g| j|j< qd}| j
|||ƒ| j |< qW x0t| jƒD ]"\}}|| j krÌ| j | j|ƒ qÌW tt| j ƒdd„ d�S )
Nc             S   s4   | dkrdS d| j dƒkrdS d| j dƒkr0dS dS )	Nzcaffe2/caffe2/operatorsr   Úcontribú/é   Zexperimentsé   é   )Úsplit)Úxr   r   r   ÚfilePriority2   s    z1OpDocGenerator.getOperators.<locals>.filePriorityÚ_ENGINE_r(   é   c             S   s   | j | jfS )N)r    r   )Úopr   r   r   Ú<lambda>V   s    z-OpDocGenerator.getOperators.<locals>.<lambda>)Úkeyéÿÿÿÿ)Ú	operatorsÚenginesr   Z_GetRegisteredOperatorsÚOpSchemaÚgetÚosÚpathÚdirnameÚfiler!   Úfindr#   Úbase_op_nameÚappendr	   Ú
addEnginesÚsortedr
   )r   r+   r   r   r    ÚoperatorÚenginer3   r   r   r   ÚgetOperators,   s,    	


zOpDocGenerator.getOperatorsc             C   s:   | j ƒ }x|D ]}|j| jƒ qW |  j| jjƒ 7  _d S )N)rA   ÚgenerateSchemar   r   Údump)r   r2   r?   r   r   r   Ú
createBodyY   s    
zOpDocGenerator.createBodyN)r   r   r   r!   r#   rA   rD   r   r   r   r   r   %   s   -r   c               @   s$   e Zd Zdd„ Zdd„ Zdd„ ZdS )r"   c             C   s   || _ |jddƒ\| _| _d S )Nr,   r(   )Úop_namer)   r;   r@   )r   r   r   r   r   r   c   s    zOperatorEngine.__init__c             C   sJ   g }x@dt j| jƒfdt j| jƒfgD ]\}}|s4q&|j||fƒ q&W |S )NÚCPUZCUDA)r4   Úget_cpu_implrE   Úget_cuda_implr<   )r   ZdeviceImplListÚdeviceÚimplr   r   r   ÚgetDeviceImplg   s    zOperatorEngine.getDeviceImplc             C   s2   x,| j ƒ D ] \}}|jdj| j||d�ƒ q
W d S )Nz{engine} on {device}: {impl})r@   rI   rJ   )rK   ÚaddLineÚformatr@   )r   r   rI   rJ   r   r   r   ÚgenerateDocp   s
    zOperatorEngine.generateDocN)r   r   r   r   rK   rN   r   r   r   r   r"   b   s   	r"   c               @   s\   e Zd Zdd„ Zdd„ Zdd„ Zdd„ Zd	d
„ Zdd„ Zdd„ Z	dd„ Z
dd„ Zdd„ ZdS )r   c             C   s,   || _ || _|| _tdj| j ƒƒ g | _d S )NzGathering docs for {}...)r   r   r    ÚprintrM   r3   )r   r   r   r    r   r   r   r   y   s
    zOperatorDoc.__init__c             C   s
   || _ d S )N)r3   )r   r3   r   r   r   r=   €   s    zOperatorDoc.addEnginesc             C   s.   | j jr |j| j jƒ |jƒ  n
|jdƒ d S )NzNo documentation yet.)r   ÚdocZparseAndAddÚaddLinebreakrL   )r   r   r   r   r   rN   ƒ   s    
zOperatorDoc.generateDocc             C   sZ   |rV|r|j |dƒ g }|r"|g}x"|D ]\}}|j||p<dgƒ q(W |j||g kƒ d S )Nr'   r   )Ú	addHeaderr<   ZaddTable)r   r   ÚtuplesZ	title_rowÚtitleÚtabler   rP   r   r   r   ÚgenerateTableŠ   s    zOperatorDoc.generateTablec                s‚   ‡ fdd„}g }| j jr*||d| j jƒ7 }| j jrD||d| j jƒ7 }| j jr^||d| j jƒ7 }| jˆ |d dƒ tdj| jƒƒ d S )Nc                s¢   ˆ j ƒ }|j| dƒ |jƒ dfg}xz|D ]r}ˆ j ƒ }t|tƒrf|d }t|ƒdkr`|d p\d}qvd}n|j}|jptd}|j|dd� |j	|jƒ |p”dfƒ q(W |S )Nr(   r   r   T)Úinline)
ÚcloneZaddEmphasisrC   Ú
isinstanceÚtupleÚlenr   ÚdescriptionZaddCoder<   )rT   ÚargsÚfÚoutÚargr   r\   )r   r   r   ÚmakeDesc–   s    


z/OperatorDoc.generateInterface.<locals>.makeDescÚ	ArgumentsZInputsZOutputsZ	InterfacezGenerated interface for {})r   r]   Z
input_descZoutput_descrV   rO   rM   r   )r   r   ra   rS   r   )r   r   ÚgenerateInterface•   s    zOperatorDoc.generateInterfacec             C   s&   |j ddƒ |jƒ  |j| jjƒ d S )NZCoder'   )rR   rQ   ZaddCodeLinkr   r9   )r   r   r   r   r   ÚgenerateCodeLink·   s    zOperatorDoc.generateCodeLinkc             C   s   d S )Nr   )r   r   r   rJ   r   r   r   ÚgetInfo¼   s    zOperatorDoc.getInfoc             C   sP   |j ddƒ | j|dtj| jƒƒ| j|dtj| jƒƒg}|jdd„ |D ƒƒ d S )NZDevicesr'   rF   ZGPUc             S   s   g | ]}|r|‘qS r   r   )Ú.0Úir   r   r   ú
<listcomp>Ç   s    z/OperatorDoc.generateDevices.<locals>.<listcomp>)rR   re   r4   rG   r   rH   ZaddList)r   r   Zdevicesr   r   r   ÚgenerateDevices¿   s    zOperatorDoc.generateDevicesc             C   s8   t | jƒsd S |jddƒ x| jD ]}|j|ƒ q"W d S )NZEnginesr'   )r[   r3   rR   rN   )r   r   r@   r   r   r   ÚgenerateEnginesÉ   s
    
zOperatorDoc.generateEnginesc             C   sh   |j | jdƒ | jrP| j|ƒ | j|ƒ | j|ƒ | j|ƒ | j|ƒ |jƒ  n|j	dƒ | j|ƒ d S )Nr&   zNo schema documented yet.)
rR   r   r   rN   rc   rd   ri   rj   ZaddBreakrL   )r   r   r   r   r   rB   Ð   s    






zOperatorDoc.generateSchemaN)r   r   r   r   r=   rN   rV   rc   rd   re   ri   rj   rB   r   r   r   r   r   x   s   "
r   Ú__main__zOperators catalog generator.)r\   Úcatalog_pathz&operators-catalogue.md to write out to)ÚtypeÚhelpÚw)%Ú
__future__r   r   r   r   Úargparser6   Zcaffe2.pythonr   r   Zcaffe2.python.docs.formatterr   Zfuture.utilsr	   r
   ÚCr4   Úobjectr   r   r   r"   r   r   ÚArgumentParserÚparserÚadd_argumentÚstrÚ
parse_argsr]   Úopenrl   ÚfpÚopsrD   Úwriter   r   r   r   r   Ú<module>   s.   =f
