spire-doc

library14.6.2pypypi✓ verified 88d ago

Spire.Doc for Python is a standalone Word Python API for creating, reading, manipulating, and converting Word documents (DOC, DOCX, RTF, etc.) without Microsoft Office. Version 14.4.2 is current; major version bumps occur roughly every 3-6 months, often introducing breaking changes in API paths.

serialization data aws

pip install spire.doc

package ↗homepage ↗

INSTALL

IMPORT

SIG · SPIRE-DOC

spire-doc

serializationpythonv14.6.2

Install

3.2s avg

Import

546ms

Disk

155MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v14.6.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.2s · import 0.546s · 157MB

155MB installed

● package 155MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Document

✓ from spire.doc import Document

✗ from spire.doc import SpireDoc

Old import paths from earlier versions (v3.x) used different class names.

FileFormat

✓ from spire.doc import FileFormat

✗ from spire.doc.common import FileFormat

In v12+, constants moved; direct import from spire.doc is required.

Creates a simple Word document with one paragraph and saves as DOCX. No license file required for free tier (limited to sections/pages).

from spire.doc import Document, FileFormat doc = Document() section = doc.AddSection() paragraph = section.AddParagraph() paragraph.AppendText("Hello, Spire.Doc!") doc.SaveToFile("output.docx", FileFormat.Docx) doc.Close()

Debug

Known issues

breakingFrom v12.0 onward, import paths changed significantly. Old patterns like `from spire.doc import *` or `from spire.doc.common import *` are deprecated.

fix

Use explicit imports: `from spire.doc import Document, FileFormat, TextAlignment, etc.`

affects: >=12.0

deprecatedThe methods `Document.SaveToFile()` with `FileFormat.Docx2010` and similar version-specific enums are deprecated in favor of generic `FileFormat.Docx`.

fix

Replace with `FileFormat.Docx` or `FileFormat.Doc`.

affects: >=13.0

gotchaThe free version has a page/section limit (typically 3 pages). Exceeding causes silent truncation or exceptions.

fix

Check with `doc.PageCount` in development or purchase a license to remove limitations.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'spire.doc'

The package is installed as `spire.doc` but import is case-sensitive.

fix

Install using `pip install spire.doc`. Ensure no typos.

AttributeError: module 'spire.doc' has no attribute 'Document'

Using old import pattern or missing correct import path.

fix

Use `from spire.doc import Document` (not `from spire.doc import SpireDoc` or `import spire.doc`).

FileFormat' object has no attribute 'Docx2010'

Version-specific file format enums removed in v13+.

fix

Replace with `FileFormat.Docx` (without version number).

Upgrade

Version history

14.6.2latest on PyPI · released Jun 18, 2026

Audit

Dependencies

pythonnetoptionalRequired for .NET interoperability on Windows; macOS/Linux may need alternative configuration.

Agent activity

57 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/spire-doc/ ↗

homepagehttps://www.e-iceblue.com ↗