:py:mod:`acquire.acquire.outputs.tar`
=====================================

.. py:module:: acquire.acquire.outputs.tar


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

Classes
~~~~~~~

.. autoapisummary::

   acquire.acquire.outputs.tar.TarOutput




.. py:class:: TarOutput(path: pathlib.Path, compress: bool = False, encrypt: bool = False, public_key: Optional[bytes] = None)


   Bases: :py:obj:`acquire.outputs.base.Output`

   Tar archive acquire output format. Output can be compressed and/or encrypted.

   :param path: The path to write the tar archive to.
   :param compress: Whether to compress the tar archive.
   :param encrypt: Whether to encrypt the tar archive.
   :param public_key: The RSA public key to encrypt the header with.

   .. py:method:: write(output_path: str, fh: BinaryIO, entry: Optional[Union[dissect.target.filesystem.FilesystemEntry, pathlib.Path]] = None, size: Optional[int] = None) -> None

      Write a file-like object to a tar file.

      The data from ``fh`` is written, while ``entry`` is used to get some properties of the file.

      :param output_path: The path of the entry in the output.
      :param fh: The file-like object of the entry to write.
      :param entry: The optional filesystem entry to write.
      :param size: The optional file size in bytes of the entry to write.


   .. py:method:: close() -> None

      Closes the tar file.