ditkrg/rswag
5
0
Fork 0
mirror of https://github.com/ditkrg/rswag.git synced 2026-01-25 07:16:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

Modifies parameters and body request/responses to output 3.0 syntax for basic operations.

Browse Source 
SwaggerEditor passes basic output
This commit is contained in:
Jay Danielian
2019-07-14 17:28:11 -04:00
parent 23349b2678
commit c820bb75e0
7 changed files with 226 additions and 85 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
test-app/Rakefile
View File

@@ -4,4 +4,12 @@
require File.expand_path('../config/application', __FILE__)
TestApp::Application.load_tasks
RSpec::Core::RakeTask.new('swaggerize') do |t|
t.pattern = 'spec/requests/**/*_spec.rb, spec/api/**/*_spec.rb, spec/integration/**/*_spec.rb'
t.rspec_opts = [ '--format Rswag::Specs::SwaggerFormatter', '--order defined' ]
end

122
test-app/spec/integration/auth_tests_spec.rb
View File

@@ -1,61 +1,61 @@
# frozen_string_literal: true
require 'swagger_helper'
describe 'Auth Tests API', type: :request, swagger_doc: 'v1/swagger.json' do
path '/auth-tests/basic' do
post 'Authenticates with basic auth' do
tags 'Auth Tests'
operationId 'testBasicAuth'
security [basic_auth: []]
response '204', 'Valid credentials' do
let(:Authorization) { "Basic #{::Base64.strict_encode64('jsmith:jspass')}" }
run_test!
end
response '401', 'Invalid credentials' do
let(:Authorization) { "Basic #{::Base64.strict_encode64('foo:bar')}" }
run_test!
end
end
end
path '/auth-tests/api-key' do
post 'Authenticates with an api key' do
tags 'Auth Tests'
operationId 'testApiKey'
security [api_key: []]
response '204', 'Valid credentials' do
let(:api_key) { 'foobar' }
run_test!
end
response '401', 'Invalid credentials' do
let(:api_key) { 'barfoo' }
run_test!
end
end
end
path '/auth-tests/basic-and-api-key' do
post 'Authenticates with basic auth and api key' do
tags 'Auth Tests'
operationId 'testBasicAndApiKey'
security [{ basic_auth: [], api_key: [] }]
response '204', 'Valid credentials' do
let(:Authorization) { "Basic #{::Base64.strict_encode64('jsmith:jspass')}" }
let(:api_key) { 'foobar' }
run_test!
end
response '401', 'Invalid credentials' do
let(:Authorization) { "Basic #{::Base64.strict_encode64('jsmith:jspass')}" }
let(:api_key) { 'barfoo' }
run_test!
end
end
end
end
# # frozen_string_literal: true
#
# require 'swagger_helper'
#
# describe 'Auth Tests API', type: :request, swagger_doc: 'v1/swagger.json' do
# path '/auth-tests/basic' do
# post 'Authenticates with basic auth' do
# tags 'Auth Tests'
# operationId 'testBasicAuth'
# security [basic_auth: []]
#
# response '204', 'Valid credentials' do
# let(:Authorization) { "Basic #{::Base64.strict_encode64('jsmith:jspass')}" }
# run_test!
# end
#
# response '401', 'Invalid credentials' do
# let(:Authorization) { "Basic #{::Base64.strict_encode64('foo:bar')}" }
# run_test!
# end
# end
# end
#
# path '/auth-tests/api-key' do
# post 'Authenticates with an api key' do
# tags 'Auth Tests'
# operationId 'testApiKey'
# security [api_key: []]
#
# response '204', 'Valid credentials' do
# let(:api_key) { 'foobar' }
# run_test!
# end
#
# response '401', 'Invalid credentials' do
# let(:api_key) { 'barfoo' }
# run_test!
# end
# end
# end
#
# path '/auth-tests/basic-and-api-key' do
# post 'Authenticates with basic auth and api key' do
# tags 'Auth Tests'
# operationId 'testBasicAndApiKey'
# security [{ basic_auth: [], api_key: [] }]
#
# response '204', 'Valid credentials' do
# let(:Authorization) { "Basic #{::Base64.strict_encode64('jsmith:jspass')}" }
# let(:api_key) { 'foobar' }
# run_test!
# end
#
# response '401', 'Invalid credentials' do
# let(:Authorization) { "Basic #{::Base64.strict_encode64('jsmith:jspass')}" }
# let(:api_key) { 'barfoo' }
# run_test!
# end
# end
# end
# end

15
test-app/spec/integration/blogs_spec.rb
View File

@@ -12,7 +12,6 @@ describe 'Blogs API', type: :request, swagger_doc: 'v1/swagger.json' do
operationId 'createBlog'
consumes 'application/json'
produces 'application/json'
# parameter name: :blog, in: :body, schema: { '$ref' => '#/components/schemas/blog' }
request_body_json schema: { '$ref' => '#/components/schemas/blog' },
examples: :blog
@@ -20,13 +19,14 @@ describe 'Blogs API', type: :request, swagger_doc: 'v1/swagger.json' do
let(:blog) { { blog: { title: 'foo', content: 'bar' } } }
response '201', 'blog created' do
schema '$ref' => '#/components/schemas/blog'
run_test!
end
response '422', 'invalid request' do
schema '$ref' => '#/components/schemas/errors_object'
let(:blog) { { blog: { title: 'foo' } } }
run_test! do |response|
expect(response.body).to include("can't be blank")
end
@@ -44,6 +44,7 @@ describe 'Blogs API', type: :request, swagger_doc: 'v1/swagger.json' do
response '200', 'success' do
schema type: 'array', items: { '$ref' => '#/components/schemas/blog' }
run_test!
end
response '406', 'unsupported accept header' do
@@ -54,7 +55,7 @@ describe 'Blogs API', type: :request, swagger_doc: 'v1/swagger.json' do
end
path '/blogs/{id}' do
parameter name: :id, in: :path, type: :string
let(:id) { blog.id }
let(:blog) { Blog.create(title: 'foo', content: 'bar', thumbnail: 'thumbnail.png') }
@@ -64,6 +65,8 @@ describe 'Blogs API', type: :request, swagger_doc: 'v1/swagger.json' do
description 'Retrieves a specific blog by id'
operationId 'getBlog'
produces 'application/json'
parameter name: :id, in: :path, type: :string
response '200', 'blog found' do
header 'ETag', type: :string
@@ -90,13 +93,15 @@ describe 'Blogs API', type: :request, swagger_doc: 'v1/swagger.json' do
end
end
# TODO: get this to output to proper 3.0 syntax for multi-part upload body
# https://swagger.io/docs/specification/describing-request-body/file-upload/
path '/blogs/{id}/upload' do
parameter name: :id, in: :path, type: :string
let(:id) { blog.id }
let(:blog) { Blog.create(title: 'foo', content: 'bar') }
put 'Uploads a blog thumbnail' do
parameter name: :id, in: :path, type: :string
tags 'Blogs'
description 'Upload a thumbnail for specific blog by id'
operationId 'uploadThumbnailBlog'

129
test-app/swagger/v1/swagger.json
View File

@@ -13,12 +13,6 @@
],
"description": "Creates a new blog from provided data",
"operationId": "createBlog",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"requestBody": {
"required": true,
"content": {
@@ -32,6 +26,9 @@
}
}
}
},
"schema": {
"$ref": "#/components/schemas/blog"
}
}
}
@@ -49,15 +46,15 @@
"title": "foo",
"content": "bar",
"thumbnail": null
},
"schema": {
"$ref": "#/components/schemas/blog"
}
}
}
},
"422": {
"description": "invalid request",
"schema": {
"$ref": "#/components/schemas/errors_object"
},
"content": {
"application/json": {
"example": {
@@ -66,6 +63,9 @@
"can't be blank"
]
}
},
"schema": {
"$ref": "#/components/schemas/errors_object"
}
}
}
@@ -79,22 +79,125 @@
],
"description": "Searches blogs by keywords",
"operationId": "searchBlogs",
"produces": [
"application/json"
],
"parameters": [
{
"name": "keywords",
"in": "query",
"type": "string"
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/blog"
}
}
}
}
},
"406": {
"description": "unsupported accept header"
}
}
}
},
"/blogs/{id}": {
"get": {
"summary": "Retrieves a blog",
"tags": [
"Blogs"
],
"description": "Retrieves a specific blog by id",
"operationId": "getBlog",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "blog found",
"headers": {
"ETag": {
"schema": {
"type": "string"
}
},
"Last-Modified": {
"schema": {
"type": "string"
}
},
"Cache-Control": {
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"example": {
"id": 1,
"title": "Hello world!",
"content": "Hello world and hello universe. Thank you all very much!!!",
"thumbnail": "thumbnail.png"
},
"schema": {
"$ref": "#/components/schemas/blog"
}
}
}
},
"404": {
"description": "blog not found"
}
}
}
},
"/blogs/{id}/upload": {
"put": {
"summary": "Uploads a blog thumbnail",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "file",
"in": "formData",
"required": true,
"schema": {
"type": "file"
}
}
],
"tags": [
"Blogs"
],
"description": "Upload a thumbnail for specific blog by id",
"operationId": "uploadThumbnailBlog",
"responses": {
"200": {
"description": "blog updated"
}
}
}
}
},
"servers": [