A basic document parsing and loading utility - Parsers

Overview

The docp-* project suite is designed as a comprehensive (doc)ument (p)arsing library. Built in CPython, it consolidates the capabilities of various lower-level libraries, offering a unified solution for parsing binary document structures.

The suite is extended by several sister projects, each providing unique functionality:

The Toolset (Parsers)

As of this release, parsers for the following binary document types are supported:

• PDF
• MS PowerPoint (PPTX)
• (more coming soon)

Quickstart

Installation

To install docp-parsers, first activate your target virtual environment, then use pip:

pip install docp-parsers

For older releases, visit PyPI or the GitHub Releases page.

Example Usage

For convenience, here are a couple examples for how to parse the supported document types.

Extract text from a PDF file:

    >>> from docp_parsers import PDFParser

    >>> pdf = PDFParser(path='/path/to/myfile.pdf')
    >>> pdf.extract_text()

    # Access the content of page 1.
    >>> pg1 = pdf.pages[1].content

Extract text from a PowerPoint presentation:

    >>> from docp_parsers import PPTXParser

    >>> pptx = PPTXParser(path='/path/to/myfile.pptx')
    >>> pptx.extract_text()

    # Access the text on slide 1.
    >>> pg1 = pptx.slides[1].content

Using the Library

The documentation suite provides detailed explanations and usage examples for each importable module. For in-depth documentation, code examples, and source links, refer to the Library API page.

A search field is available in the left navigation bar to help you quickly locate specific modules or methods.

Troubleshooting

No troubleshooting guidance is available at this time.

For questions not covered here, or to report bugs, issues, or suggestions, please open an issue on GitHub.