diff --git a/lib/ansible/plugins/callback/unixy.py b/lib/ansible/plugins/callback/unixy.py new file mode 100644 index 0000000000..2fa03abf75 --- /dev/null +++ b/lib/ansible/plugins/callback/unixy.py @@ -0,0 +1,198 @@ +# Copyright: (c) 2017, Allyson Bowles <@akatch> +# Copyright: (c) 2012-2014, Michael DeHaan +# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt) + +# Make coding more python3-ish +from __future__ import (absolute_import, division, print_function) +__metaclass__ = type + +DOCUMENTATION = ''' + callback: unixy + type: stdout + short_description: condensed Ansible output + version_added: 2.5 + description: + - Consolidated Ansible output in the style of *NIX startup logs + extends_documentation_fragment: + - default_callback + requirements: + - set as stdout in configuration +''' + +from ansible.plugins.callback import CallbackBase +from ansible.utils.color import colorize, hostcolor +from ansible import constants as C +from os.path import basename + + +class CallbackModule(CallbackBase): + + ''' + Design goals: + - Print consolidated output that looks like a *NIX startup log + - Defaults should avoid displaying unnecessary information wherever possible + + TODOs: + - Only display task names if the task runs on at least one host + - Add option to display all hostnames on a single line in the appropriate result color (failures may have a separate line) + - Consolidate stats display + - Display whether run is in --check mode + - Don't show play name if no hosts found + ''' + + CALLBACK_VERSION = 2.0 + CALLBACK_TYPE = 'stdout' + CALLBACK_NAME = 'unixy' + + def _run_is_verbose(self, result): + return ((self._display.verbosity > 0 or '_ansible_verbose_always' in result._result) and '_ansible_verbose_override' not in result._result) + + def _get_task_display_name(self, task): + self.task_display_name = None + display_name = task.get_name().strip().split(" : ") + + task_display_name = display_name[-1] + if task_display_name.startswith("include"): + return + else: + self.task_display_name = task_display_name + + def _preprocess_result(self, result): + self.delegated_vars = result._result.get('_ansible_delegated_vars', None) + self._handle_exception(result._result) + self._handle_warnings(result._result) + + def _process_result_output(self, result, msg): + task_host = result._host.get_name() + task_result = "%s %s" % (task_host, msg) + + if self._run_is_verbose(result): + task_result = "%s %s: %s" % (task_host, msg, self._dump_results(result._result, indent=4)) + + if self.delegated_vars: + task_delegate_host = self.delegated_vars['ansible_host'] + task_result = "%s -> %s %s" % (task_host, task_delegate_host, msg) + + if result._result.get('msg') and result._result.get('msg') != "All items completed": + task_result += " | msg: " + result._result.get('msg') + + if result._result.get('stdout'): + task_result += " | stdout: " + result._result.get('stdout') + + if result._result.get('stderr'): + task_result += " | stderr: " + result._result.get('stderr') + + return task_result + + def v2_playbook_on_task_start(self, task, is_conditional): + self._get_task_display_name(task) + if self.task_display_name is not None: + self._display.display("%s..." % self.task_display_name) + + def v2_playbook_on_handler_task_start(self, task): + self._get_task_display_name(task) + if self.task_display_name is not None: + self._display.display("%s (via handler)... " % self.task_display_name) + + def v2_playbook_on_play_start(self, play): + # TODO display name of play and list of play hosts + # TODO don't display play name if no hosts in play + name = play.get_name().strip() + if name: + msg = u"\n- %s -" % name + else: + msg = u"---" + + self._display.display(msg) + + def v2_runner_on_failed(self, result, ignore_errors=False): + self._preprocess_result(result) + display_color = C.COLOR_ERROR + msg = "failed" + + task_result = self._process_result_output(result, msg) + self._display.display(" " + task_result, display_color) + + def v2_runner_on_ok(self, result, msg="ok", display_color=C.COLOR_OK): + self._preprocess_result(result) + + result_was_changed = ('changed' in result._result and result._result['changed']) + if result_was_changed: + msg = "done" + display_color = C.COLOR_CHANGED + + task_result = self._process_result_output(result, msg) + self._display.display(" " + task_result, display_color) + + def v2_runner_item_on_failed(self, result): + self.v2_runner_on_failed(result) + + def v2_runner_on_unreachable(self, result): + msg = "unreachable" + display_color = C.COLOR_UNREACHABLE + task_result = self._process_result_output(result, msg) + + self._display.display(" " + task_result, display_color) + + def v2_on_file_diff(self, result): + if result._task.loop and 'results' in result._result: + for res in result._result['results']: + if 'diff' in res and res['diff'] and res.get('changed', False): + diff = self._get_diff(res['diff']) + if diff: + self._display.display(diff) + elif 'diff' in result._result and result._result['diff'] and result._result.get('changed', False): + diff = self._get_diff(result._result['diff']) + if diff: + self._display.display(diff) + + def v2_playbook_on_stats(self, stats): + self._display.display("\n- Play recap -", screen_only=True) + + hosts = sorted(stats.processed.keys()) + for h in hosts: + # TODO how else can we display these? + t = stats.summarize(h) + + self._display.display(u" %s : %s %s %s %s" % ( + hostcolor(h, t), + colorize(u'ok', t['ok'], C.COLOR_OK), + colorize(u'changed', t['changed'], C.COLOR_CHANGED), + colorize(u'unreachable', t['unreachable'], C.COLOR_UNREACHABLE), + colorize(u'failed', t['failures'], C.COLOR_ERROR)), + screen_only=True + ) + + self._display.display(u" %s : %s %s %s %s" % ( + hostcolor(h, t, False), + colorize(u'ok', t['ok'], None), + colorize(u'changed', t['changed'], None), + colorize(u'unreachable', t['unreachable'], None), + colorize(u'failed', t['failures'], None)), + log_only=True + ) + + def v2_playbook_on_no_hosts_matched(self): + self._display.display(" No hosts found!", color=C.COLOR_DEBUG) + + def v2_playbook_on_no_hosts_remaining(self): + self._display.display(" Ran out of hosts!", color=C.COLOR_ERROR) + + def v2_playbook_on_start(self, playbook): + # TODO display whether this run is happening in check mode + self._display.display("Executing playbook %s" % basename(playbook._file_name)) + + if self._display.verbosity > 3: + if self._options is not None: + for option in dir(self._options): + if option.startswith('_') or option in ['read_file', 'ensure_value', 'read_module']: + continue + val = getattr(self._options, option) + if val: + self._display.vvvv('%s: %s' % (option, val)) + + def v2_runner_retry(self, result): + msg = " Retrying... (%d of %d)" % (result._result['attempts'], result._result['retries']) + if (self._display.verbosity > 2 or '_ansible_verbose_always' in result._result) and '_ansible_verbose_override' not in result._result: + msg += "Result was: %s" % self._dump_results(result._result) + self._display.display(msg, color=C.COLOR_DEBUG)