test_cli.py
1"""CLI boundary contracts: dispatch, resources, output, and failures."""23from contextlib import redirect_stderr, redirect_stdout4import io5import json6from pathlib import Path7import sys8import tempfile9from tempfile import TemporaryDirectory10import unittest11from unittest.mock import patch1213ROOT = Path(__file__).resolve().parents[2]14# Absolute on every OS (UNUSED is not absolute on Windows); never created.15UNUSED = str(Path(tempfile.gettempdir()) / 'market-lab-unused')16DEFAULT = Path(tempfile.gettempdir()) / 'market-lab-default'17sys.path.insert(0, str(ROOT))1819from sim_platform.cli.main import main, parser20from sim_platform.domain.models import ContractError212223class CliTests(unittest.TestCase):24 def invoke(self, *argv):25 stdout, stderr = io.StringIO(), io.StringIO()26 with redirect_stdout(stdout), redirect_stderr(stderr):27 status = main(list(argv))28 return status, stdout.getvalue(), stderr.getvalue()2930 def test_version_exits_without_opening_platform(self):31 output = io.StringIO()32 with patch('sim_platform.cli.context.Platform') as platform:33 with redirect_stdout(output), self.assertRaises(SystemExit) as result:34 main(['--version'])35 self.assertEqual(result.exception.code, 0)36 self.assertEqual(output.getvalue(), 'Market Lab 1.0.0\n')37 platform.assert_not_called()3839 def test_path_reports_explicit_directory_without_creating_it(self):40 with TemporaryDirectory() as temporary:41 directory = Path(temporary) / 'not-created'42 with patch('sim_platform.cli.context.Platform') as platform:43 status, stdout, stderr = self.invoke('--data-dir', str(directory), 'path')44 self.assertEqual(status, 0)45 self.assertEqual(stderr, '')46 self.assertEqual(47 json.loads(stdout),48 {49 'data_directory': str(directory),50 'database': str(directory / 'platform.sqlite'),51 },52 )53 self.assertFalse(directory.exists())54 platform.assert_not_called()5556 def test_path_resolves_default_directory_without_opening_platform(self):57 with (58 patch('sim_platform.cli.context.data_directory', return_value=DEFAULT),59 patch('sim_platform.cli.context.Platform') as platform,60 ):61 status, stdout, stderr = self.invoke('path')62 self.assertEqual(status, 0)63 self.assertEqual(json.loads(stdout)['data_directory'], str(DEFAULT))64 self.assertEqual(stderr, '')65 platform.assert_not_called()6667 def test_relative_directory_is_an_expected_error(self):68 with patch('sim_platform.cli.context.Platform') as platform:69 status, stdout, stderr = self.invoke('--data-dir', 'relative', 'profiles')70 self.assertEqual(status, 1)71 self.assertEqual(stdout, '')72 self.assertEqual(stderr, 'Platform error: data directory must be absolute\n')73 platform.assert_not_called()7475 def test_comparison_still_validates_global_directory(self):76 with patch('sim_platform.research.batch.compare') as compare:77 status, stdout, stderr = self.invoke(78 '--data-dir',79 'relative',80 'compare',81 '--input',82 'unused.bin',83 )84 self.assertEqual(status, 1)85 self.assertEqual(stdout, '')86 self.assertIn('data directory must be absolute', stderr)87 compare.assert_not_called()8889 def test_account_handler_closes_platform_on_expected_failure(self):90 with patch('sim_platform.cli.context.Platform') as factory:91 app = factory.return_value92 app.create_account.side_effect = ContractError('unknown profile')93 status, stdout, stderr = self.invoke(94 '--data-dir',95 UNUSED,96 'create-account',97 '--profile',98 'missing',99 '--name',100 'Account',101 '--cash',102 '100.0001',103 )104 self.assertEqual(status, 1)105 self.assertEqual(stdout, '')106 self.assertEqual(stderr, 'Platform error: unknown profile\n')107 app.create_account.assert_called_once_with('missing', 'Account', 1_000_001)108 factory.return_value.close.assert_called_once()109110 def test_market_owns_stream_output_and_exit_code_without_storage(self):111 def run_market(args, context):112 print('{"event": 1}')113 print('{"event": 2}')114 return 7115116 with (117 patch('sim_platform.cli.commands.market.session.run_market', side_effect=run_market),118 patch('sim_platform.cli.context.data_directory') as directory,119 patch('sim_platform.cli.context.Platform') as platform,120 ):121 status, stdout, stderr = self.invoke('market', '--input', 'unused.bin')122 self.assertEqual(status, 7)123 self.assertEqual(stdout, '{"event": 1}\n{"event": 2}\n')124 self.assertEqual(stderr, '')125 directory.assert_not_called()126 platform.assert_not_called()127128 def test_desktop_delegates_optional_launch_without_resolving_storage(self):129 with (130 patch('sim_platform.desktop.app.launch', return_value=4) as launch,131 patch('sim_platform.cli.context.data_directory') as directory,132 ):133 status, stdout, stderr = self.invoke('desktop', '--demo', '--library', 'reader.so')134 self.assertEqual((status, stdout, stderr), (4, '', ''))135 launch.assert_called_once_with(None, Path('reader.so'), True)136 directory.assert_not_called()137138 def test_desktop_has_no_classic_entry(self):139 with redirect_stderr(io.StringIO()), self.assertRaises(SystemExit) as result:140 parser().parse_args(['desktop', '--classic'])141 self.assertEqual(result.exception.code, 2)142143 def test_decision_options_do_not_leak_into_execution(self):144 arguments = ['--profile', 'p', '--account', 'a', '--maker', 'm', '--input', 'source.bin']145 decision = parser().parse_args(['decision', *arguments, '--policy', 'human'])146 self.assertEqual(decision.policy, 'human')147 execution = parser().parse_args(['execution', *arguments])148 self.assertFalse(hasattr(execution, 'policy'))149 with redirect_stderr(io.StringIO()), self.assertRaises(SystemExit) as error:150 parser().parse_args(['execution', *arguments, '--policy', 'human'])151 self.assertEqual(error.exception.code, 2)152153 def test_invalid_arguments_keep_argparse_exit_code(self):154 with redirect_stderr(io.StringIO()) as stderr, self.assertRaises(SystemExit) as error:155 main(['create-account', '--profile', 'p', '--name', 'A', '--cash', '0.00001'])156 self.assertEqual(error.exception.code, 2)157 self.assertIn('at most four decimal places', stderr.getvalue())158 self.assertNotIn('Platform error:', stderr.getvalue())159160 def test_unexpected_errors_propagate_for_debugging(self):161 with patch('sim_platform.cli.context.Platform') as factory:162 app = factory.return_value163 app.profiles.side_effect = RuntimeError('programming error')164 with self.assertRaisesRegex(RuntimeError, 'programming error'):165 self.invoke('--data-dir', UNUSED, 'profiles')166 factory.return_value.close.assert_called_once()167168169if __name__ == '__main__':170 unittest.main()