Add unit tests

Author: bigbag

.coverage

@@ -0,0 +1,50 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Run linting
+        run: |
+          uv run black --check src/
+          uv run flake8 src/
+          uv run isort --check-only src/
+
+      - name: Run tests with coverage
+        run: |
+          uv run pytest tests/ \
+            --cov=src \
+            --cov-report=xml \
+            --cov-report=term-missing \
+            -v
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/test.yml

@@ -18,7 +18,7 @@ PYTHON_VERSION=3.12
 PYTHONPATH := $(or ${PYTHONPATH},.)
 TEST_DIR = tests/
 
-LINT_SOURCES_PATHS = src/
+LINT_SOURCES_PATHS = src/ tests/
 
 export PYTHONPATH
 
@@ -169,10 +169,10 @@ clean:  ## Clear temporary information
 ####################
 
 .PHONY: test
-## Run all tests
+## Run all tests with coverage
 test:
 	PYTHONPATH=$(PYTHONPATH):src \
-	$(PYTHON) -m pytest --disable-warnings $(TEST_DIR)
+	$(PYTHON) -m pytest --cov=src --cov-report=term-missing --cov-report=html $(TEST_DIR)
 
 
 #################################################################################

Makefile

@@ -129,6 +129,38 @@ src/
 EPUB → epub_parser.py → pagination.py → text_renderer.py → xtc_format.py → XTC/XTCH
 ```
 
+## Testing
+
+Run tests with pytest:
+
+```bash
+# Run all tests with coverage
+make test
+
+# Run specific test file
+PYTHONPATH=.:src pytest tests/test_config.py -v
+
+# Run tests matching pattern
+PYTHONPATH=.:src pytest -k "test_sanitize" -v
+```
+
+The test suite covers:
+- **config.py**: Constants, heading size calculations
+- **epub_utils.py**: OPF finding, namespace handling
+- **optimizer.py**: CSS sanitization, manifest operations, font removal, image processing, EPUB rebuild
+- **xtc_format.py**: Binary encoding, quantization, container writing
+- **epub_parser.py**: HTML parsing, metadata extraction, TOC parsing
+- **text_renderer.py**: Font handling, text wrapping
+- **pagination.py**: Page layout, chapter detection
+- **converter.py**: End-to-end conversion, CLI argument handling, directory processing
+
+### Test Fixtures
+
+Test fixtures in `tests/fixtures/` include:
+- Minimal valid EPUB structure (container.xml, content.opf, chapter1.xhtml)
+- NCX and NAV navigation files
+- Generated test images (grayscale, color)
+
 ## Documentation
 
 - [XTC/XTG/XTH/XTCH Format Specification](docs/xtc-format-spec.md) ([source](https://gist.github.com/CrazyCoder/b125f26d6987c0620058249f59f1327d))

README.md

@@ -21,7 +21,7 @@ omit = *tests*
 
 [tool:pytest]
 python_files = tests.py test_*.py *_tests.py
-addopts = --cov-report=term-missing --cov-config=setup.cfg --cov=llmdoc
+addopts = --cov-report=term-missing --cov-config=setup.cfg --cov=src
 mock_traceback_monkeypatch = false
 
 [mypy]

setup.cfg

@@ -0,0 +1 @@
+# Tests package