:py:mod:`dissect.target.filesystems.fat`
========================================

.. py:module:: dissect.target.filesystems.fat




Module Contents
---------------

Classes
~~~~~~~

.. autoapisummary::

   dissect.target.filesystems.fat.FatFilesystem
   dissect.target.filesystems.fat.FatDirEntry
   dissect.target.filesystems.fat.FatFilesystemEntry




.. py:class:: FatFilesystem(fh: BinaryIO, *args, **kwargs)

   Bases: :py:obj:`dissect.target.filesystem.Filesystem`


   Base class for filesystems.


   .. py:attribute:: __type__
      :value: 'fat'


      A short string identifying the type of filesystem.


   .. py:attribute:: fatfs


   .. py:attribute:: tzinfo


   .. py:method:: get(path: str) -> dissect.target.filesystem.FilesystemEntry

      Retrieve a :class:`FilesystemEntry` from the filesystem.

      :param path: The path which we want to retrieve.

      :returns: A :class:`FilesystemEntry` for the path.



.. py:class:: FatDirEntry(fs: Filesystem, path: str, name: str, entry: Any)

   Bases: :py:obj:`dissect.target.filesystem.DirEntry`


   Directory entry base class. Closely models ``os.DirEntry``.

   Filesystem implementations are encouraged to subclass this class to provide efficient
   implementations of the various methods.

   :param fs: The filesystem the entry belongs to.
   :param path: The path of the parent directory.
   :param name: The name of the entry.
   :param entry: The raw entry backing this directory entry.


   .. py:attribute:: fs
      :type:  FatFilesystem

      The filesystem the entry belongs to.


   .. py:attribute:: entry
      :type:  dissect.fat.fat.RootDirectory | dissect.fat.fat.DirectoryEntry

      The raw entry backing this directory entry.


   .. py:method:: get() -> FatFilesystemEntry

      Retrieve the :class:`FilesystemEntry` this directory entry points to.

      Subclasses should override this method to provide an efficient implementation.



   .. py:method:: stat(*, follow_symlinks: bool = True) -> dissect.target.helpers.fsutil.stat_result


.. py:class:: FatFilesystemEntry(fs: Filesystem, path: str, entry: Any)

   Bases: :py:obj:`dissect.target.filesystem.FilesystemEntry`


   Base class for filesystem entries.


   .. py:attribute:: fs
      :type:  FatFilesystem


   .. py:attribute:: entry
      :type:  dissect.fat.fat.RootDirectory | dissect.fat.fat.DirectoryEntry


   .. py:method:: get(path: str) -> dissect.target.filesystem.FilesystemEntry

      Get a filesystem entry relative from the current one.



   .. py:method:: open() -> BinaryIO

      Returns file handle (file-like object).



   .. py:method:: scandir() -> collections.abc.Iterator[dissect.target.filesystem.FilesystemEntry]

      List the directory contents of this directory. Returns a generator of filesystem entries.



   .. py:method:: is_symlink() -> bool

      Return whether this entry is a link.



   .. py:method:: is_dir(follow_symlinks: bool = True) -> bool

      Return whether this entry is a directory.



   .. py:method:: is_file(follow_symlinks: bool = True) -> bool

      Return whether this entry is a file.



   .. py:method:: stat(follow_symlinks: bool = True) -> dissect.target.helpers.fsutil.stat_result

      Return the stat information of this entry.



   .. py:method:: lstat() -> dissect.target.helpers.fsutil.stat_result

      Return the stat information of the given path, without resolving links.