o pf4@sdZddlmZmZmZddlZddlmZddlZddlm Z ddl m Z m Z ddl mZdd lmZdd lmZdd lmZdd lmZejrudd lmZmZmZmZmZmZddlmZee ee effZ ee!gefZ"e#dZ$ej%GdddeZ&dS)z0Container for filesystem resource informations. )absolute_importprint_functionunicode_literalsN)cast)deepcopy)Textoverload) ResourceType)MissingInfoNamespace)join) Permissions)epoch_to_datetime)AnyCallableListMappingOptionalUnion)datetimeTc@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 `~fs.time.epoch_to_datetime`. )raw _to_datetime namespacescCs ||_||_t|j|_dS)z3Create a resource info object from a raw info dict.N)rr frozensetkeysr)selfraw_info to_datetimer @/home/ertert/spirit/venv/lib/python3.10/site-packages/fs/info.py__init__1sz Info.__init__cCs|jr d|jSd|jS)Nz z )is_dirformatnamerr r r!__str__8s  z Info.__str__cCs|jt|ddkS)Nr)rgetattr)rotherr r r!__eq__Asz Info.__eq__cCdSNr rtr r r!_make_datetimeEzInfo._make_datetimecCr+r,r r-r r r!r/Jr0cCs|dur ||SdSr,)rr-r r r!r/Os cCr+r,r )r namespacekeyr r r!getVr0zInfo.getcCr+r,r rr1r2defaultr r r!r3[r0NcCs,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 = my_fs.getinfo("foo.py", namespaces=["details"]) >>> info.get('details', 'type') 2 )rr3KeyErrorr4r r r!r3`s  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 rr1r r r!_require_namespacevs zInfo._require_namespacecCs||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 _writer )r3)rr1r2 _writeabler r r! is_writeables$zInfo.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. )rr7r r r! has_namespaces zInfo.has_namespacecCstt|j|p |jdS)z+Create a copy of this resource info object.)r)rrrr)rrr r r!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. )r r%)rdir_pathr r r! make_paths zInfo.make_pathcCtt|ddS)z`str`: the resource name.basicr%)rrr3r&r r r!r%z Info.namecCsH|dd}|dr|ddkrdS|d\}}}|r"d|SdS)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 '' rAr%.r)r3 startswithcount rpartition)rr%basenamedotextr r r!suffixs z Info.suffixcCsD|dd}|dr|ddkrgSdd|dddDS)z`List`: a list of any suffixes in the name. Example: >>> info = my_fs.getinfo("foo.tar.gz") >>> info.suffixes ['.tar', '.gz'] rAr%rCrcSsg|]}d|qS)rCr ).0rKr r r! sz!Info.suffixes..N)r3rErFsplitrr%r r r!suffixess z Info.suffixescCs(|dd}|dr |S|ddS)z`str`: the name minus any suffixes. Example: >>> info = my_fs.getinfo("foo.tar.gz") >>> info.stem 'foo' rAr%rCr)r3rErNrOr r r!stems z Info.stemcCr@)z6`bool`: `True` if the resource references a directory.rAr#rboolr3r&r r r!r#rBz Info.is_dircCstt|dd S)z1`bool`: `True` if the resource references a file.rAr#rRr&r r r!is_file sz Info.is_filecCs|d|dddduS)z,`bool`: `True` if the resource is a symlink.linktargetNr8r3r&r r r!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)r8r r3r&r r r!rZ 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. rYaccessedr8r/r3r_timer r r!r]& z Info.accessedcCr\)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. rYmodifiedr^r_r r r!rb6raz Info.modifiedcCr\)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. rYcreatedr^r_r r r!rcFraz Info.createdcCr\)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. rYmetadata_changedr^r_r r r!rdVrazInfo.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)r8r3r )r _perm_namesrfr r r!rffs 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. rYsize)r8rintr3r&r r r!rhyr[z 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. reuserrWr&r r r!rk z Info.usercCrj)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. reuidrWr&r r r!rmrlzInfo.uidcCrj)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. regrouprWr&r r r!rnrlz Info.groupcCrj)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. regidrWr&r r r!rorlzInfo.gidcCrj)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. rUrVrWr&r r r!rVrlz Info.targetr,)&__name__ __module__ __qualname____doc__ __slots__rr"r'__repr__r*r r/r3r8r;r<r=r?propertyr%rKrPrQr#rTrXrZr]rbrcrdrfrhrkrmrnrorVr r r r!rsx       '                   r)'rs __future__rrrtypingrsixr=r_typingrr enumsr errorsr pathr rfr timer TYPE_CHECKINGrrrrrrrobjectRawInfori ToDatetimeTypeVarrpython_2_unicode_compatiblerr r r r!s(