Concise DSL for generating OpenAPI Specification 3 (OAS3) JSON documentation for Ruby application.
mk
's parameter eq
is changed to get
. (dssl.rb)Thanks to @austbot, fix - colorize fails at runtime.
do_*
can be passed common schema after (or before) by:
.match
),
it also matches and generate both HTTP methods.root_controller
=> base_doc_class
.ctrl_path
=> ctrl_base
.apis_tag
=> doc_tag
.@_ctrl_infos
=> @doc_info
, @_api_infos
=> @api_info
, @_apis_dry_blocks
=> @zro_dry_blocks
.OpenApi.paths_index
=> OpenApi.routes_index
.get_actions_by_ctrl_path
=> get_actions_by_route_base
.Config.dft_file_format
=> Config.file_format
.should
).deep_merge!
instead of _fusion
.ApiInfoObj
=> ApiInfo
.type: [String, Integer ..]
will generate an array, which's items
would be a oneOf combined schema.desc
will override dry's.type: something
is passed to schema_hash
, but not type
.skip
the params inside block.body_ref
invalid.length
's order is reversed.simplecov
.have_keys
and have_size
.recognize_is_options_in
.instance_eval
=> instance_exec
in dsl.rb.generate_docs
and where schema could be defined.server
in api
.recursive
s.enum: { 'desc' => :enum1 }
=> enum!: { 'desc' => :enum1 }