# #region TestCleanReleaseTui [C:2] [TYPE Module] # @RELATION BINDS_TO -> SrcRoot # @SEMANTICS: tests, tui, clean-release, curses # @PURPOSE: Unit tests for the interactive curses TUI of the clean release process. # @LAYER Tests # @INVARIANT: TUI initializes, handles hotkeys (F5, F10) and safely falls back without TTY. import curses import json import os import pytest from unittest import mock from unittest.mock import MagicMock, patch from src.models.clean_release import CheckFinalStatus from src.scripts.clean_release_tui import CleanReleaseTUI, main @pytest.fixture def mock_stdscr() -> MagicMock: stdscr = MagicMock() stdscr.getmaxyx.return_value = (40, 100) stdscr.getch.return_value = -1 return stdscr # #region test_headless_fallback [C:2] [TYPE Function] # @RELATION BINDS_TO -> TestCleanReleaseTui def test_headless_fallback(capsys): """ @TEST_EDGE: stdout_unavailable Tests that non-TTY startup is explicitly refused and wrapper is not invoked. """ with mock.patch("src.scripts.clean_release_tui.curses.wrapper") as curses_wrapper_mock: with mock.patch("sys.stdout.isatty", return_value=False): exit_code = main() curses_wrapper_mock.assert_not_called() assert exit_code == 2 captured = capsys.readouterr() assert "TTY is required for TUI mode" in captured.err assert "Use CLI/API workflow instead" in captured.err # #endregion test_headless_fallback @patch("src.scripts.clean_release_tui.curses") # #region test_tui_initial_render [C:2] [TYPE Function] # @RELATION BINDS_TO -> TestCleanReleaseTui def test_tui_initial_render(mock_curses_module, mock_stdscr: MagicMock): """ Simulates the initial rendering cycle of the TUI application to ensure titles, headers, footers and the READY state are drawn appropriately. """ # Ensure constants match mock_curses_module.KEY_F10 = curses.KEY_F10 mock_curses_module.KEY_F5 = curses.KEY_F5 mock_curses_module.color_pair.side_effect = lambda x: x mock_curses_module.A_BOLD = 0 app = CleanReleaseTUI(mock_stdscr) assert app.status == "READY" # We only want to run one loop iteration, so we mock getch to return F10 mock_stdscr.getch.return_value = curses.KEY_F10 app.loop() # Assert header was drawn addstr_calls = mock_stdscr.addstr.call_args_list assert any("Enterprise Clean Release Validator" in str(call) for call in addstr_calls) assert any("Candidate: [2026.03.03-rc1]" in str(call) for call in addstr_calls) # Assert checks list is shown assert any("Data Purity" in str(call) for call in addstr_calls) assert any("Internal Sources Only" in str(call) for call in addstr_calls) # Assert footer is shown assert any("F5 Run" in str(call) for call in addstr_calls) # #endregion test_tui_initial_render @patch("src.scripts.clean_release_tui.curses") # #region test_tui_run_checks_f5 [C:2] [TYPE Function] # @RELATION BINDS_TO -> TestCleanReleaseTui def test_tui_run_checks_f5(mock_curses_module, mock_stdscr: MagicMock): """ Simulates pressing F5 to transition into the RUNNING checks flow. """ # Ensure constants match mock_curses_module.KEY_F10 = curses.KEY_F10 mock_curses_module.KEY_F5 = curses.KEY_F5 mock_curses_module.color_pair.side_effect = lambda x: x mock_curses_module.A_BOLD = 0 app = CleanReleaseTUI(mock_stdscr) # getch sequence: # 1. First loop: F5 (triggers run_checks) # 2. Next call after run_checks: F10 to exit mock_stdscr.f5_pressed = False def side_effect(): if not mock_stdscr.f5_pressed: mock_stdscr.f5_pressed = True return curses.KEY_F5 return curses.KEY_F10 mock_stdscr.getch.side_effect = side_effect with mock.patch("time.sleep", return_value=None): app.loop() # After F5 is pressed, status should be BLOCKED due to deliberate 'test-data' violation assert app.status == CheckFinalStatus.BLOCKED assert app.report_id is not None assert "CCR-" in app.report_id assert len(app.violations_list) > 0 # #endregion test_tui_run_checks_f5 @patch("src.scripts.clean_release_tui.curses") # #region test_tui_exit_f10 [C:2] [TYPE Function] # @RELATION BINDS_TO -> TestCleanReleaseTui def test_tui_exit_f10(mock_curses_module, mock_stdscr: MagicMock): """ Simulates pressing F10 to exit the application immediately without running checks. """ # Ensure constants match mock_curses_module.KEY_F10 = curses.KEY_F10 app = CleanReleaseTUI(mock_stdscr) mock_stdscr.getch.return_value = curses.KEY_F10 # loop() should return cleanly app.loop() assert app.status == "READY" # #endregion test_tui_exit_f10 @patch("src.scripts.clean_release_tui.curses") # #region test_tui_clear_history_f7 [C:2] [TYPE Function] # @RELATION BINDS_TO -> TestCleanReleaseTui def test_tui_clear_history_f7(mock_curses_module, mock_stdscr: MagicMock): """ Simulates pressing F7 to clear history. """ mock_curses_module.KEY_F10 = curses.KEY_F10 mock_curses_module.KEY_F7 = curses.KEY_F7 mock_curses_module.color_pair.side_effect = lambda x: x mock_curses_module.A_BOLD = 0 app = CleanReleaseTUI(mock_stdscr) app.status = CheckFinalStatus.BLOCKED app.report_id = "SOME-REPORT" # F7 then F10 mock_stdscr.getch.side_effect = [curses.KEY_F7, curses.KEY_F10] app.loop() assert app.status == "READY" assert app.report_id is None assert len(app.checks_progress) == 0 # #endregion test_tui_clear_history_f7 @patch("src.scripts.clean_release_tui.curses") # #region test_tui_real_mode_bootstrap_imports_artifacts_catalog [C:2] [TYPE Function] # @RELATION BINDS_TO -> TestCleanReleaseTui def test_tui_real_mode_bootstrap_imports_artifacts_catalog( mock_curses_module, mock_stdscr: MagicMock, tmp_path, # #endregion test_tui_real_mode_bootstrap_imports_artifacts_catalog ): """ @TEST_CONTRACT: bootstrap.json + artifacts.json -> candidate PREPARED with imported artifacts """ mock_curses_module.KEY_F10 = curses.KEY_F10 mock_curses_module.color_pair.side_effect = lambda x: x mock_curses_module.A_BOLD = 0 bootstrap_path = tmp_path / "bootstrap.json" artifacts_path = tmp_path / "artifacts.json" bootstrap_path.write_text( json.dumps( { "candidate_id": "real-candidate-1", "version": "1.0.0", "source_snapshot_ref": "git:release/1", "created_by": "operator", "allowed_hosts": ["repo.intra.company.local"], } ), encoding="utf-8", ) artifacts_path.write_text( json.dumps( { "artifacts": [ { "id": "artifact-1", "path": "backend/dist/package.tar.gz", "sha256": "deadbeef", "size": 1024, "category": "core", "source_uri": "https://repo.intra.company.local/releases/package.tar.gz", "source_host": "repo.intra.company.local", } ] } ), encoding="utf-8", ) with mock.patch.dict( os.environ, { "CLEAN_TUI_MODE": "real", "CLEAN_TUI_BOOTSTRAP_JSON": str(bootstrap_path), "CLEAN_TUI_ARTIFACTS_JSON": str(artifacts_path), }, clear=False, ): app = CleanReleaseTUI(mock_stdscr) candidate = app.repo.get_candidate("real-candidate-1") artifacts = app.repo.get_artifacts_by_candidate("real-candidate-1") assert candidate is not None assert candidate.status == "PREPARED" assert len(artifacts) == 1 assert artifacts[0].path == "backend/dist/package.tar.gz" assert artifacts[0].detected_category == "core" # #endregion TestCleanReleaseTui