zero-rails_openapi 1.5.6 → 1.5.7
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +12 -1
- data/Gemfile.lock +5 -5
- data/README.md +12 -0
- data/lib/open_api/dsl.rb +1 -0
- data/lib/open_api/generator.rb +5 -3
- data/lib/open_api/version.rb +1 -1
- data/zero-rails_openapi.gemspec +1 -1
- metadata +6 -6
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: ed64dbbb343efdc64e8ea606b49e5363f6fcc04a
|
4
|
+
data.tar.gz: f6914e5543de926f5672710f9247ccb3b1c1bdbc
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 6308ca2b74eee6cd14d2a828eaed6c4591ffd2496e115c1e2c1d0807f7c70b457965f7146738efdb430740eb7a3f95d7fe0991060b4ca2531e18037c14547d5f
|
7
|
+
data.tar.gz: 290fcb45ceb1f876ea4b3f20ccdfd4f056be1a5e18a6e534bef63e8d7a7d217e513872ec3bbed827748d2bd258bae69af455102f6dda5a870797a87981c4286c
|
data/CHANGELOG.md
CHANGED
@@ -2,11 +2,22 @@
|
|
2
2
|
|
3
3
|
## [Unreleased]
|
4
4
|
|
5
|
+
## [1.5.7] - 2018/4/6 - [view diff](https://github.com/zhandao/zero-rails_openapi/compare/v1.5.6...v1.5.7)
|
6
|
+
|
7
|
+
## Changed
|
8
|
+
|
9
|
+
1. issue [#16](#https://github.com/zhandao/zero-rails_openapi/issues/16) DSL in `base_doc_class` can not be generated.
|
10
|
+
|
11
|
+
## Fixed
|
12
|
+
|
13
|
+
1. issue [#15](#https://github.com/zhandao/zero-rails_openapi/issues/15) colorize was not required.
|
14
|
+
2. securitySchemes defined by config DSL was not be generated.
|
15
|
+
|
5
16
|
## [1.5.6] - 2018/3/23 - [view diff](https://github.com/zhandao/zero-rails_openapi/compare/v1.5.5...v1.5.6)
|
6
17
|
|
7
18
|
## Changed
|
8
19
|
|
9
|
-
1.
|
20
|
+
1. Upgrade `loofah` and `rails-html-sanitizer` cause XSS vulnerability.
|
10
21
|
2. Refactor and document DSL for Rspec (spec_dsl.rb).
|
11
22
|
|
12
23
|
## [1.5.5] - 2018/2/21 - [view diff](https://github.com/zhandao/zero-rails_openapi/compare/v1.5.4...v1.5.5)
|
data/Gemfile.lock
CHANGED
@@ -1,9 +1,9 @@
|
|
1
1
|
PATH
|
2
2
|
remote: .
|
3
3
|
specs:
|
4
|
-
zero-rails_openapi (1.5.
|
4
|
+
zero-rails_openapi (1.5.7)
|
5
5
|
activesupport (>= 3)
|
6
|
-
colorize
|
6
|
+
colorize
|
7
7
|
rails (>= 3)
|
8
8
|
|
9
9
|
GEM
|
@@ -53,7 +53,7 @@ GEM
|
|
53
53
|
crass (1.0.3)
|
54
54
|
diff-lcs (1.3)
|
55
55
|
docile (1.3.0)
|
56
|
-
erubi (1.7.
|
56
|
+
erubi (1.7.1)
|
57
57
|
globalid (0.4.1)
|
58
58
|
activesupport (>= 4.2.0)
|
59
59
|
i18n (0.9.5)
|
@@ -68,11 +68,11 @@ GEM
|
|
68
68
|
mini_mime (1.0.0)
|
69
69
|
mini_portile2 (2.3.0)
|
70
70
|
minitest (5.11.3)
|
71
|
-
nio4r (2.
|
71
|
+
nio4r (2.3.0)
|
72
72
|
nokogiri (1.8.2)
|
73
73
|
mini_portile2 (~> 2.3.0)
|
74
74
|
rack (2.0.4)
|
75
|
-
rack-test (0.8.
|
75
|
+
rack-test (0.8.3)
|
76
76
|
rack (>= 1.0, < 3)
|
77
77
|
rails (5.1.5)
|
78
78
|
actioncable (= 5.1.5)
|
data/README.md
CHANGED
@@ -6,12 +6,24 @@
|
|
6
6
|
[![Test Coverage](https://api.codeclimate.com/v1/badges/471fd60f6eb7b019ceed/test_coverage)](https://codeclimate.com/github/zhandao/zero-rails_openapi/test_coverage)
|
7
7
|
|
8
8
|
Concise DSL for generating OpenAPI Specification 3 (**OAS3**, formerly Swagger3) JSON documentation for Rails application.
|
9
|
+
|
10
|
+
```ruby
|
11
|
+
class Api::ExamplesController < ApiController
|
12
|
+
api :update, 'POST update some thing' do
|
13
|
+
path :id, Integer
|
14
|
+
query :token, String, desc: 'api token', length: 16
|
15
|
+
form data: { phone: String }
|
16
|
+
end
|
17
|
+
end
|
18
|
+
```
|
9
19
|
|
10
20
|
## Contributing
|
11
21
|
|
12
22
|
**Hi, here is ZhanDao = ▽ =
|
13
23
|
It may be a very useful tool if you want to write API document clearly.
|
14
24
|
I'm looking forward to your issue and PR!**
|
25
|
+
|
26
|
+
[Need Help](https://github.com/zhandao/zero-rails_openapi/issues/14)
|
15
27
|
|
16
28
|
If you have any questions, please read the test code first.
|
17
29
|
such as [api DSL](spec/api_spec.rb) and [schema Obj](spec/oas_objs/schema_obj_spec.rb).
|
data/lib/open_api/dsl.rb
CHANGED
data/lib/open_api/generator.rb
CHANGED
@@ -1,5 +1,6 @@
|
|
1
1
|
require 'active_support/hash_with_indifferent_access'
|
2
2
|
require 'open_api/config'
|
3
|
+
require 'colorize'
|
3
4
|
|
4
5
|
module OpenApi
|
5
6
|
module Generator
|
@@ -27,11 +28,12 @@ module OpenApi
|
|
27
28
|
doc = { openapi: '3.0.0', **settings.slice(:info, :servers) }.merge!(
|
28
29
|
security: settings[:global_security], tags: [ ], paths: { },
|
29
30
|
components: {
|
30
|
-
securitySchemes:
|
31
|
-
|
31
|
+
securitySchemes: settings[:securitySchemes] || { },
|
32
|
+
schemas: { }, parameters: { }, requestBodies: { }
|
33
|
+
}
|
32
34
|
)
|
33
35
|
|
34
|
-
settings[:base_doc_class].descendants.each do |ctrl|
|
36
|
+
[(bdc = settings[:base_doc_class]), *bdc.descendants].each do |ctrl|
|
35
37
|
doc_info = ctrl.instance_variable_get('@doc_info')
|
36
38
|
next if doc_info.nil?
|
37
39
|
|
data/lib/open_api/version.rb
CHANGED
data/zero-rails_openapi.gemspec
CHANGED
@@ -28,7 +28,7 @@ Gem::Specification.new do |spec|
|
|
28
28
|
spec.add_development_dependency 'rspec', '~> 3.0'
|
29
29
|
spec.add_development_dependency 'simplecov'
|
30
30
|
|
31
|
-
spec.add_runtime_dependency 'colorize'
|
31
|
+
spec.add_runtime_dependency 'colorize'
|
32
32
|
spec.add_runtime_dependency 'activesupport', '>= 3'
|
33
33
|
spec.add_runtime_dependency 'rails', '>= 3'
|
34
34
|
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: zero-rails_openapi
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.5.
|
4
|
+
version: 1.5.7
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- zhandao
|
8
8
|
autorequire:
|
9
9
|
bindir: exe
|
10
10
|
cert_chain: []
|
11
|
-
date: 2018-
|
11
|
+
date: 2018-04-06 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: bundler
|
@@ -70,16 +70,16 @@ dependencies:
|
|
70
70
|
name: colorize
|
71
71
|
requirement: !ruby/object:Gem::Requirement
|
72
72
|
requirements:
|
73
|
-
- -
|
73
|
+
- - ">="
|
74
74
|
- !ruby/object:Gem::Version
|
75
|
-
version: 0
|
75
|
+
version: '0'
|
76
76
|
type: :runtime
|
77
77
|
prerelease: false
|
78
78
|
version_requirements: !ruby/object:Gem::Requirement
|
79
79
|
requirements:
|
80
|
-
- -
|
80
|
+
- - ">="
|
81
81
|
- !ruby/object:Gem::Version
|
82
|
-
version: 0
|
82
|
+
version: '0'
|
83
83
|
- !ruby/object:Gem::Dependency
|
84
84
|
name: activesupport
|
85
85
|
requirement: !ruby/object:Gem::Requirement
|