o

!we�/�@
s,UdZd
dl
mZ
d
dlZd
dlZd
dlZd
dlZd
dlZd
dlZd
dl	Z	d
dl
Z
d
dlZd
dlZd
dl
Z
d
dlZd
dlZd
dlmZ
d
dlmZmZmZmZmZmZmZmZmZmZmZmZmZmZ
d
dl m!Z!
d
dl"m#Z#
d
dl$m%Z%
d
d	l"TiZ&d
e'd<dmdd�Z(e(e�
ZGdd�d�Z)ej*dndd��
Z+dodd�Z,dpdd�Z-ed�
Z.ed �
Z/dqd#d$�Z0drd(d)�Z1dsd,d-�Z2dtd0d1�Z3dud3d4�Z4dtd5d6�Z5dvdwd9d:�Z6Gd;d<�d<�Z7dxd@dA�Z8GdBdC�dC�Z9dydGdH�Z:dzdKdL�Z;dvd{dOdP�Z<d|dSdT�Z=d}dWdX�Z>edYeedZ�Z?	[d~ddadb�Z@d�d�dhdi�ZAd�dkdl�ZBdS)�z$Miscellaneous stuff for coverage.py.�)
�annotationsN)
�
ModuleType)�Any�Callable�Dict�IO�Iterable�Iterator�List�Mapping�NoReturn�Optional�Sequence�Tuple�TypeVar�Union)
�env)
�CoverageException)
�TArc)
�
*zDict[ModuleType, ModuleType]�ISOLATED_MODULES�modr�returnc
C
s\|tv
r*t
�|j�
}
|
t|<t|�
D]}t||�}t|t
j�r#t|�
}t|
||�
qt|S)
aJ
Copy a module so that we are isolated from aggressive mocking.

    If a test suite mocks os.path.exists (for example), and then we need to use
    it during the test, everything will get tangled up if we use their mock.
    Making a copy of the module when we import it will isolate coverage.py from
    those complications.
    )	r�typesr�__name__�dir�getattr�
isinstance�isolate_module�setattr)r�new_mod�name�value�r#�F/home/arjun/projects/env/lib/python3.10/site-packages/coverage/misc.pyr(s








rc@
s$eZ
dZd
Zd	dd�Zd	dd�ZdS)
�SysModuleSaverzASaves the contents of sys.modules, and removes new modules later.r�Nonec

C
stt
j�
|_dS�
N��set�sys�modules�old_modules�
�selfr#r#r$�__init__?�
zSysModuleSaver.__init__c
C
s&tt
j�
|j}
|
D]}t
j|=q
d
S)z6Remove any modules imported since this object started.Nr()r.�new_modules�
mr#r#r$�restoreBs


�zSysModuleSaver.restoreN�rr&)r�
__module__�__qualname__�__doc__r/r3r#r#r#r$r%=s


r%�Iterator[None]c
c
s(�t�}z
d
V
W|�
�
d
S|�
�
w)z@A context manager to remove any modules imported during a block.N)r%r3)
�saverr#r#r$�sys_modules_savedIs
�

r:�modname�str�Tuple[ModuleType, bool]c

	C
sdt��%
zt
�|�
d
fWWd�
Sty'


tdfYWd�
Sw1s+w



Y
dS)a�
Import a third-party module we need, but might not be installed.

    This also cleans out the module after the import, so that coverage won't
    appear to have imported it.  This lets the third party use coverage for
    their own tests.

    Arguments:
        modname (str): the name of the module to import.

    Returns:
        The imported module, and a boolean indicating if the module could be imported.

    If the boolean is False, the module returned is not the one you want: don't use it.

    TNF)r:�	importlib�
import_module�ImportErrorr*)
r;r#r#r$�import_third_partySs

�

��rA�pairrc
C
s$|\}
}|
|krd
|
Sd|
|fS)z�Make a nice string representation of a pair of numbers.

    If the numbers are equal, just return the number, otherwise return the pair
    with a dash between them, indicating the range.

    z%dz%d-%dr#)rB�start�endr#r#r$�	nice_pairjs

rE�TSelf�TRetVal�fn�Callable[[TSelf], TRetVal]c

s(tj
rd
�
j�d	��
fdd�}
|
S�
S)
z�A decorator to indicate that a method shouldn't be called more than once.

    Normally, this does nothing.  During testing, this raises an exception if
    called more than once.

    �_once_r.rFrrGc


s0t|��rt
d
�
j�d��
�
t|�d�
�
|�
S)NzShouldn't have called z more than onceT)�hasattr�AssertionErrorrrr-��attrrHr#r$�_wrapper�s




zexpensive.<locals>._wrapperN)r.rFrrG)r�TESTINGr)rHrOr#rMr$�	expensive{s


rQ�
br�Optional[bool]c

C
s|d
urd
St|�
S)z"Return bool(b), but preserve None.N)
�bool)
rRr#r#r$�bool_or_none�s
rU�regexes�
Iterable[str]c

C
s0t|�
}t
|�
d
kr|dSd�dd�|D�
�
S)zDCombine a series of regex strings into one that matches any of them.�
r
�
|c
s
s�|]	}
d|
�d
�V
qdS)z(?:�
)Nr#)�.0�
rr#r#r$�	<genexpr>�s�zjoin_regex.<locals>.<genexpr>)�list�len�join)
rVr#r#r$�
join_regex�s

ra�pathr&c

C
sFzt�
|�

Wd
Sty"
}

z|
jtjkr�WYd
}
~
d
Sd
}
~
w
w)z9Remove a file, and don't get annoyed if it doesn't exist.N)�os�remove�OSError�errno�ENOENT)rb�
er#r#r$�file_be_gone�s



���ri�	directoryc

C
s|rtj
|d
d�
dSdS)zVMake sure the directory exists.

    If `directory` is None or empty, do nothing.
    T)
�exist_okN)rc�makedirs)
rjr#r#r$�
ensure_dir�s
�rmc

C
stt
j�|�
�

d
S)z,Make sure the directory for the path exists.N)rmrcrb�dirname)
rbr#r#r$�ensure_dir_for_file�sro�outfile�Optional[IO[str]]c
C
s4|d
urtj
}t|dd
�pttjdd
�pt��}
|
S)zHDetermine the encoding to use for output written to `outfile` or stdout.N�encoding)r*�stdoutr�
__stdout__�locale�getpreferredencoding)rprrr#r#r$�output_encoding�s

��rwc@
s.eZ
dZd
Zddd�Zddd	�Zddd�Zd
S)�Hasherz&Hashes Python data for fingerprinting.rr&c

C
st�
d
�
|_dS)N�sha3_256)�hashlib�new�hashr-r#r#r$r/�r0zHasher.__init__�
vrcC
s2
|j�
tt|
�
�
�d
�
�

t|
t�r|j�
|
�d
�
�

nut|
t�r(|j�
|
�

ni|
dur-ndt|
ttf�r@|j�
t|
�
�d
�
�

nQt|
t	t
f�rR|
D]}|�
|�

qIn?t|
t�ro|
��}t
|�
D]}|�
|�

|�
|
|�

q_n"t|
�
D]}|�d�
r{qst|
|�}t�|�
r�qs|�
|�

|�
|�

qs|j�
d�

dS)z+Add `v` to the hash, recursively if needed.zutf-8N�__�
.)r|�updater<�type�encoder�bytes�int�float�tupler^�dict�keys�sortedr�
startswithr�inspect�	isroutine)r.r}rhr��
k�
ar#r#r$r��s8












�





�











z
Hasher.updater<c

C
s|j�
�d
d�S)z$Retrieve the hex digest of the hash.N� )r|�	hexdigestr-r#r#r$r��szHasher.hexdigestNr4)r}rrr&�rr<)rr5r6r7r/r�r�r#r#r#r$rx�s




rx�that�	func_namercC
sLt|d
�rd}|j
}nd}|j}|j�d|j��}t|�d|�d|
�d��
�
)z7Helper to raise NotImplementedError in interface stubs.�_coverage_plugin_name�Plugin�Class�
.�
 z needs to implement z())rKr��	__class__r5r�NotImplementedError)r�r��thingr!�klassr#r#r$�_needs_to_implement�s





�r�c@
s$eZ
dZd
Zddd�Zddd	�Zd
S)
�DefaultValuez�A sentinel object to use for unusual default-value needs.

    Construct with a string that will be used as the repr, for display in help
    and Sphinx output.

    �
display_asr<rr&cC
s
|
|_dSr'�
r�)r.r�r#r#r$r/

s

zDefaultValue.__init__c


C
s|jSr'r�r-r#r#r$�__repr__
s
zDefaultValue.__repr__N)r�r<rr&r�)rr5r6r7r/r�r#r#r#r$r��s

r��text�	variables�Mapping[str, str]c
s,d
}d�d
��
�fdd�}t�
||�
��
�
S)a�
Substitute ``${VAR}`` variables in `text` with their values.

    Variables in the text can take a number of shell-inspired forms::

        $VAR
        ${VAR}
        ${VAR?}             strict: an error if VAR isn't defined.
        ${VAR-missing}      defaulted: "missing" if VAR isn't defined.
        $$                  just a dollar sign.

    `variables` is a dictionary of variable values.

    Returns the resulting text with values substituted.

    a5(?x)   # Use extended regex syntax
        \$                      # A dollar sign,
        (?:                     # then
            (?P<dollar>\$) |        # a dollar sign, or
            (?P<word1>\w+) |        # a plain word, or
            {                       # a {-wrapped
                (?P<word2>\w+)          # word,
                (?:
                    (?P<strict>\?) |        # with a strict marker
                    -(?P<defval>[^}]*)      # or a default value
                )?                      # maybe.
            }
        )
        )�dollar�word1�word2�match�
re.Match[str]rr<c

s\td
d�|j
��D�
�
}
|
dkrdS|
�vr�|
S|dr*d|
�d�
��}t|�
�
|dS)zCalled for each $replacement.c
s
s�|]}
|
r|
V
qdSr'r#)r[�
gr#r#r$r],
s�z?substitute_variables.<locals>.dollar_replace.<locals>.<genexpr>�
$�strictz	Variable z is undefined: �defval)�next�groupr)r��word�msg��
dollar_groupsr�r�r#r$�dollar_replace)
s






z,substitute_variables.<locals>.dollar_replaceN)r�r�rr<)�re�sub)r�r��dollar_patternr�r#r�r$�substitute_variables
s

r��dt�datetime.datetimec

C
s|���
d
�
S)z?Return a string with local timezone representing the date.
    z%Y-%m-%d %H:%M %z)�
astimezone�strftime)
r�r#r#r$�format_local_datetime;
sr��modfile�
Optional[str]cC
s^|
d
ur|d}
tj
�||
�}|d
u
sJ�
tj
�|�
}|tj|<|jd
u
s'J�
|j�|�

|S)z�Import a local file as a module.

    Opens a file in the current directory named `modname`.py, imports it
    as `modname`, and returns the module object.  `modfile` is the file to
    import if it isn't in the current directory.

    Nz.py)r>�util�spec_from_file_location�module_from_specr*r+�loader�exec_module)r;r��specrr#r#r$�import_local_fileA
s







r��
s�List[Union[str, int]]c


s$ddd���f
dd�t�
d	|�D�
S)z\Turn a string into a list of string and number chunks.
        "z23a" -> ["z", 23, "a"]
    r�r<r�Union[str, int]c

S
s"zt|�
WSt
y


|YSw)
z6If `s` is a number, return an int, else `s` unchanged.)r��
ValueError�
r�r#r#r$�tryintY
s




�z_human_key.<locals>.tryintc

sg|]}
�|
�
�qSr#r#)r[�
c�
r�r#r$�
<listcomp>`
sz_human_key.<locals>.<listcomp>z(\d+)N)r�r<rr�)r��splitr�r#r�r$�
_human_keyU
s
r��strings�	List[str]c

C
st|t
d
�S)z�Sort the given iterable of strings the way that humans expect.

    Numeric components in the strings are sorted as numbers.

    Returns the sorted list.

    )
�key)r�r�)
r�r#r#r$�human_sortedb
sr��SortableItem)
�boundF�items�Iterable[SortableItem]�reverserT�List[SortableItem]cC
st|d
d�|
d�S)z�Sort (string, ...) items the way humans expect.

    The elements of `items` can be any tuple/list. They'll be sorted by the
    first element (a string), with ties broken by the remaining elements.

    Returns the sorted list of items.
    c

S
st|d
�
g
|dd��
RS)Nr
rX)
r�)
�itemr#r#r$�<lambda>y
sz$human_sorted_items.<locals>.<lambda>)r�r�)
r�)r�r�r#r#r$�human_sorted_itemsn
sr���
nr�r��thingscC
s|d
kr|
S|p|
dS)zZPluralize a word.

    If n is 1, return thing.  Otherwise return things, or thing+s.
    rXr�r#)r�r�r�r#r#r$�plural|
s
r��urlcC
s,tt
jd
�rt
j��rd|
�d|�d�S|S)z�Format text+url as a clickable link for stdout.

    If attached to a terminal, use escape sequences. Otherwise, just return
    the text.
    �isattyz]8;;�
z]8;;)rKr*rsr�)r�r�r#r#r$�stdout_link�
s
r�)rrrr)rr8)r;r<rr=)rBrrr<)rHrIrrI)rRrrrS)rVrWrr<)rbr<rr&)rjr<rr&r')rprqrr<)r�rr�r<rr)r�r<r�r�rr<)r�r�rr<)r;r<r�r�rr)r�r<rr�)r�rWrr�)
F)r�r�r�rTrr�)r�r�)r�r�r�r<r�r<rr<)r�r<r�r<rr<)Cr7�
__future__r�
contextlib�datetimerfrzr>�importlib.utilr�rurc�os.pathr�r*rr�typingrrrrrr	r
rrr
rrrr�coverager�coverage.exceptionsr�coverage.typesrr�__annotations__rr%�contextmanagerr:rArErFrGrQrUrarirmrorwrxr�r�r�r�r�r�r�r�r�r�r�r#r#r#r$�<module>
sf











@





	





	
	
	
(

3



�