r2-oas 0.2.0 → 0.3.4

data/docs/setting/CORS.md

@@ -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

@@ -1,176 +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|`""`|
-|CACHE_DOCS|Effective only when there is no `.docs` file. Specifying `true` will generate a` .docs` file when the `routes:oas:docs` command is executed.|`false`|
-
-
-## .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
-```
-
-## .docs
-
-It holds the information in the current routing as a cache. Thanks to this, when the `routes:oas:docs` command is executed, changes in routing can be detected and appropriate processing can be performed.
-
-If you want to inspect `.docs`. You can check it by entering the following code with `pry` or something.
-
-```ruby
-result = IO.binread("oas_docs/.docs")
-inflate = Zlib::Inflate.inflate(result)
-puts Marshal.load(inflate)
-```

data/docs/usage/analyze_docs.md

@@ -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
-```