parser.add_argument('--machine-parseable', dest='machine_parseable', action='store_true',

		default=False, help='output in a machine-parseable columnar format')

def format_qa_output_machine_parseable(formatter, stats, fails, dofull, dofail, options, qawarnings):

	"""Helper function that formats output in a machine-parseable column format

	Args:

		formatter - a subclass of Formatter

		stats - a dict of qa status items

		fails - a dict of qa status failures

		dofull - boolean to print full results or a summary

		dofail - boolean to decide if failure was hard or soft

	Returns:

		None (modifies formatter)

	"""

	full = options.mode == 'full'

	# we only want key value pairs where value > 0 

	for category, number in \

		filter(lambda myitem: myitem[1] > 0, iter(stats.items())):

		formatter.add_literal_data("NumberOf " + category + " ")

		if category in qawarnings:

			formatter.push_style("WARN")

		else:   

			formatter.push_style("BAD")

		formatter.add_literal_data("%s" % number)

		formatter.pop_style()

		formatter.add_line_break()

		if not dofull:

			if not full and dofail and category in qawarnings:

				# warnings are considered noise when there are failures

				continue

			fails_list = fails[category]

			if not full and len(fails_list) > 12:

				fails_list = fails_list[:12]

			for failure in fails_list:

				formatter.add_literal_data(category + " " + failure)

				formatter.add_line_break()