RubyGems - r2-oas - Versions diffs - 0.1.2 → 0.3.2 - Mend

r2-oas 0.1.2 → 0.3.2

Files changed (83) hide show

checksums.yaml +4 -4
data/.gitignore +4 -0
data/.rubocop.yml +6 -3
data/.rubocop_todo.yml +68 -1
data/.travis.yml +6 -2
data/Appraisals +13 -0
data/CHANGELOG.md +51 -0
data/GEMSPEC.md +20 -0
data/README.ja.md +71 -0
data/README.md +70 -0
data/lib/r2-oas.rb +3 -4
data/lib/r2-oas/deploy/client.rb +33 -6
data/lib/r2-oas/errors.rb +1 -0
data/lib/r2-oas/lib/core_ext/hash/deep_merge.rb +44 -0
data/lib/r2-oas/lib/core_ext/object/blank.rb +135 -0
data/lib/r2-oas/lib/three-way-merge/twm.rb +83 -0
data/lib/r2-oas/schema/builder.rb +23 -0
data/lib/r2-oas/schema/editor.rb +26 -7
data/lib/r2-oas/schema/generator.rb +1 -1
data/lib/r2-oas/schema/manager/file_manager.rb +26 -0
data/lib/r2-oas/schema/ui.rb +0 -1
data/lib/r2-oas/schema/v3/analyzer/base_analyzer.rb +1 -6
data/lib/r2-oas/schema/v3/analyzer/components/object_analyzer.rb +1 -1
data/lib/r2-oas/schema/v3/analyzer/path_analyzer.rb +1 -1
data/lib/r2-oas/schema/v3/analyzer/tag_analyzer.rb +1 -1
data/lib/r2-oas/schema/v3/builder.rb +28 -0
data/lib/r2-oas/schema/v3/builder/base_builder.rb +60 -0
data/lib/r2-oas/schema/v3/builder/doc_builder.rb +43 -0
data/lib/r2-oas/schema/v3/cleaner/base_cleaner.rb +1 -1
data/lib/r2-oas/schema/v3/generator.rb +1 -5
data/lib/r2-oas/schema/v3/generator/base_generator.rb +30 -1
data/lib/r2-oas/schema/v3/generator/components/object_generator.rb +6 -25
data/lib/r2-oas/schema/v3/generator/components/request_body_generator.rb +6 -6
data/lib/r2-oas/schema/v3/generator/doc_generator.rb +84 -18
data/lib/r2-oas/schema/v3/generator/path_generator.rb +7 -19
data/lib/r2-oas/schema/v3/generator/schema_generator.rb +6 -26
data/lib/r2-oas/schema/v3/manager/file/base_file_manager.rb +10 -4
data/lib/r2-oas/schema/v3/manager/pathname_manager.rb +6 -1
data/lib/r2-oas/store.rb +118 -0
data/lib/r2-oas/task_logging.rb +6 -0
data/lib/r2-oas/tasks/main.rake +66 -73
data/lib/r2-oas/tasks/tool.rake +32 -28
data/lib/r2-oas/tool/paths/ls.rb +1 -1
data/lib/r2-oas/version.rb +1 -1
data/r2-oas.gemspec +19 -10
metadata +88 -60
data/.github/ISSUE_TEMPLATE.md +0 -12
data/.github/PULL_REQUEST_TEMPLATE.md +0 -12
data/Gemfile.lock +0 -222
data/bin/console +0 -12
data/bin/setup +0 -8
data/docs/.nojekyll +0 -0
data/docs/README.md +0 -326
data/docs/_sidebar.md +0 -22
data/docs/index.html +0 -28
data/docs/schema/3.0.0.md +0 -155
data/docs/setting/COC.md +0 -14
data/docs/setting/CORS.md +0 -22
data/docs/setting/configure.md +0 -163
data/docs/usage/analyze_docs.md +0 -875
data/docs/usage/clean_docs.md +0 -19
data/docs/usage/deploy_docs.md +0 -839
data/docs/usage/display_paths_list.md +0 -35
data/docs/usage/display_paths_stats.md +0 -54
data/docs/usage/edit_docs.md +0 -218
data/docs/usage/generate_docs.md +0 -256
data/docs/usage/monitor_docs.md +0 -219
data/docs/usage/use_hook_methods.md +0 -236
data/docs/usage/use_hook_to_generate_docs.md +0 -235
data/docs/usage/use_schema_namespace.md +0 -183
data/docs/usage/use_tag_namespace.md +0 -182
data/docs/usage/view_docs.md +0 -262
data/lib/r2-oas/deploy/swagger-ui/dist/favicon-16x16.png +0 -0
data/lib/r2-oas/deploy/swagger-ui/dist/favicon-32x32.png +0 -0
data/lib/r2-oas/deploy/swagger-ui/dist/oauth2-redirect.html +0 -68
data/lib/r2-oas/deploy/swagger-ui/dist/swagger-ui-bundle.js +0 -134
data/lib/r2-oas/deploy/swagger-ui/dist/swagger-ui-bundle.js.map +0 -1
data/lib/r2-oas/deploy/swagger-ui/dist/swagger-ui-standalone-preset.js +0 -22
data/lib/r2-oas/deploy/swagger-ui/dist/swagger-ui-standalone-preset.js.map +0 -1
data/lib/r2-oas/deploy/swagger-ui/dist/swagger-ui.css +0 -4
data/lib/r2-oas/deploy/swagger-ui/dist/swagger-ui.css.map +0 -1
data/lib/r2-oas/deploy/swagger-ui/dist/swagger-ui.js +0 -9
data/lib/r2-oas/deploy/swagger-ui/dist/swagger-ui.js.map +0 -1

@@ -1,22 +0,0 @@
-<!-- docs/_sidebar.md -->
-* **Usage**
- * [Generate Docs](/usage/generate_docs)
- * [Edit docs](/usage/edit_docs)
- * [View docs](/usage/view_docs)
- * [Monitor Docs](/usage/monitor_docs)
- * [Analyze Docs](/usage/analyze_docs)
- * [Use Hook to Generate Docs](/usage/use_hook_to_generate_docs)
- * [Use schema namespace](/usage/use_schema_namespace)
- * [Use tag namespace](/usage/use_tag_namespace)
- * [Use hook methods](/usage/use_hook_methods)
- * [Deploy docs](/usage/deploy_docs)
- * [Clean Docs](/usage/clean_docs)
- * [Display Paths Lists](/usage/display_paths_list)
- * [Display Paths Stats](/usage/display_paths_stats)
-* **Configure**
- * [COC](/setting/COC)
- * [Configure](/setting/configure)
- * [CORS](/setting/CORS)
-* **Support Schema**
- * [3.0.0](/schema/3.0.0)

data/docs/index.html DELETED

@@ -1,28 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <title>Document</title>
-  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
-  <meta name="description" content="Description">
-  <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
-  <link rel="stylesheet" href="//unpkg.com/docsify/lib/themes/vue.css">
-</head>
-<body>
-  <div id="app"></div>
-  <script>
-    window.$docsify = {
-      auto2top: true,
-      name: '<span>r2-oas</span>',
-      repo: 'https://github.com/yukihirop/r2-oas',
-      loadSidebar: true,
-      subMaxLevel: 2
-    }
-  </script>
-  <script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
-  <script src="//unpkg.com/docsify/lib/plugins/search.min.js"></script>
-  <script src="//unpkg.com/docsify/lib/plugins/emoji.min.js"></script>
-  <script src="//cdn.jsdelivr.net/npm/prismjs/components/prism-ruby.min.js"></script>
-  <script src="//cdn.jsdelivr.net/npm/prismjs/components/prism-bash.min.js"></script>
-</body>
-</html>

data/docs/schema/3.0.0.md DELETED

@@ -1,155 +0,0 @@
-# 3.0.0
-## Support Schema
-Generate schema yaml like this:
-- Schema
-  - openapi
-  - info
-  - tags
-  - paths
-  - externalDocs
-  - servers
-  - security
-  - components
-    - schemas
-    - requestBodies
-    - securitySchemes
-    - parameters
-    - responses (experimental)
-    - examples (experimental)
-    - headers (experimental)
-    - links (experimental)
-    - callbacks (experimental)
-## openapi
-Support field like this:
-|field name|field type|
-|----------|----------|
-|`openapi`|`string`|
-[show more...](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#openapi-object)
-## info
-Support field like this:
-|field name|field type|
-|----------|----------|
-|`title`|`string`|
-|`description`|`string`|
-|`termsOfService`|`string`|
-|`contact`|`Contact Object`|
-|`license`|`License Object`|
-|`version`|`string`|
-[show more...](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#info-object)
-## tags
-Support field like this:
-|field name|field type|
-|----------|----------|
-|`name`|`string`|
-|`description`|`string`|
-|`externalDocs`|`External Document Object`|
-[show more...](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#tagObject)
-## paths
-Support field like this:
-|field name|field type|
-|----------|----------|
-|`/{path}`|`Path Item Object`|
-[show more...](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#paths-object)
-for example:
-```
-paths:
-  "/users":
-    post:
-      tags:
-      - user
-      summary: post summary
-      description: post description
-      responses:
-        default:
-          description: ''
-      deprecated: false
-  "/{model_name}/{id}":
-    get:
-      tags:
-      - rails_admin/main
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/main description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Main"
-      deprecated: false
-      parameters:
-      - name: model_name
-        in: path
-        description: model_name
-        required: true
-        schema:
-          type: string
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-```
-## externalDocs
-Support field like this:
-|field name|field type|
-|----------|----------|
-|`description`|`string`|
-|`url`|`string`|
-[show more...](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#external-documentation-object)
-## servers
-Support field like this:
-|field name|field type|
-|----------|----------|
-|`url`|`string`|
-|`description`|`string`|
-[show more...](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#server-object)
-## components
-Support field like this:
-|field name|field type|
-|----------|----------|
-|`schemas`| `Schema Object` |
-|`requestBodies`| `Request Body Object`|
-|`securitySchemes`| `Security Schemes Object` |
-|`parameters`| `Parameter Object` |
-|`responses`| `Response Object` |
-|`examples`| `Example Object` |
-|`headers`| `Header Object` |
-|`links`|`Link Object` |
-|`callbacks`| `Callback Object`|
-[show more...](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#components-object)

data/docs/setting/COC.md DELETED

@@ -1,14 +0,0 @@
-# ❗️Convention over Configuration (CoC)
-- `tag name` represents `controller name` and determine `paths file name`.
-  - For example, If `controller name` is `Api::V1::UsersController`, `tag_name` is `api/v1/user`. and `paths file name` is `api/v1/user.yml`
-- `_` of `components/{schemas,requestBodies, ...} name` convert `/` when save file.
-  - For example, If `components/schemas name` is `Api_V1_User`, `components/schemas file name` is `api/v1/user.yml`.
-  - `_` is supposed to be used to express `namespace`.
-  - format is `Namespace1_Namespace2_Model`.
-- `.` of `components/{schemas,requestBodies, ...} name` convert `/` when save file.
-  - For example, If `components/schemas name` is `api.v1.User`, `components/schemas file name` is `api/v1/user.yml`.
-  - `.` is supposed to be used to express `namespace`.
-  - format is `namespace1.namespace2.Model`.

data/docs/setting/CORS.md DELETED

@@ -1,22 +0,0 @@
-# CORS
-Use [rack-cors](https://github.com/cyu/rack-cors) to enable CORS.
-```ruby
-require 'rack/cors'
-use Rack::Cors do
-  allow do
-    origins '*'
-    resource '*', headers: :any, methods: [ :get, :post, :put, :delete, :options ]
-  end
-end
-```
-Alternatively you can set CORS headers in a `before` block.
-```ruby
-before do
-  header['Access-Control-Allow-Origin'] = '*'
-  header['Access-Control-Request-Method'] = '*'
-end
-```

data/docs/setting/configure.md DELETED

@@ -1,163 +0,0 @@
-## Configure
-All settings are `optional`. The initial value is as follows.
-In your rails project, Write `config/environments/development.rb` like that:
-```ruby
-# default setting
-R2OAS.configure do |config|
-  config.version                            = :v3
-  config.root_dir_path                      = "./oas_docs"
-  config.schema_save_dir_name               = "src"
-  config.doc_save_file_name                 = "oas_doc.yml"
-  config.force_update_schema                = false
-  config.use_tag_namespace                  = true
-  config.use_schema_namespace               = false
-  config.interval_to_save_edited_tmp_schema = 15
-  # :dot or :underbar
-  config.namespace_type                     = :underbar
-  config.deploy_dir_path                    = "./deploy_docs"
-  config.server.data = [
-    {
-      url: "http://localhost:3000",
-      description: "localhost"
-    }
-  ]
-  config.swagger.configure do |swagger|
-    swagger.ui.image            = "swaggerapi/swagger-ui"
-    swagger.ui.port             = "8080"
-    swagger.ui.exposed_port     = "8080/tcp"
-    swagger.ui.volume           = "/app/swagger.json"
-    swagger.editor.image        = "swaggerapi/swagger-editor"
-    swagger.editor.port         = "81"
-    swagger.editor.exposed_port = "8080/tcp"
-  end
-  config.use_object_classes = {
-    info_object:                    R2OAS::Schema::V3::InfoObject,
-    paths_object:                   R2OAS::Schema::V3::PathsObject,
-    path_item_object:               R2OAS::Schema::V3::PathItemObject,
-    external_document_object:       R2OAS::Schema::V3::ExternalDocumentObject,
-    components_object:              R2OAS::Schema::V3::ComponentsObject,
-    components_schema_object:       R2OAS::Schema::V3::Components::SchemaObject,
-    components_request_body_object: R2OAS::Schema::V3::Components::RequestBodyObject
-  }
-  config.http_statuses_when_http_method = {
-    get: {
-      default: %w(200 422),
-      path_parameter: %w(200 404 422)
-    },
-    post: {
-      default: %w(201 422),
-      path_parameter: %w(201 404 422)
-    },
-    patch: {
-      default: %w(204 422),
-      path_parameter: %w(204 404 422)
-    },
-    put: {
-      default: %w(204 422),
-      path_parameter: %w(204 404 422)
-    },
-    delete: {
-      default: %w(200 422),
-      path_parameter: %w(200 404 422)
-    }
-  }
-  config.http_methods_when_generate_request_body = %w[post patch put]
-  config.ignored_http_statuses_when_generate_component_schema = %w[204 404]
-  config.tool.paths_stats.configure do |paths_stats|
-    paths_stats.month_to_turn_to_warning_color = 3
-    paths_stats.warning_color                  = :red
-    paths_stats.table_title_color              = :yellow
-    paths_stats.heading_color                  = :yellow
-    paths_stats.highlight_color                = :magenta
-  end
-end
-```
-we explain the options that can be set.
-#### basic
-|option|description|default|
-|------|-----------|---|
-|version|OpenAPI schema version| `:v3` |
-|root_dir_path|Root directory for storing products.| `"./oas_docs"` |
-|schema_save_dir_name|Directory name for storing swagger schemas|`"src"`|
-|doc_save_file_name|File name for storing swagger doc|`"oas_doc.yml"`|
-|force_update_schema|Force update schema from routes data|`false`|
-|use_tag_namespace|Use namespace for tag name|`true`|
-|use_schema_namespace|Use namespace for schema name|`true`|
-|interval_to_save_edited_tmp_schema|Interval(sec) to save edited tmp schema|`15`|
-|http_statuses_when_http_method|Determine the response to support for each HTTP method|omission...|
-|http_methods_when_generate_request_body|HTTP methods when generate requestBody|`[post put patch]`|
-|ignored_http_statuses_when_generate_component_schema|Ignore HTTP statuses when generate component schema|`[204 404]`|
-|namespace_type|namespace for components(schemas/requestBodies) name| `underbar` |
-|deploy_dir_path|deploy directory.|`"./deploy_docs"`|
-#### server
-|option|children option|description|default|
-|------|---------------|-----------|-------|
-|server|data|Server data (url, description) |[{ url: `http://localhost:3000`, description: `localhost` }] |
-#### swagger
-|option|children option|grandchild option|description|default|
-|------|---------------|-----------------|-----------|-------|
-|swagger|ui|image|Swagger UI Docker Image|`"swaggerapi/swagger-ui"`|
-|swagger|ui|port|Swagger UI Port|`"8080"`|
-|swagger|ui|exposed_port|Swagger UI Exposed Port|`"8080/tcp"`|
-|swagger|ui|volume|Swagger UI Volume|`"/app/swagger.json"`|
-|swagger|editor|image|Swagger Editor Docker Image|`"swaggerapi/swagger-editor"`|
-|swagger|editor|port|Swagger Editor Port|`"8080"`|
-|swagger|editor|exposed_port|Swagger Editor Exposed Port|`"8080/tcp"`|
-#### hook
-|option|description|default|
-|------|-----------|-------|
-|use_object_classes|Object class(hook class) to generate Openapi document|{ info_object: `R2OAS::Schema::V3::InfoObject`,<br>paths_object: `R2OAS::Schema::V3::PathsObject`,<br>path_item_object: `R2OAS::Schema::V3::PathItemObject`, external_document_object: `R2OAS::Schema::V3::ExternalDocumentObject`,<br> components_object: `R2OAS::Schema::V3::ComponentsObject`,<br> components_schema_object: `R2OAS::Schema::V3::Components::SchemaObject`, <br> components_request_body_object:`R2OAS::Schema::V3::Components::RequestBodyObject` }|
-#### tool
-|option|children option|grandchild option|description|default|
-|------|---------------|-----------------|-----------|-------|
-|tool|paths_stats|month_to_turn_to_warning_color|Elapsed month to issue a warning|`3`|
-|tool|paths_stats|warning_color|Warning Color|`:red`|
-|tool|paths_stats|table_title_color|Table Title Color|`:yellow`|
-|tool|paths_stats|heading_color|Heading Color|`:yellow`|
-|tool|paths_stats|highlight_color|Highlight Color|`:magenta`|
-Please refer to [here](https://github.com/janlelis/paint) for the color.
-## Environment variables
-We explain the environment variables that can be set.
-|variable|description|default|
-|--------|-----------|-------|
-|PATHS_FILE|Specify one paths file path|`""`|
-|OAS_FILE|Specify swagger file path to analyze|`""`|
-## .paths
-Writing file paths in .paths will only read them.
-You can comment out with `#`
-`oas_docs/.paths`
-```
-#account_user_role.yml    # ignore
-account.yml
-account.yml               # ignore
-account.yml               # ignore
-```

data/docs/usage/analyze_docs.md DELETED

@@ -1,875 +0,0 @@
-# Analyze docs
-## Prepare
-Add this line to your application's Gemfile:
-```ruby
-group :development do
-  gem 'r2-oas'
-end
-```
-## Command
-```bash
-$ OAS_FILE="~/Desktop/swagger_file.yml" bundle exec rake routes:oas:analyze
-```
-## Example
-if there is `swagger_file.yml` like this:
-<details>
-```yaml
----
-openapi: 3.0.0
-paths:
-  "/users":
-    post:
-      tags:
-      - user
-      summary: post summary
-      description: post description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: user description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/User"
-      deprecated: false
-  "/users/new":
-    get:
-      tags:
-      - user
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: user description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/User"
-      deprecated: false
-  "/users/:id/edit":
-    get:
-      tags:
-      - user
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: user description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/User"
-      deprecated: false
-      parameters:
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/users/:id":
-    delete:
-      tags:
-      - user
-      summary: delete summary
-      description: delete description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: user description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/User"
-      deprecated: false
-      parameters:
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/api/v1/tasks":
-    post:
-      tags:
-      - api/v1/task
-      summary: post summary
-      description: post description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: api/v1/task description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Task"
-      deprecated: false
-  "/api/v1/tasks/new":
-    get:
-      tags:
-      - api/v1/task
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: api/v1/task description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Task"
-      deprecated: false
-  "/api/v1/tasks/:id/edit":
-    get:
-      tags:
-      - api/v1/task
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: api/v1/task description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Task"
-      deprecated: false
-      parameters:
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/api/v1/tasks/:id":
-    delete:
-      tags:
-      - api/v1/task
-      summary: delete summary
-      description: delete description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: api/v1/task description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Task"
-      deprecated: false
-      parameters:
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/api/v1/posts":
-    post:
-      tags:
-      - api/v1/post
-      summary: post summary
-      description: post description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: api/v1/post description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Post"
-      deprecated: false
-  "/api/v1/posts/new":
-    get:
-      tags:
-      - api/v1/post
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: api/v1/post description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Post"
-      deprecated: false
-  "/api/v1/posts/:id/edit":
-    get:
-      tags:
-      - api/v1/post
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: api/v1/post description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Post"
-      deprecated: false
-      parameters:
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/api/v1/posts/:id":
-    delete:
-      tags:
-      - api/v1/post
-      summary: delete summary
-      description: delete description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: api/v1/post description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Post"
-      deprecated: false
-      parameters:
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/api/v2/posts":
-    post:
-      tags:
-      - api/v2/post
-      summary: post summary
-      description: post description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: responses description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Post"
-      deprecated: false
-  "/api/v2/posts/new":
-    get:
-      tags:
-      - api/v2/post
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: responses description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Post"
-      deprecated: false
-  "/api/v2/posts/:id/edit":
-    get:
-      tags:
-      - api/v2/post
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: responses description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Post"
-      deprecated: false
-      parameters:
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/api/v2/posts/:id":
-    delete:
-      tags:
-      - api/v2/post
-      summary: delete summary
-      description: delete description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: responses description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Post"
-      deprecated: false
-      parameters:
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/tasks":
-    post:
-      tags:
-      - task
-      summary: post summary
-      description: post description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: task description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Task"
-      deprecated: false
-  "/tasks/new":
-    get:
-      tags:
-      - task
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: task description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Task"
-      deprecated: false
-  "/tasks/:id/edit":
-    get:
-      tags:
-      - task
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: task description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Task"
-      deprecated: false
-      parameters:
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/tasks/:id":
-    delete:
-      tags:
-      - task
-      summary: delete summary
-      description: delete description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: task description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Task"
-      deprecated: false
-      parameters:
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/subadmin":
-    get:
-      tags:
-      - rails_admin/engine
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/engine description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Engine"
-      deprecated: false
-  "/admin":
-    get:
-      tags:
-      - rails_admin/engine
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/engine description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Engine"
-      deprecated: false
-  "/":
-    get:
-      tags:
-      - rails_admin/main
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/main description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Main"
-      deprecated: false
-  "/:model_name":
-    post:
-      tags:
-      - rails_admin/main
-      summary: post summary
-      description: post description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/main description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Main"
-      deprecated: false
-      parameters:
-      - name: model_name
-        in: path
-        description: model_name
-        required: true
-        schema:
-          type: string
-  "/:model_name/new":
-    post:
-      tags:
-      - rails_admin/main
-      summary: post summary
-      description: post description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/main description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Main"
-      deprecated: false
-      parameters:
-      - name: model_name
-        in: path
-        description: model_name
-        required: true
-        schema:
-          type: string
-  "/:model_name/export":
-    post:
-      tags:
-      - rails_admin/main
-      summary: post summary
-      description: post description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/main description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Main"
-      deprecated: false
-      parameters:
-      - name: model_name
-        in: path
-        description: model_name
-        required: true
-        schema:
-          type: string
-  "/:model_name/bulk_delete":
-    delete:
-      tags:
-      - rails_admin/main
-      summary: delete summary
-      description: delete description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/main description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Main"
-      deprecated: false
-      parameters:
-      - name: model_name
-        in: path
-        description: model_name
-        required: true
-        schema:
-          type: string
-  "/:model_name/bulk_action":
-    post:
-      tags:
-      - rails_admin/main
-      summary: post summary
-      description: post description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/main description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Main"
-      deprecated: false
-      parameters:
-      - name: model_name
-        in: path
-        description: model_name
-        required: true
-        schema:
-          type: string
-  "/:model_name/:id":
-    get:
-      tags:
-      - rails_admin/main
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/main description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Main"
-      deprecated: false
-      parameters:
-      - name: model_name
-        in: path
-        description: model_name
-        required: true
-        schema:
-          type: string
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/:model_name/:id/edit":
-    put:
-      tags:
-      - rails_admin/main
-      summary: put summary
-      description: put description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/main description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Main"
-      deprecated: false
-      parameters:
-      - name: model_name
-        in: path
-        description: model_name
-        required: true
-        schema:
-          type: string
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/:model_name/:id/delete":
-    delete:
-      tags:
-      - rails_admin/main
-      summary: delete summary
-      description: delete description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/main description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Main"
-      deprecated: false
-      parameters:
-      - name: model_name
-        in: path
-        description: model_name
-        required: true
-        schema:
-          type: string
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-  "/:model_name/:id/show_in_app":
-    get:
-      tags:
-      - rails_admin/main
-      summary: get summary
-      description: get description
-      responses:
-        default:
-          description: ''
-        '200':
-          description: rails_admin/main description
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/schemas/Main"
-      deprecated: false
-      parameters:
-      - name: model_name
-        in: path
-        description: model_name
-        required: true
-        schema:
-          type: string
-      - name: id
-        in: path
-        description: id
-        required: true
-        schema:
-          type: integer
-externalDocs:
-  description: ''
-  url: ''
-tags:
-- name: rails_admin/engine
-  description: rails_admin/engine description
-  externalDocs:
-    description: description
-    url: url
-- name: api/v2/post
-  description: api/v2/post description
-  externalDocs:
-    description: description
-    url: url
-- name: api/v1/post
-  description: api/v1/post description
-  externalDocs:
-    description: description
-    url: url
-- name: api/v1/task
-  description: api/v1/task description
-  externalDocs:
-    description: description
-    url: url
-- name: task
-  description: task description
-  externalDocs:
-    description: description
-    url: url
-- name: user
-  description: user description
-  externalDocs:
-    description: description
-    url: url
-- name: rails_admin/main
-  description: rails_admin/main description
-  externalDocs:
-    description: description
-    url: url
-components:
-  schemas:
-    User:
-      type: object
-      properties:
-        id:
-          type: integer
-          format: int64
-    Task:
-      type: object
-      properties:
-        id:
-          type: integer
-          format: int64
-    Engine:
-      type: object
-      properties:
-        id:
-          type: integer
-          format: int64
-    Main:
-      type: object
-      properties:
-        id:
-          type: integer
-          format: int64
-    Post:
-      type: object
-      properties:
-        id:
-          type: integer
-          format: int64
-info:
-  title: Swagger API Document Title
-  description: |-
-    This is a sample server Petstore server.  You can find out more about
-                Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net,
-                #swagger](http://swagger.io/irc/).  For this sample, you can use the api key
-                `special-key` to test the authorization filters.
-  termsOfService: http://swagger.io/terms/
-  contact:
-    name: ''
-    url: ''
-  license:
-    name: ''
-    url: ''
-  version: 1.0.0
-servers:
-- url: http://localhost:3000
-  description: localhost
-```
-</details>
-```
-$ OAS_FILE=~/Desktop/swagger_file.yml be rake routes:oas:analyze
-I, [2019-05-05T15:00:40.716815 #18669]  INFO -- : [R2-OAS] start
-I, [2019-05-05T15:00:40.756046 #18669]  INFO -- : [Analyze Swagger file] start
-I, [2019-05-05T15:00:40.758453 #18669]  INFO -- : [Analyze Swagger file (paths)] start
-I, [2019-05-05T15:00:40.763028 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/user.yml
-I, [2019-05-05T15:00:40.775377 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/api/v1/task.yml
-I, [2019-05-05T15:00:40.776937 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/api/v1/post.yml
-I, [2019-05-05T15:00:40.778774 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/api/v2/post.yml
-I, [2019-05-05T15:00:40.780856 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/task.yml
-I, [2019-05-05T15:00:40.782192 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/rails_admin/engine.yml
-I, [2019-05-05T15:00:40.787576 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/rails_admin/main.yml
-I, [2019-05-05T15:00:40.787615 #18669]  INFO -- : [Analyze Swagger file (paths)] end
-I, [2019-05-05T15:00:40.788014 #18669]  INFO -- : [Analyze Swagger file (tags)] start
-I, [2019-05-05T15:00:40.788948 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/tags.yml
-I, [2019-05-05T15:00:40.788972 #18669]  INFO -- : [Analyze Swagger file (tags)] end
-I, [2019-05-05T15:00:40.788985 #18669]  INFO -- : [Analyze Swagger file (components)] start
-I, [2019-05-05T15:00:40.788999 #18669]  INFO -- : [Analyze Swagger file (components/schemas)] start
-I, [2019-05-05T15:00:40.790696 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/components/schemas/user.yml
-I, [2019-05-05T15:00:40.791151 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/components/schemas/task.yml
-I, [2019-05-05T15:00:40.791635 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/components/schemas/engine.yml
-I, [2019-05-05T15:00:40.792107 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/components/schemas/main.yml
-I, [2019-05-05T15:00:40.792495 #18669]  INFO -- :   Write schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/components/schemas/post.yml
-I, [2019-05-05T15:00:40.792515 #18669]  INFO -- : [Analyze Swagger file (components/schemas)] end
-I, [2019-05-05T15:00:40.792526 #18669]  INFO -- : [Analyze Swagger file (components)] end
-I, [2019-05-05T15:00:40.793238 #18669]  INFO -- : [Analyze Swagger file] end
-I, [2019-05-05T15:00:40.848054 #18669]  INFO -- : [Generate Swagger schema files] start
-I, [2019-05-05T15:00:40.848102 #18669]  INFO -- : [Generate Swagger schema files] end
-I, [2019-05-05T15:00:40.848115 #18669]  INFO -- : [Generate Swagger docs from schema files] start
-I, [2019-05-05T15:00:40.848612 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/openapi.yml
-I, [2019-05-05T15:00:40.849247 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/user.yml
-I, [2019-05-05T15:00:40.850005 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/api/v1/task.yml
-I, [2019-05-05T15:00:40.850882 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/api/v1/post.yml
-I, [2019-05-05T15:00:40.851566 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/api/v2/post.yml
-I, [2019-05-05T15:00:40.852122 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/task.yml
-I, [2019-05-05T15:00:40.852441 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/rails_admin/engine.yml
-I, [2019-05-05T15:00:40.853853 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/paths/rails_admin/main.yml
-I, [2019-05-05T15:00:40.853983 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/externalDocs.yml
-I, [2019-05-05T15:00:40.854312 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/tags.yml
-I, [2019-05-05T15:00:40.854465 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/components/schemas/user.yml
-I, [2019-05-05T15:00:40.854613 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/components/schemas/task.yml
-I, [2019-05-05T15:00:40.854796 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/components/schemas/engine.yml
-I, [2019-05-05T15:00:40.854978 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/components/schemas/main.yml
-I, [2019-05-05T15:00:40.855185 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/components/schemas/post.yml
-I, [2019-05-05T15:00:40.855543 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/info.yml
-I, [2019-05-05T15:00:40.855888 #18669]  INFO -- :  Use schema file: 	/Users/yukihirop/RubyProjects/r2-oas/oas_docs/src/servers.yml
-I, [2019-05-05T15:00:40.872235 #18669]  INFO -- : [Generate Swagger docs from schema files] end
-I, [2019-05-05T15:00:40.872286 #18669]  INFO -- : [R2-OAS] end
-```
-Generate like this:
-```
-$ tree ../oas_docs
-../oas_docs
-├── schema
-│   ├── components
-│   │   └── schemas
-│   │       ├── engine.yml
-│   │       ├── main.yml
-│   │       ├── post.yml
-│   │       ├── task.yml
-│   │       └── user.yml
-│   ├── externalDocs.yml
-│   ├── info.yml
-│   ├── openapi.yml
-│   ├── paths
-│   │   ├── api
-│   │   │   ├── v1
-│   │   │   │   ├── post.yml
-│   │   │   │   └── task.yml
-│   │   │   └── v2
-│   │   │       └── post.yml
-│   │   ├── rails_admin
-│   │   │   ├── engine.yml
-│   │   │   └── main.yml
-│   │   ├── task.yml
-│   │   └── user.yml
-│   ├── servers.yml
-│   └── tags.yml
-└── oas_doc.yml
-8 directories, 18 files
-```