a
b^S7 @ s d dl mZ d dlmZmZmZmZmZmZm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZmZmZmZmZmZmZ ejZej Z ej Z ej Z ej Z ej Z ej!Z!ej"Z"G dd de#Z$dd Z%dS ) )_gi) TYPE_NONETYPE_INTERFACE TYPE_CHAR
TYPE_UCHAR TYPE_BOOLEANTYPE_INT TYPE_UINT TYPE_LONG
TYPE_ULONG
TYPE_INT64 TYPE_UINT64 TYPE_ENUM
TYPE_FLAGS
TYPE_FLOAT TYPE_DOUBLE TYPE_STRING TYPE_POINTER
TYPE_BOXED
TYPE_PARAM TYPE_OBJECT
TYPE_PYOBJECT
TYPE_GTYPE TYPE_STRV TYPE_VARIANTc @ sJ e Zd ZdZeeeeee e
e e e
iZedededee e e eeeeediZeeeeededeee eee ee iZ edededededede dede di Z G dd d e Z!d
d
d
d
dde"j#d
d
f d d Z$d
d Z%dd Z&dd Z'dd Z(dd Z)dd Z*dd Z+dd Z,d d Z-d d Z.d!d" Z/d#d$ Z0d%d& Z1d'd( Z2d)d* Z3d+d, Z4d
S )-Propertya Creates a new Property which when used in conjunction with
GObject subclass will create a Python property accessor for the
GObject ParamSpec.
:param callable getter:
getter to get the value of the property
:param callable setter:
setter to set the value of the property
:param type type:
type of property
:param default:
default value, must match the property type.
:param str nick:
short description
:param str blurb:
long description
:param GObject.ParamFlags flags:
parameter flags
:keyword minimum:
minimum allowed value (int, float, long only)
:keyword maximum:
maximum allowed value (int, float, long only)
.. code-block:: python
class MyObject(GObject.Object):
prop = GObject.Property(type=str)
obj = MyObject()
obj.prop = 'value'
obj.prop # now is 'value'
The API is similar to the builtin :py:func:`property`:
.. code-block:: python
class AnotherObject(GObject.Object):
value = 0
@GObject.Property
def prop(self):
'Read only property.'
return 1
@GObject.Property(type=int)
def propInt(self):
'Read-write integer property.'
return self.value
@propInt.setter
def propInt(self, value):
self.value = value
l l l g c @ s e Zd Zdd ZdS )zProperty.__metaclass__c C s dS )Nz selfr r 8/usr/lib64/python3.9/site-packages/gi/_propertyhelper.py__repr__ s z Property.__metaclass__.__repr__N)__name__
__module__ __qualname__r" r r r r!
__metaclass__ s r& Nc
C s4 d | _ |d u rt}| || _| || _| t|tsDt d|| _
t|ts\t d|| _ || _ || _
|r~|s~| j}n$|r|s| j}n|s|s| j}| j}| | || _|d ur|| k rt d| j| f n| }|| _| d ur | | kr$t d| j| f n| } | | _d | _d S )Nznick must be a stringzblurb must be a stringz+Minimum for type %s cannot be lower than %dz,Maximum for type %s cannot be higher than %d)nameobject_type_from_pythontype _get_defaultdefault_check_default
isinstancestr TypeErrornickblurb__doc__flags_readonly_setter_writeonly_getter_default_getter_default_settergetterfset _get_minimumminimum _get_maximummaximum_exc)
r r9 setterr* r, r1 r2 r4 r< r> r r r! __init__ sT
zProperty.__init__c C s d| j p
d| jj f S )Nzz(uninitialized))r' r* r r r r! r" s zProperty.__repr__c C s6 |d u r | S d | _ | |}| j r2| j }d | _ ||S N)r? fget)r instanceklassvalueexcr r r! __get__ s
zProperty.__get__c C s: |d u r t d | _|| j| | jr6| j}d | _|d S rB )r0 r? Z set_propertyr' )r rD rF rG r r r! __set__ s zProperty.__set__c C s
| |S )z;Allows application of the getter along with init arguments.)r9 r rC r r r! __call__ s zProperty.__call__c C s |j r|j | _|j | _ || _| S )z8Set the getter function to fget. For use as a decorator.)r3 r2 rC rJ r r r! r9 s
zProperty.getterc C s || _ | js| jj| _| S )z8Set the setter function to fset. For use as a decorator.)r: r' rC r# )r r: r r r! r@ s
zProperty.setterc C s || j v r| j | S t|trBt|tjtjtjtjtj frB|j
S |t t t
ttttttttttttttt t t t t fv rz|S t!d|f d S )NzUnsupported type: %r)"_type_from_pytype_lookupr. r*
issubclassr ZGObjectZGEnumZGFlagsZGBoxedZ
GInterface __gtype__r r r r r r r r
r r r
r r r r r r r r r r r r0 )r type_r r r! r) s(
zProperty._type_from_pythonc C s |d ur |S | j | jd S rB )_default_lookupgetr* )r r, r r r! r+
s zProperty._get_defaultc C sz | j }| j}|tkr.|dvr.td|f nH|tkrJ|d urFtdn,|tkrf|d urbtdn|tr|d u rtdn t ||std||f n|t
rt ||std||f n|t r2|d ur2t |t
stdt| |D ](}t |ttfvrtd t| qnD|trv|d urvt|d
rft |tsvtd ||f d S ) N)TFz%default must be True or False, not %rz)object types does not have default valuesz(GType types does not have default valuesz%enum properties needs a default valuez'enum value %s must be an instance of %rz(flags value %s must be an instance of %rz Strv value %s must be a listz'Strv value %s must contain only stringsrN z*variant value %s must be an instance of %r)r* r, r r0 r r is_ar r ZGTyper r r. listreprr/ bytesr hasattr)r ptyper, valr r r! r- sF
zProperty._check_defaultc C s | j | jd S rB )_min_value_lookuprQ r* r r r r! r; 3 s zProperty._get_minimumc C s | j | jd S rB )_max_value_lookuprQ r* r r r r! r= 6 s zProperty._get_maximumc C s t |d| j | d S NZ_property_helper_)setattrr' r rD rF r r r! r8 = s zProperty._default_setterc C s t |d| j | jS r[ )getattrr' r, r rD r r r! r7 @ s zProperty._default_getterc C s t d| jt|jf | _d S )Nz %s property of %s is read-onlyr0 r' r* r# r? r] r r r! r5 C s zProperty._readonly_setterc C s t d| jt|jf | _d S )Nz %s property of %s is write-onlyr` r_ r r r! r6 G s zProperty._writeonly_getterc C s | j }|ttttttttfv r0| j | j
| j f}nl|t ks^|t
ks^|ts^|ts^|trh| j f}n4|ttfv rzd}n"|ts|trd}nt|| j | j| jf| | jf S )Nr )r* r r r
r r r
r r r< r> r, r r rR r r r r r r r NotImplementedErrorr1 r2 r4 )r rW argsr r r! get_pspec_argsO s&
zProperty.get_pspec_args)5r# r$ r% r3 intr boolr floatr r/ r r( r rL r r r
r
G_MAXFLOAT G_MAXDOUBLEG_MININTr
G_MINLONGr rY G_MAXUINT
G_MAXULONGG_MAXINT G_MAXLONGrZ rP r* r& r ZPARAM_READWRITErA r" rH rI rK r9 r@ r) r+ r- r; r= r8 r7 r5 r6 rc r r r r! r ' sp 7
8
!r c s j di }g } j D ]b\}}t|tr |js:||_|j|v rf||j | krXq td|j | ||j< || q |sdS | _ d j v sd j v r|D ],}|j
|j ks|j |j
krtd jf qdd }| _ fd d
}| _dS ) z
Scans the given class for instances of Property and merges them
into the classes __gproperties__ dict if it exists or adds it if not.
__gproperties__z0Property %s was already found in __gproperties__Ndo_get_propertydo_set_propertyzGObject subclass %r defines do_get/set_property and it also uses a property with a custom setter or getter. This is not allowedc S s |j dd}t| |d S N-_)r' replacer^ )r pspecr' r r r! obj_get_property s z,install_properties..obj_get_propertyc s. |j dd}t |d }|r*|| | d S rr )r' ru r^ r: )r rv rF r' propclsr r! obj_set_property s z,install_properties..obj_set_property)__dict__rQ itemsr. r r' rc
ValueErrorappendro rC r7 r: r8 r0 r# rp rq )rz Z gpropertiesZpropsr' rx rw r{ r ry r! install_propertiesb s6
r N)&r r Z
_constantsr r r r r r r r
r r r
r r r r r r r r r r r r r rg rh ri rm rk rj rn rl r( r r r r r r! s h =