a
T`2 c @ s d dl Z d dlZd dlZd dlZd dlZd dlmZ d dlmZ d dl m
Z
m Z d dl m
Z
mZ d dlmZ eeeZi ZG dd dejZG d d
d
eZd d Zd
d ZeZdd Zdd Ze i i edfddZ dddZ dd Z dS ) N)
get_loader)PyGIDeprecationWarning) CallableInfopygobject_new_full) TYPE_NONE TYPE_INVALID) extend_pathc s8 e Zd ZdZ fddZdd Zdd Zdd Z ZS )
OverridesProxyModulez7Wraps a introspection module and contains all overridesc s t t| |j || _d S N)Zsuperr __init____name___introspection_module)selfintrospection_module __class__ 9/usr/lib/python3.9/site-packages/gi/overrides/__init__.pyr
s
z OverridesProxyModule.__init__c C s t | j|S r )getattrr )r
Znamer r r __getattr__ s z OverridesProxyModule.__getattr__c C s6 t t| j}|| j |t| j t|S r )ZsetZdirr updateZ__dict__Zkeysr sorted)r
Zresultr r r __dir__" s z OverridesProxyModule.__dir__c C s dt | j| jf S )Nz<%s %r>)typer r )r
r r r __repr__( s z OverridesProxyModule.__repr__) r
__module__ __qualname____doc__r
r r r Z
__classcell__r r r r r s
r c @ s0 e Zd ZdZdd Zdd Zdd Zdd Zd
S ) _DeprecatedAttributezA deprecation descriptor for OverridesProxyModule subclasses.
Emits a PyGIDeprecationWarning on every access and tries to act as a
normal instance attribute (can be replaced and deleted).
c C s$ || _ || _td|||f | _d S )Nz#%s.%s is deprecated; use %s instead)_attr_valuer _warning)r
namespaceattrvalue replacementr r r r
3 s z _DeprecatedAttribute.__init__c C s( |d u rt | jtj| jdd | jS )N
stacklevel)AttributeErrorr warningswarnr r )r
instanceZownerr r r __get__: s
z _DeprecatedAttribute.__get__c C s$ | j }tt|| t||| d S r )r delattrr setattr)r
r+ r# r" r r r __set__@ s z _DeprecatedAttribute.__set__c C s t t|| j d S r )r- r r )r
r+ r r r
__delete__F s z _DeprecatedAttribute.__delete__N)r r r r r
r, r/ r0 r r r r r , s
r c
C s | j ddd }d| }|tjv }tj|}t|d tfi }|| }|tj|< ddlm} t|dsnJ |||< zd | }z t |} W n t
y d
} Y n0 | d
u r| W ||= tj|= |r|tj|< S t |}
W ||= tj|= |r|tj|< n ||= tj|= |r|tj|< 0 ||_
g } t|
d r4|
j} | D ]@} zt|
| }
W n t
tfyh Y q8Y n0 t|| |
q8t|g D ]^\}}zt||}W n t
y td | Y n0 t|| t||||}t||| q|S )
zLoads overrides for an introspection module.
Either returns the same module again in case there are no overrides or a
proxy module including overrides. Doesn't cache the result.
. gi.repository.Z ProxyModuler% )modulesr z
gi.overrides.N__all__z1%s was set deprecated but wasn't added to __all__)r rsplitsysr5 Zgetr r ZimporterZhasattrr r( importlibZ
import_moduleZ_overrides_moduler6 r TypeErrorr. _deprecated_attrspopZAssertionErrorr- r )r r! Z
module_keyZhas_oldZ
old_moduleZ
proxy_typeZproxyr5 Zoverride_package_nameZoverride_loaderZ override_modZ override_allZvarZitemr" r$ r# deprecated_attrr r r load_overridesK sn
r> c s t | tr>| }|jddd }tjd| fdd}|S t | tjrXtd| nzt | d}W n t
y td | j Y n0 | j d
st
d | | jf | }|tksJ |tkr| |_| jddd }tjd| t | j | | S d S )
a Decorator for registering an override.
Other than objects added to __all__, these can get referenced in the same
override module via the gi.repository module (get_parent_for_object() does
for example), so they have to be added to the module immediately.
r1 r2 r3 r4 c s t | j| | S r )r. r funcZmoduler r wrapper s zoverride..wrapperz"func must be a gi function, got %sZ__info__zKCan not override a type %s, which is not in a gobject introspection typelibz gi.overrideszUYou have tried override outside of the overrides module. This is not allowed (%s, %s)N)Z
isinstancer r r7 r8 r5 typesZ FunctionTyper: r r( r Z
startswithZKeyErrorZ
get_g_typer r Zpytyper. )Ztype_r@ r! rB ZinfoZg_typer rA r override s<
rD c s t fdd}|S )z7Decorator for marking methods and classes as deprecatedc s( t jd jf tdd | i |S )Nz %s is deprecated; use %s insteadr% r& )r) r* r r )argskwargsfnr$ r r wrapped s zdeprecated..wrapped functoolsZwraps)rH r$ rI r rG r
deprecated s rL c C s t | g ||f dS )a: Marks a module level attribute as deprecated. Accessing it will emit
a PyGIDeprecationWarning warning.
e.g. for ``deprecated_attr("GObject", "STATUS_FOO", "GLib.Status.FOO")``
accessing GObject.STATUS_FOO will emit:
"GObject.STATUS_FOO is deprecated; use GLib.Status.FOO instead"
:param str namespace:
The namespace of the override this is called in.
:param str namespace:
The attribute name (which gets added to __all__).
:param str replacement:
The replacement text which will be included in the warning.
N)r; Z
setdefaultappend)r! r" r$ r r r r= s r= r% c s fdd}|S )a Wrapper for deprecating GObject based __init__ methods which specify
defaults already available or non-standard defaults.
:param callable super_init_func:
Initializer to wrap.
:param list arg_names:
Ordered argument name list.
:param list ignore:
List of argument names to ignore when calling the wrapped function.
This is useful for function which take a non-standard keyword that is munged elsewhere.
:param dict deprecated_aliases:
Dictionary mapping a keyword alias to the actual g_object_newv keyword.
:param dict deprecated_defaults:
Dictionary of non-standard defaults that will be used when the
keyword is not explicitly passed.
:param Exception category:
Exception category of the error.
:param int stacklevel:
Stack level for the deprecation passed on to warnings.warn
:returns: Wrapped version of ``super_init_func`` which gives a deprecation
warning when non-keyword args or aliases are used.
:rtype: callable
c sR |r:t jdd dt| d tt |}ni }|| g } D ](\}}||v rT||||< | | qT|rt jddfddt
|D dt
|f d g } D ]&\}}||vrȈ| ||< | | q|r"t jddfd dt
|D d D ]}||v r&|| q&| fi |S )
zInitializer for a GObject based classes with support for property
sets through the use of explicit keyword arguments.
zUsing positional arguments with the GObject constructor has been deprecated. Please specify keyword(s) for "%s" or use a class specific constructor. See: https://wiki.gnome.org/PyGObject/InitializerDeprecationsz, Nr& zThe keyword(s) "%s" have been deprecated in favor of "%s" respectively. See: https://wiki.gnome.org/PyGObject/InitializerDeprecationsc 3 s | ]} | V qd S r r Z.0Zk)deprecated_aliasesr r ( z4deprecated_init..new_init..zInitializer is relying on deprecated non-standard defaults. Please update to explicitly use: %s See: https://wiki.gnome.org/PyGObject/InitializerDeprecationsc 3 s | ]}d | | f V qdS )z%s=%sNr rN )deprecated_defaultsr r rP 7 rQ ) r) r* ZjoinlenZdictZzipr Zitemsr< rM r ) r
rE rF Z
new_kwargsZ aliases_usedZkeyZaliasZ
defaults_usedr# arg_namescategoryrO rR ignorer' super_init_funcr r new_init sJ
z!deprecated_init..new_initr )rX rU rW rO rR rV r' rY r rT r deprecated_init s 3rZ c s t fdd}|S )a Translate method's return value for stripping off success flag.
There are a lot of methods which return a "success" boolean and have
several out arguments. Translate such a method to return the out arguments
on success and None on failure.
c sP | i |}|d r8t |dkr*|d S |dd S nrH pDdS d S )Nr r% r2 z call failed)rS )rE rF Zretexc_strexc_typefail_retmethodr r rI K s z%strip_boolean_result..wrappedrJ )r_ r] r\ r^ rI r r[ r strip_boolean_resultD s r` c s fdd}|S )Nc s& t | d} t |d} | |g|R S )NF)r )ZaZbZ user_datar? r r wrap\ s
z'wrap_list_store_sort_func..wrapr )r@ ra r r? r wrap_list_store_sort_funcZ s rb )NNN) rK rC r) r9 r8 Zpkgutilr Zgir Zgi._gir r Z
gi._constantsr r r Z__path__r r; Z
ModuleTyper Zobjectr r> rD Z overridefuncrL r= ZtuplerZ r` rb r r r r Z s2
V-
T