Files
Django_TasksApp/tests/test_docs_audit.py
T

50 lines
2.3 KiB
Python

import importlib.util
import json
import tempfile
import unittest
from datetime import datetime, timezone
from pathlib import Path
from unittest.mock import patch
SCRIPT = Path(__file__).resolve().parents[1] / 'scripts' / 'docs_audit.py'
spec = importlib.util.spec_from_file_location('docs_audit', SCRIPT)
audit = importlib.util.module_from_spec(spec)
spec.loader.exec_module(audit)
class AuditPreflightTests(unittest.TestCase):
def test_missing_state_and_force_never_claim_semantic_review(self):
with tempfile.TemporaryDirectory() as directory, patch.object(audit, 'DOCS', Path(directory)), \
patch.object(audit, 'STATE', Path(directory) / 'missing.json'), patch.object(audit, 'git', return_value=None):
result = audit.preflight(force=True, now=datetime(2026, 11, 4, tzinfo=timezone.utc))
self.assertTrue(result['due'])
self.assertFalse(result['semantic_review_performed'])
self.assertIsNone(result['changed_tracked_source_files'])
def test_due_boundary_and_invalid_commit(self):
with tempfile.TemporaryDirectory() as directory:
state = Path(directory) / 'state.json'
state.write_text(json.dumps({'last_successful_audit': '2026-10-21T12:00:00Z',
'last_audited_commit': 'bad-commit'}))
with patch.object(audit, 'DOCS', Path(directory)), patch.object(audit, 'STATE', state), \
patch.object(audit, 'git', side_effect=lambda *args: 'head' if args == ('rev-parse', 'HEAD') else None):
result = audit.preflight(now=datetime(2026, 11, 4, 12, tzinfo=timezone.utc))
self.assertTrue(result['due'])
self.assertFalse(result['stored_commit_valid'])
self.assertTrue(any('valid local commit' in warning for warning in result['warnings']))
def test_local_links(self):
with tempfile.TemporaryDirectory() as directory:
root = Path(directory)
docs = root / 'docs'
docs.mkdir()
(docs / 'a.md').write_text('[works](b.md) [broken](missing.md) [external](https://example.com)')
(docs / 'b.md').write_text('ok')
with patch.object(audit, 'ROOT', root), patch.object(audit, 'DOCS', docs):
self.assertEqual(audit.links(), ['docs/a.md -> missing.md'])
if __name__ == '__main__':
unittest.main()