JezK
Edit File: descriptors.cpython-39.pyc
a q�qe�& � @ s� d Z ddlZddlmZmZ ddlmZ ddlmZ ddl m Z ddl m Z m Z mZmZmZmZ ddlmZ d d lmZ G d d � d �ZG d d� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�Z G dd� d�Z dS )z� SETools descriptors. These classes override how a class's attributes are get/set/deleted. This is how the @property decorator works. See https://docs.python.org/3/howto/descriptor.html for more details. � N)�ABC�abstractmethod)� defaultdict)� Collection)�Enum)�Any�Callable�MutableMapping�Optional�Type�Union)�WeakKeyDictionary� )�validate_perms_anyc @ sX e Zd ZdZd ee eeeef eee dd�dd�Z dd� Z d dd �Z d d � Z dS )�CriteriaDescriptora� Single item criteria descriptor. Keyword Parameters: name_regex The name of instance's regex setting attribute; used as name_regex below. If unset, regular expressions will never be used. lookup_function The name of the SELinuxPolicy lookup function, e.g. lookup_type or lookup_boolean. default_value The default value of the criteria. The default is None. enum_class The class of enumeration which supports a lookup class method. Read-only instance attribute use (obj parameter): policy The instance of SELinuxPolicy name_regex This attribute is read to determine if the criteria should be looked up or compiled into a regex. If the attribute does not exist, False is assumed. N)� name_regex�lookup_function� enum_class�returnc C sN |s|s|sJ d��|r$|r$J d��|| _ || _|| _|| _d| _t� | _d S )NzQA simple attribute should be used if there is no regex, lookup function, or enum.z9Lookup functions and enum classes are mutually exclusive.� )�regex� default_valuer r �namer � instances)�selfr r r r � r �9/usr/lib64/python3.9/site-packages/setools/descriptors.py�__init__: s � �zCriteriaDescriptor.__init__c C s || _ d S �N�r )r �ownerr r r r � __set_name__M s z CriteriaDescriptor.__set_name__c C s |d u r | S | j �|| j�S r )r � setdefaultr �r �objZobjtyper r r �__get__P s zCriteriaDescriptor.__get__c C s� |s| j | j|< n�| jr8t|| jd�r8t�|�| j|< nZ| jrnt| j�rP| j}nt|j| j�}||�| j|< n$| j r�| j � |�| j|< n || j|< d S )NF) r r r �getattr�re�compiler �callable�policyr �lookup)r r$ �valuer+ r r r �__set__V s zCriteriaDescriptor.__set__)NNNN)N)�__name__� __module__� __qualname__�__doc__r �strr r r r r r! r% r- r r r r r " s � � r c @ s e Zd ZdZdd� ZdS )�CriteriaSetDescriptorz!Descriptor for a set of criteria.c s� |s�j �j|< n��jr8t|�jd�r8t�|��j|< nv�jr|t�j�rP�j� nt|j�j�� t � fdd�|D ���j|< n2�j r�t �fdd�|D ���j|< nt |��j|< d S )NFc 3 s | ]}� |�V qd S r r ��.0�v)r+ r r � <genexpr>u � z0CriteriaSetDescriptor.__set__.<locals>.<genexpr>c 3 s | ]}� j �|�V qd S r )r r+ r4 )r r r r7 w r8 ) r r r r& r' r( r r) r* � frozensetr �r r$ r, r )r+ r r r- k s z CriteriaSetDescriptor.__set__N)r. r/ r0 r1 r- r r r r r3 g s r3 c @ s. e Zd ZdZdee dd�dd�Zdd� ZdS ) � CriteriaPermissionSetDescriptora� Descriptor for a set of permissions criteria. name_regex The name of instance's regex setting attribute; used as name_regex below. If unset, regular expressions will never be used. default_value The default value of the criteria. The default is None. Read-only instance attribute use (obj parameter): policy The instance of SELinuxPolicy tclass If it exists, it will be used to validate the permissions. See validate_perms_any() tclass_regex If tclass is a regex, the above permission validation will not use tclass: permissions are verified to be in at least one class in the policy but not verified that the permissions are in classes that the regex matches. Assumes False if the attribute doesn't exist. N)r r c C s || _ || _d| _t� | _d S )Nr )r r r r r )r r r r r r r � s z(CriteriaPermissionSetDescriptor.__init__c C s� |s| j | j|< n�| jr8t|| jd�r8t�|�| j|< nbtdd� |D ��}t|dd�r\d }n t|dd �}|r�t|t�s�t|f�}t |||j d� || j|< d S )NFc s s | ] }|V qd S r r r4 r r r r7 � r8 z:CriteriaPermissionSetDescriptor.__set__.<locals>.<genexpr>Z tclass_regex�tclass)r< r* ) r r r r& r' r( r9 � isinstancer r r* )r r$ r, Zpermsr< r r r r- � s �z'CriteriaPermissionSetDescriptor.__set__)NN)r. r/ r0 r1 r r2 r r- r r r r r; | s r; c @ sB e Zd ZdZedd�dd�Zd dd�Zedd � �Zed d � �Z dS ) �NetworkXGraphEdgeDescriptora' Descriptor abstract base class for NetworkX graph edge attributes. Parameter: name The edge property name Instance class attribute use (obj parameter): G The NetworkX graph source The edge's source node target The edge's target node N)�propnamer c C s || _ d S r r )r r? r r r r � s z$NetworkXGraphEdgeDescriptor.__init__c C sH |d u r | S z|j |j |j | j W S tyB t| j��Y n0 d S r )�G�source�targetr �KeyError�AttributeErrorr# r r r r% � s z#NetworkXGraphEdgeDescriptor.__get__c C s d S r r r: r r r r- � s z#NetworkXGraphEdgeDescriptor.__set__c C s d S r r �r r$ r r r � __delete__� s z&NetworkXGraphEdgeDescriptor.__delete__)N) r. r/ r0 r1 r2 r r% r r- rF r r r r r> � s r> c @ s e Zd ZdZdd� Zdd� ZdS )� EdgeAttrDictz7A descriptor for edge attributes that are dictionaries.c C s: |d u r&t t�|j|j |j | j< ntd�| j���d S )Nz0{0} dictionaries should not be assigned directly)r �listr@ rA rB r rD �formatr: r r r r- � s �zEdgeAttrDict.__set__c C s |j |j |j | j �� d S r �r@ rA rB r �clearrE r r r rF � s zEdgeAttrDict.__delete__N�r. r/ r0 r1 r- rF r r r r rG � s rG c @ s e Zd ZdZdd� Zdd� ZdS )�EdgeAttrIntMaxz� A descriptor for edge attributes that are non-negative integers that always keep the max assigned value until re-initialized. c C s\ |d u r"d|j |j |j | j< n6|j |j |j | j }t||�|j |j |j | j< d S �Nr )r@ rA rB r �max)r r$ r, Z current_valuer r r r- � s zEdgeAttrIntMax.__set__c C s d|j |j |j | j< d S rN )r@ rA rB r rE r r r rF � s zEdgeAttrIntMax.__delete__NrL r r r r rM � s rM c @ s e Zd ZdZdd� Zdd� ZdS )� EdgeAttrListz0A descriptor for edge attributes that are lists.c C s6 |d u r"g |j |j |j | j< ntd�| j���d S )Nz){0} lists should not be assigned directly)r@ rA rB r � ValueErrorrI r: r r r r- s zEdgeAttrList.__set__c C s |j |j |j | j �� d S r rJ rE r r r rF s zEdgeAttrList.__delete__NrL r r r r rP s rP c @ s: e Zd ZdZeed�dd�Zd dd�Zdd � Zd d � Z dS ) �PermissionMapDescriptoraN Descriptor for Permission Map mappings. Parameter: name The map setting name. validator A callable for validating the setting. Instance class attribute use (obj parameter): _perm_map The full permission map. class_ The mapping's object class perm The mapping's permission )r? � validatorc C s || _ || _d S r )r rS )r r? rS r r r r " s z PermissionMapDescriptor.__init__Nc C s$ |d u r | S |j |j |j | j S r )� _perm_map�class_�permr r# r r r r% & s z PermissionMapDescriptor.__get__c C s" | � |�|j|j |j | j< d S r )rS rT rU rV r r: r r r r- , s z PermissionMapDescriptor.__set__c C s t �d S r )rD rE r r r rF / s z"PermissionMapDescriptor.__delete__)N) r. r/ r0 r1 r2 r r r% r- rF r r r r rR s rR ) r1 r' �abcr r � collectionsr �collections.abcr �enumr �typingr r r r r r �weakrefr �utilr r r3 r; r> rG rM rP rR r r r r �<module> s E?#