(GH-225) Document functions in Puppet Datatypes

[glennsarti]

Fixes #225

Previously the puppet datatype handler only documented attributes, not functions
for example [1]. This commit updates the data type handler to read in the
function information and then allow that to be used by puppet-strings in its
JSON, Markdown and HTML renderers. This commit also adds tests for many
different scenarios and all three rendering types.

[1] https://github.com/puppetlabs/puppet/blob/3e03e734dda415272ec156b03ed9f021ba243228/lib/puppet/datatypes/error.rb#L13-L15

---

• Actually read functions in datatypes
• unit tests for handler
• Add output support (HTML pending)
• Test with multiple interface definitions
• Tests for JSON output
• Tests for markdown output
• Tests for HTML output?

[glennsarti]

Example HTML output

[glennsarti]

@binford2k @scotje Can I get a review (and merge) on this?

[eputnam]

the only thing i saw that might be worth changing is meth and meths to method and methods #methamphetamines. otherwise this is dope and always love seeing tests!

[glennsarti]

Unfortunately methods is a method name on Object so you can't use it :-( Thus YARD uses meth and meths

[1] pry(main)> t-editor-services [add-tests-for-puppetfile ≡]> be pry
[5] pry(main)> $x = '12345'
=> "12345"
[6] pry(main)> $x.methods
=> [:shellsplit,
 :encode,
 :include?,
 :%,
 :*,
 :+,
 :to_c,
 :count,
 :partition,
 :sum,

[eputnam]

oh duh, sorry. as you were.

[scotje]

Looks good @glennsarti! I updated the markdown unit specs to match the new regex based specs (and deleted the old exact-match fixtures so they aren't confusing in the future).