o Q`K&@sdZddlmZddlmZddlZddlmZddlZddlmZej r5ddlm Z m Z m Z m Z mZmZd d ZGd d d eZejGd ddeZdS)z Abstract permissions container. )print_function)unicode_literalsN)Iterable)Text)IteratorListOptionalTupleTypeUnioncCs t|S)z/Make a mode integer from an initial value. ) Permissionsget_mode)initr0/usr/lib/python3/dist-packages/fs/permissions.py make_mode rc@s*eZdZdZddZd ddZddZdS) _PermPropertyz6Creates simple properties to get/set permissions. cCs||_d||_dS)NzBoolean for '{}' permission.)_nameformat__doc__)selfnamerrr__init__sz_PermProperty.__init__NcCs |j|vSN)r)robjZobj_typerrr__get__# z_PermProperty.__get__cCs$|r ||jdS||jdSr)addrremove)rrvaluerrr__set__'sz_PermProperty.__set__r)__name__ __module__ __qualname__rrrr"rrrrrs   rc@sLeZdZdZgdZddeDZ        d7ddZdd Zd d Zd d Z ddZ ddZ ddZ e ddZe ddZe d8ddZe ddZddZddZd d!Zed"d#Zejd$d#Zed%Zed&Zed'Zed(Zed)Zed*Zed+Zed,Z ed-Z!ed.Z"ed/Z#ed0Z$d1d2Z%d3d4Z&d5d6Z'dS)9r abAn 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_xrcCsg|]\}}|qSrr).0rZ_maskrrr ^szPermissions.Nc s|dur t||_n:durfdd|jD|_n*t} |_| dd|p(dD| dd|p4dD| dd|p@dD|rL|jd|rT|jd |r^|jd dSdS) Nch|] \}}|@r|qSrrr:rmaskmoderr oz'Permissions.__init__..cs |] }|dkrd|VqdS)-Zu_Nrr:prrr rz'Permissions.__init__..csrC)rDZg_NrrErrrrGsrHcsrC)rDZo_NrrErrrrGtrHr(r&r')set_perms _LINUX_PERMSupdater) rnamesr@usergroupotherr(r&r'permsrr?rr`s    zPermissions.__init__c sjjsdddtjD}d|Sfdd}d|dd |d d |d d f}d|dd |dd |dd f}d|dd |dd |dd f}g}d}||||}||jrj|djrr|djrz|ddd|S)Nz, css|]}d|VqdS)z'{}'N)rrErrrrGsz'Permissions.__repr__..zPermissions(names=[{}])cs|jvr|SdS)NrIrK)Zpermrrrr_checksz$Permissions.__repr__.._checkrIr)rr+wr-xr/r1r3r5r7r9z!user='{}', group='{}', other='{}'z sticky=Truez setuid=Truez setguid=TruezPermissions({})) rKissubset_LINUX_PERMS_NAMESjoinsortedrappendr(r&) rZ _perms_strrUrOrPrQargsZ_fmtZbasicrrTr__repr__}s$  """    zPermissions.__repr__cCs|Sr)as_strrTrrr__str__szPermissions.__str__cC t|jSr)iterrKrTrrr__iter__rzPermissions.__iter__cCs ||jvSrrS)rZ permissionrrr __contains__rzPermissions.__contains__cCs$t|tr |}n|}||kSr) isinstancer dump)rrQrNrrr__eq__s   zPermissions.__eq__cCs || Sr)rh)rrQrrr__ne__s zPermissions.__ne__cCs2|dd}|dd}|dd}||||dS)z-Parse permissions in Linux notation. N )rOrPrQr)clsZlsrOrPrQrrrparses   zPermissions.parsecCs ||dS)z.Load a serialized permissions object. rNr)rm permissionsrrrloads zPermissions.loadcCsP|dur |ddSt||r|St|tr||dSt|tr$||dStd)aCreate 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='') Nir?rozpermissions is invalid)rfintlist ValueErrorrmrrrrcreates      zPermissions.createcCs ||jS)z4Convert an initial value to a mode integer. )rvr@rurrrrs zPermissions.get_modecCstt|jdS)z0Make a copy of this permissions object. ro)r rsrKrTrrrcopyszPermissions.copycCrb)z/Get a list suitable for serialization. )r\rKrTrrrrgrzPermissions.dumpcsfddtjdddD}djvr!djvrdnd |d <d jvr1d jvr-dnd |d <djvrAdjvr=dnd|d<d|}|S)z@Get a Linux-style string representation of permissions. cs"g|] \}}|jvr |ndqS)rDrS)r:rcrTrrr;sz&Permissions.as_str..iNZ rwxrwxrwxr&r-sSr8r'r3r(r9tTr4rI)ziprZrKr[)rrRZperm_strrrTrr`s     zPermissions.as_strcCs*d}|jD] \}}||jvr||O}q|S)z`int`: mode integer. rrLrK)rr@rr>rrrr@s  zPermissions.modecsfdd|jD|_dS)Ncr<rrr=r?rrrArBz#Permissions.mode..r)rr@rr?rr@sr)r+r-r/r1r3r5r7r9r(r&r'cG|j|dS)zAdd permission(s). Arguments: *permissions (str): Permission name(s), such as ``'u_w'`` or ``'u_x'``. N)rKrMrrprrrr# zPermissions.addcGr)zRemove permission(s). Arguments: *permissions (str): Permission name(s), such as ``'u_w'`` or ``'u_x'``.s N)rKdifference_updaterrrrr .rzPermissions.removecGs |j|S)zCheck 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. )rK issupersetrrrrcheck9s zPermissions.check)NNNNNNNNr)(r#r$r%rrLrZrr_rardrerhri classmethodrnrqrvrrwrgr`propertyr@setterrr)r+r-r/r1r3r5r7r9r(r&r'rr rrrrrr /sb        r )rZ __future__rrtypingrZsixZ_typingrZ TYPE_CHECKINGrrr r r r robjectrZpython_2_unicode_compatibler rrrrs