Metadata-Version: 2.4
Name: groupdocs-parser-net
Version: 0.0.0
Summary: Document parsing and data extraction library that lets you extract text, images, attachments, barcodes and structured content from popular formats such as PDF, Word, Excel, PowerPoint, emails, archives, images and more.
Home-page: https://products.groupdocs.com/parser/python-net/
Author: GroupDocs
License: Other/Proprietary License
Keywords: parse,parser,extract,text,images,attachments,barcodes,metadata,pdf,docx,xlsx,pptx,html,email,archive
Platform: win32
Platform: win_amd64
Platform: linux
Platform: macos_x86_64
Platform: macos_arm64
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Unix
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Utilities
Classifier: Topic :: Office/Business
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: platform
Dynamic: requires-python
Dynamic: summary

[![GroupDocs.Parser for Python via .NET Banner](https://raw.githubusercontent.com/groupdocs/groupdocs.github.io/master/img/banners/groupdocs-parser-python-net-banner.png)](https://purchase.groupdocs.com/temp-license/114765)

[Product Home](https://products.groupdocs.com/parser/python-net/) | [Docs](https://docs.groupdocs.com/parser/python-net/) | [Live Demos](https://products.groupdocs.app/parser/family) | [API Reference](https://reference.groupdocs.com/parser/) | [Blog](https://blog.groupdocs.com/category/parser/) | [Search](https://search.groupdocs.com/) | [Free Support Forum](https://forum.groupdocs.com/c/parser) | [Temporary License](https://purchase.groupdocs.com/temp-license/114765)

## Table of Contents

- [About](#about)
- [Quick Example](#quick-example-extract-text-from-a-pdf)
- [Key Features](#key-features)
- [Supported Document Formats](#supported-document-formats)
- [Feature Support Matrix](#feature-support-matrix)
- [Getting Started](#getting-started)
  - [Prerequisites](#prerequisites)
  - [Installation](#installation)
  - [Use Cases](#use-cases)
- [Licensing](#licensing)
- [Support](#support)
- [Additional Resources](#additional-resources)

## About

GroupDocs.Parser for Python via .NET is a document parsing and data extraction library that lets you extract text, images, attachments, barcodes and structured content from popular formats such as PDF, Word, Excel, PowerPoint, emails, archives, images and more.

## Quick Example: Extract Text from a PDF

Use a few lines of Python code to extract text from PDF and Office documents:

```py
from groupdocs.parser import Parser

# Create a Parser instance for your document
with Parser("sample.pdf") as parser:
    # Extract text from the document
    text = parser.GetText()
    
    # Print all extracted text to the console
    print(text)
```

## Key Features

**GroupDocs.Parser for Python via .NET** provides a single, unified API for advanced document parsing and data extraction:

- **Rich text extraction & search** – Extract plain or formatted text from PDFs, Office documents, emails, e‑books, archives and more, with page‑level access and advanced search options (case‑sensitive, whole‑word, regex).
- **Structured content & templates** – Parse document structure (headings, paragraphs, tables, text areas) and use templates to pull out strongly‑typed fields from invoices, receipts and other business documents.
- **Images, attachments & barcodes** – Extract embedded images, file attachments and barcodes from supported document and image formats.
- **OCR for scanned documents** – Use OCR to read text from scanned PDFs and raster images, optionally combining it with spell‑checking for better recognition quality.
- **Wide format & platform support** – Work with dozens of document, image and archive formats on Windows, Linux and macOS using the .NET‑powered parsing engine from your Python code.

---

## Supported Document Formats

**GroupDocs.Parser for Python via .NET** supports a wide range of document families including:

- **Word processing** – DOC, DOCX, RTF, TXT, ODT and others  
- **PDF & markup** – PDF, HTML/MHTML, Markdown, XML  
- **Spreadsheets** – XLS, XLSX, ODS, CSV and related formats  
- **Presentations** – PPT, PPTX, ODP and similar formats  
- **Email & notes** – PST, OST, EML, MSG, ONE  
- **eBooks & web content** – EPUB, MOBI, AZW3, CHM, FB2  
- **Images** – JPEG, PNG, TIFF, GIF, BMP, SVG and more  
- **Archives & containers** – ZIP, RAR, 7Z, TAR, GZ, BZ2  

See the [complete list of supported document formats](https://docs.groupdocs.com/parser/python-net/supported-document-formats/).


## Feature Support Matrix

**GroupDocs.Parser for Python via .NET** supports different features across document formats. Here's a quick overview:

| Feature | PDF | Word | Excel | PowerPoint | Email | eBooks |
|---------|:---:|:---:|:---:|:---:|:---:|:---:|
| Text Extraction | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Table Extraction | ✅ | ✅ | ✅ | ✅ | ❌ | ⚠️ |
| Image Extraction | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Hyperlink Extraction | ✅ | ✅ | ❌ | ❌ | ❌ | ⚠️ |
| Barcode Scanning | ✅ | ✅ | ✅ | ✅ | ❌ | ⚠️ |
| Metadata Extraction | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Table of Contents | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ |
| Template Parsing | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |

✅ Fully Supported | ⚠️ Limited Support | ❌ Not Supported

---

## Getting Started

### Prerequisites

- Python 3.5+
- Windows, Linux, or macOS

Learn more about [system requirements](https://docs.groupdocs.com/parser/python-net/system-requirements/).

### Installation

You can install **GroupDocs.Parser for Python via .NET** from **PyPI** or download it from the official website.

**Install from PyPI**

```bash
pip install groupdocs-parser-net
```

**Upgrade to the latest version**

```bash
pip install --upgrade groupdocs-parser-net
```

**Download from the official website**

To download the GroupDocs.Parser package for your operating system, please visit the official [GroupDocs Releases website](https://releases.groupdocs.com/parser/python-net/) and choose the appropriate package based on your system's architecture.

Learn more about [installation](https://docs.groupdocs.com/parser/python-net/installation/).

---

### Use Cases

Beyond basic text extraction, here are the most common use cases for quick text, image and metadata extraction.

> **📁 Code Examples**: For complete, runnable examples with sample files, check out the [GroupDocs.Parser for Python via .NET - Code Examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Python-via-.NET/) repository.
> See [how to run code examples](https://docs.groupdocs.com/parser/python-net/how-to-run-examples/) for more details.

#### Search Text in a Document

This example shows how to search for a specific phrase in a PDF document and print where it was found.

```py
from groupdocs.parser import Parser

# Load the PDF document
with Parser("sample.pdf") as parser:
    # Search for a phrase in the document
    for area in parser.Search("Total Amount"):
        # Print page index and rectangle where phrase was found
        print(f"Page {area.PageIndex}, Rectangle: {area.Rectangle}")
```

#### Extract Document Images

This example shows how to iterate over images embedded in a Word document and save them to disk.

```py
from groupdocs.parser import Parser

# Load the Word document
with Parser("sample.docx") as parser:
    # Get images from the document
    images = parser.GetImages()

    # Save each image to a PNG file
    index = 1
    for image in images:
        image.Save(f"image_{index}.png")
        index += 1
```

#### Extract Document Metadata

This example shows how to read basic metadata such as author, creation date and other properties from a document.

```py
from groupdocs.parser import Parser

# Load the document
with Parser("sample.pdf") as parser:
    # Get document metadata
    metadata = parser.GetMetadata()

    # Print all metadata items
    for item in metadata:
        print(f"{item.Name}: {item.Value}")
```
---

## Licensing

For testing without trial limitations, you can request a 30-day Temporary License:

* Visit the [Get a Temporary License](https://purchase.groupdocs.com/temp-license/114765/) page
* Follow the instructions to request your temporary license
* Copy the license file and apply it using the code example

```python
import os
from groupdocs.parser import License

# Get absolute path to license file
license_path = os.path.abspath("./GroupDocs.Parser.lic")

# Instantiate License and set the license
license = License()
license.set_license(license_path)
```

This product is licensed under the GroupDocs End User License Agreement (EULA). For pricing information, visit the [GroupDocs.Parser for Python via .NET pricing page](https://purchase.groupdocs.com/pricing/parser/python-net/).

---

## Support

GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/), [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) and [Paid Consulting](https://consulting.groupdocs.com/).

### Free Support Forum

The [GroupDocs Free Support Forum](https://forum.groupdocs.com/) is available to all users and provides:
- Direct access to the GroupDocs development team
- Community-driven support and knowledge sharing
- No time limitations on support requests
- Access to historical solutions and discussions

### Paid Support Helpdesk

The [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) offers:
- Higher priority response times
- Dedicated support team
- Extended support hours
- Priority issue resolution

### Paid Consulting

We can work together with you on your project and develop a part or complete application. If you need new features in the existing GroupDocs product or to create API for new file formats, send us a request at [consulting.groupdocs.com/contact](https://consulting.groupdocs.com/contact/).

---

## Additional Resources

- **[Documentation](https://docs.groupdocs.com/parser/python-net/)** – Complete API documentation and guides
- **[API Reference](https://reference.groupdocs.com/parser/)** – Detailed API reference documentation
- **[Live Demos](https://products.groupdocs.app/parser/family)** – Interactive online demos
- **[Code Examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Python-via-.NET/)** – Working code examples with sample files
- **[Blog](https://blog.groupdocs.com/category/parser/)** – Latest updates and tutorials
