# # Copyright (c) 2009, 2010 Testrepository Contributors # # Licensed under either the Apache License, Version 2.0 or the BSD 3-clause # license at the users choice. A copy of both licenses are available in the # project source as Apache-2.0 and BSD. You may not use this file except in # compliance with one of these two licences. # # Unless required by applicable law or agreed to in writing, software # distributed under these licenses is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # license you chose for the specific language governing permissions and # limitations under that license. """Tests for UI support logic and the UI contract.""" from io import BytesIO, TextIOWrapper import optparse import subprocess import sys from fixtures import EnvironmentVariable from testtools.compat import _b, _u from testtools.content import text_content from testtools.matchers import raises from testrepository import arguments, commands from testrepository.commands import load from testrepository.repository import memory from testrepository.tests import ResourcedTestCase, StubTestCommand from testrepository.ui import cli, decorator, model def cli_ui_factory(input_streams=None, options=(), args=()): if input_streams and len(input_streams) > 1: # TODO: turn additional streams into argv and simulated files, or # something - however, may need to be cli specific tests at that # point. raise NotImplementedError(cli_ui_factory) stdout = TextIOWrapper(BytesIO(), line_buffering=True) if input_streams: stdin = TextIOWrapper(BytesIO(input_streams[0][1])) else: stdin = TextIOWrapper(BytesIO()) stderr = TextIOWrapper(BytesIO(), line_buffering=True) argv = list(args) for option, value in options: # only bool handled so far if value: argv.append('--%s' % option) return cli.UI(argv, stdin, stdout, stderr) def decorator_ui_factory(input_streams=None, options=(), args=()): base = model.UI(input_streams=input_streams, options=options, args=args) return decorator.UI(input_streams=input_streams, decorated=base) # what ui implementations do we need to test? ui_implementations = [ ('CLIUI', {'ui_factory': cli_ui_factory}), ('ModelUI', {'ui_factory': model.UI}), ('DecoratorUI', {'ui_factory': decorator_ui_factory}), ] class TestUIContract(ResourcedTestCase): scenarios = ui_implementations def get_test_ui(self): ui = self.ui_factory() cmd = commands.Command(ui) ui.set_command(cmd) return ui def test_factory_noargs(self): ui = self.ui_factory() def test_factory_input_stream_args(self): ui = self.ui_factory([('subunit', _b('value'))]) def test_here(self): ui = self.get_test_ui() self.assertNotEqual(None, ui.here) def test_iter_streams_load_stdin_use_case(self): # A UI can be asked for the streams that a command has indicated it # accepts, which is what load < foo will require. ui = self.ui_factory([('subunit', _b('test: foo\nsuccess: foo\n'))]) cmd = commands.Command(ui) cmd.input_streams = ['subunit+'] ui.set_command(cmd) results = [] for result in ui.iter_streams('subunit'): results.append(result.read()) self.assertEqual([_b('test: foo\nsuccess: foo\n')], results) def test_iter_streams_unexpected_type_raises(self): ui = self.get_test_ui() self.assertThat(lambda: ui.iter_streams('subunit'), raises(KeyError)) def test_output_error(self): self.useFixture(EnvironmentVariable('TESTR_PDB')) try: raise Exception('fooo') except Exception: err_tuple = sys.exc_info() ui = self.get_test_ui() ui.output_error(err_tuple) def test_output_rest(self): # output some ReST - used for help and docs. ui = self.get_test_ui() ui.output_rest(_u('')) def test_output_stream(self): # a stream of bytes can be output. ui = self.get_test_ui() ui.output_stream(BytesIO()) def test_output_stream_non_utf8(self): # When the stream has non-utf8 bytes it still outputs correctly. ui = self.get_test_ui() ui.output_stream(BytesIO(_b('\xfa'))) def test_output_table(self): # output_table shows a table. ui = self.get_test_ui() ui.output_table([('col1', 'col2'), ('row1c1','row1c2')]) def test_output_tests(self): # output_tests can be called, and takes a list of tests to output. ui = self.get_test_ui() ui.output_tests([self, self.__class__('test_output_table')]) def test_output_values(self): # output_values can be called and takes a list of things to output. ui = self.get_test_ui() ui.output_values([('foo', 1), ('bar', 'quux')]) def test_output_summary(self): # output_summary can be called, takes success boolean and list of # things to output. ui = self.get_test_ui() ui.output_summary(True, 1, None, 1, None, []) def test_set_command(self): # All ui objects can be given their command. ui = self.ui_factory() cmd = commands.Command(ui) self.assertEqual(True, ui.set_command(cmd)) def test_set_command_checks_args_unwanted_arg(self): ui = self.ui_factory(args=['foo']) cmd = commands.Command(ui) self.assertEqual(False, ui.set_command(cmd)) def test_set_command_checks_args_missing_arg(self): ui = self.ui_factory() cmd = commands.Command(ui) cmd.args = [arguments.command.CommandArgument('foo')] self.assertEqual(False, ui.set_command(cmd)) def test_set_command_checks_args_invalid_arg(self): ui = self.ui_factory(args=['a']) cmd = commands.Command(ui) cmd.args = [arguments.command.CommandArgument('foo')] self.assertEqual(False, ui.set_command(cmd)) def test_args_are_exposed_at_arguments(self): ui = self.ui_factory(args=['load']) cmd = commands.Command(ui) cmd.args = [arguments.command.CommandArgument('foo')] self.assertEqual(True, ui.set_command(cmd)) self.assertEqual({'foo':[load.load]}, ui.arguments) def test_set_command_with_no_name_works(self): # Degrade gracefully if the name attribute has not been set. ui = self.ui_factory() cmd = commands.Command(ui) self.assertEqual(True, ui.set_command(cmd)) def test_options_at_options(self): ui = self.get_test_ui() self.assertEqual(False, ui.options.quiet) def test_options_when_set_at_options(self): ui = self.ui_factory(options=[('quiet', True)]) cmd = commands.Command(ui) ui.set_command(cmd) self.assertEqual(True, ui.options.quiet) def test_options_on_command_picked_up(self): ui = self.ui_factory(options=[('subunit', True)]) cmd = commands.Command(ui) cmd.options = [optparse.Option("--subunit", action="store_true", default=False, help="Show output as a subunit stream.")] ui.set_command(cmd) self.assertEqual(True, ui.options.subunit) # And when not given the default works. ui = self.ui_factory() cmd = commands.Command(ui) cmd.options = [optparse.Option("--subunit", action="store_true", default=False, help="Show output as a subunit stream.")] ui.set_command(cmd) self.assertEqual(False, ui.options.subunit) def test_exec_subprocess(self): # exec_subprocess should 'work like popen'. ui = self.ui_factory() proc = ui.subprocess_Popen([sys.executable, "-V"], stdout=subprocess.PIPE, stderr=subprocess.PIPE) out, err = proc.communicate() proc.returncode def test_subprocesses_have_stdin(self): # exec_subprocess should 'work like popen'. ui = self.ui_factory() proc = ui.subprocess_Popen([sys.executable, "-V"], stdout=subprocess.PIPE, stderr=subprocess.PIPE) proc.stdout.read(0) out, err = proc.communicate() def test_subprocesses_have_stdout(self): # exec_subprocess should 'work like popen'. ui = self.ui_factory() proc = ui.subprocess_Popen([sys.executable, "-V"], stdout=subprocess.PIPE, stderr=subprocess.PIPE) proc.stdout.read(0) out, err = proc.communicate() def test_make_result(self): # make_result should return a StreamResult and a summary result. ui = self.ui_factory() ui.set_command(commands.Command(ui)) result, summary = ui.make_result(lambda: None, StubTestCommand()) result.startTestRun() result.status() result.stopTestRun() summary.wasSuccessful() def test_make_result_previous_run(self): # make_result can take a previous run. ui = self.ui_factory() ui.set_command(commands.Command(ui)) result, summary = ui.make_result( lambda: None, StubTestCommand(), previous_run=memory.Repository().get_failing()) result.startTestRun() result.status() result.stopTestRun() summary.wasSuccessful()