Universal Parser
================

.. note::
    It's required to install ``reader``, ``pdf`` and ``codes`` from :ref:`Optional dependencies` section.

The first step for using an Universal Parser, to automatically extract information from the pdf-files, is to create a new class that inherits from a :class:`~.UniversalParser`.

The next step, in a case that the parser is not working properly or you would like it to work differently, you can implement an Extension, see :class:`~.UniversalParserExtension`.
The extensions are then provided in the constructor of your Universal Parser, they are automatically selected then based on the :attr:`~.UniversalParser.context` value.

At the end, you just need to implement :meth:`~.UniversalParser.parse_body` method, that contains overall parsing logic.

.. automodule:: aiviro.modules.universal_parser
    :members: UniversalParser, UniversalParserExtension, DocumentType, DocItem, BaseSplitCondition, CSVWriter, QRData