:py:mod:`dissect.target.tools.build_magic`
==========================================

.. py:module:: dissect.target.tools.build_magic




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


Functions
~~~~~~~~~

.. autoapisummary::
   :nosignatures:

   dissect.target.tools.build_magic.parse_freedesktop_xml
   dissect.target.tools.build_magic.convert_value
   dissect.target.tools.build_magic.main



Attributes
~~~~~~~~~~

.. autoapisummary::

   dissect.target.tools.build_magic.TEMPLATE
   dissect.target.tools.build_magic.IGNORED_TYPES
   dissect.target.tools.build_magic.IGNORED_SUB_TYPES


.. py:data:: TEMPLATE
   :value: Multiline-String

   .. raw:: html

      <details><summary>Show Value</summary>

   .. code-block:: python

      """# This file is generated by target-build-magic
      # Do not edit manually, for overrides see 'overrides.py'
      #
      # Generated on:         {timestamp}
      # Source SHA1 hash:     {hash}
      # Number of types:      {count}
      # References:           http://www.freedesktop.org/standards/shared-mime-info
      #                       https://gitlab.freedesktop.org/xdg/shared-mime-info/-/blob/master/data/freedesktop.org.xml.in
      
      TYPES = {types}
      """

   .. raw:: html

      </details>



.. py:data:: IGNORED_TYPES
   :value: ('application/x-iso9660-appimage', 'application/vnd.appimage', 'application/x-core',...


.. py:data:: IGNORED_SUB_TYPES
   :value: ('application/zip', 'application/xml', 'application/json', 'application/annodex')


.. py:function:: parse_freedesktop_xml(path: pathlib.Path) -> str

   Attempt to parse a FreeDesktop shared-mime-info document.

   Does not yet parse nested magic values.


.. py:function:: convert_value(type: str, value: str) -> bytes

   Convert a value to bytes.


.. py:function:: main() -> int