RubyGems - r2-oas - Versions diffs - 0.3.0 → 0.4.0 - Mend

r2-oas 0.3.0 → 0.4.0

Files changed (129) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +45 -0
data/GEMSPEC.md +4 -3
data/README.ja.md +54 -37
data/README.md +50 -31
data/lib/r2-oas.rb +5 -7
data/lib/r2-oas/app_configuration.rb +17 -1
data/lib/r2-oas/app_configuration/deprecation.rb +28 -0
data/lib/r2-oas/configuration.rb +52 -0
data/lib/r2-oas/deploy/client.rb +21 -6
data/lib/r2-oas/{plugins/schema/v3/object → dynamic/schema/v3/object/from_routes}/hookable_base_object.rb +7 -7
data/lib/r2-oas/errors.rb +5 -0
data/lib/r2-oas/hooks/hook.rb +7 -5
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/pluggable_configuration.rb +8 -5
data/lib/r2-oas/plugin/base.rb +44 -0
data/lib/r2-oas/plugin/executor.rb +148 -0
data/lib/r2-oas/plugin/hookable.rb +42 -0
data/lib/r2-oas/plugin/public.rb +3 -0
data/lib/r2-oas/plugin/transform/transform.rb +10 -0
data/lib/r2-oas/plugin/transform/v3/transform.rb +20 -0
data/lib/r2-oas/plugin/transform/v3/visitable.rb +37 -0
data/lib/r2-oas/public.rb +5 -0
data/lib/r2-oas/schema/base.rb +1 -1
data/lib/r2-oas/schema/builder.rb +1 -1
data/lib/r2-oas/schema/editor.rb +8 -1
data/lib/r2-oas/schema/v3/analyzer/path_analyzer.rb +1 -1
data/lib/r2-oas/schema/v3/builder.rb +1 -1
data/lib/r2-oas/schema/v3/builder/base_builder.rb +14 -2
data/lib/r2-oas/schema/v3/builder/doc_builder.rb +10 -2
data/lib/r2-oas/schema/v3/generator/base_generator.rb +7 -2
data/lib/r2-oas/schema/v3/generator/doc_generator.rb +1 -1
data/lib/r2-oas/schema/v3/manager/file/include_ref_base_file_manager.rb +3 -2
data/lib/r2-oas/schema/v3/object/from_files/base_object.rb +62 -0
data/lib/r2-oas/schema/v3/object/from_files/components/request_body_object.rb +103 -0
data/lib/r2-oas/schema/v3/object/from_files/components/schema_object.rb +102 -0
data/lib/r2-oas/schema/v3/object/from_files/components_object.rb +46 -0
data/lib/r2-oas/schema/v3/object/from_files/external_document_object.rb +23 -0
data/lib/r2-oas/schema/v3/object/from_files/info_object.rb +23 -0
data/lib/r2-oas/schema/v3/object/from_files/openapi_object.rb +61 -0
data/lib/r2-oas/schema/v3/object/from_files/path_item_object.rb +110 -0
data/lib/r2-oas/schema/v3/object/from_files/paths_object.rb +33 -0
data/lib/r2-oas/schema/v3/object/from_files/utils/all.rb +4 -0
data/lib/r2-oas/schema/v3/object/from_files/utils/deep_methods.rb +27 -0
data/lib/r2-oas/schema/v3/object/from_files/utils/refs.rb +151 -0
data/lib/r2-oas/schema/v3/object/{base_object.rb → from_routes/base_object.rb} +11 -1
data/lib/r2-oas/schema/v3/object/{components → from_routes/components}/request_body_object.rb +23 -19
data/lib/r2-oas/schema/v3/object/{components → from_routes/components}/schema_object.rb +16 -12
data/lib/r2-oas/schema/v3/object/{components_object.rb → from_routes/components_object.rb} +11 -11
data/lib/r2-oas/schema/v3/object/from_routes/external_document_object.rb +28 -0
data/lib/r2-oas/schema/v3/object/{info_object.rb → from_routes/info_object.rb} +11 -2
data/lib/r2-oas/schema/v3/object/{openapi_object.rb → from_routes/openapi_object.rb} +12 -11
data/lib/r2-oas/schema/v3/object/{path_item_object.rb → from_routes/path_item_object.rb} +6 -6
data/lib/r2-oas/schema/v3/object/{paths_object.rb → from_routes/paths_object.rb} +11 -8
data/lib/r2-oas/schema/v3/object/{public.rb → from_routes/public.rb} +0 -0
data/lib/r2-oas/schema/v3/object/{server_object.rb → from_routes/server_object.rb} +0 -0
data/lib/r2-oas/schema/v3/object/{tag_object.rb → from_routes/tag_object.rb} +2 -1
data/lib/r2-oas/schema/v3/object/store.rb +54 -0
data/lib/r2-oas/shared/all.rb +1 -0
data/lib/r2-oas/shared/callable.rb +17 -0
data/lib/r2-oas/store.rb +20 -16
data/lib/r2-oas/support/deprecation.rb +24 -0
data/lib/r2-oas/support/deprecation/behavior.rb +21 -0
data/lib/r2-oas/support/deprecation/instance_delegator.rb +42 -0
data/lib/r2-oas/support/deprecation/reporting.rb +91 -0
data/lib/r2-oas/task_logging.rb +3 -7
data/lib/r2-oas/tasks/common.rake +1 -2
data/lib/r2-oas/tasks/main.rake +31 -9
data/lib/r2-oas/tasks/tool.rake +16 -6
data/lib/r2-oas/version.rb +1 -1
data/r2-oas.gemspec +3 -5
metadata +70 -81
data/.github/ISSUE_TEMPLATE.md +0 -12
data/.github/PULL_REQUEST_TEMPLATE.md +0 -12
data/.gitignore +0 -16
data/.rspec +0 -3
data/.rubocop.yml +0 -10
data/.rubocop_todo.yml +0 -282
data/.travis.yml +0 -26
data/Appraisals +0 -13
data/CODE_OF_CONDUCT.md +0 -74
data/Gemfile +0 -12
data/Rakefile +0 -8
data/bin/console +0 -12
data/bin/setup +0 -8
data/devscript/all_support_ruby.sh +0 -43
data/devscript/bundle_for_all_support_ruby.sh +0 -31
data/devscript/rspec_for_all_support_ruby.sh +0 -27
data/docs/.nojekyll +0 -0
data/docs/README.md +0 -173
data/docs/_sidebar.md +0 -25
data/docs/attention/if_clash.md +0 -17
data/docs/index.html +0 -29
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 -176
data/docs/trableshouting/runtime_error.md +0 -44
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 -412
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 -181
data/docs/usage/use_tag_namespace.md +0 -180
data/docs/usage/view_docs.md +0 -262
data/gemfiles/ruby_2.3.3.gemfile +0 -11
data/gemfiles/ruby_2.4.2.gemfile +0 -11
data/gemfiles/ruby_2.5.8.gemfile +0 -11
data/gemfiles/ruby_2.6.6.gemfile +0 -11
data/gemfiles/ruby_2.7.1.gemfile +0 -11
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
data/lib/r2-oas/schema/v3/object/external_document_object.rb +0 -19

@@ -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 OAS file] start
-I, [2019-05-05T15:00:40.758453 #18669]  INFO -- : [Analyze OAS file (paths)] start
-I, [2019-05-05T15:00:40.763028 #18669]  INFO -- :   Write schema file: 	oas_docs/src/paths/user.yml
-I, [2019-05-05T15:00:40.775377 #18669]  INFO -- :   Write schema file: 	oas_docs/src/paths/api/v1/task.yml
-I, [2019-05-05T15:00:40.776937 #18669]  INFO -- :   Write schema file: 	oas_docs/src/paths/api/v1/post.yml
-I, [2019-05-05T15:00:40.778774 #18669]  INFO -- :   Write schema file: 	oas_docs/src/paths/api/v2/post.yml
-I, [2019-05-05T15:00:40.780856 #18669]  INFO -- :   Write schema file: 	oas_docs/src/paths/task.yml
-I, [2019-05-05T15:00:40.782192 #18669]  INFO -- :   Write schema file: 	oas_docs/src/paths/rails_admin/engine.yml
-I, [2019-05-05T15:00:40.787576 #18669]  INFO -- :   Write schema file: 	oas_docs/src/paths/rails_admin/main.yml
-I, [2019-05-05T15:00:40.787615 #18669]  INFO -- : [Analyze OAS file (paths)] end
-I, [2019-05-05T15:00:40.788014 #18669]  INFO -- : [Analyze OAS file (tags)] start
-I, [2019-05-05T15:00:40.788948 #18669]  INFO -- :   Write schema file: 	oas_docs/src/tags.yml
-I, [2019-05-05T15:00:40.788972 #18669]  INFO -- : [Analyze OAS file (tags)] end
-I, [2019-05-05T15:00:40.788985 #18669]  INFO -- : [Analyze OAS file (components)] start
-I, [2019-05-05T15:00:40.788999 #18669]  INFO -- : [Analyze OAS file (components/schemas)] start
-I, [2019-05-05T15:00:40.790696 #18669]  INFO -- :   Write schema file: 	oas_docs/src/components/schemas/user.yml
-I, [2019-05-05T15:00:40.791151 #18669]  INFO -- :   Write schema file: 	oas_docs/src/components/schemas/task.yml
-I, [2019-05-05T15:00:40.791635 #18669]  INFO -- :   Write schema file: 	oas_docs/src/components/schemas/engine.yml
-I, [2019-05-05T15:00:40.792107 #18669]  INFO -- :   Write schema file: 	oas_docs/src/components/schemas/main.yml
-I, [2019-05-05T15:00:40.792495 #18669]  INFO -- :   Write schema file: 	oas_docs/src/components/schemas/post.yml
-I, [2019-05-05T15:00:40.792515 #18669]  INFO -- : [Analyze OAS file (components/schemas)] end
-I, [2019-05-05T15:00:40.792526 #18669]  INFO -- : [Analyze OAS file (components)] end
-I, [2019-05-05T15:00:40.793238 #18669]  INFO -- : [Analyze OAS file] end
-I, [2019-05-05T15:00:40.848054 #18669]  INFO -- : [Build OAS schema files] start
-I, [2019-05-05T15:00:40.848102 #18669]  INFO -- : [Build OAS schema files] end
-I, [2019-05-05T15:00:40.848115 #18669]  INFO -- : [Build OAS docs from schema files] start
-I, [2019-05-05T15:00:40.848612 #18669]  INFO -- :  Use schema file: 	oas_docs/src/openapi.yml
-I, [2019-05-05T15:00:40.849247 #18669]  INFO -- :  Use schema file: 	oas_docs/src/paths/user.yml
-I, [2019-05-05T15:00:40.850005 #18669]  INFO -- :  Use schema file: 	oas_docs/src/paths/api/v1/task.yml
-I, [2019-05-05T15:00:40.850882 #18669]  INFO -- :  Use schema file: 	oas_docs/src/paths/api/v1/post.yml
-I, [2019-05-05T15:00:40.851566 #18669]  INFO -- :  Use schema file: 	oas_docs/src/paths/api/v2/post.yml
-I, [2019-05-05T15:00:40.852122 #18669]  INFO -- :  Use schema file: 	oas_docs/src/paths/task.yml
-I, [2019-05-05T15:00:40.852441 #18669]  INFO -- :  Use schema file: 	oas_docs/src/paths/rails_admin/engine.yml
-I, [2019-05-05T15:00:40.853853 #18669]  INFO -- :  Use schema file: 	oas_docs/src/paths/rails_admin/main.yml
-I, [2019-05-05T15:00:40.853983 #18669]  INFO -- :  Use schema file: 	oas_docs/src/externalDocs.yml
-I, [2019-05-05T15:00:40.854312 #18669]  INFO -- :  Use schema file: 	oas_docs/src/tags.yml
-I, [2019-05-05T15:00:40.854465 #18669]  INFO -- :  Use schema file: 	oas_docs/src/components/schemas/user.yml
-I, [2019-05-05T15:00:40.854613 #18669]  INFO -- :  Use schema file: 	oas_docs/src/components/schemas/task.yml
-I, [2019-05-05T15:00:40.854796 #18669]  INFO -- :  Use schema file: 	oas_docs/src/components/schemas/engine.yml
-I, [2019-05-05T15:00:40.854978 #18669]  INFO -- :  Use schema file: 	oas_docs/src/components/schemas/main.yml
-I, [2019-05-05T15:00:40.855185 #18669]  INFO -- :  Use schema file: 	oas_docs/src/components/schemas/post.yml
-I, [2019-05-05T15:00:40.855543 #18669]  INFO -- :  Use schema file: 	oas_docs/src/info.yml
-I, [2019-05-05T15:00:40.855888 #18669]  INFO -- :  Use schema file: 	oas_docs/src/servers.yml
-I, [2019-05-05T15:00:40.872235 #18669]  INFO -- : [Build OAS 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
-```