swagger_yard 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: e69ba8fc51e7c39ca9291c1e2917f28b5ed794fe
-  data.tar.gz: f00801cc7268c6faf6d1fdc22c8d9b14ccf55756
+SHA256:
+  metadata.gz: 92fee53b6f39a4a44e733619571d5c051054df3e7721058b50d6f18654898d73
+  data.tar.gz: 93e2c4acd9fb8c523a39c916257e41a5c6426e5033439f814223d91397317606
 SHA512:
-  metadata.gz: baa76a8eccd08176c057fb6d6969001899350d7f0ce8b5cf25ab00cd29d42bf81e554440e5517a1dd517c1bb4952f8deb6143127442e208f91c181825fec6faa
-  data.tar.gz: 7ddf6347f3a340ab921f0f576146fcd3709f8adbcbe049319ab63137fc156779998369f68b1612b97138434fccf9ae8198dde34b19e6463bc713df9d6038d375
+  metadata.gz: 23e2f8c39bdaf2a8009dc7f78b4a8f589da25737fa4cb3e77ab89395abe84459a52106d85aa026b533bbefdfe646cfa9c7fc7d9ede512be5edd4e242ada164ba
+  data.tar.gz: b893eddf59099d0fc2cba25486d5e7b2073b2386d3e0805addf7f7d2b280ccdd165038cd5323ab5315ecd8ac7a5ad07b0b6541471c6c14f7ff5890309de313cf

data/README.md

@@ -1,4 +1,4 @@
-# SwaggerYard [![Build Status](https://travis-ci.org/livingsocial/swagger_yard.svg?branch=master)](https://travis-ci.org/livingsocial/swagger_yard) #
+# SwaggerYard [![Build Status](https://github.com/livingsocial/swagger_yard/actions/workflows/rspec.yml/badge.svg)](https://github.com/livingsocial/swagger_yard/actions/workflows/rspec.yml)
 
 SwaggerYard is a gem to convert custom YARD tags in comments into Swagger 2.0 or OpenAPI 3.0.0 specs.
 
@@ -41,6 +41,9 @@ Then start to annotate controllers and models as described below.
 To generate a Swagger or OpenAPI specification, use one of the `SwaggerYard::Swagger` or `SwaggerYard::OpenAPI` classes as follows in a script or Rake task (or use [swagger_yard-rails](/livingsocial/swagger_yard-rails)):
 
 ```
+# Register the yard tags
+SwaggerYard.register_custom_yard_tags!
+
 spec = SwaggerYard::OpenAPI.new
 # Generate YAML
 File.open("openapi.yml", "w") { |f| f << YAML.dump(spec.to_h) }
@@ -107,7 +110,7 @@ end
 
 ### Model ###
 
-Each model to be exposed in the specification must have a `@model` tag. Model properties are specified with `@property` tags.
+Each model to be exposed in the specification must have a `@model` tag. Model properties are specified with `@property` tags. JSON Schema `additionalProperties` can be specified with `@additional_properties <type>` where `<type>` is any type defined elsewhere, or simply `false` to denote a closed model (`additionalProperties: false`).
 
 ```ruby
 #
@@ -117,6 +120,7 @@ Each model to be exposed in the specification must have a `@model` tag. Model pr
 # @property name  [Array<string>]    the names for the pet
 # @property age   [integer]   the age of the pet
 # @property relatives(required) [Array<Pet>] other Pets in its family
+# @additional_properties string
 #
 class Pet
 end
@@ -172,10 +176,13 @@ Types of things (parameters or responses of an operation, properties of a model)
 - Basic types (integer, boolean, string, object, number, date, time, date-time, uuid, etc.) should be lowercased.
 - An array of models or basic types is specified with `[array<...>]`.
 - An enum of allowed string values is specified with `[enum<one,two,three>]`.
+- An enum of allowed values that are defined in the application `[enum<{CURRENCIES}>]`.
 - An object definition can include the property definitions of its fields, and / or of an additional property for any remaining allowed fields. E.g., `[object<name: string, age: integer,  string >]`
 - Structured data like objects, arrays, pairs, etc., definitions can also be nested; E.g., `[object<pairs:array<object<right:integer,left:integer>>>]`
 - JSON-Schema `format` attributes can be specified for basic types using `<...>`. For example, `[integer<int64>]` produces JSON `{ "type": "integer", "format": "int64" }`.
 - Regex pattern constraints can be specified for strings using `[regex<PATTERN>]`. For example, `[regex<^.{3}$>]` produces JSON `{ "type": "string", "pattern": "^.{3}$" }`.
+- A union of two or more sub-types is expressed as `(A | B)` (parentheses required). This translates to `oneOf:` in JSON Schema.
+- An intersection of two or more sub-types is expressed as `(A & B)` (parentheses required). This translates to `allOf:` in JSON Schema.
 
 ### Options ###
 
@@ -258,6 +265,24 @@ class Person
 end
 ```
 
+### Standalone Model ###
+
+Types can be specified without being associated to an existing model with the `@!model` directive. It is useful when documenting a create and an update of the same class:
+
+```ruby
+# @!model CreatePet
+# @property id(required)    [integer]
+# @property name(required)  [string]
+#
+# @!model UpdatePet
+# @property id(required)    [integer]
+# @property name            [string]
+```
+
+It can also be needed when the body parameter of a path is not totally matching a model.
+
+Note that a model name must be given to the directive.
+
 
 ### External Schema ###
 

data/lib/swagger_yard/directives.rb

@@ -0,0 +1,32 @@
+module SwaggerYard::Directives
+  
+  # A directive used to create a model tag with a dummy class.
+  # based on https://github.com/lsegal/yard/blob/master/lib/yard/tags/directives.rb#L361
+  class ParamClassDirective < YARD::Tags::Directive
+
+    def call; end
+
+    def after_parse
+      return unless handler
+
+      create_object
+    end
+
+    def create_object
+      name = tag.name
+      obj = YARD::CodeObjects::ClassObject.new(handler.namespace, tag.name)
+      handler.register_file_info(obj)
+      handler.register_source(obj)
+      handler.register_group(obj)
+      obj.docstring = YARD::Docstring.new!(parser.text,
+                                           parser.tags,
+                                           obj,
+                                           nil,
+                                           parser.reference)
+      obj.add_tag(YARD::Tags::Tag.new(:model, name))
+      parser.object = obj
+      parser.post_process
+      obj
+    end
+  end
+end

data/lib/swagger_yard/model.rb

@@ -5,7 +5,8 @@ module SwaggerYard
   #
   class Model
     include Example
-    attr_reader :id, :discriminator, :inherits, :description, :properties
+    attr_reader :id, :discriminator, :inherits,
+      :description, :properties, :additional_properties
 
     def self.from_yard_object(yard_object)
       new.tap do |model|
@@ -41,8 +42,12 @@ module SwaggerYard
       properties.detect {|prop| prop.name == key }
     end
 
+    TAG_ORDER = %w(model inherits discriminator property example additional_properties)
+
     def parse_tags(tags)
-      tags.each do |tag|
+      sorted_tags = tags.each_with_index.sort_by { |t,i|
+        [TAG_ORDER.index(t.tag_name), i] }.map(&:first)
+      sorted_tags.each do |tag|
         case tag.tag_name
         when "model"
           @has_model_tag = true
@@ -63,11 +68,13 @@ module SwaggerYard
             if (prop = property(tag.name))
               prop.example = tag.text
             else
-              SwaggerYard.log.warn("no property '#{tag.name}' defined yet to which to attach example: #{value.inspect}")
+              SwaggerYard.log.warn("no property '#{tag.name}' defined yet to which to attach example: #{tag.text.inspect}")
             end
           else
             self.example = tag.text
           end
+        when "additional_properties"
+          @additional_properties = Type.new(tag.text).schema
         end
       end
 

data/lib/swagger_yard/swagger.rb

@@ -158,6 +158,7 @@ module SwaggerYard
 
       h["example"] = mod.example if mod.example
 
+      h["additionalProperties"] = mod.additional_properties if !mod.additional_properties.nil?
       h
     end
 

data/lib/swagger_yard/type_parser.rb

@@ -24,12 +24,16 @@ module SwaggerYard
 
       rule(:identifier) { name >> (str('::') >> name).repeat }
 
+      rule(:constant)   { spaced('{') >> identifier.as(:constant) >> spaced('}') }
+
       rule(:external_identifier) { name.as(:namespace) >> str('#') >> identifier.as(:identifier) }
 
+      rule(:_false)      { str('false').as(:false) }
+
       rule(:regexp)     { stri('regex') >> match['Pp'].maybe >> space >>
                           str('<') >> (str('\\\\') | str('\\>') | match['[^>]']).repeat.as(:regexp) >> str('>') }
 
-      rule(:enum_list)  { name.as(:value) >> (spaced(',') >> name.as(:value)).repeat }
+      rule(:enum_list)  { (name.as(:value) | constant) >> (spaced(',') >> (name.as(:value) | constant)).repeat }
 
       rule(:enum)       { stri('enum') >> spaced('<') >> enum_list >> spaced('>') }
 
@@ -43,10 +47,17 @@ module SwaggerYard
 
       rule(:formatted)  { name.as(:name) >> spaced('<') >> name.as(:format) >> spaced('>') }
 
+      rule(:union)      { spaced('(') >> type >> (spaced('|') >> type).repeat >> spaced(')') }
+
+      rule(:intersect)  { spaced('(') >> type >> (spaced('&') >> type).repeat >> spaced(')') }
+
       rule(:type)       { enum.as(:enum) |
                           array.as(:array) |
                           object.as(:object) |
                           formatted.as(:formatted) |
+                          union.as(:union) |
+                          intersect.as(:intersect) |
+                          _false |
                           external_identifier.as(:external_identifier) |
                           identifier.as(:identifier) |
                           regexp }
@@ -58,9 +69,9 @@ module SwaggerYard
       rule(identifier: simple(:id)) do
         v = id.to_s
         case v
-        when /array/i
+        when /^array$/i
           { 'type' => 'array', 'items' => { 'type' => 'string' } }
-        when /object/i
+        when /^object$/i
           { 'type' => 'object' }
         when "float", "double"
           { 'type' => 'number', 'format' => v }
@@ -76,17 +87,16 @@ module SwaggerYard
         end
       end
 
+      rule(constant: simple(:constant)) do
+        constant.to_s.constantize
+      rescue NameError => e
+        raise UnknownConstant, e.message
+      end
+
       rule(external_identifier: { namespace: simple(:namespace), identifier: simple(:identifier) }) do
-        prefix, name = namespace.to_s, identifier.to_s
-        unless url = SwaggerYard.config.external_schema[prefix]
-          raise UndefinedSchemaError, "unknown prefix #{prefix} for #{name}"
-        end
-        uri = URI(url)
-        fragment = uri.fragment ? "##{uri.fragment}" : model_path
-        uri.fragment = nil
-        fragment += '/' unless fragment.end_with?('/')
-        url = uri.to_s
-        { '$ref' => "#{url}#{fragment}#{Model.mangle(name)}"}
+        prefix, name  = namespace.to_s, identifier.to_s
+        url, fragment = resolve_uri.call(name, prefix)
+        { '$ref' => "#{url}#{fragment}#{Model.mangle(name)}" }
       end
 
       rule(formatted: { name: simple(:name), format: simple(:format) }) do
@@ -99,8 +109,10 @@ module SwaggerYard
 
       rule(value: simple(:value)) { value.to_s }
 
+      rule(false: simple(:false)) { false }
+
       rule(enum: subtree(:values)) do
-        { 'type' => 'string', 'enum' => Array(values) }
+        { 'type' => 'string', 'enum' => Array(values).flatten }
       end
 
       rule(array: subtree(:type)) do
@@ -125,6 +137,14 @@ module SwaggerYard
           result.update additional.first unless additional.empty?
         end
       end
+
+      rule(union: subtree(:types)) do
+        { 'oneOf' => Array(types) }
+      end
+
+      rule(intersect: subtree(:types)) do
+        { 'allOf' => Array(types) }
+      end
     end
 
     def initialize(model_path = Type::MODEL_PATH)
@@ -138,9 +158,21 @@ module SwaggerYard
     end
 
     def json_schema(str)
-      @xform.apply(parse(str), model_path: @model_path)
+      @xform.apply(parse(str),
+                   model_path: @model_path,
+                   resolve_uri: ->(name, prefix) { resolve_uri(name, prefix) })
     rescue Parslet::ParseFailed => e
       raise InvalidTypeError, "'#{str}': #{e.message}"
     end
+
+    def resolve_uri(name, prefix)
+      unless url = SwaggerYard.config.external_schema[prefix]
+        raise UndefinedSchemaError, "unknown prefix #{prefix} for #{name}"
+      end
+      uri, fragment = url.split '#'
+      fragment = fragment ? "##{fragment}" : @model_path
+      fragment += '/' unless fragment.end_with?('/')
+      [uri, fragment]
+    end
   end
 end

data/lib/swagger_yard/type_parser.rb.~15b1c21e39906b88fcc3b6ec11649ad1a159adbf~

@@ -0,0 +1,146 @@
+require 'parslet'
+
+module SwaggerYard
+  class TypeParser
+    class Parser < Parslet::Parser
+      # Allow for whitespace surrounding a string value
+      def spaced(arg)
+        space >> str(arg) >> space
+      end
+
+      def stri(str)
+        key_chars = str.split(//)
+        key_chars.collect! { |char| match["#{char.upcase}#{char.downcase}"] }.
+          reduce(:>>)
+      end
+
+      rule(:space)      { match[" \n"].repeat }
+
+      rule(:id_char)    { match['-a-zA-Z0-9_'].repeat }
+
+      rule(:id_start)   { match('[a-zA-Z_]') }
+
+      rule(:name)       { id_start >> id_char }
+
+      rule(:identifier) { name >> (str('::') >> name).repeat }
+
+      rule(:external_identifier) { name.as(:namespace) >> str('#') >> identifier.as(:identifier) }
+
+      rule(:regexp)     { stri('regex') >> match['Pp'].maybe >> space >>
+                          str('<') >> (str('\\\\') | str('\\>') | match['[^>]']).repeat.as(:regexp) >> str('>') }
+
+      rule(:enum_list)  { name.as(:value) >> (spaced(',') >> name.as(:value)).repeat }
+
+      rule(:enum)       { stri('enum') >> spaced('<') >> enum_list >> spaced('>') }
+
+      rule(:array)      { stri('array') >> spaced('<') >> type >> spaced('>') }
+
+      rule(:pair)       { (name.as(:property) >> spaced(':') >> type.as(:type)).as(:pair) }
+
+      rule(:pairs)      { pair >> (spaced(',') >> pair).repeat >> (spaced(',') >> type.as(:additional)).maybe }
+
+      rule(:object)     { stri('object') >> spaced('<') >> (pairs | type.as(:additional)) >> spaced('>') }
+
+      rule(:formatted)  { name.as(:name) >> spaced('<') >> name.as(:format) >> spaced('>') }
+
+      rule(:type)       { enum.as(:enum) |
+                          array.as(:array) |
+                          object.as(:object) |
+                          formatted.as(:formatted) |
+                          external_identifier.as(:external_identifier) |
+                          identifier.as(:identifier) |
+                          regexp }
+
+      root :type
+    end
+
+    class Transform < Parslet::Transform
+      rule(identifier: simple(:id)) do
+        v = id.to_s
+        case v
+        when /^array$/i
+          { 'type' => 'array', 'items' => { 'type' => 'string' } }
+        when /^object$/i
+          { 'type' => 'object' }
+        when "float", "double"
+          { 'type' => 'number', 'format' => v }
+        when "date-time", "date", "time", "uuid"
+          { 'type' => 'string', 'format' => v }
+        else
+          name = Model.mangle(v)
+          if /[[:upper:]]/.match(name)
+            { '$ref' => "#{model_path}#{name}" }
+          else
+            { 'type' => name }
+          end
+        end
+      end
+
+      rule(external_identifier: { namespace: simple(:namespace), identifier: simple(:identifier) }) do
+        prefix, name = namespace.to_s, identifier.to_s
+        unless url = SwaggerYard.config.external_schema[prefix]
+          raise UndefinedSchemaError, "unknown prefix #{prefix} for #{name}"
+        end
+        uri = URI(url)
+        fragment = uri.fragment ? "##{uri.fragment}" : model_path
+        uri.fragment = nil
+        fragment += '/' unless fragment.end_with?('/')
+        url = uri.to_s
+        { '$ref' => "#{url}#{fragment}#{Model.mangle(name)}"}
+      end
+
+      rule(formatted: { name: simple(:name), format: simple(:format) }) do
+        { 'type' => name.to_s, 'format' => format.to_s }
+      end
+
+      rule(regexp: simple(:pattern)) do
+        { 'type' => 'string', 'pattern' => pattern.to_s.gsub('\\\\', '\\').gsub('\>', '>') }
+      end
+
+      rule(value: simple(:value)) { value.to_s }
+
+      rule(enum: subtree(:values)) do
+        { 'type' => 'string', 'enum' => Array(values) }
+      end
+
+      rule(array: subtree(:type)) do
+        { 'type' => 'array', 'items' => type }
+      end
+
+      rule(pair: { property: simple(:prop), type: subtree(:type) }) do
+        { 'properties' => { prop.to_s => type } }
+      end
+
+      rule(additional: subtree(:type)) do
+        { 'additionalProperties' => type }
+      end
+
+      rule(object: subtree(:properties)) do
+        { 'type' => 'object' }.tap do |result|
+          all_props = Array === properties ? properties : [properties]
+          props, additional = all_props.partition {|pr| pr['properties'] }
+          props.each do |pr|
+            result['properties'] = (result['properties'] || {}).merge(pr['properties'])
+          end
+          result.update additional.first unless additional.empty?
+        end
+      end
+    end
+
+    def initialize(model_path = Type::MODEL_PATH)
+      @parser = Parser.new
+      @xform  = Transform.new
+      @model_path = model_path
+    end
+
+    def parse(str)
+      @parser.parse(str)
+    end
+
+    def json_schema(str)
+      @xform.apply(parse(str), model_path: @model_path)
+    rescue Parslet::ParseFailed => e
+      raise InvalidTypeError, "'#{str}': #{e.message}"
+    end
+  end
+end

data/lib/swagger_yard/type_parser.rb.~5b9ef33~

@@ -0,0 +1,151 @@
+require 'parslet'
+
+module SwaggerYard
+  class TypeParser
+    class Parser < Parslet::Parser
+      # Allow for whitespace surrounding a string value
+      def spaced(arg)
+        space >> str(arg) >> space
+      end
+
+      def stri(str)
+        key_chars = str.split(//)
+        key_chars.collect! { |char| match["#{char.upcase}#{char.downcase}"] }.
+          reduce(:>>)
+      end
+
+      rule(:space)      { match[" \n"].repeat }
+
+      rule(:id_char)    { match['-a-zA-Z0-9_'].repeat }
+
+      rule(:id_start)   { match('[a-zA-Z_]') }
+
+      rule(:name)       { id_start >> id_char }
+
+      rule(:identifier) { name >> (str('::') >> name).repeat }
+
+      rule(:external_identifier) { name.as(:namespace) >> str('#') >> identifier.as(:identifier) }
+
+      rule(:regexp)     { stri('regex') >> match['Pp'].maybe >> space >>
+                          str('<') >> (str('\\\\') | str('\\>') | match['[^>]']).repeat.as(:regexp) >> str('>') }
+
+      rule(:enum_list)  { name.as(:value) >> (spaced(',') >> name.as(:value)).repeat }
+
+      rule(:enum)       { stri('enum') >> spaced('<') >> enum_list >> spaced('>') }
+
+      rule(:array)      { stri('array') >> spaced('<') >> type >> spaced('>') }
+
+      rule(:pair)       { (name.as(:property) >> spaced(':') >> type.as(:type)).as(:pair) }
+
+      rule(:pairs)      { pair >> (spaced(',') >> pair).repeat >> (spaced(',') >> type.as(:additional)).maybe }
+
+      rule(:object)     { stri('object') >> spaced('<') >> (pairs | type.as(:additional)) >> spaced('>') }
+
+      rule(:formatted)  { name.as(:name) >> spaced('<') >> name.as(:format) >> spaced('>') }
+
+      rule(:type)       { enum.as(:enum) |
+                          array.as(:array) |
+                          object.as(:object) |
+                          formatted.as(:formatted) |
+                          external_identifier.as(:external_identifier) |
+                          identifier.as(:identifier) |
+                          regexp }
+
+      root :type
+    end
+
+    class Transform < Parslet::Transform
+      rule(identifier: simple(:id)) do
+        v = id.to_s
+        case v
+        when /^array$/i
+          { 'type' => 'array', 'items' => { 'type' => 'string' } }
+        when /^object$/i
+          { 'type' => 'object' }
+        when "float", "double"
+          { 'type' => 'number', 'format' => v }
+        when "date-time", "date", "time", "uuid"
+          { 'type' => 'string', 'format' => v }
+        else
+          name = Model.mangle(v)
+          if /[[:upper:]]/.match(name)
+            { '$ref' => "#{model_path}#{name}" }
+          else
+            { 'type' => name }
+          end
+        end
+      end
+
+      rule(external_identifier: { namespace: simple(:namespace), identifier: simple(:identifier) }) do
+        prefix, name  = namespace.to_s, identifier.to_s
+        url, fragment = resolve_uri.call(name, prefix)
+        { '$ref' => "#{url}#{fragment}#{Model.mangle(name)}" }
+      end
+
+      rule(formatted: { name: simple(:name), format: simple(:format) }) do
+        { 'type' => name.to_s, 'format' => format.to_s }
+      end
+
+      rule(regexp: simple(:pattern)) do
+        { 'type' => 'string', 'pattern' => pattern.to_s.gsub('\\\\', '\\').gsub('\>', '>') }
+      end
+
+      rule(value: simple(:value)) { value.to_s }
+
+      rule(enum: subtree(:values)) do
+        { 'type' => 'string', 'enum' => Array(values) }
+      end
+
+      rule(array: subtree(:type)) do
+        { 'type' => 'array', 'items' => type }
+      end
+
+      rule(pair: { property: simple(:prop), type: subtree(:type) }) do
+        { 'properties' => { prop.to_s => type } }
+      end
+
+      rule(additional: subtree(:type)) do
+        { 'additionalProperties' => type }
+      end
+
+      rule(object: subtree(:properties)) do
+        { 'type' => 'object' }.tap do |result|
+          all_props = Array === properties ? properties : [properties]
+          props, additional = all_props.partition {|pr| pr['properties'] }
+          props.each do |pr|
+            result['properties'] = (result['properties'] || {}).merge(pr['properties'])
+          end
+          result.update additional.first unless additional.empty?
+        end
+      end
+    end
+
+    def initialize(model_path = Type::MODEL_PATH)
+      @parser = Parser.new
+      @xform  = Transform.new
+      @model_path = model_path
+    end
+
+    def parse(str)
+      @parser.parse(str)
+    end
+
+    def json_schema(str)
+      @xform.apply(parse(str),
+                   model_path: @model_path,
+                   resolve_uri: ->(name, prefix) { resolve_uri(name, prefix) })
+    rescue Parslet::ParseFailed => e
+      raise InvalidTypeError, "'#{str}': #{e.message}"
+    end
+
+    def resolve_uri(name, prefix)
+      unless url = SwaggerYard.config.external_schema[prefix]
+        raise UndefinedSchemaError, "unknown prefix #{prefix} for #{name}"
+      end
+      uri, fragment = url.split '#'
+      fragment = fragment ? "##{fragment}" : @model_path
+      fragment += '/' unless fragment.end_with?('/')
+      [uri, fragment]
+    end
+  end
+end

data/lib/swagger_yard/version.rb

@@ -1,3 +1,3 @@
 module SwaggerYard
-  VERSION = "1.0.1"
+  VERSION = "1.1.0"
 end

data/lib/swagger_yard.rb

@@ -15,9 +15,11 @@ require "swagger_yard/path_item"
 require "swagger_yard/swagger"
 require "swagger_yard/openapi"
 require "swagger_yard/handlers"
+require "swagger_yard/directives"
 
 module SwaggerYard
   class Error < StandardError; end
+  class UnknownConstant < Error; end
   class InvalidTypeError < Error; end
   class UndefinedSchemaError < Error; end
 
@@ -111,10 +113,12 @@ module SwaggerYard
       ::YARD::Tags::Library.define_tag("Model superclass", :inherits)
       ::YARD::Tags::Library.define_tag("Model property", :property, :with_types_name_and_default)
       ::YARD::Tags::Library.define_tag("Model discriminator", :discriminator, :with_types_name_and_default)
+      ::YARD::Tags::Library.define_tag("Additional properties", :additional_properties)
       ::YARD::Tags::Library.define_tag("Authorization", :authorization, :with_types_and_name)
       ::YARD::Tags::Library.define_tag("Authorization Use", :authorize_with)
       # @example is a core YARD tag, let's use it
       # ::YARD::Tags::Library.define_tag("Example", :example, :with_title_and_text)
+      ::YARD::Tags::Library.define_directive(:model, :with_title_and_text, Directives::ParamClassDirective)
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: swagger_yard
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - chtrinh (Chris Trinh)
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-07-24 00:00:00.000000000 Z
+date: 2021-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: yard
@@ -42,16 +42,16 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '12'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '12'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -84,44 +84,44 @@ dependencies:
   name: apivore
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: addressable
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -193,6 +193,7 @@ files:
 - lib/swagger_yard/api_group.rb
 - lib/swagger_yard/authorization.rb
 - lib/swagger_yard/configuration.rb
+- lib/swagger_yard/directives.rb
 - lib/swagger_yard/example.rb
 - lib/swagger_yard/handlers.rb
 - lib/swagger_yard/model.rb
@@ -207,12 +208,14 @@ files:
 - lib/swagger_yard/type.rb
 - lib/swagger_yard/type.rb.~master~
 - lib/swagger_yard/type_parser.rb
+- lib/swagger_yard/type_parser.rb.~15b1c21e39906b88fcc3b6ec11649ad1a159adbf~
+- lib/swagger_yard/type_parser.rb.~5b9ef33~
 - lib/swagger_yard/version.rb
 homepage: http://www.synctv.com
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -220,16 +223,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.2.1
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
 summary: SwaggerYard API doc through YARD
 test_files: []