File: //lib/python3/dist-packages/gi/__pycache__/_propertyhelper.cpython-38.pyc
U
�� ^�7 � @ s� d dl mZ d dlmZmZ d dlmZmZmZm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m Z ej Z ej Z ej Z ej!Z!ej"Z"ej#Z#ej$Z$ej%Z%G dd� de&�Z'dd� Z(dS ) � )�_gi)� string_types�long_)� TYPE_NONE�TYPE_INTERFACE� TYPE_CHAR�
TYPE_UCHAR� TYPE_BOOLEAN�TYPE_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 @ sN e Zd ZdZeeeeee e
e e e
eeiZedededee e e eeeeediZeeee ededeee 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"� Z0d#d$� Z1d%d&� Z2d'd(� Z3d)d*� Z4d+d,� Z5d
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<class 'GObject.Property'>� ��selfr r �4/usr/lib/python3/dist-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 krt}| �|�| _| �|�| _| �� t|t�sDt d��|| _
t|t�s\t d��|| _ || _ || _
|r~|s~| j}n$|r�|s�| j}n|s�|s�| j}| j}| �|� || _|d k r�|| �� k r�t d| j| �� f ��n| �� }|| _| d k �r | | �� k�r$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)�name�object�_type_from_python�type� _get_default�default�_check_default�
isinstancer � TypeError�nick�blurb�__doc__�flags�_readonly_setter�_writeonly_getter�_default_getter�_default_setter�getter�fset� _get_minimum�minimum� _get_maximum�maximum�_exc)
r" r: �setterr, r. r2 r3 r5 r= r? r r r# �__init__� sT
��
��zProperty.__init__c C s d| j p
d| jj f S )Nz<GObject Property %s (%s)>z(uninitialized))r) r, r! r r r# r$ � s �zProperty.__repr__c C s6 |d kr | S d | _ | �|�}| j r2| j }d | _ |�|S �N)r@ �fget)r" �instance�klass�value�excr r r# �__get__� s
zProperty.__get__c C s: |d kr t �d | _|�| j|� | jr6| j}d | _|�d S rC )r1 r@ Z set_propertyr) )r" rE rG rH r r r# �__set__� s zProperty.__set__c C s
| � |�S )z;Allows application of the getter along with init arguments.)r: �r" rD 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.)r4 r3 rD rK 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) rD r% )r" r; r r r# rA � s
zProperty.setterc C s� || j kr| j | S t|t�rBt|tjtjtjtjtj f�rB|j
S |t t t
ttttttttttttttt t t t t fkrz|S t!d|f ��d S )NzUnsupported type: %r)"�_type_from_pytype_lookupr0 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 r1 )r" Ztype_r r r# r+ � sB
��
�zProperty._type_from_pythonc C s |d k r |S | j �| jd �S rC )�_default_lookup�getr, )r" r. r r r# r- s zProperty._get_defaultc C sz | j }| j}|tkr.|dkr.td|f ���nH|tkrJ|d k rFtd���n,|tkrf|d k rbtd���n|�t�r�|d kr�td��n t� |��|�s�td||f ��n�|�t
�r�t� |��|�s�td||f ��n�|�t ��r2|d k �r2t |t
��stdt|� ��|D ](}t |�ttfk�rtd t|� ���qnD|�t��rv|d k �rvt|d
��rft� |��t��svtd ||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 stringsrO z*variant value %s must be an instance of %r)r, r. r r1 r r �is_ar r ZGTyper r r0 �list�repr�str�bytesr �hasattr)r" �ptyper. �valr r r# r/ sF �
�
� �zProperty._check_defaultc C s | j �| jd �S rC )�_min_value_lookuprQ r, r! r r r# r< 6 s zProperty._get_minimumc C s | j �| jd �S rC )�_max_value_lookuprQ r, r! r r r# r> 9 s zProperty._get_maximumc C s t |d| j |� d S �NZ_property_helper_)�setattrr) �r" rE rG r r r# r9 @ s zProperty._default_setterc C s t |d| j | j�S r\ )�getattrr) r. �r" rE r r r# r8 C s zProperty._default_getterc C s t d| jt|�jf �| _d S )Nz %s property of %s is read-only�r1 r) r, r% r@ r^ r r r# r6 F s �zProperty._readonly_setterc C s t d| jt|�jf �| _d S )Nz %s property of %s is write-onlyra r` r r r# r7 J s �zProperty._writeonly_getterc C s� | j }|ttttttttfkr0| j | j
| j f}nl|t ks^|t
ks^|�t�s^|�t�s^|�t�rh| j f}n4|ttfkrzd}n"|�t�s�|�t�r�d}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 �NotImplementedErrorr2 r3 r5 )r" rX �argsr r r# �get_pspec_argsR s,
����
zProperty.get_pspec_args)6r% r& r' r4 r r �intr
�boolr �floatr rU r r* r rM r r
r r �
G_MAXFLOAT� G_MAXDOUBLE�G_MININT� G_MINLONGr rZ � G_MAXUINT�
G_MAXULONG�G_MAXINT� G_MAXLONGr[ rP r, r( r ZPARAM_READWRITErB r$ rI rJ rL r: rA r+ r- r/ r< r> r9 r8 r6 r7 rd r r r r# r ( s� 8 � �
� � �
8
!r c s� � j �di �}g }� j �� D ]b\}}t|t�r |js:||_|j|krf||j |�� krXq td|j ��|�� ||j< |�|� q |s�dS |� _ d� j ks�d� j kr�|D ],}|j
|j ks�|j |j
kr�td� jf ��q�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__N�do_get_property�do_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.<locals>.obj_get_propertyc s. |j �dd�}t� |d �}|r*|�| |� d S rs )r) rv r_ r; )r" rw rG r) �prop��clsr r# �obj_set_property� s z,install_properties.<locals>.obj_set_property)�__dict__rQ �itemsr0 r r) rd �
ValueError�appendrp rD r8 r; r9 r1 r% rq rr )r{ Z gpropertiesZpropsr) ry rx r| r rz r# �install_propertiese s6
�� r� N))r r Z_compatr 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 r* r r� r r r r# �<module> s h ?