a
    «ˆc~P  ã                   @   sÜ  d Z ddlmZmZ ddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZeƒ Ze	j ¡ D ]\ZZeeeƒrde e¡ qddD ]Ze e¡ q†e
jZe
jZeejƒZeeƒZdd„ Zdd„ Zd	d
„ Zdd„ Zdd„ Z G dd„ dƒZ!G dd„ dƒZ"dd„ Z#dd„ Z$dd„ Z%dd„ Z&e 'd¡Z(e 'd¡Z)e 'd¡Z*e 'd¡Z+e 'd¡Z,d d!„ Z-d"d#„ Z.d$d%„ Z/d&d'„ Z0d(d)„ Z1d*d+„ Z2d,d-„ Z3d.d/„ Z4d0d1„ Z5d2d3„ Z6d4d5„ Z7ej8fd6d7„Z9e:d8k�rØe9ej8ƒZ;e;du�rØe <e;¡ dS )9a\  
This program will generate .pyi files for all the VTK modules
in the "vtkmodules" package (or whichever package you specify).
These files are used for type checking and autocompletion in
some Python IDEs.

The VTK modules must be in Python's path when you run this script.
Options are as follows:

 -p PACKAGE    The package to generate .pyi files for [vtkmodules]
 -o OUTPUT     The output directory [default is the package directory]
 -e EXT        The file suffix [.pyi]
 -h HELP

With no arguments, the script runs with the defaults (the .pyi files
are put inside the existing vtkmodules package).  This is equivalent
to the following:

    python -m vtkmodules.generate_pyi -p vtkmodules

To put the pyi files somewhere else, perhaps with a different suffix:

    python -m vtkmodules.generate_pyi -o /path/to/vtkmodules -e .pyi

To generate pyi files for just one or two modules:

    python -m vtkmodules.generate_pyi -p vtkmodules vtkCommonCore vtkCommonDataModel

To generate pyi files for your own modules in your own package:

    python -m vtkmodules.generate_pyi -p mypackage mymodule [mymodule2 ...]

é    )Ú	vtkObjectÚvtkSOADataArrayTemplateN)ÚAnyZBufferZCallbackÚNoneZPointerÚTemplateÚUnionc                 C   s   t | ƒtkS )z(Check for VTK's custom method descriptor)ÚtypeÚ	vtkmethod©Úm© r   úZ/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/vtkmodules/generate_pyi.pyÚisvtkmethodC   s    r   c                 C   s   t t| ƒƒdkS )z$Check for namespaces within a modulez,<class 'vtkmodules.vtkCommonCore.namespace'>)Ústrr   r
   r   r   r   ÚisnamespaceG   s    r   c                 C   s   t | ƒot| tƒS )z,Check for enums (currently derived from int))ÚisclassÚ
issubclassÚintr
   r   r   r   ÚisenumL   s    r   c                 C   s*   | du rdS t | ƒtkrdS t | ƒjS dS )z4Generate a typename that can be used for annotation.Nr   r   )r   ÚtemplateÚ__name__)Úor   r   r   ÚtypenameP   s
    r   c                 C   s    t | ƒ}|tvrd| d }|S )z:Generate a typename, or if necessary, a forward reference.ú')r   Útypes)r   Únamer   r   r   Útypename_forwardY   s    r   c                   @   s(   e Zd ZdZdd„ Zdd„ Zdd„ ZdS )	ÚGraphz A graph for topological sorting.c                 C   s
   i | _ d S ©N©Únodes)Úselfr   r   r   Ú__init__f   s    zGraph.__init__c                 C   s
   | j | S r   r   )r!   r   r   r   r   Ú__getitem__h   s    zGraph.__getitem__c                 C   s   || j |< d S r   r   )r!   r   Únoder   r   r   Ú__setitem__j   s    zGraph.__setitem__N)r   Ú
__module__Ú__qualname__Ú__doc__r"   r#   r%   r   r   r   r   r   d   s   r   c                   @   s   e Zd ZdZdd„ ZdS )ÚNodezA node for the graph.c                 C   s   || _ || _d S r   )ÚobjÚdeps)r!   r   Údr   r   r   r"   o   s    zNode.__init__N)r   r&   r'   r(   r"   r   r   r   r   r)   m   s   r)   c                 C   s–   t ƒ }t|  ¡ ƒ}|D ]z\}}t|ƒrd||jkrPdd„ |jD ƒ}t||ƒ||< q�t||jgƒ||< qt|ƒr|t|g ƒ||< qt|t|ƒgƒ||< q|S )z)Build a graph from a module's dictionary.c                 S   s   g | ]
}|j ‘qS r   )r   )Ú.0Úbr   r   r   Ú
<listcomp>{   ó    zbuild_graph.<locals>.<listcomp>)	r   ÚsortedÚitemsr   r   Ú	__bases__r)   Úismethodr   )r,   Úgraphr2   r   r   Úbasesr   r   r   Úbuild_graphs   s    
r7   c                 C   sb   |  |¡ z| | }W n ty*   Y dS 0 |jD ]}||vr2t| |||ƒ q2| ||jf¡ dS )zHelper for topological sorting.N)ÚaddÚKeyErrorr+   Úsorted_graph_helperÚappendr*   )r5   r   Úvisitedr2   r$   Údepr   r   r   r:   †   s    

r:   c                 C   s0   g }t ƒ }| jD ]}||vrt| |||ƒ q|S )z)Sort a graph and return the sorted items.)Úsetr    r:   )r5   r2   r<   r   r   r   r   Úsorted_graph’   s    
r?   c                 C   s   t t| ƒƒS )zBReturn the items from a module's dictionary, topologically sorted.)r?   r7   )r,   r   r   r   Útopologically_sorted_items›   s    r@   z!("([^\\"]|\\.)*"|'([^\\']|\\.)*')z'([A-Za-z_]([A-Za-z0-9_]|[.][A-Za-z_])*)z[ \t]+(?=\S)z[(]self[,)]z[\'\"{}\[\]()\n]c                 C   sd   |  d|¡}|dkrt|ƒ}tj d|  d ¡ tj |||… d ¡ tj d||  d ¡ dS )z.Print a parse error, syntax or otherwise.
    Ú
éÿÿÿÿzError: z:
ú-z^
N)ÚfindÚlenÚsysÚstderrÚwrite)ÚmessageÚtextÚbeginÚposÚendr   r   r   Úparse_error«   s    rN   c                 C   sÚ   t | tjƒr(| j}|tvrÖd| d }n®t | tjtjfƒrÖt| jƒ}| jd }| j	}||j	| |j
| … }t|||ƒ}|r°t | tjƒr¢dd |g| ¡ d }qÖd| d }n&t | tjƒrÊd| d }nd| d }|S )	z6Return the new text to be used for an annotation.
    r   r   zTuple[ú, ú]zList[z	Sequence[zMutableSequence[)Ú
isinstanceÚastÚNameÚidr   ÚTupleÚListrE   ÚeltsÚ
col_offsetÚend_col_offsetÚannotation_textÚjoin)ÚarJ   Z	is_returnr   ÚsizeÚeÚoffsetZold_namer   r   r   rZ   µ   s$    

rZ   c                 C   sà   t  | ¡jd }dd„ |jjD ƒ}t|ƒ}| |j¡ g }t|ƒD ]L\}}|durB| |j|j	… }t
||||kƒ}||krB| |j|j	|f¡ qB|rÜd}	d}
|D ]&\}}}|	| |
|… 7 }	|	|7 }	|}
q |	| |
d… 7 }	|	} | S )zuFix the annotations in a method definition.
    The signature must be a single-line function def, no decorators.
    r   c                 S   s   g | ]
}|j ‘qS r   )Ú
annotation)r-   Úargr   r   r   r/   Ù   r0   z#fix_annotations.<locals>.<listcomp>NÚ )rR   ÚparseÚbodyÚargsrE   r;   ÚreturnsÚ	enumeraterX   rY   rZ   )Ú	signatureZ
definitionÚannotationsZreturn_iÚchangesÚir\   Zold_textrJ   ZnewsigÚlastposrK   rM   r   r   r   Úfix_annotationsÓ   s*    rm   c                 C   sl   t  dd|¡}t  dd|¡}| d¡r(n@| | jd ¡rhd| d }tjd	krVt|ƒ}||vrh| |¡ d
S )z7Process a method signature and add it to the list.
    z\s+ú z([({\[:=]) z\1zC++:ú(údef z: ...é  N)ÚreÚsubÚ
startswithr   rF   Ú
hexversionrm   r;   )r   Úlrh   r   r   r   Úpush_signatureó   s    

rw   c                 C   sv  | j }g }|du r|S d}d}g }|t|ƒk �rrt ||¡}|�r(| ¡ \}}| ¡ }|dv r�t ||¡}	|	r||	 ¡ \}}ntd|||ƒ �qrn–|dv r°| 	dddd	œ| ¡ nv|d
v rÜ|rÈ|| 
¡ krÚtd|||ƒ �qrnJ|dk�rl|�slt ||¡�sl|||…  ¡ }
|
�rrt| ||
ƒ |}n�qrnDt|ƒ}|�sZ|||…  ¡ }
|
�rlt| ||
ƒ ntd|||ƒ �qr|}q"|S )z?Return a list of method signatures found in the docstring.
    Nr   z"'zUnterminated stringz{[(Ú}rP   ú))Ú{ú[ro   z}])zUnmatched bracketrA   )r(   rE   ÚkeycharÚsearchÚspanÚgroupÚstringÚmatchrN   r;   ÚpopÚindentÚstriprw   )r   ÚdocÚ
signaturesrK   rL   Zdelim_stackr�   rM   Úcr   rh   r   r   r   Úget_signatures  sN    rˆ   c              	   C   s¬   g }| j }| j}|r"| |d ¡s&|S t| ƒ}|D ]t}| d| d ¡r2t d| d d|¡}| d| d ¡rŒ| t |d d|d	¡¡ q2| t |d d
|d	¡¡ q2|S )z3Get constructors from the class documentation.
    ro   rp   z-> '?z'?z-> Nonez()z\(z__init__(selfé   z__init__(self, )r   r(   rt   rˆ   rr   rs   r;   )r‡   Úconstructorsr   r…   r†   rh   r   r   r   Úget_constructorsI  s    r‹   c                 C   s"   t | ƒrt |¡sd| S |S dS )z/If method has no "self", add @static decorator.z@staticmethod
N)r   Úhas_selfr}   )r   rh   r   r   r   Úhandle_static\  s    r�   c                 C   s   |t  dd| | ¡ S )z:Add the given indent before every line in the string.
    z\n(?=([^\n]))rA   )rr   rs   )Úsrƒ   r   r   r   Ú
add_indentc  s    r�   c           	      C   s
  d}|j dkrd| }d| j  d | d }d}t| jƒ}g }|D ]D\}}t|ƒrx||j krx|tt|ƒdƒ7 }|d	7 }qB| ||f¡ qB|}g }|D ]V\}}| d
¡sÜt|ƒsÜt	|ƒsÜ|d| d t
|ƒ d 7 }|d	7 }q”| ||f¡ q”|dk�r|dd… d }|S )z0Fake a namespace by creating a dummy class.
    Ú	namespaceúvtkmodules.vtkCommonCorezvtkmodules.vtkCommonCore.úclass ro   ú):
r   ú    r‰   Ú__ú:rA   rB   ú ...
)r   r@   Ú__dict__r   r�   Ú	class_pyir;   rt   r4   r   r   )	r‡   ÚmodÚbaseÚoutÚcountr2   Úothersr   r   r   r   r   Únamespace_pyih  s,    




rŸ   c                 C   s^  g }| j D ]8}|j| jdfv r,| |j¡ q
| |jd |j ¡ q
d| j d d |¡ d }d}t| jƒ}g }|D ]D\}}t|ƒr¬||jkr¬|tt	|ƒdƒ7 }|d	7 }qv| ||f¡ qv|}g }|D ]\\}}| 
d
¡�st|ƒ�st|ƒ�s|d| d t|ƒ d 7 }|d	7 }qÈ| ||f¡ qÈt| ƒ}	t|	ƒdk�r>nP|d	7 }t|	ƒd	k�rl|t|	d dƒd 7 }n"|	D ]}
|td|
 dƒd 7 }�qp|}g }|D ]¤\}}t|ƒ�r.t|ƒ}t|ƒdk�rÆ�qš|d	7 }t|ƒd	k�r t||d ƒ}|t|dƒd 7 }�qš|D ]&}
t||
ƒ}|td| dƒd 7 }�qn| ||f¡ �qš|dk�rZ|dd… d }|S )z/Generate all the method stubs for a class.
    ÚbuiltinsÚ.r’   ro   rO   r“   r   r”   r‰   r•   r–   rA   z
@overload
rB   r—   )r3   r&   r;   r   r[   r@   r˜   r   r�   r™   rt   r4   r   r‹   rE   rˆ   r�   )r‡   r6   r.   rœ   r�   r2   rž   r   r   rŠ   Úoverloadr†   rh   r   r   r   r™   Š  s`    


 



r™   c           	      C   s2  |  d¡ |  d¡ |  d¡ |  d¡ |  d¡ |  d¡ |  d¡ |  d¡ | jdkrn|  d	¡ |  d¡ tdgƒ}| j ¡ D ]2\}}t|ƒr‚||jkr‚|jD ]}| |j¡ q¢q‚| 	| j¡ | 	d
¡ t
|ƒD ]}|  d| d ¡ qÔ|rú|  d¡ t| jƒ}g }|D ]J\}}t|ƒ�rF||jk�rF|  t|| ƒ¡ |  d¡ n| ||f¡ �q|}g }|D ]H\}}t|ƒ�rœ||jk�rœ|  t|ƒ¡ |  d¡ n| ||f¡ �qd|}g }|D ]H\}}t|ƒ�rò||jk�rò|  |d |j d ¡ n| ||f¡ �qº|}g }|D ]T\}}| d¡�sTt|ƒ�sTt|ƒ�sT|  |d t|ƒ d ¡ n| ||f¡ �qt|ƒt|ƒk�r‚|  d¡ |}g }|D ]H\}}t|ƒ�rÆ||jk�rÆ|  t|ƒ¡ |  d¡ n| ||f¡ �qŽ|}g }|D ]H\}}t|ƒ�r||jk�r|  |d |j d ¡ n| ||f¡ �qädS )z;Generate the contents of a .pyi file for a VTK module.
    z;from typing import overload, Any, Callable, TypeVar, Union
z:from typing import Tuple, List, Sequence, MutableSequence
rA   z,Callback = Union[Callable[..., None], None]
zBuffer = TypeVar('Buffer')
zPointer = TypeVar('Pointer')
zTemplate = TypeVar('Template')
r‘   zclass namespace: pass
r    zimport z = r•   r–   N)rH   r   r>   r˜   r2   r   r3   r8   r&   Údiscardr1   r@   r   rŸ   r;   r   r™   rt   r4   r   rE   )	rš   ÚoutputÚdependsr   r   r›   Zdependr2   rž   r   r   r   Ú
module_pyiÒ  s~    















 
r¦   c              	   C   s–  t j | d ¡}tj| d d| d dd�}|jddtdd	d
� |jddtdd� |jddtddd
� |jddddd� |jdtddd� | | dd … ¡}|j}|j	}|j
}|j}|d u sÈt|ƒdkrÒt |¡}|d u �r,t|dd ƒ}	|	d u �st j |	¡dk�r tj |d | d ¡ dS t j |	¡}t|ƒdk�rÊ|jD ]ˆ}
ztj |d  |
 ¡}W n: t�y–   d }|�s’d!}tj |d" |
 d# ¡ Y n0 |d u �r¦�q@t|jtjjƒ�s¼�q@| |
¡ �q@d$}|D ]¾}
t j ||
| ¡}|j�rFtjd%k�rt j!nd}t"|d&ƒ�"}t#| $¡ |d'|ƒ W d   ƒ n1 �s:0    Y  nHt |d  |
 ¡}t"|d(ƒ�}t%||ƒ W d   ƒ n1 �s„0    Y  �qÒd S ))Nr   zpython z [-p package] [-o output_dir]z-A .pyi generator for the VTK python wrappers.)ÚprogÚusageÚdescriptionz-pz	--packageZ
vtkmoduleszPackage name [vtkmodules].)r   ÚdefaultÚhelpz-oz--outputz%Output directory [package directory].)r   r«   z-ez--extz.pyizOutput file suffix [.pyi].z--testr�   z)Test .pyi files instead of creating them.)Úactionrª   r«   ÚmodulesÚ*zModules to process [all].)r   Únargsr«   r‰   Ú__file__z__init__.pyz: z has no __init__.py
r¡   Tz: couldn't get loader for rA   Frq   ÚrÚexecÚw)&ÚosÚpathÚbasenameÚargparseÚArgumentParserÚadd_argumentr   Ú
parse_argsÚpackager­   r¤   ÚextrE   Ú	importlibÚimport_moduleÚgetattrrF   rG   rH   ÚdirnameÚ__all__ÚutilÚ	find_specÚ
ValueErrorrQ   ÚloaderÚ	machineryÚExtensionFileLoaderr;   r[   Útestru   rR   ÚPyCF_TYPE_COMMENTSÚopenÚcompileÚreadr¦   )ÚargvZprognameÚparserre   Zpackagenamer­   Zbasedirr¼   rš   ÚfilenameÚmodnameÚspecZerrflagZpyifileÚflagsÚfr   r   r   Úmain.  st    
ýÿ
ÿÿ
ÿ
ÿ



4rÔ   Ú__main__)=r(   Zvtkmodules.vtkCommonCorer   r   rF   r´   rr   rR   r·   r    ÚinspectZimportlib.utilr½   r>   r   r˜   r2   r   r   rQ   r   r8   Ú	isroutiner4   r   ZIsAr	   r   r   r   r   r   r   r   r)   r7   r:   r?   r@   rË   r€   Ú
identifierrƒ   rŒ   r|   rN   rZ   rm   rw   rˆ   r‹   r�   r�   rŸ   r™   r¦   rÍ   rÔ   r   ÚresultÚexitr   r   r   r   Ú<module>   sf   "

			





 B"H\D


