| Server IP : 127.0.0.1 / Your IP : 216.73.216.109 Web Server : Apache/2.4.54 (Win64) OpenSSL/1.1.1q PHP/8.1.10 System : Windows NT DESKTOP-E5T4RUN 10.0 build 19045 (Windows 10) AMD64 User : SERVERWEB ( 0) PHP Version : 8.1.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/cygwin64/lib/python3.9/site-packages/sphinx/ext/autodoc/__pycache__/ |
Upload File : |
a
�abh � @ s. d Z ddlZddlZddlZddlmZmZ ddlmZ ddl m
Z
ddl m Z m
Z
mZmZmZmZmZmZ ddlmZ ddlmZ e�e�ZG d d
� d
�Zedd fe e e e ee d �d
d�Z G dd� de
�Z G dd� de�Z G dd� de�Z ej!ee e
d d�dd��Z"e e#d�dd�Z$ee d�d d �Z%dS ) z�
sphinx.ext.autodoc.mock
~~~~~~~~~~~~~~~~~~~~~~~
mock for autodoc
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�Loader�MetaPathFinder)�
ModuleSpec)�
ModuleType)�Any� Generator�Iterator�List�Optional�Sequence�Tuple�Union)�logging)� safe_getattrc s� e Zd ZU dZd ZdZ dZdZeedf e d< eeed�� fdd � Z
eed
d�d d �Z e d
�dd�Z
eed�dd�Zed
�dd�Zeed�dd�Zed d�dd�Zed d�dd�Zeeed�d d �Zed
�d d �Z� ZS ) � _MockObject� Used by autodoc_mock_imports.� T� .�__sphinx_decorator_args__)�args�kwargs�returnc sV t |�dkrJt|d t�rJ|d d j}|| u rJt|d |j||d d�S t� �| �S )N� � ���r � )�
superclass�
attributes)�len�
isinstance�tuple� __class__�_make_subclass�__display_name__�super�__new__)�clsr r r �r! r �;/usr/lib/python3.9/site-packages/sphinx/ext/autodoc/mock.pyr% ! s �z_MockObject.__new__Nc O s | j | _d S �N)�__name__� __qualname__)�selfr r r r r( �__init__+ s z_MockObject.__init__�r c C s dS )Nr r �r, r r r( �__len__. s z_MockObject.__len__)�keyr c C s dS )NFr �r, r1 r r r( � __contains__1 s z_MockObject.__contains__c C s t g �S r) )�iterr/ r r r( �__iter__4 s z_MockObject.__iter__)�basesr c C s | j fS r) r' )r, r6 r r r( �__mro_entries__7 s z_MockObject.__mro_entries__c C s t t|�| j| j�� S r) )r" �strr# r! r2 r r r( � __getitem__: s z_MockObject.__getitem__c C s t || j| j�� S r) )r" r# r! r2 r r r( � __getattr__= s z_MockObject.__getattr__c O s | � � }||_|S r) )r! r )r, r r �callr r r( �__call__@ s z_MockObject.__call__c C s | j S r) )r# r/ r r r( �__repr__E s z_MockObject.__repr__)r* �
__module__r+ �__doc__r# �__sphinx_mock__r r r �__annotations__r% r- �intr0 r8 �boolr3 r r5 r7 r9 r: r< r= �
__classcell__r r r' r( r s
r r )�name�moduler r �decorator_argsr c C s2 ||d | | |d�}|� |p i � t| |f|�S )N�.)r> r# r* r )�update�type)rE rF r r rG �attrsr r r( r" I s
�r" c sP e Zd ZdZejZdZedd�� fdd� Z ee
d�dd�Z ed �d
d �Z � Z
S ) � _MockModuler TN)rE r c s t � �|� g | _g | _d S r) )r$ r- �__all__�__path__�r, rE r' r r( r- Y s z_MockModule.__init__c C s t || j�� S r) )r" r* rO r r r( r: ^ s z_MockModule.__getattr__r. c C s | j S r) )r* r/ r r r( r= a s z_MockModule.__repr__)r* r> r+ r? �os�devnull�__file__r@ r8 r- r r: r= rD r r r' r( rL T s rL c sH e Zd ZdZddd�� fdd� Zeed�dd �Zedd
�d d �Z� Z S )
�
MockLoaderzA loader for mocking.�
MockFinderN)�finderr c s t � �� || _d S r) )r$ r- rU )r, rU r' r r( r- g s
zMockLoader.__init__)�specr c C s( t �d|j� | jj�|j� t|j�S )Nz%[autodoc] adding a mock module as %s!)�logger�debugrE rU �mocked_modules�appendrL )r, rV r r r( �
create_modulek s zMockLoader.create_module)rF r c C s d S r) r )r, rF r r r( � exec_modulep s zMockLoader.exec_module)
r* r> r+ r? r- r r r[ r\ rD r r r' r( rS e s rS c sd e Zd ZdZee dd�� fdd� Zd eeee e
ef e ee d�dd�Z
dd �d
d �Z� ZS )
rT zA finder for mocking.N��modnamesr c s$ t � �� || _t| �| _g | _d S r) )r$ r- r^ rS �loaderrY )r, r^ r' r r( r- w s
zMockFinder.__init__)�fullname�path�targetr c C s6 | j D ]*}||ks |�|d �rt|| j� S qd S )NrH )r^ �
startswithr r_ )r, r` ra rb �modnamer r r( � find_spec} s
zMockFinder.find_specr. c C s | j D ]}tj�|d� qdS )z)Invalidate mocked modules on sys.modules.N)rY �sys�modules�pop)r, rd r r r( �invalidate_caches� s
z MockFinder.invalidate_caches)N)r* r> r+ r? r r8 r- r
r r
�bytesr r re ri rD r r r' r( rT t s �� rT )NNNr] c c sP z4t | �}tj�d|� dV W tj�|� |�� ntj�|� |�� 0 dS )z�Insert mock modules during context::
with mock(['target.module.name']):
# mock modules are enabled here
...
r N)rT rf � meta_path�insert�removeri )r^ rU r r r( �mock� s
� rn )�subjectr c C s� zt | dd�du rW dS W n ty. Y dS 0 t| t�r>dS z2t t| �dg �}t|�dkrn|d tu rnW dS W n ty� Y n0 dS )z Check if the object is mocked.r@ NFT�__mro__r ���)r �AttributeErrorr rL rJ r r )ro rp r r r( �ismock� s
rs c C s t | �r| jr| jd S | S dS )zsUnwrap mock if *subject* is decorated by mocked object.
If not decorated, returns given *subject* itself.
r N)rs r )ro r r r( �
undecorate� s
rt )&r? �
contextlibrP rf �
importlib.abcr r Zimportlib.machineryr �typesr �typingr r r r r
r r r
Z sphinx.utilr Zsphinx.util.inspectr Z getLoggerr* rW r r8 r" rL rS rT �contextmanagerrn rC rs rt r r r r( �<module> s.
(
0��