hanami 2.3.0.beta2 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2b1e7bd746a82ee41c5240dff465f74f79c783ebd9ed73c21b41144dff2a641
-  data.tar.gz: d0b26e86ba4736cdd2841abf353ad58d3064f381a6e45adb615c4d8c28ca7c95
+  metadata.gz: 38d55453c1d105a2082e3fb7b6f3ae75318261b02cf496db56832f7223fbb5d2
+  data.tar.gz: fe85b8b2cb513066219d58556d981e9afbad8c824415ef303d56134de19c1754
 SHA512:
-  metadata.gz: 35f0d90cf493960b018734f68aa210b362195d1efbca45308efa8c877f9ec6220b37a1cd8a753034d3a4e27a623de7d40bd8d02b0786b140b5dd0fda631de246
-  data.tar.gz: 735d731e95a0edc4858e8d1930e10540664f25ed3f9069bda184570e9056800f83cc6f2b3ac0703e45e261d33e163e9cb55c80c76b1dc95be074901b691a261a
+  metadata.gz: 363fb71d90a7c35bc55a8eb45ab050314be92e3ef0eb074a5da75d57b8f034e653a3e640c2e49548f0e3dcdf7adaa8cb013fda940befbaf33066e71fd4deded4
+  data.tar.gz: 8de0ec686d58238d32397950322e90411158dc9089cbf134d32983a03d0ba5518b3a0338097ee0e8a46a35bc12688c348a498ada16cfa41201ce3824b7892ed9

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Hanami
 
+A flexible framework for maintainable Ruby apps.
+
+A complete Hanami app is composed of multiple gems. For a complete overview of changes, see also these CHANGELOGs:
+
+[Assets][assets], [Assets JS][assets-js], [CLI][cli],
+[Controller][controller], [DB][db], [RSpec][rspec],
+[Reloader][reloader], [Router][router], [Utils][utils],
+[Validations][validations], [View][view], [Webconsole][webconsole]
+
+[assets]: https://github.com/hanami/hanami-assets/blob/main/CHANGELOG.md
+[assets-js]: https://github.com/hanami/hanami-assets-js/blob/main/CHANGELOG.md
+[cli]: https://github.com/hanami/hanami-cli/blob/main/CHANGELOG.md
+[controller]: https://github.com/hanami/hanami-controller/blob/main/CHANGELOG.md
+[db]: https://github.com/hanami/hanami-db/blob/main/CHANGELOG.md
+[rspec]: https://github.com/hanami/hanami-rspec/blob/main/CHANGELOG.md
+[reloader]: https://github.com/hanami/hanami-reloader/blob/main/CHANGELOG.md
+[router]: https://github.com/hanami/hanami-router/blob/main/CHANGELOG.md
+[utils]: https://github.com/hanami/hanami-utils/blob/main/CHANGELOG.md
+[validations]: https://github.com/hanami/hanami-validations/blob/main/CHANGELOG.md
+[view]: https://github.com/hanami/hanami-view/blob/main/CHANGELOG.md
+[webconsole]: https://github.com/hanami/hanami-webconsole/blob/main/CHANGELOG.md
+
 ## [Unreleased]
 
 ### Added
@@ -14,6 +36,46 @@
 
 ### Security
 
+## [v2.3.0] - 2025-11-12
+
+### Added
+
+- Add `resources` and `resource` methods to the routes DSL. (@afomera and @timriley in #1542 and #1548)
+
+  ```ruby
+  resources :users
+  # Generates:
+  # GET    /users          users.index
+  # GET    /users/new      users.new
+  # POST   /users          users.create
+  # GET    /users/:id      users.show
+  # GET    /users/:id/edit users.edit
+  # PATCH  /users/:id      users.update
+  # DELETE /users/:id      users.destroy
+
+  resource :profile
+  # Generates (singular, no index):
+  # GET    /profile/new    profile.new
+  # POST   /profile        profile.create
+  # GET    /profile        profile.show
+  # GET    /profile/edit   profile.edit
+  # PATCH  /profile        profile.update
+  # DELETE /profile        profile.destroy
+  ```
+
+### Changed
+
+- Enable body parsing middleware by default. (@timriley in #1549)
+
+  This will parse multipart form upload bodies in requests with content type of `multipart/form-data`, and JSON bodies in requests with content types of `application/json` or `application/vnd.api+json`.
+- For standard logging, use block-based API to provide log payloads, so that log payloads are not generated if the log severity is less than the configured log level. (@p8 in #1550)
+
+### Fixed
+
+- Avoid errors when eagerloading Zeitwerk (or when running `bin/rails zeitwerk:check` if your Hanami app is embedded within Rails) by skipping autoloading for extension files that may depend on non-installed gems. (@timriley in #1498)
+- Only extend `Dry::Operation` for Hanami’s database layer when the hanami-db gem is bundled. (@timriley in #1490)
+- Address deprecation warnings from previous usage of `JSON.fast_generate`. (@krzykamil in #1546)
+
 ## [v2.3.0.beta1] - 2025-10-17
 
 ### Changed
@@ -1523,6 +1585,7 @@ end
 - [Luca Guidi] Official support for MRI 2.0
 
 
-[unreleased]: https://github.com/hanami/hanami/compare/v2.3.0.beta2...HEAD
+[unreleased]: https://github.com/hanami/hanami/compare/v2.3.0...HEAD
+[v2.3.0] https://github.com/hanami/hanami/compare/v2.3.0.beta2...v2.3.0
 [v2.3.0.beta2] https://github.com/hanami/hanami/compare/v2.3.0.beta1...v2.3.0.beta2
 [v2.3.0.beta1] https://github.com/hanami/hanami/compare/v2.2.1...v2.3.0.beta1

data/README.md

@@ -21,8 +21,6 @@ These components are designed to be used independently or together in a Hanami a
 
 ## Installation
 
-Hanami supports Ruby (MRI) 3.1+.
-
 ```shell
 gem install hanami
 ```
@@ -95,7 +93,7 @@ $ bundle exec rspec path/to/spec.rb
 
 ### Development Requirements
 
-* Ruby >= 3.1
+* Ruby >= 3.2
 * Bundler
 * Node.js
 

data/hanami.gemspec

@@ -37,9 +37,9 @@ Gem::Specification.new do |spec|
   spec.add_dependency "dry-inflector",    "~> 1.0", ">= 1.1.0", "< 2"
   spec.add_dependency "dry-monitor",      "~> 1.0", ">= 1.0.1", "< 2"
   spec.add_dependency "dry-system",       "~> 1.1"
-  spec.add_dependency "dry-logger",       "~> 1.0", "< 2"
-  spec.add_dependency "hanami-cli",       "~> 2.3.0.beta2"
-  spec.add_dependency "hanami-utils",     "~> 2.3.0.beta2"
+  spec.add_dependency "dry-logger",       "~> 1.2", "< 2"
+  spec.add_dependency "hanami-cli",       ">= 2.3.0"
+  spec.add_dependency "hanami-utils",     ">= 2.3.0"
   spec.add_dependency "json",             ">= 2.7.2"
   spec.add_dependency "zeitwerk",         "~> 2.6"
   spec.add_dependency "rack-session"

data/lib/hanami/config/actions/content_security_policy.rb

@@ -101,7 +101,7 @@ module Hanami
         # @return [Boolean]
         #
         # @api public
-        # @since x.x.x
+        # @since 2.3.0
         def nonce?
           @policy.any? { _2.match?(/'nonce'/) }
         end
@@ -112,7 +112,7 @@ module Hanami
         # @return [Array<(Symbol, Array)>]
         #
         # @api public
-        # @since x.x.x
+        # @since 2.3.0
         def middleware
           return [] unless nonce?
 

data/lib/hanami/config/actions.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "dry/configurable"
+require "hanami/action"
 
 module Hanami
   class Config
@@ -88,7 +89,7 @@ module Hanami
       # @return [Proc]
       #
       # @api public
-      # @since x.x.x
+      # @since 2.3.0
       setting :content_security_policy_nonce_generator, default: -> { SecureRandom.urlsafe_base64(16) }
 
       # @!attribute [rw] method_override
@@ -156,7 +157,7 @@ module Hanami
       end
 
       # @api public
-      # @since x.x.x
+      # @since 2.3.0
       def content_security_policy? = !!@content_security_policy
 
       private

data/lib/hanami/config/router.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "dry/configurable"
+require_relative "../slice/routing/resolver"
 
 module Hanami
   class Config

data/lib/hanami/config.rb

@@ -320,7 +320,6 @@ module Hanami
       self.render_detailed_errors = (env == :development)
       load_from_env
 
-
       @actions = load_dependent_config("hanami-controller") {
         require_relative "config/actions"
         Actions.new
@@ -336,6 +335,7 @@ module Hanami
       @logger = Config::Logger.new(env: env, app_name: app_name)
 
       @middleware = load_dependent_config("hanami-router") {
+        require_relative "slice/routing/middleware/stack"
         Slice::Routing::Middleware::Stack.new
       }
 
@@ -484,24 +484,16 @@ module Hanami
       self.slices = ENV["HANAMI_SLICES"]&.split(",")&.map(&:strip)
     end
 
-    SUPPORTED_MIDDLEWARE_PARSERS = %i[json].freeze
-    private_constant :SUPPORTED_MIDDLEWARE_PARSERS
+    DEFAULT_MIDDLEWARE_PARSERS = {
+      form: ["multipart/form-data"],
+      json: ["application/json", "application/vnd.api+json"]
+    }.freeze
+    private_constant :DEFAULT_MIDDLEWARE_PARSERS
 
     def use_body_parser_middleware
-      return unless Hanami.bundled?("hanami-controller")
-
-      return if actions.formats.empty?
-      return if middleware.stack["/"].map(&:first).any? { |klass| klass == "Hanami::Middleware::BodyParser" }
-
-      parsers = SUPPORTED_MIDDLEWARE_PARSERS & actions.formats.accepted
-      return if parsers.empty?
+      return unless Hanami.bundled?("hanami-router") && Hanami.bundled?("hanami-controller")
 
-      middleware.use(
-        :body_parser,
-        [parsers.to_h { |parser_format|
-          [parser_format, actions.formats.mime_types_for(parser_format)]
-        }]
-      )
+      middleware.use(:body_parser, [DEFAULT_MIDDLEWARE_PARSERS])
     end
 
     def load_dependent_config(gem_name)

data/lib/hanami/extensions/action.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "hanami/action"
+require_relative "action/slice_configured_action"
 
 module Hanami
   # @api private

data/lib/hanami/extensions/operation/slice_configured_db_operation.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Hanami
+  module Extensions
+    module Operation
+      # Extends operations to support the database.
+      #
+      # Add an initializer accepting a `rom:` dependency, which is supplied automatically from the
+      # `"db.rom"` component in the operation's slice.
+      #
+      # @api private
+      class SliceConfiguredDBOperation < Module
+        attr_reader :slice
+
+        def initialize(slice)
+          super()
+          @slice = slice
+        end
+
+        def extended(operation_class)
+          require "dry/operation/extensions/rom"
+          operation_class.include Dry::Operation::Extensions::ROM
+
+          operation_class.include InstanceMethods
+          operation_class.include SliceInstanceMethods.new(slice)
+          define_new
+        end
+
+        def inspect
+          "#<#{self.class.name}[#{slice.name}>"
+        end
+
+        private
+
+        def define_new
+          resolve_rom = method(:resolve_rom)
+
+          define_method(:new) do |**kwargs|
+            super(
+              **kwargs,
+              rom: kwargs.fetch(:rom) { resolve_rom.() },
+            )
+          end
+        end
+
+        def resolve_rom
+          slice["db.rom"] if slice.key?("db.rom")
+        end
+
+        module InstanceMethods
+          attr_reader :rom
+
+          def initialize(rom:, **)
+            @rom = rom
+          end
+        end
+
+        class SliceInstanceMethods < Module
+          attr_reader :slice
+
+          def initialize(slice)
+            @slice = slice
+          end
+
+          def included(operation_class)
+            define_transaction
+          end
+
+          private
+
+          def define_transaction
+            slice = self.slice
+            define_method(:transaction) do |**kwargs, &block|
+              unless rom
+                msg = <<~TEXT.strip
+                  A configured db for #{slice} is required to run transactions.
+                TEXT
+                raise Hanami::ComponentLoadError, msg
+              end
+
+              super(**kwargs, &block)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/hanami/extensions/operation.rb

@@ -11,38 +11,23 @@ module Hanami
     # @api public
     # @since 2.2.0
     module Operation
+      require_relative "operation/slice_configured_db_operation"
+
       # @api private
-      # @since 2.2.0
-      def self.included(operation_class)
+      def self.extended(operation_class)
         super
 
         operation_class.extend(Hanami::SliceConfigurable)
-        operation_class.extend(ClassMethods)
       end
 
-      # @api private
-      # @since 2.2.0
-      module ClassMethods
-        # @api private
-        # @since 2.2.0
-        def configure_for_slice(slice)
-          include slice.namespace::Deps["db.rom"]
-        end
-
-        # @api private
-        # @since 2.2.0
-        def inherited(subclass)
-          super
+      # private
 
-          return unless subclass.superclass == self
-          return unless Hanami.bundled?("hanami-db")
-
-          require "dry/operation/extensions/rom"
-          subclass.include Dry::Operation::Extensions::ROM
-        end
+      # @api private
+      def configure_for_slice(slice)
+        extend SliceConfiguredDBOperation.new(slice) if Hanami.bundled?("hanami-db")
       end
     end
   end
 end
 
-Dry::Operation.include(Hanami::Extensions::Operation)
+Dry::Operation.extend(Hanami::Extensions::Operation)

data/lib/hanami/extensions/view/context.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "../../errors"
+require_relative "slice_configured_context"
 
 module Hanami
   module Extensions
@@ -167,7 +168,7 @@ module Hanami
             # @return [Boolean]
             #
             # @api public
-            # @since x.x.x
+            # @since 2.3.0
             def request?
               !!@request
             end

data/lib/hanami/extensions/view/part.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require_relative "standard_helpers"
+require_relative "slice_configured_part"
+
 module Hanami
   module Extensions
     module View

data/lib/hanami/extensions/view/scope.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require_relative "slice_configured_helpers"
+require_relative "standard_helpers"
+
 module Hanami
   module Extensions
     module View

data/lib/hanami/extensions/view.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "hanami/view"
+require_relative "view/slice_configured_view"
 
 module Hanami
   # @api private

data/lib/hanami/helpers/assets_helper.rb

@@ -710,7 +710,7 @@ module Hanami
       #
       # @return [String, nil] nonce value of the current request
       #
-      # @since x.x.x
+      # @since 2.3.0
       #
       # @example App configuration
       #
@@ -766,7 +766,7 @@ module Hanami
         _context.assets.crossorigin?(source)
       end
 
-      # @since x.x.x
+      # @since 2.3.0
       # @api private
       def _nonce(source, nonce_option)
         if nonce_option == false

data/lib/hanami/middleware/content_security_policy_nonce.rb

@@ -14,16 +14,16 @@ module Hanami
     # @see Hanami::Middleware::ContentSecurityPolicyNonce
     #
     # @api private
-    # @since x.x.x
+    # @since 2.3.0
     class ContentSecurityPolicyNonce
       # @api private
-      # @since x.x.x
+      # @since 2.3.0
       def initialize(app)
         @app = app
       end
 
       # @api private
-      # @since x.x.x
+      # @since 2.3.0
       def call(env)
         return @app.call(env) unless Hanami.app.config.actions.content_security_policy?
 

data/lib/hanami/routes.rb

@@ -2,6 +2,7 @@
 
 require_relative "constants"
 require_relative "errors"
+require_relative "slice/router"
 
 module Hanami
   # App routes