Aspose.Words for Python

26.4.0 · active · verified Sun Apr 12

Aspose.Words for Python is a powerful document processing library that enables developers to create, modify, convert, and render documents in various popular formats (DOCX, PDF, HTML, etc.) without requiring Microsoft Office. It's built via .NET and provides comprehensive API for working with document elements. The current version is 26.4.0, and it follows a monthly release cadence.

Warnings

gotcha Aspose.Words for Python is a commercial product. Running without a valid license will result in documents being watermarked and other trial limitations (e.g., maximum document size, number of pages) being applied. Ensure you apply your license if using it in production.
Fix: Obtain a valid license from Aspose and apply it early in your application's lifecycle using `aw.License().set_license('License.lic')` or a stream.
gotcha Processing large or complex documents, especially during conversions (e.g., DOCX to PDF with many images/complex layouts), can be highly memory-intensive. Monitor memory usage in production environments.
Fix: Optimize document content where possible. For extremely large documents, consider processing them in chunks if the task allows, or ensure sufficient RAM is allocated to your application environment.
gotcha Accurate rendering of documents, particularly when converting to fixed-page formats like PDF or images, heavily depends on the availability of fonts. If required fonts are missing on the system, Aspose.Words might substitute them, leading to visual discrepancies.
Fix: Ensure all necessary fonts are installed on the server or environment where Aspose.Words is running. You can also configure Aspose.Words to use specific font folders or font sources via `aw.fonts.FontSettings`.

Install

pip install aspose-words Install latest version

Imports

aspose.words
```
import aspose.words as aw
```
The package name is 'aspose-words' but the import module is 'aspose.words'.
Document
```
from aspose.words import Document
```
Commonly imported classes like Document, DocumentBuilder are directly available from the aspose.words module.

Quickstart

This quickstart demonstrates how to create a new Word document, add text using a DocumentBuilder, and save it in both DOCX and PDF formats. Remember that without a valid license, trial limitations like watermarks will be applied.

import aspose.words as aw

# Create a new document
doc = aw.Document()
builder = aw.DocumentBuilder(doc)

# Add some text to the document
builder.writeln("Hello, Aspose.Words for Python!")
builder.writeln("This is a quick start example.")

# Save the document as DOCX
output_docx_path = "output.docx"
doc.save(output_docx_path)

# Save the document as PDF
output_pdf_path = "output.pdf"
doc.save(output_pdf_path)

print(f"Document saved to {output_docx_path} and {output_pdf_path}")

# Note: Without a license, documents saved will contain an Aspose watermark
# and other trial limitations.

view raw JSON →