textxtract 0.1.0

A robust, extensible Python package for synchronous and asynchronous text extraction from PDF, DOCX, DOC, TXT, ZIP, MD, RTF, HTML, and more.

TextXtract

A robust, extensible Python package for synchronous and asynchronous text extraction from PDF, DOCX, DOC, TXT, ZIP, Markdown, RTF, HTML, CSV, JSON, XML, and more.

Features

• Synchronous and asynchronous extraction APIs
• Modular file type handlers (PDF, DOCX, DOC, TXT, ZIP, Markdown, RTF, HTML, CSV, JSON, XML, and more.)
• Abstract base classes for extensibility
• Custom exception handling and logging
• Configurable encoding, logging, and timeouts
• Easy to add new file type handlers
• Comprehensive unit tests with pytest

Installation

pip install .

Usage Example

from textxtract.sync.extractor import SyncTextExtractor
from textxtract.aio.extractor import AsyncTextExtractor

# Synchronous extraction
extractor = SyncTextExtractor()
text = extractor.extract(file_bytes, filename)

# Asynchronous extraction
import asyncio
async_extractor = AsyncTextExtractor()
text = asyncio.run(async_extractor.extract_async(file_bytes, filename))

API Reference

See ARCHITECTURE_PLAN.md for detailed architecture and module layout.

Running Tests

pytest

Contributing

1. Fork the repository.
2. Create a new branch.
3. Add your feature or fix.
4. Write tests.
5. Submit a pull request.

License

MIT License