feat: add comments support

HISTORY.rst

@@ -3,13 +3,21 @@
 Release History
 ---------------
 
+1.2.0 (2025-06-16)
+++++++++++++++++++
+
+- Add support for comments
+- Drop support for Python 3.8, add testing for Python 3.13
+
+
 1.1.2 (2024-05-01)
 ++++++++++++++++++
 
 - Fix #1383 Revert lxml<=4.9.2 pin that breaks Python 3.12 install
 - Fix #1385 Support use of Part._rels by python-docx-template
 - Add support and testing for Python 3.12
 
+
 1.1.1 (2024-04-29)
 ++++++++++++++++++
 

Makefile

@@ -1,7 +1,6 @@
 BEHAVE = behave
 MAKE   = make
 PYTHON = python
-BUILD  = $(PYTHON) -m build
 TWINE  = $(PYTHON) -m twine
 
 .PHONY: accept build clean cleandocs coverage docs install opendocs sdist test
@@ -24,10 +23,10 @@ help:
 	@echo "  wheel        generate a binary distribution into dist/"
 
 accept:
-	$(BEHAVE) --stop
+	uv run $(BEHAVE) --stop
 
 build:
-	$(BUILD)
+	uv build
 
 clean:
 	# find . -type f -name \*.pyc -exec rm {} \;
@@ -38,7 +37,7 @@ cleandocs:
 	$(MAKE) -C docs clean
 
 coverage:
-	py.test --cov-report term-missing --cov=docx tests/
+	uv run pytest --cov-report term-missing --cov=docx tests/
 
 docs:
 	$(MAKE) -C docs html
@@ -50,16 +49,16 @@ opendocs:
 	open docs/.build/html/index.html
 
 sdist:
-	$(BUILD) --sdist .
+	uv build --sdist
 
 test:
-	pytest -x
+	uv run pytest -x
 
 test-upload: sdist wheel
-	$(TWINE) upload --repository testpypi dist/*
+	uv run $(TWINE) upload --repository testpypi dist/*
 
 upload: clean sdist wheel
-	$(TWINE) upload dist/*
+	uv run $(TWINE) upload dist/*
 
 wheel:
-	$(BUILD) --wheel .
+	uv build --wheel

docs/api/comments.rst

@@ -0,0 +1,27 @@
+
+.. _comments_api:
+
+Comment-related objects
+=======================
+
+.. currentmodule:: docx.comments
+
+
+|Comments| objects
+------------------
+
+.. autoclass:: Comments()
+   :members:
+   :inherited-members:
+   :exclude-members:
+       part
+
+
+|Comment| objects
+------------------
+
+.. autoclass:: Comment()
+   :members:
+   :inherited-members:
+   :exclude-members:
+       part

docs/conf.py

@@ -91,6 +91,10 @@
 
 .. |_Columns| replace:: :class:`._Columns`
 
+.. |Comment| replace:: :class:`.Comment`
+
+.. |Comments| replace:: :class:`.Comments`
+
 .. |CoreProperties| replace:: :class:`.CoreProperties`
 
 .. |datetime| replace:: :class:`.datetime.datetime`