t ,gܕ d dl mZ d dlmZ d dlZddlmZ G d d Zde d e
d
e
d dfd Z G d
de
e Z G d de
e Z G d dee ZdD ]Z e eed G d dee ZdD ]Z e eed G d dej j e Z ed Zd ed efd Ze
e e
eeeeeiZd ed efd Zd ed efd Z e Z e Z dS ) )wraps)TypeVarN ) SetuptoolsDeprecationWarningc " e Zd ZU dZdZeed< dS )Statica`
Wrapper for built-in object types that are allow setuptools to identify
static core metadata (in opposition to ``Dynamic``, as defined :pep:`643`).
The trick is to mark values with :class:`Static` when they come from
``pyproject.toml`` or ``setup.cfg``, so if any plugin overwrite the value
with a built-in, setuptools will be able to recognise the change.
We inherit from built-in classes, so that we don't need to change the existing
code base to deal with the new types.
We also should strive for immutability objects to avoid changes after the
initial parsing.
F _mutated_N)__name__
__module__ __qualname____doc__r bool__annotations__ d/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/setuptools/_static.pyr r s. Itr r targetmethodcopyingreturnc t | |d dS t dt ffd }d|_ t | || dS )a
Because setuptools is very flexible we cannot fully prevent
plugins and user customizations from modifying static values that were
parsed from config files.
But we can attempt to block "in-place" mutations and identify when they
were done.
Nselfc ` d| _ t j dd dd | g|R i |S )NTz/Direct modification of value will be disallowedz
In an effort to implement PEP 643, direct/in-place changes of static values
that come from configuration files are deprecated.
If you need to modify this value, please first create a copy with z
and make sure conform to all relevant standards when overriding setuptools
functionality (https://packaging.python.org/en/latest/specifications/).
)i
r )due_date)r r emit)r argskwargsr fns r _replacementz+_prevent_modification.._replacement' sk $) =
PW
$
r$(((((((r )getattrr r r
setattr)r r r r r s ` @r _prevent_modificationr$ s}
& &B z
2YY)6 ) ) ) ) ) ) Y)" L FFL)))))r c e Zd ZdS )StrNr
r r r r r r& r& = Dr r& c e Zd ZdS )TupleNr' r r r r* r* A r( r r* c e Zd ZdZdS )Lista
:meta private:
>>> x = List([1, 2, 3])
>>> is_static(x)
True
>>> x += [0] # doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
SetuptoolsDeprecationWarning: Direct modification ...
>>> is_static(x) # no longer static after modification
False
>>> y = list(x)
>>> y.clear()
>>> y
[]
>>> y == x
False
>>> is_static(List(y))
True
Nr
r r r
r r r r, r, E s r r, )
__delitem____iadd__ __setitem__appendclearextendinsertremovereversepopz
`list(value)`c e Zd ZdZdS )Dicta
:meta private:
>>> x = Dict({'a': 1, 'b': 2})
>>> is_static(x)
True
>>> x['c'] = 0 # doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
SetuptoolsDeprecationWarning: Direct modification ...
>>> x._mutated_
True
>>> is_static(x) # no longer static after modification
False
>>> y = dict(x)
>>> y.popitem()
('b', 2)
>>> y == x
False
>>> is_static(Dict(y))
True
Nr- r r r r9 r9 l s r r9 )r. __ior__r0 r2 r7 popitem
setdefaultupdatez
`dict(value)`c e Zd ZdZdS ) SpecifierSetz>Not exactly a built-in type but useful for ``requires-python``Nr- r r r r? r? s HHHHr r? Tvaluec | S )z
>>> noop(42)
42
r rA s r nooprD s
Lr c l t t | t | S )zc
>>> is_static(attempt_conversion("hello"))
True
>>> is_static(object())
False
) _CONVERSIONSgettyperD rC s r attempt_conversionrI s( DKK . .u 5 55r c < t | t o| j S )z
>>> is_static(a := Dict({'a': 1}))
True
>>> is_static(dict(a))
False
>>> is_static(b := List([1, 2, 3]))
True
>>> is_static(list(b))
False
)
isinstancer r rC s r is_staticrL s eV $ $ r[ s 2 2 2 2 2 2 $ *$ * *c *d * * * *D #v E6 4 0 : :G $ 9999 4 0
:
:G $ 9999I I I I I9'4f I I I GCLL a S%dD$? 6a 6A 6 6 6 6 =V = = = = = TVV
TVV
r