Module: YARD::Markdown::SectionAssemblyHelper

Defined in:
lib/yard/markdown/section_assembly_helper.rb

Overview

Assembles grouped content into ordered Markdown sections.

Instance Method Summary collapse

Instance Method Details

#append_lines(lines, content, separated: true) ⇒ void

This method returns an undefined value.

Appends non-empty content to a mutable list of lines.

Parameters:

  • lines (Array<String>) —

    Destination line buffer.

  • content (String) —

    Rendered Markdown block to split into lines.

  • separated (Boolean) (defaults to: true) —

    Whether to insert a blank separator line first.



27
28
29
30
31
32
 
# File 'lib/yard/markdown/section_assembly_helper.rb', line 27

def append_lines(lines, content, separated: true)
  return if content.lstrip.empty?

  lines << "" if separated && !lines.empty? && !lines.last.empty?
  lines.concat(content.split("\n"))
end

#grouped_items(items, group_order) ⇒ Array<Array>

Groups items by their YARD group and orders them for rendering.

Parameters:

  • items (Array<#group>) —

    Renderable objects that expose a YARD group name.

  • group_order (Array<String>, nil) —

    Preferred ordering for named groups.

Returns:

  • (Array<Array>) —

    Ordered pairs of group names and grouped items.



12
13
14
15
16
17
18
19
 
# File 'lib/yard/markdown/section_assembly_helper.rb', line 12

def grouped_items(items, group_order)
  groups = items.group_by(&:group)
  names = groups.keys
  order = Array(group_order)
  ordered_names = (order & names) + (names.compact - order).sort + ([nil] & names)

  ordered_names.map { |name| [name, groups.fetch(name)] }
end