ob4TdZddlmZmZmZddlZddlmZddlZddlm Z ddl m Z m Z ddl mZdd lmZdd lmZdd lmZdd lmZej.rz )is_dirformatnamer s r#__str__z Info.__str__8s3 ;;&&tyy1 1 '' 2 2r%c6|jt|ddk(S)Nr)rgetattr)r others r#__eq__z Info.__eq__Asxx75%666r%cyNr ts r#_make_datetimezInfo._make_datetimeE r%cyr1r2r3s r#r5zInfo._make_datetimeJr6r%c*||j|Syr1)rr3s r#r5zInfo._make_datetimeOs =$$Q' 'r%cyr1r2)r namespacekeys r#getzInfo.getVr6r%cyr1r2r r:r;defaults r#r<zInfo.get[r6r%Ncd |j|j||S#t$r|cYSwxYw)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 = my_fs.getinfo("foo.py", namespaces=["details"]) >>> info.get('details', 'type') 2 )rr<KeyErrorr>s r#r<zInfo.get`s7" 88I&**38 8 N s ! //c6||jvr t|y)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 r r:s r#_require_namespacezInfo._require_namespacevs  DHH $&y1 1 %r%c0|j|dd}||vS)aCheck if a given key in a namespace is writable. When creating an `Info` object, you can add a ``_write`` key to each raw namespace that lists which keys are writable or not. In general, this means they are compatible with the `setinfo` function of filesystem objects. Arguments: namespace (str): A namespace identifier. key (str): A key within the namespace. Returns: bool: `True` if the key can be modified, `False` otherwise. Example: Create an `Info` object that marks only the ``modified`` key as writable in the ``details`` namespace:: >>> now = time.time() >>> info = Info({ ... "basic": {"name": "foo", "is_dir": False}, ... "details": { ... "modified": now, ... "created": now, ... "_write": ["modified"], ... } ... }) >>> info.is_writeable("details", "created") False >>> info.is_writeable("details", "modified") True _writer2)r<)r r:r; _writeables r# is_writeablezInfo.is_writeables"HXXi26 j  r%c||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. )rrCs r# has_namespacezInfo.has_namespacesDHH$$r%c^tt|j|xs |jS)z+Create a copy of this resource info object.)r")rrrr)r r"s r#copyz Info.copys%HTXX&K4T4CTCTUUr%c.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. )r r))r dir_paths r# make_pathzInfo.make_pathsHdii((r%cBtt|jddS)z`str`: the resource name.basicr))rr r<r*s r#r)z Info.namesD$((7F344r%c|jdd}|jdr|jddk(ry|jd\}}}|rd|zSdS)aE`str`: the last component of the name (with dot). In case there is no suffix, an empty string is returned. Example: >>> info = my_fs.getinfo("foo.py") >>> info.suffix '.py' >>> info2 = my_fs.getinfo("bar") >>> info2.suffix '' rQr).r)r< startswithcount rpartition)r r)basenamedotexts r#suffixz Info.suffixsX xx( ??3 DJJsOq$8!__S1#ssSy'R'r%c|jdd}|jdr|jddk(rgS|jdddDcgc]}d|z c}Scc}w)z`List`: a list of any suffixes in the name. Example: >>> info = my_fs.getinfo("foo.tar.gz") >>> info.suffixes ['.tar', '.gz'] rQr)rSrN)r<rUrVsplit)r r)r[s r#suffixesz Info.suffixess[xx( ??3 DJJsOq$8I+/::c?12+>?f ???s Act|jdd}|jdr|S|jddS)z`str`: the name minus any suffixes. Example: >>> info = my_fs.getinfo("foo.tar.gz") >>> info.stem 'foo' rQr)rSr)r<rUr])r r)s r#stemz Info.stems8xx( ??3 Kzz#q!!r%cBtt|jddS)z6`bool`: `True` if the resource references a directory.rQr'rboolr<r*s r#r'z Info.is_dirsD$((7H566r%cDtt|jdd S)z1`bool`: `True` if the resource references a file.rQr'rbr*s r#is_filez Info.is_file sdhhw9:::r%cN|jd|jdddduS)z,`bool`: `True` if the resource is a symlink.linktargetNrDr<r*s r#is_linkz Info.is_links* 'xx$/t;;r%c\|jdt|jdddS)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)rDr r<r*s r#rmz Info.types*  *DHHY:;;r%cj|jd|j|jdd}|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. rlaccessedrDr5r<r _times r#roz Info.accessed&2  *##DHHY $CD r%cj|jd|j|jdd}|S)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. rlmodifiedrprqs r#ruz Info.modified6rsr%cj|jd|j|jdd}|S)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. rlcreatedrprqs r#rwz Info.createdFs2  *##DHHY $BC r%cj|jd|j|jdd}|S)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. rlmetadata_changedrprqs r#ryzInfo.metadata_changedVs3  *##DHHY8J$KL r%ch|jd|jdd}|yt|}|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)rDr<r)r _perm_namesr|s r#r|zInfo.permissionsfs; )hhx7  !+. r%cd|jdtt|jddS)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. rlsize)rDrintr<r*s r#rz Info.sizeys*  *C)V455r%cH|jd|jddS)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{userrir*s r#rz Info.users# )xx&))r%cH|jd|jddS)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{uidrir*s r#rzInfo.uid# )xx%((r%cH|jd|jddS)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{grouprir*s r#rz Info.groups# )xx'**r%cH|jd|jddS)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{gidrir*s r#rzInfo.gidrr%cH|jd|jddS)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. rgrhrir*s r#rhz Info.targets# 'xx))r%r1)&__name__ __module__ __qualname____doc__ __slots__rr$r+__repr__r/r r5r<rDrHrJrLrOpropertyr)r[r^r`r'rerjrmrorurwryr|rrrrrrhr2r%r#rrs 6I->53H7        , 2%!N %V )55 ((* @ @ " "77 ;; <<  < <        $ 6 6 * * ) ) + + ) ) * *r%r)'r __future__rrrtypingrsixrLr_typingr r enumsr errorsr pathr r|rtimer TYPE_CHECKINGrrrrrrrobjectRawInfor ToDatetimeTypeVarrpython_2_unicode_compatiblerr2r%r#rsIH  #($# DD!dGD&L112G3%/*JsA  s*6s*!s*r%