Module: PuppetStrings::Yard::Util
- Defined in:
- lib/puppet-strings/yard/util.rb
Overview
The module for various puppet-strings utility helpers.
Class Method Summary collapse
-
.docstring_to_hash(docstring, select_tags = nil) ⇒ Hash
Converts a YARD::Docstring (or String) to a docstring hash for JSON output.
-
.github_to_yard_links(data) ⇒ String
hacksville, usa YARD creates ids in the html with with the style of “label-Module+description”, where the markdown we use in the README involves the GitHub-style, which is #module-description.
-
.scrub_string(str) ⇒ String
Trims indentation from trailing whitespace and removes ruby literal quotation syntax ‘%Q{}` and `%q` from parsed strings.
-
.tags_to_hashes(tags) ⇒ Array
Converts a list of tags into an array of hashes.
Class Method Details
.docstring_to_hash(docstring, select_tags = nil) ⇒ Hash
Converts a YARD::Docstring (or String) to a docstring hash for JSON output.
62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 |
# File 'lib/puppet-strings/yard/util.rb', line 62 def self.docstring_to_hash(docstring, =nil) hash = {} hash[:text] = docstring if docstring.is_a? YARD::Docstring = (docstring..select { |t| .nil? || .include?(t.tag_name.to_sym) }) unless .empty? hash[:tags] = # .sort_by do |tag| # sort_key = tag[:tag_name].dup # sort_key << "-#{tag[:name]}" if tag[:name] # sort_key << "-#{tag[:opt_name]}" if tag[:opt_name] # sort_key # end end end hash end |
.github_to_yard_links(data) ⇒ String
hacksville, usa YARD creates ids in the html with with the style of “label-Module+description”, where the markdown we use in the README involves the GitHub-style, which is #module-description. This takes our GitHub-style links and converts them to reference the YARD-style ids.
27 28 29 30 31 32 33 |
# File 'lib/puppet-strings/yard/util.rb', line 27 def self.github_to_yard_links(data) data.scan(/href\=\"\#(.+)\"/).each do |bad_link| data = data.gsub("=\"##{bad_link.first}\"", "=\"#label-#{bad_link.first.capitalize.gsub('-', '+')}\"") end data end |
.scrub_string(str) ⇒ String
Trims indentation from trailing whitespace and removes ruby literal quotation syntax ‘%Q{}` and `%q` from parsed strings.
11 12 13 14 15 16 17 18 |
# File 'lib/puppet-strings/yard/util.rb', line 11 def self.scrub_string(str) match = str.match(/^%[Qq]{(.*)}$/m) if match return Puppet::Util::Docs.scrub(match[1]) end Puppet::Util::Docs.scrub(str) end |
.tags_to_hashes(tags) ⇒ Array
Converts a list of tags into an array of hashes.
38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 |
# File 'lib/puppet-strings/yard/util.rb', line 38 def self.() # Skip over the API tags that are public .select { |t| (t.tag_name != 'api' || t.text != 'public') }.map do |t| next t.to_hash if t.respond_to?(:to_hash) tag = { tag_name: t.tag_name } # grab nested information for @option and @enum tags if tag[:tag_name] == 'option' || tag[:tag_name] == 'enum' tag[:opt_name] = t.pair.name tag[:opt_text] = t.pair.text tag[:opt_types] = t.pair.types if t.pair.types tag[:parent] = t.name end tag[:text] = t.text if t.text tag[:types] = t.types if t.types tag[:name] = t.name if t.name tag end end |