File: //usr/lib/python3/dist-packages/sphinx/ext/autodoc/__pycache__/mock.cpython-310.pyc
o
�$�a �
@ s> d Z ddlZddlZddlZddlmZmZ ddlmZ ddl m
Z
ddl m Z m
Z
mZmZmZmZmZmZ ddlmZ ddlmZ e�e�ZG d d
� d
�Zedd fd e d
e de de dede f dd�Z G dd� de
�Z G dd� de�Z G dd� de�Z ej!dee de
d fd d ��Z"d e de#fd d �Z$d ede fd!d"�Z%dS )#z�
sphinx.ext.autodoc.mock
~~~~~~~~~~~~~~~~~~~~~~~
mock for autodoc
:copyright: Copyright 2007-2021 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< deded ef� fd
d � Z
deded d fd
d�Z d e fdd�Z
ded efdd�Zd efdd�Zded efdd�Zded d fdd�Zded d fdd �Zdeded efd d �Zd efd d �Z� ZS )!� _MockObject� Used by autodoc_mock_imports.� T� .�__sphinx_decorator_args__�args�kwargs�returnc sV t |�dkr%t|d t�r%|d d j}|| u r%t|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 �9/usr/lib/python3/dist-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__c C � dS )Nr r �r, r r r( �__len__. � z_MockObject.__len__�keyc C r. )NFr �r, r2 r r r( � __contains__1 r1 z_MockObject.__contains__c C s t g �S r) )�iterr/ r r r( �__iter__4 � z_MockObject.__iter__�basesc C s | j fS r) r' )r, r8 r r r( �__mro_entries__7 r7 z_MockObject.__mro_entries__c C s t t|�| j| j�� S r) )r" �strr# r! r3 r r r( � __getitem__: s z_MockObject.__getitem__c C s t || j| j�� S r) )r" r# r! r3 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 � | j S r) )r# r/ r r r( �__repr__E � z_MockObject.__repr__)r* �
__module__r+ �__doc__r# �__sphinx_mock__r r r �__annotations__r% r- �intr0 r: �boolr4 r r6 r9 r; r< r> r@ �
__classcell__r r r' r( r s
r r �name�moduler r �decorator_argsr c C s2 ||d | | |d�}|� |pi � t| |f|�S )N�.)rB r# r* r )�update�type)rI rJ r r rK �attrsr r r( r" I s
�r" c sT e Zd ZdZejZdZdeddf� fdd� Z dede
fdd �Z defd
d �Z � Z
S ) � _MockModuler TrI r Nc s t � �|� g | _g | _d S r) )r$ r- �__all__�__path__�r, rI r' r r( r- Y s
z_MockModule.__init__c C s t || j�� S r) )r" r* rS r r r( r< ^ s z_MockModule.__getattr__c C r? r) )r* r/ r r r( r@ a rA z_MockModule.__repr__)r* rB r+ rC �os�devnull�__file__rD r: r- r r< r@ rH r r r' r( rP T s rP c sF e Zd ZdZd� fdd� Zdedefd d
�Zd eddfd d
�Z� Z S )�
MockLoaderzA loader for mocking.�finder�
MockFinderr Nc s t � �� || _d S r) )r$ r- rX )r, rX r' r r( r- g s
zMockLoader.__init__�specc C s( t �d|j� | jj�|j� t|j�S )Nz%[autodoc] adding a mock module as %s!)�logger�debugrI rX �mocked_modules�appendrP )r, rZ r r r( �
create_modulek s
zMockLoader.create_modulerJ c C s d S r) r )r, rJ r r r( � exec_modulep r1 zMockLoader.exec_module)rX rY r N)
r* rB r+ rC r- r r r_ r` rH r r r' r( rW e s
rW c
sj e Zd ZdZdee ddf� fdd� Z ddedeee e
ef d e dee fd
d �Z
dd d
�Z� ZS )rY zA finder for mocking.�modnamesr Nc s$ t � �� || _t| �| _g | _d S r) )r$ r- ra rW �loaderr] )r, ra r' r r( r- w s
zMockFinder.__init__�fullname�path�targetc C s6 | j D ]}||ks|�|d �rt|| j� S qd S )NrL )ra �
startswithr rb )r, rc rd re �modnamer r r( � find_spec} s
�zMockFinder.find_specc C s | j D ] }tj�|d� qdS )z)Invalidate mocked modules on sys.modules.N)r] �sys�modules�pop)r, rg r r r( �invalidate_caches� s
�z MockFinder.invalidate_cachesr) )r N)r* rB r+ rC r r: r- r
r r
�bytesr r rh rl rH r r r' r( rY t s ��
� rY ra )NNNc c sP � zt | �}tj�d|� dV W tj�|� |�� dS tj�|� |�� w )z�Insert mock modules during context::
with mock(['target.module.name']):
# mock modules are enabled here
...
r N)rY ri � meta_path�insert�removerl )ra rX r r r( �mock� s � �
rq �subjectc C s� z
t | dd�du r W dS W n
ty Y dS w t| t�r dS z t t| �dg �}t|�dkr7|d tu r:W dS W dS W dS tyF Y dS w )z Check if the object is mocked.rD NFT�__mro__r r )r �AttributeErrorr rP rN r r )rr rs r r r( �ismock� s* � �
�� ��ru c C s t | �r | jr | jd S | S )zsUnwrap mock if *subject* is decorated by mocked object.
If not decorated, returns given *subject* itself.
r )ru r )rr r r r( �
undecorate� s
rv )&rC �
contextlibrT ri �
importlib.abcr r �importlib.machineryr �typesr �typingr r r r r
r r r
� sphinx.utilr �sphinx.util.inspectr � getLoggerr* r[ r r: r" rP rW rY �contextmanagerrq rG ru rv r r r r( �<module> s8
(
0���
�