| Server IP : 93.86.61.54 / Your IP : 216.73.216.156 Web Server : Apache/2.4.62 (Ubuntu) System : Linux rasin.ddns.net 6.8.0-124-generic #124~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Tue May 26 21:05:19 UTC x86_64 User : www-data ( 33) PHP Version : 8.4.22 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /lib/python3/dist-packages/fs/__pycache__/ |
Upload File : |
o
�Q `K& � @ s� d Z ddlmZ ddlmZ ddlZddlmZ ddlZddlmZ ej r5ddlm
Z
m Z m Z m
Z
mZmZ d d
� ZG d d � d e�ZejG d
d� de��ZdS )z Abstract permissions container.
� )�print_function)�unicode_literalsN)�Iterable� )�Text)�Iterator�List�Optional�Tuple�Type�Unionc C s
t �| �S )z/Make a mode integer from an initial value.
)� Permissions�get_mode)�init� r �0/usr/lib/python3/dist-packages/fs/permissions.py� make_mode �
r c @ s* e Zd ZdZdd� Zd dd�Zdd� ZdS )
�
_PermPropertyz6Creates simple properties to get/set permissions.
c C s || _ d�|�| _d S )Nz Boolean for '{}' permission.)�_name�format�__doc__)�self�namer r r �__init__ s z_PermProperty.__init__Nc C s
| j |v S �N)r )r �obj�obj_typer r r �__get__# �
z_PermProperty.__get__c C s$ |r
|� | j� d S |�| j� d S r )�addr �remove)r r �valuer r r �__set__' s z_PermProperty.__set__r )�__name__�
__module__� __qualname__r r r r# r r r r r s
r c @ sL e Zd ZdZg d�Zdd� eD �Z d7dd�Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z e
dd� �Ze
dd� �Ze
d8dd��Ze
dd� �Zd d � Zd d � Zd d!� Zed"d#� �Zejd$d#� �Zed%�Zed&�Zed'�Zed(�Z ed)�Z ed*�Z ed+�Z ed,�Z ed-�Z!ed.�Z"ed/�Z#ed0�Z$d1d2� Z%d3d4� Z&d5d6� Z'dS )9r
ab An abstraction for file system permissions.
Permissions objects store information regarding the permissions
on a resource. It supports Linux permissions, but is generic enough
to manage permission information from almost any filesystem.
Arguments:
names (list, optional): A list of permissions.
mode (int, optional): A mode integer.
user (str, optional): A triplet of *user* permissions, e.g.
``"rwx"`` or ``"r--"``
group (str, optional): A triplet of *group* permissions, e.g.
``"rwx"`` or ``"r--"``
other (str, optional): A triplet of *other* permissions, e.g.
``"rwx"`` or ``"r--"``
sticky (bool, optional): A boolean for the *sticky* bit.
setuid (bool, optional): A boolean for the *setuid* bit.
setguid (bool, optional): A boolean for the *setguid* bit.
Example:
>>> from fs.permissions import Permissions
>>> p = Permissions(user='rwx', group='rw-', other='r--')
>>> print(p)
rwxrw-r--
>>> p.mode
500
>>> oct(p.mode)
'0764'
) )�setuidi )�setguidi )�stickyi )�u_r� )�u_w� )�u_x�@ )�g_r� )�g_w� )�g_x� )�o_r� )�o_w� )�o_xr c C s g | ]\}}|�qS r r )�.0r �_maskr r r �
<listcomp>^ s zPermissions.<listcomp>Nc
s� |d ur
t |�| _n:� d ur� fdd�| jD �| _n*t � } | _| �dd� |p(dD �� | �dd� |p4dD �� | �dd� |p@dD �� |rL| j�d� |rT| j�d � |r^| j�d
� d S d S ) Nc � h | ]
\}}� |@ r|�qS r r �r; r �mask��moder r � <setcomp>o � z'Permissions.__init__.<locals>.<setcomp>c s � � | ] }|d krd| V qdS )�-�u_Nr �r; �pr r r � <genexpr>r � � z'Permissions.__init__.<locals>.<genexpr>� c s rE )rF �g_Nr rH r r r rJ s rK c s rE )rF �o_Nr rH r r r rJ t rK r) r' r( )�set�_perms� _LINUX_PERMS�updater )
r �namesrB �user�group�otherr) r' r( �permsr rA r r ` s �zPermissions.__init__c s � j �� j�sd�dd� t� j �D ��}d�|�S � fdd�}d�|dd �|d
d �|d d
�f�}d�|dd �|dd �|dd
�f�}d�|dd �|dd �|dd
�f�}g }d}|�|||�}|�|� � jrj|�d� � jrr|�d� � jrz|�d� d�d�|��S )Nz, c s s � | ]}d � |�V qdS )z'{}'N)r rH r r r rJ � s � z'Permissions.__repr__.<locals>.<genexpr>zPermissions(names=[{}])c s | � j v r|S dS )NrL �rP )�permr �r r r �_check� s z$Permissions.__repr__.<locals>._checkrL r* �rr, �wr. �xr0 r2 r4 r6 r8 r: z!user='{}', group='{}', other='{}'z sticky=Truez setuid=Truez setguid=TruezPermissions({})) rP �issubset�_LINUX_PERMS_NAMES�join�sortedr �appendr) r' ) r �
_perms_strr[ rT rU rV �args�_fmt�basicr rZ r �__repr__} s$
"""
zPermissions.__repr__c C s | � � S r )�as_strrZ r r r �__str__� s zPermissions.__str__c C �
t | j�S r )�iterrP rZ r r r �__iter__� r zPermissions.__iter__c C s
|| j v S r rX )r �
permissionr r r � __contains__� r zPermissions.__contains__c C s$ t |t�r
|�� }n|}| �� |kS r )�
isinstancer
�dump)r rV rS r r r �__eq__� s
zPermissions.__eq__c C s | � |� S r )rr )r rV r r r �__ne__� s zPermissions.__ne__c C s2 |dd� }|dd� }|dd� }| |||d�S )z-Parse permissions in Linux notation.
N� � � )rT rU rV r )�cls�lsrT rU rV r r r �parse� s zPermissions.parsec C s
| |d�S )z.Load a serialized permissions object.
�rS r )rw � permissionsr r r �load� s
zPermissions.loadc C sP |du r | dd�S t || �r|S t |t�r| |d�S t |t�r$| |d�S td��)a� Create a permissions object from an initial value.
Arguments:
init (int or list, optional): May be None to use `0o777`
permissions, a mode integer, or a list of permission names.
Returns:
int: mode integer that may be used for instance by `os.makedir`.
Example:
>>> Permissions.create(None)
Permissions(user='rwx', group='rwx', other='rwx')
>>> Permissions.create(0o700)
Permissions(user='rwx', group='', other='')
>>> Permissions.create(['u_r', 'u_w', 'u_x'])
Permissions(user='rwx', group='', other='')
Ni� rA rz zpermissions is invalid)rp �int�list�
ValueError�rw r r r r �create� s
zPermissions.createc C s | � |�jS )z4Convert an initial value to a mode integer.
)r� rB r� r r r r � s zPermissions.get_modec C s t t| j�d�S )z0Make a copy of this permissions object.
rz )r
r~ rP rZ r r r �copy� s zPermissions.copyc C rk )z/Get a list suitable for serialization.
)rb rP rZ r r r rq � r zPermissions.dumpc s� � fdd�t � jdd� d�D �}d� jv r!d� jv r dnd |d
< d � jv r1d � jv r-dnd |d
< d� jv rAd� jv r=dnd|d< d�|�}|S )z@Get a Linux-style string representation of permissions.
c s" g | ]
\}}|� j v r
|nd �qS )rF rX )r; r �crZ r r r= � s ��z&Permissions.as_str.<locals>.<listcomp>i����N� rwxrwxrwxr' r. �s�Sr9 r( r4 � r) r: �t�Tr5 rL )�zipr` rP ra )r rW �perm_strr rZ r ri � s
�
zPermissions.as_strc C s* d}| j D ]
\}}|| jv r||O }q|S )z `int`: mode integer.
r �rQ rP )r rB r r@ r r r rB s
�zPermissions.modec s � fdd�| j D �| _d S )Nc r> r r r? rA r r rC rD z#Permissions.mode.<locals>.<setcomp>r� )r rB r rA r rB s r* r, r. r0 r2 r4 r6 r8 r: r) r' r( c G � | j �|� dS )z�Add permission(s).
Arguments:
*permissions (str): Permission name(s), such as ``'u_w'``
or ``'u_x'``.
N)rP rR �r r{ r r r r # � zPermissions.addc G r� )z�Remove permission(s).
Arguments:
*permissions (str): Permission name(s), such as ``'u_w'``
or ``'u_x'``.s
N)rP �difference_updater� r r r r! . r� zPermissions.removec G s | j �|�S )z�Check if one or more permissions are enabled.
Arguments:
*permissions (str): Permission name(s), such as ``'u_w'``
or ``'u_x'``.
Returns:
bool: `True` if all given permissions are set.
)rP �
issupersetr� r r r �check9 s zPermissions.check)NNNNNNNNr )(r$ r% r& r rQ r` r rh rj rm ro rr rs � classmethodry r| r� r r� rq ri �propertyrB �setterr r* r, r. r0 r2 r4 r6 r8 r: r) r' r( r r! r� r r r r r
/ sb
�
r
)r �
__future__r r �typingr �six�_typingr �
TYPE_CHECKINGr r r r
r r r �objectr �python_2_unicode_compatibler
r r r r �<module> s