50 lines
2.3 KiB
Python
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()
|