betterdocs 0.5.0 → 0.6.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/VERSION +1 -1
- data/betterdocs.gemspec +4 -4
- data/lib/betterdocs/generator/markdown.rb +4 -4
- data/lib/betterdocs/generator/markdown/templates/section.md.erb +23 -7
- data/lib/betterdocs/version.rb +1 -1
- metadata +3 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 371f8478bd3ccf3696faf4e8e007b366445a9f30
|
4
|
+
data.tar.gz: 4c434b65deaff692f847bee4eea707eb4432fb5f
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: af218fd27a8f5c5ef48f4475c54a7d17dba919dc90fa86758ed0f7557b3c5ddae433a5295acc30f9dd5fe37e17f0d9e7a976a544a34d91a3147ac2730d35fbfb
|
7
|
+
data.tar.gz: 4c360c686097a3bb66157171d2937e9c46b8a82b72340709d6eb1db3df9051d25b73077ab8df9fa27d96ed573fc816a9f480cbf7671d4c1eb376b7e689563736
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
0.
|
1
|
+
0.6.0
|
data/betterdocs.gemspec
CHANGED
@@ -1,21 +1,21 @@
|
|
1
1
|
# -*- encoding: utf-8 -*-
|
2
|
-
# stub: betterdocs 0.
|
2
|
+
# stub: betterdocs 0.6.0 ruby lib
|
3
3
|
|
4
4
|
Gem::Specification.new do |s|
|
5
5
|
s.name = "betterdocs".freeze
|
6
|
-
s.version = "0.
|
6
|
+
s.version = "0.6.0"
|
7
7
|
|
8
8
|
s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
|
9
9
|
s.require_paths = ["lib".freeze]
|
10
10
|
s.authors = ["betterplace Developers".freeze]
|
11
|
-
s.date = "2017-03-
|
11
|
+
s.date = "2017-03-30"
|
12
12
|
s.description = "This library provides tools to generate API documention for a web site's REST-ful JSON API.".freeze
|
13
13
|
s.email = "developers@betterplace.org".freeze
|
14
14
|
s.extra_rdoc_files = ["README.md".freeze, "lib/betterdocs.rb".freeze, "lib/betterdocs/controller_collector.rb".freeze, "lib/betterdocs/dsl.rb".freeze, "lib/betterdocs/dsl/common.rb".freeze, "lib/betterdocs/dsl/controller.rb".freeze, "lib/betterdocs/dsl/controller/action.rb".freeze, "lib/betterdocs/dsl/controller/action/param.rb".freeze, "lib/betterdocs/dsl/controller/action/response.rb".freeze, "lib/betterdocs/dsl/controller/controller.rb".freeze, "lib/betterdocs/dsl/controller/controller_base.rb".freeze, "lib/betterdocs/dsl/json_params.rb".freeze, "lib/betterdocs/dsl/json_params/param.rb".freeze, "lib/betterdocs/dsl/json_type_mapper.rb".freeze, "lib/betterdocs/dsl/naming.rb".freeze, "lib/betterdocs/dsl/representer.rb".freeze, "lib/betterdocs/dsl/result.rb".freeze, "lib/betterdocs/dsl/result/collection_property.rb".freeze, "lib/betterdocs/dsl/result/link.rb".freeze, "lib/betterdocs/dsl/result/property.rb".freeze, "lib/betterdocs/generator/config_shortcuts.rb".freeze, "lib/betterdocs/generator/markdown.rb".freeze, "lib/betterdocs/global.rb".freeze, "lib/betterdocs/json_params_representer.rb".freeze, "lib/betterdocs/json_params_representer_collector.rb".freeze, "lib/betterdocs/json_time_with_zone.rb".freeze, "lib/betterdocs/mix_into_controller.rb".freeze, "lib/betterdocs/railtie.rb".freeze, "lib/betterdocs/rake_tasks.rb".freeze, "lib/betterdocs/representer.rb".freeze, "lib/betterdocs/result_representer.rb".freeze, "lib/betterdocs/result_representer_collector.rb".freeze, "lib/betterdocs/sanitizer.rb".freeze, "lib/betterdocs/section.rb".freeze, "lib/betterdocs/version.rb".freeze]
|
15
15
|
s.files = [".codeclimate.yml".freeze, ".gitignore".freeze, ".rspec".freeze, ".travis.yml".freeze, "COPYING".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "betterdocs.gemspec".freeze, "lib/betterdocs.rb".freeze, "lib/betterdocs/controller_collector.rb".freeze, "lib/betterdocs/dsl.rb".freeze, "lib/betterdocs/dsl/common.rb".freeze, "lib/betterdocs/dsl/controller.rb".freeze, "lib/betterdocs/dsl/controller/action.rb".freeze, "lib/betterdocs/dsl/controller/action/param.rb".freeze, "lib/betterdocs/dsl/controller/action/response.rb".freeze, "lib/betterdocs/dsl/controller/controller.rb".freeze, "lib/betterdocs/dsl/controller/controller_base.rb".freeze, "lib/betterdocs/dsl/json_params.rb".freeze, "lib/betterdocs/dsl/json_params/param.rb".freeze, "lib/betterdocs/dsl/json_type_mapper.rb".freeze, "lib/betterdocs/dsl/naming.rb".freeze, "lib/betterdocs/dsl/representer.rb".freeze, "lib/betterdocs/dsl/result.rb".freeze, "lib/betterdocs/dsl/result/collection_property.rb".freeze, "lib/betterdocs/dsl/result/link.rb".freeze, "lib/betterdocs/dsl/result/property.rb".freeze, "lib/betterdocs/generator/config_shortcuts.rb".freeze, "lib/betterdocs/generator/markdown.rb".freeze, "lib/betterdocs/generator/markdown/templates/README.md.erb".freeze, "lib/betterdocs/generator/markdown/templates/section.md.erb".freeze, "lib/betterdocs/global.rb".freeze, "lib/betterdocs/json_params_representer.rb".freeze, "lib/betterdocs/json_params_representer_collector.rb".freeze, "lib/betterdocs/json_time_with_zone.rb".freeze, "lib/betterdocs/mix_into_controller.rb".freeze, "lib/betterdocs/railtie.rb".freeze, "lib/betterdocs/rake_tasks.rb".freeze, "lib/betterdocs/representer.rb".freeze, "lib/betterdocs/result_representer.rb".freeze, "lib/betterdocs/result_representer_collector.rb".freeze, "lib/betterdocs/sanitizer.rb".freeze, "lib/betterdocs/section.rb".freeze, "lib/betterdocs/tasks/doc.rake".freeze, "lib/betterdocs/version.rb".freeze, "spec/assets/app/assets/images/logos/logo.png".freeze, "spec/assets/app/controllers/api/foos_controller.rb".freeze, "spec/assets/app/views/api_v4/documentation/assets/CHANGELOG.md".freeze, "spec/assets/config/betterdocs.yml".freeze, "spec/betterdocs/dsl/controller/action/param_spec.rb".freeze, "spec/betterdocs/dsl/controller/action/response_spec.rb".freeze, "spec/betterdocs/dsl/json_type_mapper_spec.rb".freeze, "spec/betterdocs/dsl/result/collection_property_spec.rb".freeze, "spec/betterdocs/dsl/result/link_spec.rb".freeze, "spec/betterdocs/dsl/result/property_spec.rb".freeze, "spec/betterdocs/generator/markdown_spec.rb".freeze, "spec/betterdocs/global_spec.rb".freeze, "spec/betterdocs/json_params_representer_spec.rb".freeze, "spec/betterdocs/result_representer_spec.rb".freeze, "spec/betterdocs/sanitizer_spec.rb".freeze, "spec/controller_dsl_spec.rb".freeze, "spec/result_representer_dsl_spec.rb".freeze, "spec/spec_helper.rb".freeze]
|
16
16
|
s.homepage = "http://github.com/betterplace/betterdocs".freeze
|
17
17
|
s.rdoc_options = ["--title".freeze, "Betterdocs".freeze, "--main".freeze, "README.md".freeze]
|
18
|
-
s.rubygems_version = "2.6.
|
18
|
+
s.rubygems_version = "2.6.11".freeze
|
19
19
|
s.summary = "Betterplace API documentation library".freeze
|
20
20
|
s.test_files = ["spec/assets/app/controllers/api/foos_controller.rb".freeze, "spec/betterdocs/dsl/controller/action/param_spec.rb".freeze, "spec/betterdocs/dsl/controller/action/response_spec.rb".freeze, "spec/betterdocs/dsl/json_type_mapper_spec.rb".freeze, "spec/betterdocs/dsl/result/collection_property_spec.rb".freeze, "spec/betterdocs/dsl/result/link_spec.rb".freeze, "spec/betterdocs/dsl/result/property_spec.rb".freeze, "spec/betterdocs/generator/markdown_spec.rb".freeze, "spec/betterdocs/global_spec.rb".freeze, "spec/betterdocs/json_params_representer_spec.rb".freeze, "spec/betterdocs/result_representer_spec.rb".freeze, "spec/betterdocs/sanitizer_spec.rb".freeze, "spec/controller_dsl_spec.rb".freeze, "spec/result_representer_dsl_spec.rb".freeze, "spec/spec_helper.rb".freeze]
|
21
21
|
|
@@ -47,7 +47,7 @@ module Betterdocs
|
|
47
47
|
cd dirname do
|
48
48
|
for section in sections.values
|
49
49
|
infobar.progress(
|
50
|
-
message: "Section #{section.name.to_s.inspect} %c/%t in %te ETA %e @%E",
|
50
|
+
message: " Section #{section.name.to_s.inspect} %c/%t in %te ETA %e @%E ",
|
51
51
|
force: true
|
52
52
|
)
|
53
53
|
if @only
|
@@ -56,7 +56,7 @@ module Betterdocs
|
|
56
56
|
render_to "sections/#{section.name}.md", section_template, section.instance_eval('binding')
|
57
57
|
end
|
58
58
|
end
|
59
|
-
infobar.finish
|
59
|
+
infobar.finish message: ' %t sections created in %te, completed @%E '
|
60
60
|
infobar.newline
|
61
61
|
self
|
62
62
|
end
|
@@ -74,13 +74,13 @@ module Betterdocs
|
|
74
74
|
Infobar(total: config.assets.size)
|
75
75
|
config.each_asset do |src, dst|
|
76
76
|
infobar.progress(
|
77
|
-
message: "Asset #{File.basename(src).inspect} %c/%t in %te ETA %e @%E",
|
77
|
+
message: " Asset #{File.basename(src).inspect} %c/%t in %te ETA %e @%E ",
|
78
78
|
force: true
|
79
79
|
)
|
80
80
|
mkdir_p File.dirname(dst)
|
81
81
|
cp Betterdocs.rails.root.join(src), dst
|
82
82
|
end
|
83
|
-
infobar.finish
|
83
|
+
infobar.finish message: ' %t assets created in %te, completed @%E '
|
84
84
|
infobar.newline
|
85
85
|
self
|
86
86
|
end
|
@@ -22,7 +22,11 @@
|
|
22
22
|
<th align="left"><%= param.name %></th>
|
23
23
|
<td><code><%= param.value %></code></td>
|
24
24
|
<td><%= param.required ? 'yes' : 'no' %></td>
|
25
|
-
|
25
|
+
<td>
|
26
|
+
|
27
|
+
<%= param.description %>
|
28
|
+
|
29
|
+
</td>
|
26
30
|
</tr>
|
27
31
|
<%- end -%>
|
28
32
|
</table>
|
@@ -55,9 +59,13 @@ are optional.
|
|
55
59
|
<tr>
|
56
60
|
<th align="left"><%= param.name %></th>
|
57
61
|
<td><code><%= param.value %></code></td>
|
58
|
-
<td><%= param.types * ?| -%></td>
|
62
|
+
<td><code><%= param.types * ?| -%></code></td>
|
59
63
|
<td><%= param.required ? 'yes' : 'no' %></td>
|
60
|
-
|
64
|
+
<td>
|
65
|
+
|
66
|
+
<%= param.description %>
|
67
|
+
|
68
|
+
</td>
|
61
69
|
</tr>
|
62
70
|
<%- end -%>
|
63
71
|
</table>
|
@@ -91,9 +99,13 @@ are optional.
|
|
91
99
|
<%- else -%>
|
92
100
|
<th align="left"><%= property.full_name %></th>
|
93
101
|
<%- end -%>
|
94
|
-
<td><%= property.types * ' | ' %></td>
|
95
|
-
<td><%= property.example %></td>
|
96
|
-
|
102
|
+
<td><code><%= property.types * ' | ' %></code></td>
|
103
|
+
<td><code><%= property.example %></code></td>
|
104
|
+
<td>
|
105
|
+
|
106
|
+
<%= property.description %>
|
107
|
+
|
108
|
+
</td>
|
97
109
|
</tr>
|
98
110
|
<%- end -%>
|
99
111
|
</table>
|
@@ -115,7 +127,11 @@ are optional.
|
|
115
127
|
<%- for link in links.group_by(&:nesting_name).values.reduce(&:concat) -%>
|
116
128
|
<tr>
|
117
129
|
<th align="left"><%= link.full_name %></th>
|
118
|
-
|
130
|
+
<td>
|
131
|
+
|
132
|
+
<%= link.description %>
|
133
|
+
|
134
|
+
</td>
|
119
135
|
</tr>
|
120
136
|
<%- end -%>
|
121
137
|
<%- else -%>
|
data/lib/betterdocs/version.rb
CHANGED
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: betterdocs
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.6.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- betterplace Developers
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2017-03-
|
11
|
+
date: 2017-03-30 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: gem_hadar
|
@@ -279,7 +279,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
279
279
|
version: '0'
|
280
280
|
requirements: []
|
281
281
|
rubyforge_project:
|
282
|
-
rubygems_version: 2.6.
|
282
|
+
rubygems_version: 2.6.11
|
283
283
|
signing_key:
|
284
284
|
specification_version: 4
|
285
285
|
summary: Betterplace API documentation library
|