class Covered::MarkdownSummary

Generates a Markdown coverage summary.

def call(wrapper, output = $stdout)

@parameter output [IO] The output stream.
@parameter wrapper [Covered::Base] The coverage wrapper to report.
A coverage array gives, for each line, the number of line executions by the interpreter. A `nil` value means coverage is finished for this line (lines like `else` and `end`). 
def call(wrapper, output = $stdout)
	output.puts "# Coverage Report"
	output.puts
	
	ordered = []
	buffer = StringIO.new
	
	statistics = self.each(wrapper) do |coverage|
		ordered << coverage unless coverage.complete?
	end
	
	statistics.print(output)
	
	if ordered.any?
		output.puts "", "\#\# Least Coverage:", ""
		ordered.sort_by!(&:missing_count).reverse!
		
		ordered.first(5).each do |coverage|
			path = wrapper.relative_path(coverage.path)
			
			output.puts "- `#{path}`: #{coverage.missing_count} lines not executed!"
		end
	end
	
	output.print(buffer.string)
end

def each(wrapper)

@returns [Covered::Statistics] Statistics for all coverage objects, including omitted ones.
@parameter coverage [Covered::Coverage] The coverage object below the threshold.
@yields {|coverage| ...} Coverage whose ratio is below the configured threshold.
@parameter wrapper [Covered::Base] The coverage wrapper to enumerate.
Enumerate coverage below the threshold and return aggregate statistics. 
def each(wrapper)
	statistics = Statistics.new
	
	wrapper.each do |coverage|
		statistics << coverage
		
		if @threshold.nil? or coverage.ratio < @threshold
			yield coverage
		end
	end
	
	return statistics
end

def initialize(threshold: 1.0)

@parameter threshold [Numeric | Nil] The minimum ratio a file must meet to be omitted from the detailed output.
Initialize the report with an optional coverage threshold. 
def initialize(threshold: 1.0)
	@threshold = threshold
end

def print_annotations(output, coverage, line, line_offset)

@parameter line_offset [Integer] The current line number.
@parameter line [String] The source line.
@parameter coverage [Covered::Coverage] The coverage being rendered.
@parameter output [IO] The output stream.
Print any annotations for the given line. 
def print_annotations(output, coverage, line, line_offset)
	if annotations = coverage.annotations[line_offset]
		prefix = "#{line_offset}|".rjust(8) + "*|".rjust(8)
		output.write prefix
		
		output.write line.match(/^\s+/)
		output.puts "\# #{annotations.join(", ")}"
	end
end

def print_line(output, line, line_offset, count)

@parameter count [Integer | Nil] The execution count for the line.
@parameter line_offset [Integer] The current line number.
@parameter line [String] The source line.
@parameter output [IO] The output stream.
Print a single source line. 
def print_line(output, line, line_offset, count)
	prefix = "#{line_offset}|".rjust(8) + "#{count}|".rjust(8)
	
	output.write prefix
	output.write line
	
	# If there was no newline at end of file, we add one:
	unless line.end_with?($/)
		output.puts
	end
end

def print_line_header(output)

@parameter output [IO] The output stream.
Print the line and hit-count header. 
def print_line_header(output)
	output.puts "Line|".rjust(8) + "Hits|".rjust(8)
end