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

.. py:module:: dissect.target.filesystems.itunes


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

Classes
~~~~~~~

.. autoapisummary::

   dissect.target.filesystems.itunes.ITunesFilesystem
   dissect.target.filesystems.itunes.ITunesFilesystemEntry
   dissect.target.filesystems.itunes.ITunesFilesystemDirectoryEntry
   dissect.target.filesystems.itunes.EncryptedFileStream




.. py:class:: ITunesFilesystem(backup: dissect.target.loaders.itunes.ITunesBackup, *args, **kwargs)


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

   Filesystem implementation for iTunes backups.

   .. py:attribute:: __type__
      :value: 'itunes'

      

   .. py:method:: get(path: str, relentry: Optional[dissect.target.filesystem.FilesystemEntry] = None) -> dissect.target.filesystem.FilesystemEntry

      Returns a ITunesFileEntry object corresponding to the given path.



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


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

   Virtual file backed by a file-like object.

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

      Returns file handle (file-like object).


   .. py:method:: iterdir() -> Iterator[str]

      Iterate over the contents of a directory, return them as strings.

      :returns: An iterator of directory entries as path strings.


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

      Iterate over the contents of a directory, yields :class:`FilesystemEntry`.

      :returns: An iterator of :class:`FilesystemEntry`.


   .. 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:: is_symlink() -> bool

      Return whether this entry is a link.


   .. py:method:: readlink() -> str

      Read the link if this entry is a symlink. Returns a string.


   .. py:method:: readlink_ext() -> dissect.target.filesystem.FilesystemEntry

      Read the link if this entry is a symlink. Returns a filesystem entry.


   .. 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

      Determine the stat information of this entry, **without** resolving the symlinks.

      When it detects a symlink, it will stat the information of the symlink, not the path it points to.

      :returns: The stat information of this entry.



.. py:class:: ITunesFilesystemDirectoryEntry(fs: dissect.target.filesystem.Filesystem, path: str, entry: dissect.target.loaders.itunes.FileInfo)


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

   Virtual directory implementation. Backed by a dict.

   .. 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.



.. py:class:: EncryptedFileStream(file_info: dissect.target.loaders.itunes.FileInfo)


   Bases: :py:obj:`dissect.util.stream.AlignedStream`

   Transparently decrypted AES-CBC decrypted stream.