o Q`0@sdZddlmZddlmZddlmZddlZddlmZddlmZddl Z dd l m Z dd l m Z dd lmZdd lmZdd lmZddlmZmZejr}ddlmZddlmZmZmZmZmZmZeeeeeffZ ee!gefZ"e#dZ$e j%GdddeZ&dS)z0Container for filesystem resource informations. )absolute_import)print_function)unicode_literalsN)cast)deepcopy)join) ResourceType)MissingInfoNamespace) Permissions)epoch_to_datetime)overloadText)datetime)AnyCallableListMappingOptionalUnionTc@seZdZdZgdZefddZddZeZddZ e d d Z e d d Z d d Z e d dZ e ddZ dBddZ ddZ ddZddZdBddZddZeddZeddZed d!Zed"d#Zed$d%Zed&d'Zed(d)Zed*d+Zed,d-Zed.d/Zed0d1Zed2d3Zed4d5Zed6d7Z ed8d9Z!ed:d;Z"edd?Z$ed@dAZ%dS)CInfoaContainer for :ref:`info`. Resource information is returned by the following methods: * `~fs.base.FS.getinfo` * `~fs.base.FS.scandir` * `~fs.base.FS.filterdir` Arguments: raw_info (dict): A dict containing resource info. to_datetime (callable): A callable that converts an epoch time to a datetime object. The default uses :func:`~fs.time.epoch_to_datetime`. )raw _to_datetime namespacescCs ||_||_t|j|_dS)zz )is_dirformatnamerrrr __str__:s  z Info.__str__cCs|jt|ddkS)Nr)rgetattr)rotherrrr __eq__Csz Info.__eq__cCdSNrrtrrr _make_datetimeGzInfo._make_datetimecCr*r+rr,rrr r.Lr/cCs|dur ||SdSr+)rr,rrr r.Qs cCr*r+r)r namespacekeyrrr getXr/zInfo.getcCr*r+rrr0r1defaultrrr r2]r/NcCs,z |j|||WSty|YSw)aGet a raw info value. Arguments: namespace (str): A namespace identifier. key (str): A key within the namespace. default (object, optional): A default value to return if either the namespace or the key within the namespace is not found. Example: >>> info.get('access', 'permissions') ['u_r', 'u_w', '_wx'] )rr2KeyErrorr3rrr r2bs  cCs||jvr t|dS)zCheck if the given namespace is present in the info. Raises: ~fs.errors.MissingInfoNamespace: if the given namespace is not present in the info. N)rr rr0rrr _require_namespacews zInfo._require_namespacecCs||dd}||vS)a5Check if a given key in a namespace is writable. Uses `~fs.base.FS.setinfo`. Arguments: namespace (str): A namespace identifier. key (str): A key within the namespace. Returns: bool: `True` if the key can be modified, `False` otherwise. Z_writer)r2)rr0r1Z _writeablerrr is_writeableszInfo.is_writeablecCs ||jvS)zCheck if the resource info contains a given namespace. Arguments: namespace (str): A namespace identifier. Returns: bool: `True` if the namespace was found, `False` otherwise. )rr6rrr has_namespaces zInfo.has_namespacecCstt|j|p |jdS)z4Create a copy of this resource info object. )r)rrrr)rrrrr copysz Info.copycCs t||jS)zMake a path by joining ``dir_path`` with the resource name. Arguments: dir_path (str): A path to a directory. Returns: str: A path to the resource. )rr$)rZdir_pathrrr make_paths zInfo.make_pathcCtt|ddS)z"`str`: the resource name. basicr$)rrr2r%rrr r$z Info.namecCsH|dd}|dr|ddkrdS|d\}}}|r"d|SdS)z`str`: the last component of the name (including dot), or an empty string if there is no suffix. Example: >>> info >>> info.suffix '.py' r=r$.r)r2 startswithcount rpartition)rr$basenamedotextrrr suffixs z Info.suffixcCsD|dd}|dr|ddkrgSdd|dddDS)z`List`: a list of any suffixes in the name. Example: >>> info >>> info.suffixes ['.tar', '.gz'] r=r$r?rcSsg|]}d|qS)r?r).0rGrrr sz!Info.suffixes..N)r2rArBsplitrr$rrr suffixess z Info.suffixescCs(|dd}|dr |S|ddS)z`str`: the name minus any suffixes. Example: >>> info >>> info.stem 'foo' r=r$r?r)r2rArJrKrrr stems z Info.stemcCr<)z?`bool`: `True` if the resource references a directory. r=r"rboolr2r%rrr r"r>z Info.is_dircCstt|dd S)z:`bool`: `True` if the resource references a file. r=r"rNr%rrr is_filesz Info.is_filecCs|d|dddduS)z5`bool`: `True` if the resource is a symlink. linktargetNr7r2r%rrr is_links z Info.is_linkcCs|dt|dddS)z`~fs.enums.ResourceType`: the type of the resource. Requires the ``"details"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the 'details' namespace is not in the Info. detailstyper)r7r r2r%rrr rV z Info.typecC |d||dd}|S)z`~datetime.datetime`: the resource last access time, or `None`. Requires the ``"details"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the ``"details"`` namespace is not in the Info. rUaccessedr7r.r2rZ_timerrr rY z Info.accessedcCrX)z`~datetime.datetime`: the resource last modification time, or `None`. Requires the ``"details"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the ``"details"`` namespace is not in the Info. rUmodifiedrZr[rrr r]#r\z Info.modifiedcCrX)z`~datetime.datetime`: the resource creation time, or `None`. Requires the ``"details"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the ``"details"`` namespace is not in the Info. rUcreatedrZr[rrr r^3r\z Info.createdcCrX)z`~datetime.datetime`: the resource metadata change time, or `None`. Requires the ``"details"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the ``"details"`` namespace is not in the Info. rUmetadata_changedrZr[rrr r_Cr\zInfo.metadata_changedcCs.|d|dd}|durdSt|}|S)z`Permissions`: the permissions of the resource, or `None`. Requires the ``"access"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the ``"access"`` namespace is not in the Info. access permissionsN)r7r2r )rZ _perm_namesrarrr raSs zInfo.permissionscCs|dtt|ddS)z`int`: the size of the resource, in bytes. Requires the ``"details"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the ``"details"`` namespace is not in the Info. rUsize)r7rintr2r%rrr rbfrWz Info.sizecC|d|ddS)z`str`: the owner of the resource, or `None`. Requires the ``"access"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the ``"access"`` namespace is not in the Info. r`userrSr%rrr reu z Info.usercCrd)z`int`: the user id of the resource, or `None`. Requires the ``"access"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the ``"access"`` namespace is not in the Info. r`uidrSr%rrr rgrfzInfo.uidcCrd)z`str`: the group of the resource owner, or `None`. Requires the ``"access"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the ``"access"`` namespace is not in the Info. r`grouprSr%rrr rhrfz Info.groupcCrd)z`int`: the group id of the resource, or `None`. Requires the ``"access"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the ``"access"`` namespace is not in the Info. r`gidrSr%rrr rirfzInfo.gidcCrd)z`str`: the link target (if resource is a symlink), or `None`. Requires the ``"link"`` namespace. Raises: ~fs.errors.MissingInfoNamespace: if the ``"link"`` namespace is not in the Info. rQrRrSr%rrr rRrfz Info.targetr+)&__name__ __module__ __qualname____doc__ __slots__r r!r&__repr__r)r r.r2r7r8r9r:r;propertyr$rGrLrMr"rPrTrVrYr]r^r_rarbrergrhrirRrrrr rsx                          r)'rmZ __future__rrrtypingrr:rZsixpathrZenumsr errorsr rar timer Z_typingr rZ TYPE_CHECKINGrrrrrrrobjectZRawInforcZ ToDatetimeTypeVarrZpython_2_unicode_compatiblerrrrr s,