openapi_parameters 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '079a687acb19dfb87815260d6cf7ea39a8cfe176f3ee9e3ebfd345dde517ea08'
-  data.tar.gz: 9dd609bda36de57a3d8c3c526ffd4c707c4cbbfb0f62f83d9f47ecab640ac8a5
+  metadata.gz: 2c8fe7a86aaad928b6277f62969502db824f37ff92624c6f33abfa43dad15454
+  data.tar.gz: f8b36c4416ff14775bf9cb7ca05c5d6ad45589a5a1a390a6bcaa395142027241
 SHA512:
-  metadata.gz: 45d3a59bba22cb4b864db2472b6993d8aa3fe4a70a47af5183cc2d65b8d57e0684c9401782be84e04c79ee133aa714cfa87fa3e0436ec7d629e0dac6844681b1
-  data.tar.gz: 4f71f9ba3187ff382a9bbf53af7e5c543ffe51d6a5a4a7d02828b8380e7d1a31a60b7bfeffef163eac716a230e9a50021086631049a3a1132cba977a07395522
+  metadata.gz: f447c974255d4f21c3822c975b655ddb3f988a513bdb1684491a4bc0a60406f66d170378b8d5e2bc7d64eed5b94366716fdafa9f4074e90f5f1f1ad4567b0d2d
+  data.tar.gz: f3ac74f5faecfca7aa8513fe0e4ce901a5cca2ca42833e0f0c07e2b844e8e8ded7166ac99b492631d0d2173173cce438f4a8c37daa0b16491db0d7ddaf09aa1f

data/CHANGELOG.md

@@ -1,8 +1,19 @@
 ## [Unreleased]
 
+## [0.7.0] - 2025-09-12
+
+- Correctly handle `style:deepObject` with `explode: true` and parse into array
+  ```ruby
+  OpenapiParameters::Query.new(
+      [parameter],
+      explode: true
+  ).unpack('ids=1&ids=2')
+  # => { 'ids' => ['1', '2'] }
+  ```
+
 ## [0.6.1] - 2025-06-23
 
-- Fix converting items of array paramters
+- Fix converting items of array parameters
 
 ## [0.6.0] - 2025-06-23
 

data/lib/openapi_parameters/parameter.rb

@@ -9,6 +9,7 @@ module OpenapiParameters
       @definition = definition
       @name = definition['name']
       @is_deep_object = style == 'deepObject'
+      @is_explode = explode?
       @converter = Converters[schema]
       check_supported!
     end

data/lib/openapi_parameters/query.rb

@@ -11,16 +11,21 @@ module OpenapiParameters
       @parameters = parameters.map { Parameter.new(_1) }
       @convert = convert
       @remove_array_brackets = rack_array_compat
+      @any_deep_object = @parameters.any?(&:deep_object?)
     end
 
-    def unpack(query_string) # rubocop:disable Metrics/AbcSize
+    def unpack(query_string) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
       parsed_query = parse_query(query_string)
+      parsed_nested_query = Rack::Utils.parse_nested_query(query_string) if any_deep_object?
       parameters.each_with_object({}) do |parameter, result|
         if parameter.deep_object?
-          parsed_nested_query = Rack::Utils.parse_nested_query(query_string)
           next unless parsed_nested_query.key?(parameter.name)
 
-          value = parsed_nested_query[parameter.name]
+          value = if parameter.explode?
+                    handle_deep_object_explode(parameter, parsed_nested_query[parameter.name], parsed_query)
+                  else
+                    parsed_nested_query[parameter.name]
+                  end
         else
           next unless parsed_query.key?(parameter.name)
 
@@ -40,6 +45,10 @@ module OpenapiParameters
 
     private
 
+    def any_deep_object?
+      @any_deep_object
+    end
+
     def parse_query(query_string)
       Rack::Utils.parse_query(query_string) do |s|
         Rack::Utils.unescape(s)
@@ -47,5 +56,32 @@ module OpenapiParameters
         raise Rack::Utils::InvalidParameterError, e.message
       end
     end
+
+    def handle_deep_object_explode(parameter, value, parsed_query)
+      return value unless value.is_a?(Hash)
+
+      schema_props = parameter.schema['properties'] || {}
+
+      array_prop_values = find_prop_matches(parameter.name, schema_props, parsed_query)
+
+      schema_props.each_with_object(value) do |(prop, prop_schema), result|
+        next unless prop_schema['type'] == 'array'
+
+        arr = array_prop_values[prop]
+        result[prop] = if arr.empty? && value.key?(prop)
+                         Array(value[prop])
+                       else
+                         arr
+                       end
+      end
+    end
+
+    def find_prop_matches(parameter_name, schema_props, parsed_query)
+      schema_props.each_key.with_object({}) do |prop, result|
+        key = "#{parameter_name}[#{prop}]"
+        value = Array(parsed_query[key])
+        result[prop] = value.map { |match| Rack::Utils.unescape(match) } if value.is_a?(Array)
+      end
+    end
   end
 end

data/lib/openapi_parameters/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenapiParameters
-  VERSION = '0.6.1'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openapi_parameters
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Andreas Haller
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-26 00:00:00.000000000 Z
+date: 2025-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack