Docxray

A sophisticated DOCX analysis library — fork of python-docx with advanced parsing, styling intelligence, and deep ECMA-376 compliance.

Built for reading, inspecting, and transforming .docx (OOXML Transitional) documents with precision.

✨ Key Features

🧠 Smart property resolution – inherits formatting from style hierarchies, following ECMA-376 rules (not just raw XML values)
🖼️ Rich image support – works with Pillow or Wand (ImageMagick); handles modern formats plus legacy WMF/EMF
🔄 HTML transformation – proxy objects (Paragraph, Table, etc.) include methods to convert content to HTML with rendering options
✅ XSD soft validation – validates simple types against the official schema
🔢 Intelligent list handling – numeral module correctly restores list-item text for most common cases

🚀 Quick Start

from docxray import Document

doc = Document("path/to/your/document.docx")

# Iterate through all inner content
for item in doc.iter_inner_content():
    # Process paragraphs, tables, runs, etc.
    pass

📦 Installation

pip install docxray

Additional Dependencies

ImageMagick is required for full image processing support when using the Wand library. Without ImageMagick, Docxray will fall back to using Pillow for image handling.

For Wand (recommended for advanced formats like WMF/EMF):
- macOS: brew install imagemagick
- Ubuntu/Debian: sudo apt-get install imagemagick libmagickwand-dev
- Windows: Download and install from ImageMagick official site (ensure the development headers are included)

Note: If both Wand and ImageMagick are available, Docxray will use them for superior format support. If ImageMagick is missing, the library automatically falls back to Pillow for basic image operations.

📖 Documentation

Docxray is designed for read‑only document analysis. It provides:

Full access to document structure (paragraphs, runs, tables, images)
Styling attributes resolved through the complete OOXML style inheritance chain
Convenient proxies for manipulating content before export (e.g., to HTML)
Validation utilities to check document conformance

🧪 Example: Inspecting Run Properties

for item in doc.iter_inner_content():
    if isinstance(item, Paragraph):
        for p_item in item.iter_inner_content():
            if isinstance(p_item, Run) and p_item.italic:
                print(f"Italic text: {p_item.raw_text}")

📄 License

MIT — free for personal and commercial use.

🙏 Acknowledgements

Built as a fork of the excellent python-docx project, extended for deeper ECMA-376 compliance and analysis capabilities.

Metadata

Release files for docxray 0.0.0a27

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for docxray 0.0.0a27
File	Size	Uploaded
docxray-0.0.0a27.tar.gz	142.3 kB	Oct 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for docxray 0.0.0a27
File	Interpreter	ABI	Platform	Reset
docxray-0.0.0a27-py3-none-any.whl 180.1 kB Oct 13, 2026	Python 3	none	any	Details

Total release size: 322.3 kB

Release files / docxray-0.0.0a27.tar.gz

Download URL	docxray-0.0.0a27.tar.gz
Size	142.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`5123662f8350136db21f833d30df18f4f37e20c14ad0f6e24a73804f4e286229`
BLAKE2b-256 checksum How to use checksums	`5f369b188c19568ab7e986701c17a17a0572c7287fe6db12223c90907b9206bf`
Upload date	Oct 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.7.10`

Release files / docxray-0.0.0a27-py3-none-any.whl

Download URL	docxray-0.0.0a27-py3-none-any.whl
Size	180.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3f436eafdd8060875e926654236bebf0936f022b2b8e9062cec96334513743e8`
BLAKE2b-256 checksum How to use checksums	`07e46c1c4e4e14b455c4bde24cc8cbde037e907e5233b7ced012613d8e7b46fd`
Upload date	Oct 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.7.10`