3
<_: @ s d dl Z d dlZddlmZ ddlmZmZmZmZm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z ej Z ej Z ej Z ej Z ej!Z!ej"Z"ej#Z#ej$Z$e j%d
kre&Z'e(Z)ne*Z'e+Z)G dd de,Z-dd Z.dS ) N )_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_VARIANT c @ sN e Zd ZdZeeeeee e
e e e
eeiZedededee e e eeeeed/iZeeee ed1ed3eee eee ee iZ edededededede
dede di Z G d d
d
e!Z"d d d d dde#j$d d f 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,d- Z5d S )4Propertya 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
r ? r @ g c @ s e Zd Zdd ZdS )zProperty.__metaclass__c C s dS )Nz )selfr" r" '/usr/lib64/python3.6/_propertyhelper.py__repr__ s z Property.__metaclass__.__repr__N)__name__
__module__ __qualname__r% r" r" r" r$
__metaclass__ s r) Nc
C s< d | _ |d krt}| j|| _| j|| _| j t|tsDt d|| _
t|ts\t d|| _ || _ || _
|r| r| j}n*|r| r| j}n| r| r| j}| j}| j| || _|d k r|| j k rt d| j| j f n| j }|| _| d k r$| | j kr,t d| j| j f n| j } | | _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
isinstance _basestring TypeErrornickblurb__doc__flags_readonly_setter_writeonly_getter_default_getter_default_settergetterfset _get_minimumminimum _get_maximummaximum_exc)
r# r< setterr- r/ r4 r5 r7 r? rA r" r" r$ __init__ sL
zProperty.__init__c C s d| j p
dtj| jf S )Nzz(uninitialized))r* r Z type_namer- )r# r" r" r$ r% s zProperty.__repr__c C s\ |d kr | S d | _ y| j|}W n tk
r@ tj d }Y nX | j rX| j }d | _ ||S )N)rB fget Exception traceback print_exc)r# instanceklassvalueexcr" r" r$ __get__ s
zProperty.__get__c C s: |d kr t d | _|j| j| | jr6| j}d | _|d S )N)r3 rB Z set_propertyr* )r# rI rK rL r" r" r$ __set__ s zProperty.__set__c C s
| j |S )z;Allows application of the getter along with init arguments.)r< )r# rE 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.)r6 r5 rE )r# rE r" r" r$ r< s
zProperty.getterc C s || _ | js| jj| _| S )z8Set the setter function to fset. For use as a decorator.)r= r* rE r& )r# r= r" r" r$ rC s
zProperty.setterc C s || j kr| j | S t|trBt|tjtjtjtjtj frB|j
S |t t t
ttttttttttttttt t t t t fkrz|S t!d|f d S )NzUnsupported type: %r)"_type_from_pytype_lookupr1 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 r3 )r# Ztype_r" r" r$ r, s"
zProperty._type_from_pythonc C s |d k r |S | j j| jd S )N)_default_lookupgetr- )r# r/ r" r" r$ r. & s zProperty._get_defaultc C s| | j }| j}|tkr.|d
kr.td|f nJ|tkrJ|d k rFtdn.|tkrf|d k rbtdntj|tr|d krtdn tj||std||f ntj|t rtj||std||f ntj|t
o|d k r2t |t std t
| xx|D ](}t |ttfkrtd
t| qW nFtj|trx|d k rxt|d shtj|t rxtd ||f d S )NTFz%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 stringsrR z*variant value %s must be an instance of %r)TF)r- r/ r r3 r r r Z type_is_ar r r r1 listreprstrbytesr hasattr)r# ptyper/ valr" r" r$ r0 + s>
zProperty._check_defaultc C s | j j| jd S )N)_min_value_lookuprT r- )r# r" r" r$ r> L s zProperty._get_minimumc C s | j j| jd S )N)_max_value_lookuprT r- )r# r" r" r$ r@ O s zProperty._get_maximumc C s t |d| j | d S )N_property_helper_)setattrr* )r# rI rK r" r" r$ r; V s zProperty._default_setterc C s t |d| j | jS )Nr^ )getattrr* r/ )r# rI r" r" r$ r: Y s zProperty._default_getterc C s t d| jt|jf | _d S )Nz %s property of %s is read-only)r3 r* r- r& rB )r# rI rK r" r" r$ r8 \ s zProperty._readonly_setterc C s t d| jt|jf | _d S )Nz %s property of %s is write-only)r3 r* r- r& rB )r# rI r" r" r$ r9 ` s zProperty._writeonly_getterc C s | j }|ttttttttfkr0| j | j
| j f}nl|t ks^|t
ks^|jts^|jts^|jtrh| j f}n4|ttfkrzf }n"|jts|jtrf }nt|| j | j| jf| | jf S )N)r- r r
r r r
r r r r? rA r/ r r Zis_ar r r r r r r NotImplementedErrorr4 r5 r7 )r# rZ argsr" r" r$ get_pspec_argsh s
zProperty.get_pspec_argsl l l l l l )6r& r' r( r6 _longr intr boolr floatr rW r r+ r rP r
r r r
G_MAXFLOAT G_MAXDOUBLEG_MININT G_MINLONGr
r\ G_MAXUINT
G_MAXULONGG_MAXINT G_MAXLONGr] rS r- r) r ZPARAM_READWRITErD r% rM rN rO r< rC r, r. r0 r> r@ r; r: r8 r9 rc r" r" r" r$ r 2 sh 66
!r c s j jdi }g }xp j j D ]b\}}t|tr |js<||_|j|krh||j |j krZq td|j |j ||j< |j| q W |sdS | _ d j ksd j krx4|D ],}|j
|j ks|j |j
krtd jf qW dd }| _ 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 jdd}t| |d S )N-_)r* replacer` )r# pspecr* r" r" r$ obj_get_property s z,install_properties..obj_get_propertyc s. |j jdd}t |d }|r*|j| | d S )Nrs rt )r* ru r` r= )r# rv rK r* prop)clsr" r$ obj_set_property s z,install_properties..obj_set_property)__dict__rT itemsr1 r r* rc
ValueErrorappendrp rE r: r= r; r3 r& rq rr )ry Z gpropertiesZpropsr* rx rw rz r" )ry r$ install_properties{ s2
r )r r )/sysrG 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 rh ri rj rn rl rk ro rm version_inforW r2 re rd Z
basestringZlongr+ r r r" r" r" r$ s( h
K