import copy import json from pathlib import Path import subprocess import sys import tempfile import unittest from unittest.mock import patch import sync_history as sync class ComponentHistoryTests(unittest.TestCase): def history(self): return {'schema': 1, 'component': 'manager', 'repository': 'Corfirean/coa-server-manager', 'consumedFragments': [], 'releases': [{'version': '0.6.22', 'tag': 'v0.6.22', 'date': '2026-10-19', 'url': 'https://example.test/release', 'notes': ['Existing client files are preserved']}]} def test_manager_history_cannot_be_used_as_server_history(self): history = self.history() history['component'] = 'server' with self.assertRaises(ValueError): sync.validate_history(history) def test_duplicate_release_and_wrong_tag_are_rejected(self): history = self.history() history['releases'].append(copy.deepcopy(history['releases'][0])) with self.assertRaises(ValueError): sync.validate_history(history) history['releases'].pop() history['releases'][0]['tag'] = 'server-0.6.22' with self.assertRaises(ValueError): sync.validate_history(history) def test_unpublished_and_prerelease_tags_never_enter_history(self): release = {'tag_name': 'v0.7.0', 'draft': True, 'prerelease': False} self.assertFalse(sync.eligible(release, 'manager')) release.update(draft=False, prerelease=True) self.assertFalse(sync.eligible(release, 'manager')) release.update(prerelease=False) self.assertTrue(sync.eligible(release, 'manager')) self.assertFalse(sync.eligible(release, 'server')) self.assertFalse(sync.eligible(dict(release, tag_name='stable'), 'server')) def test_fragment_classification_preserves_source_boundaries(self): text = '---\narea: manager\ntitle: Updates recover safely\n---\nYour files are preserved.' self.assertIsNone(sync.fragment_note(text, sync.SERVER_AREAS)) self.assertIn('Updates recover safely', sync.fragment_note(text, sync.MANAGER_AREAS)) def test_remote_collection_uses_frozen_sha_and_reads_only_new_fragments(self): with patch.object(sync, 'api', return_value=[{'name': '20261019-a.md', 'sha': 'b' * 40}]) as api: notes, ids = sync.remote_fragments('owner/repo', 'a' * 40, {'owner/repo:20261019-a.md'}, sync.SERVER_AREAS) self.assertEqual(notes, []) self.assertEqual(len(ids), 1) api.assert_called_once_with('repos/owner/repo/contents/changelog.d?ref=' + 'a' * 40) with self.assertRaises(ValueError): sync.remote_fragments('owner/repo', 'main', set(), sync.SERVER_AREAS) def test_manager_collection_reads_the_real_frozen_tag(self): with tempfile.TemporaryDirectory() as folder: root = Path(folder) fragments = root / 'changelog.d' fragments.mkdir() own = fragments / '20261021-own.md' own.write_text('---\narea: manager\ntitle: Characters show their saved versions\n---\n', encoding='utf8') (fragments / '20261021-server.md').write_text('---\narea: server\ntitle: Server only\n---\n', encoding='utf8') subprocess.run(['git', 'init', '-q', str(root)], check=True) subprocess.run(['git', '-C', str(root), 'add', '.'], check=True) subprocess.run(['git', '-C', str(root), '-c', 'user.name=Fixture', '-c', 'user.email=fixture@example.invalid', '-c', 'commit.gpgsign=false', 'commit', '-qm', 'Frozen notes'], check=True) subprocess.run(['git', '-C', str(root), 'tag', 'v0.7.0'], check=True) own.write_text('Uncommitted content must not become release notes', encoding='utf8') notes, ids, source = sync.collect_manager(root, 'v0.7.0', set()) self.assertEqual(notes, ['Characters show their saved versions']) self.assertEqual(len(ids), 2) self.assertEqual(len(source['commit']), 40) seen = {'Corfirean/coa-server-manager:20261021-own.md'} self.assertEqual(sync.collect_manager(root, 'v0.7.0', seen)[0], []) def test_render_is_component_scoped_and_stable(self): text = sync.render(self.history()) self.assertIn('# CoA Server Manager changelog', text) self.assertEqual(text.count('## 0.6.22'), 1) self.assertNotIn('## 0.7.0', text) self.assertEqual(text, sync.render(self.history())) def test_render_only_does_not_contact_github_or_change_published_history(self): with tempfile.TemporaryDirectory() as folder: root = Path(folder); (root / 'changelog').mkdir() path = root / 'changelog/history.json' path.write_text(json.dumps(self.history()), encoding='utf8') with patch.object(sys, 'argv', ['sync', '--root', str(root), '--render-only']), patch.object(sync, 'gh', side_effect=AssertionError('No network')): sync.main() first = (root / 'CHANGELOG.md').read_bytes() sync.main() self.assertEqual(first, (root / 'CHANGELOG.md').read_bytes()) self.assertEqual(len(json.loads(path.read_text())['releases']), 1) def test_repeated_sync_adds_a_published_version_only_once(self): with tempfile.TemporaryDirectory() as folder: root = Path(folder); (root / 'changelog').mkdir() path = root / 'changelog/history.json' path.write_text(json.dumps(self.history()), encoding='utf8') release = {'tag_name': 'v0.6.23', 'published_at': '2026-10-20T12:00:00Z', 'html_url': 'https://example.test/new'} with patch.object(sys, 'argv', ['sync', '--root', str(root)]), patch.object(sync, 'published', return_value=[release]), patch.object(sync, 'collect_manager', return_value=(['Update checks recover safely'], ['own:fragment.md'], {'commit': 'a' * 40})) as collect: sync.main(); sync.main() self.assertEqual(collect.call_count, 1) history = json.loads(path.read_text()) self.assertEqual(len(history['releases']), 2) self.assertEqual(history['releases'][0]['notes'], self.history()['releases'][0]['notes']) self.assertEqual(history['consumedFragments'], ['own:fragment.md']) if __name__ == '__main__': unittest.main()