U
    ôŠf„  ã                   @   sÚ   d Z ddlmZ ddlZddlZddlZddlZddlmZm	Z	m
Z
mZmZ ddlmZ dZd ¡ Zdd	 d
 ¡ ¡ Ze dej¡Ze dej¡Zdd„ ZG dd„ dejƒZG dd„ dejƒZedƒdd„ ƒZdd„ ZdS )a&  

Doxygen support

Variables passed to bld():
* doxyfile -- the Doxyfile to use
* doxy_tar -- destination archive for generated documentation (if desired)
* install_path -- where to install the documentation
* pars -- dictionary overriding doxygen configuration settings

When using this tool, the wscript will look like:

	def options(opt):
		opt.load('doxygen')

	def configure(conf):
		conf.load('doxygen')
		# check conf.env.DOXYGEN, if it is mandatory

	def build(bld):
		if bld.env.DOXYGEN:
			bld(features="doxygen", doxyfile='Doxyfile', ...)
é    )ÚfnmatchcaseN)ÚTaskÚUtilsÚNodeÚLogsÚErrors)Úfeaturez"${DOXYGEN}" - zhtml latex man rft xmlz*.z *.z”
c cc cxx cpp c++ dox java ii ixx ipp i++ inl h hh hxx hpp h++ idl odl cs php php3
inc m mm py f90c cc cxx cpp c++ java ii ixx ipp i++ inl h hh hxx
z\\*
z*
c              
   C   sê   i }t  d| ¡} t | ¡}|D ]Æ}| ¡ }|r| d¡s| d¡dk rHq| d¡dkr¸| d¡}|d  ¡ }||krœ||  dd |dd … ¡ ¡  7  < qäd |dd … ¡ ¡ ||< q| d¡}d |dd … ¡ ¡ ||d  ¡ < q|S )NÚ ú#ú=r   z+=ú é   )Úre_rlÚsubÚre_nlÚsplitÚstripÚ
startswithÚfindÚjoin)ÚtxtÚtblÚlinesÚxÚtmpÚkey© r   úwaf-tools/doxygen.pyÚ
parse_doxy+   s     

(
$r   c                   @   s8   e Zd ZddgZdZdd„ Zdd„ Zdd	„ Zd
d„ ZdS )ÚdoxygenÚDOXYGENZ	DOXYFLAGSÚBLUEc           	      C   s°  | j D ]}|jstj  S qt| ddƒ�sr| jd  ¡ }t|ƒ| _| j 	d¡rl| jd j
 ¡  | jd ¡}n"| jd j
 ¡  | jd jd ¡}| ¡  | ¡ | jd< t| jddƒrÒ| jj ¡ D ]\}}|| j|< q¾t| dg ƒ| _| j 	d¡�s| j | jd j
¡ nn| j 	d¡ ¡ D ]\}tj |¡�r8| jjj |¡}n| jd j
 |¡}|�sb| jj d| ¡ | j |¡ �qt| d	dƒ�sœ| jj}|j | jd ¡| _|  ¡  tj | ¡S )
z¶
		self.pars are populated in runnable_status - because this function is being
		run *before* both self.pars "consumers" - scan() and run()

		set output_dir (node) for the output
		ÚparsNr   ZOUTPUT_DIRECTORYz.doxyÚdoxy_inputsZINPUTz#Could not find the doxygen input %rÚ
output_dir) Ú	run_afterÚhasrunr   Ú	ASK_LATERÚgetattrÚinputsÚreadr   r"   ÚgetÚparentÚget_bldÚ	make_nodeÚnameÚmkdirÚabspathÚ	generatorZ	iteritemsr#   Úappendr   ÚosÚpathÚisabsÚbldÚrootÚ	find_nodeÚfatalÚfind_dirr$   Ú	signatureÚrunnable_status)	Úselfr   r   Zoutput_nodeÚkÚvÚiÚnoder7   r   r   r   r=   C   s:    

"zdoxygen.runnable_statusc                 C   s    | j  dd¡ ¡ }| j  dd¡ ¡ }|s,t}| j  d¡dkrJdd„ |D ƒ}g }g }| jD ]>}tj | ¡ ¡rŒ|j	||d�D ]}| 
|¡ qzqX| 
|¡ qX||fS )	NZEXCLUDE_PATTERNSr	   ZFILE_PATTERNSZ	RECURSIVEZYESc                 S   s   g | ]}d | ‘qS )z**/%sr   )Ú.0Úpatternr   r   r   Ú
<listcomp>{   s     z doxygen.scan.<locals>.<listcomp>)ÚinclÚexcl)r"   r+   r   ÚDOXY_FILE_PATTERNSr#   r4   r5   Úisdirr1   Úant_globr3   )r>   Zexclude_patternsZfile_patternsÚnodesÚnamesrB   Úmr   r   r   Úscanu   s    
zdoxygen.scanc                    s|   | j  ¡ ‰ d ‡ fdd„| j D ƒ¡}| ¡ }t t| j¡}| jjpDd }tjj	|dtjj
|| jd j ¡ d�}| |¡ |jS )NÚ
c                    s   g | ]}d |ˆ | f ‘qS )z%s = %sr   )rC   r   ©Údctr   r   rE   ˆ   s     zdoxygen.run.<locals>.<listcomp>Tr   )ÚshellÚstdinÚenvÚcwd)r"   Úcopyr   Úencoder   Ú
subst_varsÚDOXY_STRrT   Ú
subprocessÚPopenÚPIPEr)   r,   r1   ÚcommunicateÚ
returncode)r>   ÚcodeÚcmdrT   Úprocr   rP   r   Úrun†   s    
&
zdoxygen.runc                 C   s€   | j jddd�}|D ]}t | ¡ ¡|_q|  j|7  _t| jdd ƒrtt| jdd ƒst| jj	j
| jj| jd| j dd� tj | ¡S )Nz**/*T)ÚquietÚinstall_pathÚdoxy_tarF)ÚpostponerU   Úrelative_trick)r$   rJ   r   Úh_filer1   ÚsigÚoutputsr(   r2   r7   Úinstall_filesrd   r   Úpost_run)r>   rK   r   r   r   r   rl   ‘   s    üzdoxygen.post_runN)	Ú__name__Ú
__module__Ú__qualname__ÚvarsÚcolorr=   rN   rb   rl   r   r   r   r   r   ?   s   2r   c                   @   s.   e Zd ZdZdZdZdgZdd„ Zdd„ Zd	S )
Útarzquick tar creationz${TAR} ${TAROPTS} ${TGT} ${SRC}ÚREDr   c                 C   sj   t | dg ƒD ]}|jstj  S qt | dd ƒs^d| _t | dg ƒD ]}|  |j¡ q@| js^tjS tj 	| ¡S )NÚinput_tasksÚtar_done_addingT)
r(   r&   r   r'   ru   Ú
set_inputsrj   r)   ÚSKIP_MEr=   )r>   r   r   r   r   r=   ¤   s    ztar.runnable_statusc                 C   s&   d  dd„ | jD ƒ¡}d| jj|f S )Nr   c                 S   s   g | ]}|  |j ¡ ¡‘qS r   )Ú	path_fromÚctxÚlaunch_node)rC   Úar   r   r   rE   ³   s     ztar.__str__.<locals>.<listcomp>z%s: %s
)r   rj   Ú	__class__rm   )r>   Útgt_strr   r   r   Ú__str__²   s    ztar.__str__N)	rm   rn   ro   Ú__doc__Úrun_strrq   Úafterr=   r~   r   r   r   r   rr   Ÿ   s   rr   c                 C   sê   t | dd ƒs| jj d¡ | j}t|tjƒs8| j |¡}|sJt	d| j ƒ‚|  
d|¡}t | dd ƒræ|  
d¡}|g|_| | j | j¡¡ | j d¡r¢dg|jd	< n&| j d
¡r¼dg|jd	< ndg|jd	< t | dd ƒræ| j | j|j¡ d S )NÚdoxyfilezno doxyfile??zdoxygen file not found: %sr   re   rr   Úbz2ZcjfZTAROPTSÚgzZczfZcfrd   )r(   r2   r7   r:   r‚   Ú
isinstancer   r5   Úfind_resourceÚ
ValueErrorÚcreate_taskrt   Úset_outputsÚfind_or_declarere   ÚendswithrT   rk   rd   rj   )r>   rB   ZdskÚtskr   r   r   Úprocess_doxy¶   s&    
r�   c                 C   s$   | j dddd� | j dddd� dS )zî
	Check if doxygen and tar commands are present in the system

	If the commands are present, then conf.env.DOXYGEN and conf.env.TAR
	variables will be set. Detection can be controlled by setting DOXYGEN and
	TAR environmental variables.
	r   r    F)ÚvarÚ	mandatoryrr   ZTARN)Úfind_program)Úconfr   r   r   Ú	configureÑ   s    	r’   )r   Úfnmatchr   r4   Zos.pathÚreÚstatÚwaflibr   r   r   r   r   Zwaflib.TaskGenr   rY   r   Z	DOXY_FMTSr   rH   ÚcompileÚ	MULTILINEr   ÚMr   r   r   rr   r�   r’   r   r   r   r   Ú<module>   s    `
