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.
Files changed (35) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +18 -0
  3. data/Appraisals +7 -0
  4. data/CHANGELOG.md +120 -0
  5. data/Gemfile +4 -0
  6. data/LICENSE.txt +22 -0
  7. data/README.md +448 -0
  8. data/Rakefile +10 -0
  9. data/certs/gem-public_cert.pem +21 -0
  10. data/lib/swagger/docs.rb +14 -0
  11. data/lib/swagger/docs/api_declaration_file.rb +125 -0
  12. data/lib/swagger/docs/api_declaration_file_metadata.rb +22 -0
  13. data/lib/swagger/docs/config.rb +63 -0
  14. data/lib/swagger/docs/dsl.rb +119 -0
  15. data/lib/swagger/docs/generator.rb +327 -0
  16. data/lib/swagger/docs/impotent_methods.rb +24 -0
  17. data/lib/swagger/docs/methods.rb +52 -0
  18. data/lib/swagger/docs/task.rb +9 -0
  19. data/lib/swagger/docs/version.rb +5 -0
  20. data/lib/tasks/swagger.rake +10 -0
  21. data/spec/fixtures/controllers/application_controller.rb +4 -0
  22. data/spec/fixtures/controllers/custom_resource_path_controller.rb +18 -0
  23. data/spec/fixtures/controllers/ignored_controller.rb +6 -0
  24. data/spec/fixtures/controllers/multiple_routes_controller.rb +13 -0
  25. data/spec/fixtures/controllers/nested_controller.rb +18 -0
  26. data/spec/fixtures/controllers/sample_controller.rb +81 -0
  27. data/spec/lib/swagger/docs/api_declaration_file_metadata_spec.rb +48 -0
  28. data/spec/lib/swagger/docs/api_declaration_file_spec.rb +203 -0
  29. data/spec/lib/swagger/docs/config_spec.rb +48 -0
  30. data/spec/lib/swagger/docs/dsl_spec.rb +17 -0
  31. data/spec/lib/swagger/docs/generator_spec.rb +451 -0
  32. data/spec/lib/swagger/docs/methods.rb +15 -0
  33. data/spec/spec_helper.rb +56 -0
  34. data/swagger-doc-rails.gemspec +31 -0
  35. 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
@@ -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