swagger-doc-rails 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/.gitignore +18 -0
- data/Appraisals +7 -0
- data/CHANGELOG.md +120 -0
- data/Gemfile +4 -0
- data/LICENSE.txt +22 -0
- data/README.md +448 -0
- data/Rakefile +10 -0
- data/certs/gem-public_cert.pem +21 -0
- data/lib/swagger/docs.rb +14 -0
- data/lib/swagger/docs/api_declaration_file.rb +125 -0
- data/lib/swagger/docs/api_declaration_file_metadata.rb +22 -0
- data/lib/swagger/docs/config.rb +63 -0
- data/lib/swagger/docs/dsl.rb +119 -0
- data/lib/swagger/docs/generator.rb +327 -0
- data/lib/swagger/docs/impotent_methods.rb +24 -0
- data/lib/swagger/docs/methods.rb +52 -0
- data/lib/swagger/docs/task.rb +9 -0
- data/lib/swagger/docs/version.rb +5 -0
- data/lib/tasks/swagger.rake +10 -0
- data/spec/fixtures/controllers/application_controller.rb +4 -0
- data/spec/fixtures/controllers/custom_resource_path_controller.rb +18 -0
- data/spec/fixtures/controllers/ignored_controller.rb +6 -0
- data/spec/fixtures/controllers/multiple_routes_controller.rb +13 -0
- data/spec/fixtures/controllers/nested_controller.rb +18 -0
- data/spec/fixtures/controllers/sample_controller.rb +81 -0
- data/spec/lib/swagger/docs/api_declaration_file_metadata_spec.rb +48 -0
- data/spec/lib/swagger/docs/api_declaration_file_spec.rb +203 -0
- data/spec/lib/swagger/docs/config_spec.rb +48 -0
- data/spec/lib/swagger/docs/dsl_spec.rb +17 -0
- data/spec/lib/swagger/docs/generator_spec.rb +451 -0
- data/spec/lib/swagger/docs/methods.rb +15 -0
- data/spec/spec_helper.rb +56 -0
- data/swagger-doc-rails.gemspec +31 -0
- metadata +175 -0
@@ -0,0 +1,15 @@
|
|
1
|
+
require 'spec_helper'
|
2
|
+
|
3
|
+
describe Swagger::Docs::Methods do
|
4
|
+
|
5
|
+
describe "#swagger_actions" do
|
6
|
+
it "merges additional configuration parameters into dsl" do
|
7
|
+
methods = Object.new
|
8
|
+
methods.extend(Swagger::Docs::Methods::ClassMethods)
|
9
|
+
methods.swagger_api("test", {produces: [ "application/json" ], consumes: [ "multipart/form-data" ]}) do
|
10
|
+
end
|
11
|
+
expect(methods.swagger_actions()).to eq({"test"=>{:produces=>["application/json"], :consumes=>["multipart/form-data"]}})
|
12
|
+
end
|
13
|
+
end
|
14
|
+
|
15
|
+
end
|
data/spec/spec_helper.rb
ADDED
@@ -0,0 +1,56 @@
|
|
1
|
+
require "rails"
|
2
|
+
require "swagger/docs"
|
3
|
+
require "ostruct"
|
4
|
+
require "json"
|
5
|
+
require 'pathname'
|
6
|
+
|
7
|
+
DEFAULT_VER = Swagger::Docs::Generator::DEFAULT_VER
|
8
|
+
|
9
|
+
RSpec.configure do |config|
|
10
|
+
config.expect_with :rspec do |c|
|
11
|
+
c.syntax = :expect
|
12
|
+
end
|
13
|
+
config.color = true
|
14
|
+
|
15
|
+
config.before(:each) do
|
16
|
+
Swagger::Docs::Config.base_api_controller = nil # use default object
|
17
|
+
end
|
18
|
+
end
|
19
|
+
|
20
|
+
def generate(config)
|
21
|
+
Swagger::Docs::Generator::write_docs(config)
|
22
|
+
end
|
23
|
+
|
24
|
+
def stub_string_verb_route(verb, action, controller, spec)
|
25
|
+
double("route", :verb => verb,
|
26
|
+
:defaults => {:action => action, :controller => controller},
|
27
|
+
:path => spec
|
28
|
+
)
|
29
|
+
end
|
30
|
+
|
31
|
+
def stub_route(verb, action, controller, spec)
|
32
|
+
double("route", :verb => double("verb", :source => verb),
|
33
|
+
:defaults => {:action => action, :controller => controller},
|
34
|
+
:path => double("path", :spec => spec)
|
35
|
+
)
|
36
|
+
end
|
37
|
+
|
38
|
+
def get_api_paths(apis, path)
|
39
|
+
apis.select{|api| api["path"] == path}
|
40
|
+
end
|
41
|
+
|
42
|
+
def get_api_operations(apis, path)
|
43
|
+
apis = get_api_paths(apis, path)
|
44
|
+
apis.collect{|api| api["operations"]}.flatten
|
45
|
+
end
|
46
|
+
|
47
|
+
def get_api_operation(apis, path, method)
|
48
|
+
operations = get_api_operations(apis, path)
|
49
|
+
operations.each{|operation| return operation if operation["method"] == method.to_s}
|
50
|
+
nil
|
51
|
+
end
|
52
|
+
|
53
|
+
def get_api_parameter(api, name)
|
54
|
+
api["parameters"].each{|param| return param if param["name"] == name}
|
55
|
+
nil
|
56
|
+
end
|
@@ -0,0 +1,31 @@
|
|
1
|
+
# coding: utf-8
|
2
|
+
lib = File.expand_path('../lib', __FILE__)
|
3
|
+
$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
|
4
|
+
require 'swagger/docs/version'
|
5
|
+
|
6
|
+
Gem::Specification.new do |spec|
|
7
|
+
spec.name = "swagger-doc-rails"
|
8
|
+
spec.version = Swagger::Docs::VERSION
|
9
|
+
spec.authors = ["zxhe"]
|
10
|
+
spec.email = ["zx.he@163.com"]
|
11
|
+
spec.description = %q{Generates json files for rails apps to use with swagger-ui}
|
12
|
+
spec.summary = %q{Generates swagger-ui json files for rails apps with APIs. You add the swagger DSL to your controller classes and then run one rake task to generate the json files.}
|
13
|
+
spec.homepage = "https://github.com/eagle168/swagger-doc-rails"
|
14
|
+
spec.license = "MIT"
|
15
|
+
|
16
|
+
spec.files = `git ls-files`.split($/)
|
17
|
+
spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
|
18
|
+
spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
|
19
|
+
spec.require_paths = ["lib"]
|
20
|
+
|
21
|
+
#spec.cert_chain = ['certs/gem-public_cert.pem']
|
22
|
+
#spec.signing_key = File.expand_path("~/.gemcert/gem-private_key.pem") if $0 =~ /gem\z/
|
23
|
+
|
24
|
+
spec.add_development_dependency "bundler", "~> 1.3"
|
25
|
+
spec.add_development_dependency "rake", "~> 10"
|
26
|
+
spec.add_development_dependency "rspec", "~> 3"
|
27
|
+
spec.add_development_dependency "appraisal", "~> 1"
|
28
|
+
|
29
|
+
spec.add_runtime_dependency "rails", ">= 3"
|
30
|
+
spec.add_runtime_dependency "activesupport", ">= 3"
|
31
|
+
end
|
metadata
ADDED
@@ -0,0 +1,175 @@
|
|
1
|
+
--- !ruby/object:Gem::Specification
|
2
|
+
name: swagger-doc-rails
|
3
|
+
version: !ruby/object:Gem::Version
|
4
|
+
version: 1.0.0
|
5
|
+
platform: ruby
|
6
|
+
authors:
|
7
|
+
- zxhe
|
8
|
+
autorequire:
|
9
|
+
bindir: bin
|
10
|
+
cert_chain: []
|
11
|
+
date: 2019-04-10 00:00:00.000000000 Z
|
12
|
+
dependencies:
|
13
|
+
- !ruby/object:Gem::Dependency
|
14
|
+
name: bundler
|
15
|
+
requirement: !ruby/object:Gem::Requirement
|
16
|
+
requirements:
|
17
|
+
- - "~>"
|
18
|
+
- !ruby/object:Gem::Version
|
19
|
+
version: '1.3'
|
20
|
+
type: :development
|
21
|
+
prerelease: false
|
22
|
+
version_requirements: !ruby/object:Gem::Requirement
|
23
|
+
requirements:
|
24
|
+
- - "~>"
|
25
|
+
- !ruby/object:Gem::Version
|
26
|
+
version: '1.3'
|
27
|
+
- !ruby/object:Gem::Dependency
|
28
|
+
name: rake
|
29
|
+
requirement: !ruby/object:Gem::Requirement
|
30
|
+
requirements:
|
31
|
+
- - "~>"
|
32
|
+
- !ruby/object:Gem::Version
|
33
|
+
version: '10'
|
34
|
+
type: :development
|
35
|
+
prerelease: false
|
36
|
+
version_requirements: !ruby/object:Gem::Requirement
|
37
|
+
requirements:
|
38
|
+
- - "~>"
|
39
|
+
- !ruby/object:Gem::Version
|
40
|
+
version: '10'
|
41
|
+
- !ruby/object:Gem::Dependency
|
42
|
+
name: rspec
|
43
|
+
requirement: !ruby/object:Gem::Requirement
|
44
|
+
requirements:
|
45
|
+
- - "~>"
|
46
|
+
- !ruby/object:Gem::Version
|
47
|
+
version: '3'
|
48
|
+
type: :development
|
49
|
+
prerelease: false
|
50
|
+
version_requirements: !ruby/object:Gem::Requirement
|
51
|
+
requirements:
|
52
|
+
- - "~>"
|
53
|
+
- !ruby/object:Gem::Version
|
54
|
+
version: '3'
|
55
|
+
- !ruby/object:Gem::Dependency
|
56
|
+
name: appraisal
|
57
|
+
requirement: !ruby/object:Gem::Requirement
|
58
|
+
requirements:
|
59
|
+
- - "~>"
|
60
|
+
- !ruby/object:Gem::Version
|
61
|
+
version: '1'
|
62
|
+
type: :development
|
63
|
+
prerelease: false
|
64
|
+
version_requirements: !ruby/object:Gem::Requirement
|
65
|
+
requirements:
|
66
|
+
- - "~>"
|
67
|
+
- !ruby/object:Gem::Version
|
68
|
+
version: '1'
|
69
|
+
- !ruby/object:Gem::Dependency
|
70
|
+
name: rails
|
71
|
+
requirement: !ruby/object:Gem::Requirement
|
72
|
+
requirements:
|
73
|
+
- - ">="
|
74
|
+
- !ruby/object:Gem::Version
|
75
|
+
version: '3'
|
76
|
+
type: :runtime
|
77
|
+
prerelease: false
|
78
|
+
version_requirements: !ruby/object:Gem::Requirement
|
79
|
+
requirements:
|
80
|
+
- - ">="
|
81
|
+
- !ruby/object:Gem::Version
|
82
|
+
version: '3'
|
83
|
+
- !ruby/object:Gem::Dependency
|
84
|
+
name: activesupport
|
85
|
+
requirement: !ruby/object:Gem::Requirement
|
86
|
+
requirements:
|
87
|
+
- - ">="
|
88
|
+
- !ruby/object:Gem::Version
|
89
|
+
version: '3'
|
90
|
+
type: :runtime
|
91
|
+
prerelease: false
|
92
|
+
version_requirements: !ruby/object:Gem::Requirement
|
93
|
+
requirements:
|
94
|
+
- - ">="
|
95
|
+
- !ruby/object:Gem::Version
|
96
|
+
version: '3'
|
97
|
+
description: Generates json files for rails apps to use with swagger-ui
|
98
|
+
email:
|
99
|
+
- zx.he@163.com
|
100
|
+
executables: []
|
101
|
+
extensions: []
|
102
|
+
extra_rdoc_files: []
|
103
|
+
files:
|
104
|
+
- ".gitignore"
|
105
|
+
- Appraisals
|
106
|
+
- CHANGELOG.md
|
107
|
+
- Gemfile
|
108
|
+
- LICENSE.txt
|
109
|
+
- README.md
|
110
|
+
- Rakefile
|
111
|
+
- certs/gem-public_cert.pem
|
112
|
+
- lib/swagger/docs.rb
|
113
|
+
- lib/swagger/docs/api_declaration_file.rb
|
114
|
+
- lib/swagger/docs/api_declaration_file_metadata.rb
|
115
|
+
- lib/swagger/docs/config.rb
|
116
|
+
- lib/swagger/docs/dsl.rb
|
117
|
+
- lib/swagger/docs/generator.rb
|
118
|
+
- lib/swagger/docs/impotent_methods.rb
|
119
|
+
- lib/swagger/docs/methods.rb
|
120
|
+
- lib/swagger/docs/task.rb
|
121
|
+
- lib/swagger/docs/version.rb
|
122
|
+
- lib/tasks/swagger.rake
|
123
|
+
- spec/fixtures/controllers/application_controller.rb
|
124
|
+
- spec/fixtures/controllers/custom_resource_path_controller.rb
|
125
|
+
- spec/fixtures/controllers/ignored_controller.rb
|
126
|
+
- spec/fixtures/controllers/multiple_routes_controller.rb
|
127
|
+
- spec/fixtures/controllers/nested_controller.rb
|
128
|
+
- spec/fixtures/controllers/sample_controller.rb
|
129
|
+
- spec/lib/swagger/docs/api_declaration_file_metadata_spec.rb
|
130
|
+
- spec/lib/swagger/docs/api_declaration_file_spec.rb
|
131
|
+
- spec/lib/swagger/docs/config_spec.rb
|
132
|
+
- spec/lib/swagger/docs/dsl_spec.rb
|
133
|
+
- spec/lib/swagger/docs/generator_spec.rb
|
134
|
+
- spec/lib/swagger/docs/methods.rb
|
135
|
+
- spec/spec_helper.rb
|
136
|
+
- swagger-doc-rails.gemspec
|
137
|
+
homepage: https://github.com/eagle168/swagger-doc-rails
|
138
|
+
licenses:
|
139
|
+
- MIT
|
140
|
+
metadata: {}
|
141
|
+
post_install_message:
|
142
|
+
rdoc_options: []
|
143
|
+
require_paths:
|
144
|
+
- lib
|
145
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
146
|
+
requirements:
|
147
|
+
- - ">="
|
148
|
+
- !ruby/object:Gem::Version
|
149
|
+
version: '0'
|
150
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
151
|
+
requirements:
|
152
|
+
- - ">="
|
153
|
+
- !ruby/object:Gem::Version
|
154
|
+
version: '0'
|
155
|
+
requirements: []
|
156
|
+
rubyforge_project:
|
157
|
+
rubygems_version: 2.5.1
|
158
|
+
signing_key:
|
159
|
+
specification_version: 4
|
160
|
+
summary: Generates swagger-ui json files for rails apps with APIs. You add the swagger
|
161
|
+
DSL to your controller classes and then run one rake task to generate the json files.
|
162
|
+
test_files:
|
163
|
+
- spec/fixtures/controllers/application_controller.rb
|
164
|
+
- spec/fixtures/controllers/custom_resource_path_controller.rb
|
165
|
+
- spec/fixtures/controllers/ignored_controller.rb
|
166
|
+
- spec/fixtures/controllers/multiple_routes_controller.rb
|
167
|
+
- spec/fixtures/controllers/nested_controller.rb
|
168
|
+
- spec/fixtures/controllers/sample_controller.rb
|
169
|
+
- spec/lib/swagger/docs/api_declaration_file_metadata_spec.rb
|
170
|
+
- spec/lib/swagger/docs/api_declaration_file_spec.rb
|
171
|
+
- spec/lib/swagger/docs/config_spec.rb
|
172
|
+
- spec/lib/swagger/docs/dsl_spec.rb
|
173
|
+
- spec/lib/swagger/docs/generator_spec.rb
|
174
|
+
- spec/lib/swagger/docs/methods.rb
|
175
|
+
- spec/spec_helper.rb
|