dry-swagger 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c52c6906b862ea3104ef5d841db24a69f38bbaa5cbda13ef553305453e1665cc
-  data.tar.gz: 5887800bdbcccd0603aad3cecba5c593391be2644456cbf4437557aa039ca923
+  metadata.gz: 76187fb16daf0690d5cea5b3725d6c0a50ea8a69fa5172557e233c4832ab776d
+  data.tar.gz: 8c0c9bd3ba2574e8f6b081cf7248b85f03ce12cc0240cf08bce6e09962eaf067
 SHA512:
-  metadata.gz: a1c2b6b524bf1a06641b7769c90c40246ef27b970177ddcd81d355c7da38435ea32329eb692107dba85ba00d757e234271a5d72bed167dcc2903e1a0c0312f3e
-  data.tar.gz: cbad39dd938d175ca9713d3a4cb834943d83ceb8efe5507e3c93e9cfb231a70251695fd40bb8eeee3a02278472fcfee603826ef04f3a627c915290f85057635d
+  metadata.gz: fc5e7e55e448a6964f12038de02d5f3b90c16cb7d950c3154dbe3df863cc3c14f76838c556ac8c538a3da50ed5f62b30b0266a5da3d3f8d83ce44546d8f18cd2
+  data.tar.gz: 0e3cc570dda791eaed872f7ea98f2404b16c80cbe73caadfdfd6e1e68bbdec576e339c839e70454fafa99757d2e57f4c81493be3514e0555ad079e611fc7dafd

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dry-swagger (0.4.0)
+    dry-swagger (0.4.1)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -33,7 +33,7 @@ Or install it yourself as:
         end
     end
     
-    Dry::Swagger::ContractParser.new.call(Contract)
+    Dry::Swagger::ContractParser.new.call(Contract).to_swagger
     => {
          "type": "object",
          "properties": {
@@ -81,7 +81,7 @@ Or install it yourself as:
       end
     end
     
-    Dry::Swagger::ContractParser.new.call(Contract)
+    Dry::Swagger::ContractParser.new.call(Contract).to_swagger
     => {
          "type": "object",
          "properties": {
@@ -135,7 +135,7 @@ Or install it yourself as:
       attribute? :optional_nullable_string, Types::String.optional
     end
     
-    Dry::Swagger::StructParser.new.call(DTO)
+    Dry::Swagger::StructParser.new.call(DTO).to_swagger
     => {
          "type": "object",
          "properties": {
@@ -170,7 +170,22 @@ Or install it yourself as:
          ]
        }
 #### With nested fields
-    {
+    class NestedDTO < Dry::Struct
+      attribute  :required_string, Types::String
+      attribute  :required_nullable_string, Types::String.optional
+      attribute  :required_string_with_enum, Types::String.enum('enum1')
+      attribute? :optional_string, Types::String
+      attribute? :optional_nullable_string, Types::String.optional
+    end
+    
+    class DTO < Dry::Struct
+      attribute  :array_of_integer, Types::Array.of(Types::Integer)
+      attribute  :array_of_objects, Types::Array.of(NestedDTO)
+      attribute  :dto, NestedDTO
+    end
+    
+    Dry::Swagger::StructParser.new.call(DTO).to_swagger
+    => {
       "type": "object",
       "properties": {
         "array_of_integer": {
@@ -258,6 +273,44 @@ Or install it yourself as:
         "dto"
       ]
     }
+## Overriding fields on run time
+You can also modify the fields during runtime by passing a block after the .call() method.
+
+For example:
+    
+    Dry::Swagger::StructParser.new.call(DTO) do |it|
+      # types = string/integer/hash/array
+      
+      # Remove a field
+      its.keys = it.keys.except(:field_name) 
+      
+      # Add new field on root level
+      it.keys[:new_field_name] = { type: type, required: true/false, :it.config.nullable_type=>true/false } 
+      
+      # Add a new field in nested hash/array
+      it.keys[:nested_field][:keys][:new_field_name] = { 
+        type: type, required: true/false, :it.config.nullable_type=>true/false
+      }
+      
+      # Remove a field in nested hash/array
+      it.keys = it.keys[:nested_field][:keys].except(:field_name)
+      
+      # Add an array or hash
+      it.keys[:nested_field] = { 
+        type: "array/hash", required: true/false, :it.config.nullable_type=> true/false, keys: {
+          # List all nested fields
+          new_field: { type: :type, required: true/false, :it.config.nullable_type=>true/false }
+        }
+      }
+      
+      # Add an Array of primitive types, type field needs to be the element type(string, integer, float), 
+      and add an array: true flag
+      
+      it.keys[:array_field_name] = { 
+        type: type, array: true, required: true/false, :it.config.nullable_type=> true/false 
+      }
+      
+    end.to_swagger()
 ## Custom Configuration For Your Project
 You can override default configurations by creating a file in config/initializers/dry-swagger.rb and changing the following values.
 
@@ -270,12 +323,12 @@ You can override default configurations by creating a file in config/initializer
     end
     
     Dry::Swagger::Config::ContractConfiguration.configuration do |config|
-          config.enable_required_validation = true / false       
-          config.enable_nullable_validation = true / false
-          config.enable_enums = true / false
-          config.enable_descriptions = true / false
-          config.nullable_type = :"x-nullable" / :nullable
-        end
+      config.enable_required_validation = true / false       
+      config.enable_nullable_validation = true / false
+      config.enable_enums = true / false
+      config.enable_descriptions = true / false
+      config.nullable_type = :"x-nullable" / :nullable
+    end
         
 By default, all these settings are true, and nullable_type is :"x-nullable".
 ## Development

data/lib/dry/swagger/documentation_generator.rb

@@ -19,7 +19,7 @@ module Dry
         documentation = { properties: {}, required: [] }
         fields.each do |field_name, attributes_hash|
           documentation[:properties][field_name] = generate_field_properties(attributes_hash)
-          documentation[:required] << field_name if attributes_hash[:required] && @config.enable_required_validation
+          documentation[:required] << field_name if attributes_hash.fetch(:required, true) && @config.enable_required_validation
 
         rescue Errors::MissingTypeError => e
           raise StandardError.new e.message % { field_name: field_name, valid_types: SWAGGER_FIELD_TYPE_DEFINITIONS.keys, attributes_hash: attributes_hash }
@@ -32,24 +32,35 @@ module Dry
 
       def generate_field_properties(attributes_hash)
         if attributes_hash[:type] == 'array'
-          items = generate_documentation(attributes_hash[:keys])
-          items.merge(@config.nullable_type => attributes_hash[@config.nullable_type] | false) if @config.enable_nullable_validation
-          { type: :array, items: items }
-        elsif attributes_hash[:array] && attributes_hash[:type] != 'array'
-          items = SWAGGER_FIELD_TYPE_DEFINITIONS.fetch(attributes_hash[:type])
-          items = items.merge(@config.nullable_type => attributes_hash[@config.nullable_type] | false) if @config.enable_nullable_validation
-          { type: :array, items:  items }
+          items = generate_documentation(attributes_hash.fetch(:keys))
+          items =  @config.enable_nullable_validation ?
+                       items.merge(@config.nullable_type => attributes_hash.fetch(@config.nullable_type, false)) :
+                       items.merge(@config.nullable_type => true)
+          documentation = { type: :array, items: items }
+        elsif attributes_hash[:array] && attributes_hash.fetch(:type) != 'array'
+          items = SWAGGER_FIELD_TYPE_DEFINITIONS.fetch(attributes_hash.fetch(:type))
+          items = @config.enable_nullable_validation ?
+                      items.merge(@config.nullable_type => attributes_hash.fetch(@config.nullable_type, false)) :
+                      items.merge(@config.nullable_type => true)
+          documentation = { type: :array, items:  items }
         elsif attributes_hash[:type] == 'hash'
           raise Errors::MissingHashSchemaError.new unless attributes_hash[:keys]
-          generate_documentation(attributes_hash[:keys])
+          documentation = generate_documentation(attributes_hash.fetch(:keys))
         else
-          field = SWAGGER_FIELD_TYPE_DEFINITIONS.fetch(attributes_hash[:type])
-          field = field.merge(@config.nullable_type => attributes_hash[@config.nullable_type] | false)  if @config.enable_nullable_validation
-          field = field.merge(enum: attributes_hash[:enum]) if attributes_hash[:enum]  if @config.enable_enums
-          field = field.merge(description: attributes_hash[:description]) if attributes_hash[:description] if @config.enable_descriptions
-          field
+          documentation = SWAGGER_FIELD_TYPE_DEFINITIONS.fetch(attributes_hash.fetch(:type))
+          if attributes_hash[:enum] && @config.enable_enums
+            documentation = documentation.merge(enum: attributes_hash.fetch(:enum))
+          end
+
+          if attributes_hash[:description] && @config.enable_descriptions
+            documentation = documentation.merge(description: attributes_hash.fetch(:description))
+          end
         end
 
+        @config.enable_nullable_validation ?
+            documentation.merge(@config.nullable_type => attributes_hash.fetch(@config.nullable_type, false)) :
+            documentation.merge(@config.nullable_type => true)
+
       rescue KeyError
         raise Errors::MissingTypeError.new
       end

data/lib/dry/swagger/version.rb

@@ -1,5 +1,5 @@
 module Dry
   module Swagger
-    VERSION = "0.4.0"
+    VERSION = "0.4.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dry-swagger
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Jane-Terziev