3
<_1 @ s d dl Z d dlZd dlZd dlZd dlmZ d dlmZ d dlm Z d dl
m Z m Z d dlm
Z
e
eeZi Zdd ZG d d
d
e jZG d d d eZd
d Zdd ZeZdd Zdd Ze i i edfddZ dddZ dS ) N)
get_loader)PyGIDeprecationWarning) CallableInfo) TYPE_NONE TYPE_INVALID) extend_pathc s fdd}|S )Nc s j | _ j| _| S )N)__name__
__module__)wrapper)wrapped /usr/lib64/python3.6/__init__.pyassign s zwraps..assignr )r r r )r r
wraps s r c s8 e Zd ZdZ fddZdd Zdd Zdd Z ZS )
OverridesProxyModulez7Wraps a introspection module and contains all overridesc s t t| j|j || _d S )N)superr __init__r _introspection_module)selfintrospection_module) __class__r r
r ! s
z OverridesProxyModule.__init__c C s t | j|S )N)getattrr )r namer r r
__getattr__& s z OverridesProxyModule.__getattr__c C s6 t t| j}|j| jj |jt| j t|S )N)setdirr update__dict__keysr sorted)r resultr 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 r __qualname____doc__r r r! r#
__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 : s
z _DeprecatedAttribute.__init__c C s( |d krt | jtj| jdd | jS )N )
stacklevel)AttributeErrorr( warningswarnr* r) )r instanceownerr r r
__get__A s
z _DeprecatedAttribute.__get__c C s$ | j }tt|| t||| d S )N)r( delattrr" setattr)r r4 r- r, r r r
__set__G s z _DeprecatedAttribute.__set__c C s t t|| j d S )N)r7 r" r( )r r4 r r r
__delete__M s z _DeprecatedAttribute.__delete__N)r r r$ r% r r6 r9 r: r r r r
r' 3 s
r' c C s | j jddd }d| }|tjk}tjj|}t|d tfi }|| }|tj|< ddlm} t|dsnt |||< zHd| }y t
|} W n t k
r d } Y nX | d kr| S t j
|}
W d ||= tj|= |r|tj|< X ||_g } t|
d
r|
j} xH| D ]@} yt|
| }
W n t tfk
r. wY nX t|| |
qW xptj|g D ]`\}}yt||}W n" t k
r t d | Y nX t|| t||||}t||| qPW |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.
. zgi.repository.Z ProxyModuler/ )modulesr z
gi.overrides.N__all__z1%s was set deprecated but wasn't added to __all__)r rsplitsysr= getr" r ZimporterhasattrAssertionErrorr r1 importlib
import_moduleZ_overrides_moduler> r TypeErrorr8 _deprecated_attrspopr7 r' )r r+ Z
module_keyZhas_oldZ
old_moduleZ
proxy_typeproxyr= Zoverride_package_nameZoverride_loaderZ override_modZ override_allvaritemr, r. r- deprecated_attrr r r
load_overridesR sX
rN c s t | tr>| }|jjddd }tjd| fdd}|S t | tjrXtd| nyt | d}W n" t
k
r td| j Y nX | jj d st
d
| | jf |j }|tkst|tkr| |_| jjddd
}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.
r; r< zgi.repository.c s t | j| | S )N)r8 r )func)moduler r
r
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)Nr? r? )
isinstancer r r@ rA r= types FunctionTyperG r r1 r
startswithKeyErrorZ
get_g_typer rD r Zpytyper8 )Ztype_rO r+ r
infoZg_typer )rP r
override s4
rW c s t fdd}|S )z7Decorator for marking methods and classes as deprecatedc s$ t jd jf tdd | |S )Nz %s is deprecated; use %s insteadr/ )r0 )r2 r3 r r )argskwargs)fnr. r r
r s
zdeprecated..wrapped)r )rZ r. r r )rZ r. r
deprecated s r[ c C s t j| g j||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)rH
setdefaultappend)r+ r, r. r r r
rM s rM 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 sZ |r:t jddj dt| d tt |}ni }|j| g }x4j D ](\}}||krV|j|||< |j | qVW |rt jddjfddt
|D djt
|f d g }x2j D ]&\}}||krΈ| ||< |j | qW |r*t jddjfd dt
|D d x"D ]}||kr0|j| q0W | f|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, N)r0 zThe keyword(s) "%s" have been deprecated in favor of "%s" respectively. See: https://wiki.gnome.org/PyGObject/InitializerDeprecationsc 3 s | ]} | V qd S )Nr ).0k)deprecated_aliasesr r
/ s 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 )r^ r_ )deprecated_defaultsr r
ra > s ) r2 r3 joinlendictzipr itemsrI r] r ) r rX rY Z
new_kwargsZ aliases_usedkeyaliasZ
defaults_usedr- ) arg_namescategoryr` rb ignorer0 super_init_funcr r
new_init s<
z!deprecated_init..new_initr )rm rj rl r` rb rk r0 rn r )rj rk r` rb rl r0 rm r
deprecated_init s 3ro 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 sL | |}|d r4t |dkr&|d S |dd S nrD p@dS d S )Nr r/ r< z call failed)rd )rX rY ret)exc_strexc_typefail_retmethodr r
r R s
z%strip_boolean_result..wrapped)r )rt rr rq rs r r )rq rr rs rt r
strip_boolean_resultK s ru )NNN) rR r2 rE rA Zpkgutilr Zgir Zgi._gir Z
gi._constantsr r r __path__r rH r
ModuleTyper objectr' rN rW Z overridefuncr[ rM tuplero ru r r r r
s.
V-
Q