Bump to 2.0.2: Python 3.8 compatibility and multi-version testing

- Lower requires-python to >=3.8; add typing_extensions dependency
- Add from __future__ import annotations to doc.py
- Switch typing.Self to typing_extensions.Self in doc.py
- Expand CI matrix to 3.8, 3.10, 3.12, 3.13; split lint and test jobs
- Add tox.ini and make tox target for local multi-version testing

Author: rembish

.github/workflows/ci.yml

@@ -7,19 +7,15 @@ on:
     branches: [master]
 
 jobs:
-  test:
+  lint:
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.12", "3.13"]
-
     steps:
       - uses: actions/checkout@v6
 
-      - name: Set up Python ${{ matrix.python-version }}
+      - name: Set up Python 3.12
         uses: actions/setup-python@v6
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version: "3.12"
 
       - name: Install cfb (not yet on PyPI)
         run: pip install git+https://github.com/rembish/cfb.git
@@ -36,10 +32,31 @@ jobs:
       - name: Type check (mypy)
         run: mypy miette
 
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.10", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install cfb (not yet on PyPI)
+        run: pip install git+https://github.com/rembish/cfb.git
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
       - name: Run tests
         run: pytest --cov=miette --cov-report=xml
 
       - name: Upload coverage
+        if: matrix.python-version == '3.12'
         uses: codecov/codecov-action@v5
         with:
           files: coverage.xml

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2.0.2 (2026-02-18)
+
+- Lower `requires-python` to `>=3.8`; add `typing_extensions` runtime dependency
+- Add `from __future__ import annotations` to `doc.py`
+- Switch `from typing import Self` to `from typing_extensions import Self` in `doc.py`
+- Expand CI matrix to Python 3.8, 3.10, 3.12, 3.13; split lint and test jobs
+- Add `tox.ini` and `make tox` target for local multi-version testing
+
 ## 2.0.1 (2026-02-18)
 
 - Modernise test suite: autouse `suppress_warnings` with `catch_warnings()` + yield, `reader` fixture with proper teardown via context manager

Makefile

@@ -2,7 +2,7 @@ VENV   := .venv
 PYTHON := $(VENV)/bin/python
 PIP    := $(VENV)/bin/pip
 
-.PHONY: help install lint format typecheck test pre-commit clean
+.PHONY: help install lint format typecheck test tox pre-commit clean
 
 help:
 	@echo "Usage: make <target>"
@@ -12,6 +12,7 @@ help:
 	@echo "  format      run black"
 	@echo "  typecheck   run mypy"
 	@echo "  test        run pytest with coverage"
+	@echo "  tox         run tests across py38, py310, py312"
 	@echo "  pre-commit  install pre-commit hooks"
 	@echo "  clean       remove build artifacts and caches"
 
@@ -37,6 +38,9 @@ typecheck: $(VENV)/bin/activate
 test: $(VENV)/bin/activate
 	$(VENV)/bin/pytest --cov=miette --cov-report=term-missing
 
+tox: $(VENV)/bin/activate
+	$(VENV)/bin/tox
+
 pre-commit: $(VENV)/bin/activate
 	$(VENV)/bin/pre-commit install
 

miette/doc.py

@@ -1,12 +1,14 @@
 """Microsoft Word Document (.doc) reader — extracts plain text."""
 
+from __future__ import annotations
+
 from functools import cached_property
 from pathlib import Path
 from struct import unpack
-from typing import Self
 
 from cfb import CfbIO
 from cfb.directory.entry import SEEK_CUR, SEEK_END, SEEK_SET, Entry
+from typing_extensions import Self
 
 from miette.exceptions import MietteFormatError
 

pyproject.toml

@@ -4,24 +4,28 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "miette"
-version = "2.0.1"
+version = "2.0.2"
 description = "Miette is a light-weight Microsoft Office documents reader"
 readme = "README.md"
 license = { text = "BSD-2-Clause" }
 authors = [{ name = "Alex Rembish", email = "alex@rembish.org" }]
-requires-python = ">=3.12"
+requires-python = ">=3.8"
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: BSD License",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Topic :: Software Development :: Libraries",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Text Processing",
 ]
-dependencies = ["cfb"]
+dependencies = ["cfb", "typing_extensions"]
 
 [project.urls]
 Homepage = "https://github.com/rembish/Miette"
@@ -34,6 +38,7 @@ dev = [
     "ruff>=0.4",
     "mypy>=1.10",
     "pre-commit>=3",
+    "tox>=4",
 ]
 
 [tool.setuptools.packages.find]
@@ -45,17 +50,17 @@ include = ["miette*"]
 
 [tool.black]
 line-length = 88
-target-version = ["py312"]
+target-version = ["py38"]
 
 [tool.ruff]
 line-length = 88
-target-version = "py312"
+target-version = "py38"
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "N", "UP", "B", "C4", "SIM", "RUF"]
 
 [tool.mypy]
-python_version = "3.12"
+python_version = "3.8"
 strict = true
 ignore_missing_imports = true
 

tox.ini

@@ -0,0 +1,9 @@
+[tox]
+envlist = py38, py310, py312
+isolated_build = true
+
+[testenv]
+# cfb is not on PyPI yet — install from the sibling repo checkout
+deps = -e {toxinidir}/../cfb
+extras = dev
+commands = pytest {posargs}