kienan
/
puppet-strings
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

(PDOC-212, PDOC-213) add support for @note and @todo

This commit is contained in:
Eric Putnam 2018-04-21 21:38:53 +01:00
parent d122b1962b
commit adbf887246
No known key found for this signature in database
GPG Key ID: 3FB595AA224A7751
26 changed files with 143 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
lib/puppet-strings/markdown/base.rb
View File

@ -57,7 +57,9 @@ module PuppetStrings::Markdown
# e.g. {:tag_name=>"author", :text=>"eputnam"}
{ :return_val => 'return',
:since => 'since',
:summary => 'summary' }.each do |method_name, tag_name|
:summary => 'summary',
:note => 'note',
:todo => 'todo' }.each do |method_name, tag_name|
# @return [String] unless the tag is nil or the string.length == 0
define_method method_name do
@tags.select { |tag| tag[:tag_name] == "#{tag_name}" }[0][:text] unless @tags.select { |tag| tag[:tag_name] == "#{tag_name}" }[0].nil? || @tags.select { |tag| tag[:tag_name] == "#{tag_name}" }[0][:text].length.zero?

8
lib/puppet-strings/markdown/templates/classes_and_defines.erb
View File

@ -8,6 +8,14 @@
<%= "The #{name} class." %>
<% end -%>
<% if todo -%>
* **TODO** <%= todo %>
<% end -%>
<% if note -%>
* **Note** <%= note %>
<% end -%>
<% if since -%>
* **Since** <%= since %>

20
lib/puppet-strings/markdown/templates/function.erb
View File

@ -7,7 +7,15 @@ Type: <%= type %>
<% elsif summary -%>
<%= summary %>
<% else -%>
<%= "The #{name} class." %>
<%= "The #{name} function." %>
<% end -%>
<% if todo -%>
* **TODO** <%= todo %>
<% end -%>
<% if note -%>
* **Note** <%= note %>
<% end -%>
<% signatures.each do |sig| -%>
@ -16,6 +24,16 @@ Type: <%= type %>
<% if sig.text -%>
<%= sig.text %>
<% elsif sig.summary -%>
<%= sig.summary %>
<% else -%>
<%= "The #{name} function." %>
<% end -%>
<% if sig.note -%>
* **Note** <%= sig.note %>
<% end -%>
<% if sig.return_type -%>
Returns: `<%= sig.return_type %>`<% if sig.return_val %> <%= sig.return_val %><% end %>

8
lib/puppet-strings/markdown/templates/resource_type.erb
View File

@ -8,6 +8,14 @@
<%= "The #{name} type." %>
<% end -%>
<% if todo -%>
* **TODO** <%= todo %>
<% end -%>
<% if note -%>
* **Note** <%= note %>
<% end -%>
<% if since -%>
* **Since** <%= since %>

6
lib/puppet-strings/yard/templates/default/puppet_class/html/note.erb Executable file
View File

@ -0,0 +1,6 @@
<% object.tags(:note).each do |tag| %>
<div class="note notetag">
<strong>Note:</strong>
<%= htmlify_line tag.text %>
</div>
<% end %>

2
lib/puppet-strings/yard/templates/default/puppet_class/html/setup.rb
View File

@ -1,7 +1,7 @@
# Initializes the template.
# @return [void]
def init
sections :header, :box_info, :summary, :overview, T('tags'), :source
sections :header, :box_info, :summary, :overview, :note, :todo, T('tags'), :source
end
# Renders the box_info section.

6
lib/puppet-strings/yard/templates/default/puppet_class/html/todo.erb Executable file
View File

@ -0,0 +1,6 @@
<% object.tags(:todo).each do |tag| %>
<div class="note todo">
<strong>TODO:</strong>
<%= htmlify_line tag.text %>
</div>
<% end %>

6
lib/puppet-strings/yard/templates/default/puppet_defined_type/html/note.erb Executable file
View File

@ -0,0 +1,6 @@
<% object.tags(:note).each do |tag| %>
<div class="note notetag">
<strong>Note:</strong>
<%= htmlify_line tag.text %>
</div>
<% end %>

2
lib/puppet-strings/yard/templates/default/puppet_defined_type/html/setup.rb
View File

@ -1,5 +1,5 @@
# Initializes the template.
# @return [void]
def init
sections :header, :box_info, :summary, :overview, T('tags'), :source
sections :header, :box_info, :summary, :overview, :note, :todo, T('tags'), :source
end

6
lib/puppet-strings/yard/templates/default/puppet_defined_type/html/todo.erb Executable file
View File

@ -0,0 +1,6 @@
<% object.tags(:todo).each do |tag| %>
<div class="note todo">
<strong>TODO:</strong>
<%= htmlify_line tag.text %>
</div>
<% end %>

6
lib/puppet-strings/yard/templates/default/puppet_function/html/note.erb Executable file
View File

@ -0,0 +1,6 @@
<% object.tags(:note).each do |tag| %>
<div class="note notetag">
<strong>Note:</strong>
<%= htmlify_line tag.text %>
</div>
<% end %>

2
lib/puppet-strings/yard/templates/default/puppet_function/html/setup.rb
View File

@ -1,5 +1,5 @@
# Initializes the template.
# @return [void]
def init
sections :header, :box_info, :summary, :overview, [T('tags'), :source]
sections :header, :box_info, :summary, :overview, :note, :todo, [T('tags'), :source]
end

6
lib/puppet-strings/yard/templates/default/puppet_function/html/todo.erb Executable file
View File

@ -0,0 +1,6 @@
<% object.tags(:todo).each do |tag| %>
<div class="note todo">
<strong>TODO:</strong>
<%= htmlify_line tag.text %>
</div>
<% end %>

6
lib/puppet-strings/yard/templates/default/puppet_plan/html/note.erb Executable file
View File

@ -0,0 +1,6 @@
<% object.tags(:note).each do |tag| %>
<div class="note notetag">
<strong>Note:</strong>
<%= htmlify_line tag.text %>
</div>
<% end %>

2
lib/puppet-strings/yard/templates/default/puppet_plan/html/setup.rb
View File

@ -1,7 +1,7 @@
# Initializes the template.
# @return [void]
def init
sections :header, :box_info, :summary, :overview, T('tags'), :source
sections :header, :box_info, :summary, :overview, :note, :todo, T('tags'), :source
end
# Renders the box_info section.

6
lib/puppet-strings/yard/templates/default/puppet_plan/html/todo.erb Executable file
View File

@ -0,0 +1,6 @@
<% object.tags(:todo).each do |tag| %>
<div class="note todo">
<strong>TODO:</strong>
<%= htmlify_line tag.text %>
</div>
<% end %>

6
lib/puppet-strings/yard/templates/default/puppet_type/html/note.erb Executable file
View File

@ -0,0 +1,6 @@
<% object.tags(:note).each do |tag| %>
<div class="note notetag">
<strong>Note:</strong>
<%= htmlify_line tag.text %>
</div>
<% end %>

2
lib/puppet-strings/yard/templates/default/puppet_type/html/setup.rb
View File

@ -1,7 +1,7 @@
# Initializes the template.
# @return [void]
def init
sections :header, :box_info, :summary, :overview, T('tags'), :properties, :parameters, :features
sections :header, :box_info, :summary, :overview, :note, :todo, T('tags'), :properties, :parameters, :features
end
# Renders the box_info section.

6
lib/puppet-strings/yard/templates/default/puppet_type/html/todo.erb Executable file
View File

@ -0,0 +1,6 @@
<% object.tags(:todo).each do |tag| %>
<div class="note todo">
<strong>TODO:</strong>
<%= htmlify_line tag.text %>
</div>
<% end %>

12
spec/fixtures/unit/json/output.json vendored
View File

@ -3,11 +3,19 @@
{
"name": "klass",
"file": "(stdin)",
"line": 5,
"line": 7,
"inherits": "foo::bar",
"docstring": {
"text": "A simple class.",
"tags": [
{
"tag_name": "todo",
"text": "Do a thing"
},
{
"tag_name": "note",
"text": "Some note"
},
{
"tag_name": "param",
"text": "First param.",
@ -44,7 +52,7 @@
{
"name": "dt",
"file": "(stdin)",
"line": 12,
"line": 14,
"docstring": {
"text": "A simple defined type.",
"tags": [

12
spec/fixtures/unit/json/output_with_plan.json vendored
View File

@ -3,11 +3,19 @@
{
"name": "klass",
"file": "(stdin)",
"line": 5,
"line": 7,
"inherits": "foo::bar",
"docstring": {
"text": "A simple class.",
"tags": [
{
"tag_name": "todo",
"text": "Do a thing"
},
{
"tag_name": "note",
"text": "Some note"
},
{
"tag_name": "param",
"text": "First param.",
@ -44,7 +52,7 @@
{
"name": "dt",
"file": "(stdin)",
"line": 12,
"line": 14,
"docstring": {
"text": "A simple defined type.",
"tags": [

8
spec/fixtures/unit/json/output_without_puppet_function.json vendored
View File

@ -8,6 +8,14 @@
"docstring": {
"text": "A simple class.",
"tags": [
{
"tag_name": "todo",
"text": "Do a thing"
},
{
"tag_name": "note",
"text": "Some note"
},
{
"tag_name": "param",
"text": "First param.",

4
spec/fixtures/unit/markdown/output.md vendored
View File

@ -39,6 +39,10 @@ _Private Classes_
An overview for a simple class.
* **TODO** Do something.
* **Note** Some note.
* **Since** 1.0.0
* **See also**

4
spec/fixtures/unit/markdown/output_with_plan.md vendored
View File

@ -43,6 +43,10 @@ _Private Classes_
An overview for a simple class.
* **TODO** Do a thing
* **Note** some note
* **Since** 1.0.0
* **See also**

2
spec/unit/puppet-strings/json_spec.rb
View File

@ -7,6 +7,8 @@ describe PuppetStrings::Json do
# Populate the YARD registry with both Puppet and Ruby source
YARD::Parser::SourceParser.parse_string(<<-SOURCE, :puppet)
# A simple class.
# @todo Do a thing
# @note Some note
# @param param1 First param.
# @param param2 Second param.
# @param param3 Third param.

2
spec/unit/puppet-strings/markdown_spec.rb
View File

@ -9,6 +9,8 @@ describe PuppetStrings::Markdown do
YARD::Parser::SourceParser.parse_string(<<-SOURCE, :puppet)
# An overview for a simple class.
# @summary A simple class.
# @todo Do a thing
# @note some note
# @since 1.0.0
# @see www.puppet.com
# @example This is an example