docstr: Fetches metadata of the file set.
  
  If the top-level artifact of the field is a directory, only the metadata of this directory is returned.
  You can use the `path` argument to list metadata of the files contained inside the directory or subdirectories.
  
  Args:
      path: Path to a nested directory, to get metadata of the files contained within the directory.
  
  Returns:
      List of FileEntry items with the following metadata: name, size (bytes), mtime (last modification time),
      and file type (file or directory).
  
  Examples:
      In this example, a Neptune run (RUN-100) has a FileSet field "dataset" containing a directory called "data",
      which has a subdirectory "samples" and a file "dataset.csv". The code for logging this would be:
      `run["dataset"].upload_files("data")`
  
      >>> import neptune
      >>> run = neptune.init_run(with_id="RUN-100")
      >>> run["dataset"].list_fileset_files()
      [FileEntry(name='data', size=None, mtime=datetime.datetime(2023, 8, 17, 10, 31, 54, 278601, tzinfo=tzutc()),
      file_type='directory')]
      >>> run["dataset"].list_fileset_files(path="data")
      [FileEntry(name='samples', size=None, mtime=datetime.datetime(2023, 8, 17, 10, 34, 6, 777017,
      tzinfo=tzutc()), file_type='directory'), FileEntry(name='dataset.csv', size=215,
      mtime=datetime.datetime(2023, 8, 17, 10, 31, 26, 402000, tzinfo=tzutc()), file_type='file')]
      >>> run["dataset"].list_fileset_files(path="data/samples")
      [FileEntry(name='sample_v2.csv', size=215, mtime=datetime.datetime(2023, 8, 17, 10, 31, 26, 491000,
      tzinfo=tzutc()), file_type='file'), FileEntry(name='sample_v3.csv', size=215, mtime=datetime.datetime(2023,
      8, 17, 10, 31, 26, 338000, tzinfo=tzutc()), file_type='file'), ...]
  
  For more information, see the API reference:
     https://docs.neptune.ai/api/field_types#list_fileset_files
docstr_tok: ["Fetches","metadata","of","the","file","set",".","If","the","top-level","artifact","of","the","field","is","a","directory",",","only","the","metadata","of","this","directory","is","returned",".","You","can","use","the","`","path","`","argument","to","list","metadata","of","the","files","contained","inside","the","directory","or","subdirectories",".","Args",":","path",":","Path","to","a","nested","directory",",","to","get","metadata","of","the","files","contained","within","the","directory",".","Returns",":","List","of","FileEntry","items","with","the","following","metadata",":","name",",","size","(","bytes",")",",","mtime","(","last","modification","time",")",",","and","file","type","(","file","or","directory",")",".","Examples",":","In","this","example",",","a","Neptune","run","(","RUN-100",")","has","a","FileSet","field","``","dataset","''","containing","a","directory","called","``","data","''",",","which","has","a","subdirectory","``","samples","''","and","a","file","``","dataset.csv","''",".","The","code","for","logging","this","would","be",":","`","run","[","``","dataset","''","]",".upload_files","(","``","data","''",")","`",">",">",">","import","neptune",">",">",">","run","=","neptune.init_run","(","with_id=","''","RUN-100","''",")",">",">",">","run","[","``","dataset","''","]",".list_fileset_files","(",")","[","FileEntry","(","name='data","'",",","size=None",",","mtime=datetime.datetime","(","2023",",","8",",","17",",","10",",","31",",","54",",","278601",",","tzinfo=tzutc","(",")",")",",","file_type='directory","'",")","]",">",">",">","run","[","``","dataset","''","]",".list_fileset_files","(","path=","''","data","''",")","[","FileEntry","(","name='samples","'",",","size=None",",","mtime=datetime.datetime","(","2023",",","8",",","17",",","10",",","34",",","6",",","777017",",","tzinfo=tzutc","(",")",")",",","file_type='directory","'",")",",","FileEntry","(","name='dataset.csv","'",",","size=215",",","mtime=datetime.datetime","(","2023",",","8",",","17",",","10",",","31",",","26",",","402000",",","tzinfo=tzutc","(",")",")",",","file_type='file","'",")","]",">",">",">","run","[","``","dataset","''","]",".list_fileset_files","(","path=","''","data\/samples","''",")","[","FileEntry","(","name='sample_v2.csv","'",",","size=215",",","mtime=datetime.datetime","(","2023",",","8",",","17",",","10",",","31",",","26",",","491000",",","tzinfo=tzutc","(",")",")",",","file_type='file","'",")",",","FileEntry","(","name='sample_v3.csv","'",",","size=215",",","mtime=datetime.datetime","(","2023",",","8",",","17",",","10",",","31",",","26",",","338000",",","tzinfo=tzutc","(",")",")",",","file_type='file","'",")",",","...","]","For","more","information",",","see","the","API","reference",":","https",":","\/\/docs.neptune.ai\/api\/field_types","#","list_fileset_files"]
code: def list_fileset_files(
      self, path: Optional[str] = None
  ) -> List[FileEntry]:
      """Fetches metadata of the file set.
  
      If the top-level artifact of the field is a directory, only the metadata of this directory is returned.
      You can use the `path` argument to list metadata of the files contained inside the directory or subdirectories.
  
      Args:
          path: Path to a nested directory, to get metadata of the files contained within the directory.
  
      Returns:
          List of FileEntry items with the following metadata: name, size (bytes), mtime (last modification time),
          and file type (file or directory).
  
      Examples:
          In this example, a Neptune run (RUN-100) has a FileSet field "dataset" containing a directory called "data",
          which has a subdirectory "samples" and a file "dataset.csv". The code for logging this would be:
          `run["dataset"].upload_files("data")`
  
          >>> import neptune
          >>> run = neptune.init_run(with_id="RUN-100")
          >>> run["dataset"].list_fileset_files()
          [FileEntry(name='data', size=None, mtime=datetime.datetime(2023, 8, 17, 10, 31, 54, 278601, tzinfo=tzutc()),
          file_type='directory')]
          >>> run["dataset"].list_fileset_files(path="data")
          [FileEntry(name='samples', size=None, mtime=datetime.datetime(2023, 8, 17, 10, 34, 6, 777017,
          tzinfo=tzutc()), file_type='directory'), FileEntry(name='dataset.csv', size=215,
          mtime=datetime.datetime(2023, 8, 17, 10, 31, 26, 402000, tzinfo=tzutc()), file_type='file')]
          >>> run["dataset"].list_fileset_files(path="data/samples")
          [FileEntry(name='sample_v2.csv', size=215, mtime=datetime.datetime(2023, 8, 17, 10, 31, 26, 491000,
          tzinfo=tzutc()), file_type='file'), FileEntry(name='sample_v3.csv', size=215, mtime=datetime.datetime(2023,
          8, 17, 10, 31, 26, 338000, tzinfo=tzutc()), file_type='file'), ...]
  
      For more information, see the API reference:
         https://docs.neptune.ai/api/field_types#list_fileset_files
      """
      return self._pass_call_to_attr(
          function_name="list_fileset_files", path=path
      )
  
imports: from functools import wraps
  from typing import TYPE_CHECKING, Any, Collection, Dict, Iterable, Iterator, List, NewType, Optional, Union
  from neptune.api.dtos import FileEntry
  from neptune.attributes import File
  from neptune.attributes.atoms.artifact import Artifact
  from neptune.attributes.constants import SYSTEM_STAGE_ATTRIBUTE_PATH
  from neptune.attributes.file_set import FileSet
  from neptune.attributes.namespace import Namespace
  from neptune.attributes.series import FileSeries
  from neptune.attributes.series.float_series import FloatSeries
  from neptune.attributes.series.string_series import StringSeries
  from neptune.attributes.sets.string_set import StringSet
  from neptune.common.warnings import warn_about_unsupported_type
  from neptune.exceptions import MissingFieldException, NeptuneCannotChangeStageManually, NeptuneUserApiInputException
  from neptune.internal.artifacts.types import ArtifactFileData
  from neptune.internal.types.stringify_value import StringifyValue
  from neptune.internal.utils import is_collection, is_dict_like, is_float, is_float_like, is_string, is_stringify_value, verify_collection_type, verify_type
  from neptune.internal.utils.paths import join_paths, parse_path
  from neptune.internal.value_to_attribute_visitor import ValueToAttributeVisitor
  from neptune.metadata_containers.abstract import SupportsNamespaces
  from neptune.types.atoms.file import File
  from neptune.types.type_casting import cast_value_for_extend
  from neptune.types.value_copy import ValueCopy
  from neptune.utils import stringify_unsupported
label_desc: Use image node_id 29 for calling the Handler obj's underlying member method code with example usage: obj.list_fileset_files(path) and returns: self