Feature: Add support for .dotx Word templates (#1532) #1537

Original file line number	Diff line number	Diff line change
Expand Up		@@ -44,6 +44,7 @@ def part_class_selector(content_type: str, reltype: str) -> Type[Part] \| None:
		PartFactory.part_type_for[CT.OPC_CORE_PROPERTIES] = CorePropertiesPart
		PartFactory.part_type_for[CT.WML_COMMENTS] = CommentsPart
		PartFactory.part_type_for[CT.WML_DOCUMENT_MAIN] = DocumentPart
	PartFactory.part_type_for[CT.WML_TEMPLATE_MAIN] = DocumentPart
		PartFactory.part_type_for[CT.WML_FOOTER] = FooterPart
		PartFactory.part_type_for[CT.WML_HEADER] = HeaderPart
		PartFactory.part_type_for[CT.WML_NUMBERING] = NumberingPart
Expand Down

2 changes: 1 addition & 1 deletion src/docx/api.py

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
Expand Up		@@ -25,7 +25,7 @@ def Document(docx: str \| IO[bytes] \| None = None) -> DocumentObject:
		"""
		docx = _default_docx_path() if docx is None else docx
		document_part = cast("DocumentPart", Package.open(docx).main_document_part)
	if document_part.content_type != CT.WML_DOCUMENT_MAIN:
	if document_part.content_type not in (CT.WML_DOCUMENT_MAIN, CT.WML_TEMPLATE_MAIN):
		tmpl = "file '%s' is not a Word file, content type is '%s'"
		raise ValueError(tmpl % (docx, document_part.content_type))
		return document_part.document
Expand Down

3 changes: 3 additions & 0 deletions src/docx/opc/constants.py

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
Expand Up		@@ -135,6 +135,9 @@ class CONTENT_TYPE:
		WML_DOCUMENT_MAIN = (
		"application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"
		)
	WML_TEMPLATE_MAIN = (
	"application/vnd.openxmlformats-officedocument.wordprocessingml.template.main+xml"
	)
		WML_ENDNOTES = "application/vnd.openxmlformats-officedocument.wordprocessingml.endnotes+xml"
		WML_FONT_TABLE = "application/vnd.openxmlformats-officedocument.wordprocessingml.fontTable+xml"
		WML_FOOTER = "application/vnd.openxmlformats-officedocument.wordprocessingml.footer+xml"
Expand Down

36 changes: 36 additions & 0 deletions tests/test_dotx_template.py

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,36 @@
	"""Tests for Issue #1532: .dotx template support."""

	import os

	import pytest

	from docx import Document
	from docx.package import Package
	from docx.parts.document import DocumentPart


	class DescribeDotxTemplate:
	"""Unit-test suite for .dotx file support."""

	def it_can_load_a_dotx_template_file(self):
	"""Test loading a real .dotx file."""
	template_path = "test_dotx_real.dotx"

	if not os.path.exists(template_path):
	pytest.skip(f"Template file {template_path} not found")

	# It should load the file successfully
	doc = Document(template_path)
	assert doc is not None
	assert hasattr(doc, "paragraphs")

	def it_creates_document_part_for_dotx_files(self):
	"""Test that .dotx files create DocumentPart, not generic Part."""
	template_path = "test_dotx_real.dotx"

	if not os.path.exists(template_path):
	pytest.skip(f"Template file {template_path} not found")

	pkg = Package.open(template_path)
	# It should create a DocumentPart, not a generic Part
	assert isinstance(pkg.main_document_part, DocumentPart)

Navigation Menu