hanami-router 3.0.0.rc1 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de8e82b648b6f8ca9d9962074d411fb23f01455d119fb703742999d8e11c72b4
-  data.tar.gz: '0081e3779fa653bfcf58bd5ef06bb91b472c163082bacbdc81db08ee62d94d1c'
+  metadata.gz: 30cf4c77a2d61c1f8c8817c19db6bd5089627a6639dbda3f6b44441433516a67
+  data.tar.gz: a79a9f499cbd4746adc14e70dd9aeff68aad669cbdb3109bab7501264e5930ab
 SHA512:
-  metadata.gz: 0fe1979c1f87763136879f17db77b9c5ca6bfc42af9916818ec70e292b2d7a86ae10c2d2c42f5e82f16406a4adf926bff9751c224a419831af0a1582c1e98c46
-  data.tar.gz: d604701c43c8446939c4e7be8322d9384b197d1142b61fc7d01a3c96080ebd2d5c5538570d2f1af702ef7b323d5b3e2af55dabeee645f30e14d3f8cb4b0808e7
+  metadata.gz: d08ff095875e2e7a24d4b3663344e6aa0cb3de17bd41ed22c809588a361f28bc9f1f1ffd0ccd1933bb35c88b78a330bbfc9a4aa178cd661202657cae56ce6d13
+  data.tar.gz: e6ca075b83151a66a015ba99c2120ee45bd35fe338cb4f7feb6d82e772eab60a8116ea4ee4fa90629c8e6e79cd2b17c867630916b9a5c3a0ac3154eabed1be77

data/CHANGELOG.md

@@ -1,6 +1,9 @@
-# Hanami::Router
+# Changelog
 
-Rack compatible HTTP router for Ruby.
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Break Versioning](https://www.taoensso.com/break-versioning).
 
 ## [Unreleased]
 
@@ -16,7 +19,26 @@ Rack compatible HTTP router for Ruby.
 
 ### Security
 
-[Unreleased]: http://github.com/hanami/hanami-router/compare/v3.0.0.rc1...HEAD
+[Unreleased]: http://github.com/hanami/hanami-router/compare/v3.0.0...HEAD
+
+## [3.0.0] - 2026-06-30
+
+### Added
+
+- Add `#permanent_redirect` and `#temporary_redirect` helpers for 301 and 302 responses. (@cllns in #302)
+
+### Changed
+
+- **BREAKING:** `#redirect` now requires an explicit `code:` argument. Use `#permanent_redirect` or `#temporary_redirect` for the common cases, and pass `code:` to `#redirect` for less common codes (e.g. `303`, `307`, `308`). (@cllns in #302)
+- Upgrade mustermann to 3.1 and remove mustermann-contrib dependency. (@rkh in #300)
+- Require Ruby 3.3 or newer.
+
+### Fixed
+
+- Only parse the request body into params when the content type is `application/x-www-form-urlencoded`. Previously, with no body parser middleware in use, posting a multipart upload (or other non-form body) could raise `Rack::QueryParser::InvalidParameterError`. (@cllns and @timriley in #305)
+- Allow URL generation (via `#path`) to work with array variables. (@inouire in #304)
+
+[3.0.0]: http://github.com/hanami/hanami-router/compare/v2.3.1...v3.0.0
 
 ## [3.0.0.rc1] - 2026-06-16
 

data/lib/hanami/router/constants.rb

@@ -2,8 +2,10 @@
 
 module Hanami
   class Router
+    # Rack env key containing the request body as parsed by the body parser middleware. Signals that
+    # the body has already been parsed, so the router should not attempt to parse it again.
+    #
     # @api private
-    # @since 2.0.0
     ROUTER_PARSED_BODY = "router.parsed_body"
   end
 end

data/lib/hanami/router/version.rb

@@ -7,6 +7,6 @@ module Hanami
     # @return [String]
     #
     # @api public
-    VERSION = "3.0.0.rc1"
+    VERSION = "3.0.0"
   end
 end

data/lib/hanami/router.rb

@@ -113,9 +113,7 @@ module Hanami
         env[::Rack::RACK_INPUT] = Rack::RewindableInput.new(input)
       end
 
-      endpoint.call(
-        _params(env, params)
-      ).to_a
+      endpoint.call(_env_with_params(env, params)).to_a
     end
 
     # Defines a named root route (a GET route for "/")
@@ -684,7 +682,7 @@ module Hanami
       env = env_for(env, params, options)
       endpoint, params = lookup(env)
 
-      RecognizedRoute.new(endpoint, _params(env, params))
+      RecognizedRoute.new(endpoint, _env_with_params(env, params))
     end
 
     # @since 2.0.0
@@ -777,7 +775,6 @@ module Hanami
     # @api private
     PREFIXED_NAME_SEPARATOR = "_"
 
-    # @since x.x.x
     # @api private
     UNDERSCORED_NAME_REGEXP = /[-+~.]/
 
@@ -789,6 +786,9 @@ module Hanami
     # @api private
     EMPTY_STRING = ""
 
+    # @api private
+    EMPTY_HASH = {}.freeze
+
     # @since 2.0.0
     # @api private
     DEFAULT_RESOLVER = ->(_, to) { to }
@@ -841,6 +841,15 @@ module Hanami
     # @api private
     PARAMS = "router.params"
 
+    # @api private
+    CONTENT_TYPE = "CONTENT_TYPE"
+
+    # @api private
+    FORM_URLENCODED_MEDIA_TYPE = "application/x-www-form-urlencoded"
+
+    # @api private
+    FORM_URLENCODED_MEDIA_TYPE_PREFIX = "#{FORM_URLENCODED_MEDIA_TYPE};".freeze
+
     # @since 2.0.0
     # @api private
     ROUTE_VARIABLE_MATCHER = /:/
@@ -1034,17 +1043,12 @@ module Hanami
       Redirect.new(destination, code, ->(*) { [code, {HTTP_HEADER_LOCATION => destination}, [body]] })
     end
 
-    # @since 2.0.0
     # @api private
-    def _params(env, params)
+    def _env_with_params(env, params)
       params ||= {}
       env[PARAMS] ||= {}
 
-      if !env.key?(ROUTER_PARSED_BODY) && (input = env[::Rack::RACK_INPUT]) and input.rewind
-        env[PARAMS].merge!(::Rack::Utils.parse_nested_query(input.read))
-        input.rewind
-      end
-
+      env[PARAMS].merge!(_form_urlencoded_body(env))
       env[PARAMS].merge!(::Rack::Utils.parse_nested_query(env[::Rack::QUERY_STRING]))
       env[PARAMS].merge!(params)
       env[PARAMS] = Params.deep_symbolize(env[PARAMS])
@@ -1052,6 +1056,28 @@ module Hanami
       env
     end
 
+    # @api private
+    def _form_urlencoded_body(env)
+      return EMPTY_HASH if env.key?(ROUTER_PARSED_BODY)
+      return EMPTY_HASH unless _form_urlencoded?(env)
+      return EMPTY_HASH unless (input = env[::Rack::RACK_INPUT])
+
+      input.rewind
+      body = ::Rack::Utils.parse_nested_query(input.read)
+      input.rewind # leave the stream readable for downstream consumers
+      body
+    end
+
+    # @api private
+    def _form_urlencoded?(env)
+      content_type = env[CONTENT_TYPE]
+      return false unless content_type
+
+      content_type = content_type.downcase
+      content_type == FORM_URLENCODED_MEDIA_TYPE ||
+        content_type.start_with?(FORM_URLENCODED_MEDIA_TYPE_PREFIX)
+    end
+
     # @since 2.0.0
     # @api private
     def _not_allowed_fixed(env)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hanami-router
 version: !ruby/object:Gem::Version
-  version: 3.0.0.rc1
+  version: 3.0.0
 platform: ruby
 authors:
 - Hanakai team