hanami 2.3.0.beta1 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8faef478dec45e673c25c67704b0fd7a363e784061412c64e96735040f2d07f
-  data.tar.gz: b88eac54b8ba6241645b616ba9eafd20d54edb888e7fca8abc9e310f414dabe5
+  metadata.gz: 38d55453c1d105a2082e3fb7b6f3ae75318261b02cf496db56832f7223fbb5d2
+  data.tar.gz: fe85b8b2cb513066219d58556d981e9afbad8c824415ef303d56134de19c1754
 SHA512:
-  metadata.gz: 8233b2e453669ae1528c3cadd8032cbff3a7337c590bb0962d307ddd71bb8b18e28f56cc19a5644225efaf0ad0bfa2f5a008dd8fbae2615a9bc819906e47e1cc
-  data.tar.gz: 07551dada781667f44be90593599a0f505e9580d82d98c70df4e18e4288651e68fb26130d3504bf228dd2b7d2237af7494d7cfac86cd06ece733920657adfa83
+  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,57 @@
 
 ### 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
+
+- Use updated API for `config.actions.formats`. (@timriley in #1544)
+- Show relative paths in `MissingActionError`. (@kyleplump and @timriley in #1445)
+
+### Removed
+
+- View context `settings` has been removed and is no longer accessible from templates. (@baweaver in #1536)
+
 ## [v2.3.0.beta1] - 2025-10-03
 
 ### Added
@@ -1512,5 +1585,7 @@ end
 - [Luca Guidi] Official support for MRI 2.0
 
 
-[unreleased]: https://github.com/hanami/hanami/compare/v2.3.0.beta1...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

@@ -7,10 +7,10 @@ require "hanami/version"
 Gem::Specification.new do |spec|
   spec.name          = "hanami"
   spec.version       = Hanami::VERSION
-  spec.authors       = ["Luca Guidi"]
-  spec.email         = ["me@lucaguidi.com"]
-  spec.summary       = "The web, with simplicity"
-  spec.description   = "Hanami is a web framework for Ruby"
+  spec.authors       = ["Hanakai team"]
+  spec.email         = ["info@hanakai.org"]
+  spec.summary       = "A flexible framework for maintainable Ruby apps"
+  spec.description   = spec.summary
   spec.homepage      = "http://hanamirb.org"
   spec.license       = "MIT"
 
@@ -27,7 +27,7 @@ Gem::Specification.new do |spec|
   spec.test_files    = Dir["spec/**/*"]
   spec.require_paths = ["lib"]
   spec.metadata["rubygems_mfa_required"] = "true"
-  spec.required_ruby_version = ">= 3.1"
+  spec.required_ruby_version = ">= 3.2"
 
   spec.metadata["allowed_push_host"] = "https://rubygems.org"
 
@@ -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.beta1"
-  spec.add_dependency "hanami-utils",     "~> 2.2"
+  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

@@ -187,12 +187,12 @@ module Hanami
 
     # @!attribute [rw] console
     #   Returns the app's console config
-    # 
+    #
     #   @example
     #     config.console.engine # => :irb
-    # 
+    #
     #   @return [Hanami::Config::Console]
-    # 
+    #
     #   @api public
     #   @since 2.3.0
     setting :console, default: Hanami::Config::Console.new
@@ -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.values
-      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
@@ -90,28 +91,18 @@ module Hanami
             # @since 2.1.0
             attr_reader :inflector
 
-            # Returns the app's settings.
-            #
-            # @return [Hanami::Settings] the settings
-            #
-            # @api public
-            # @since 2.1.0
-            attr_reader :settings
-
             # @see SliceConfiguredContext#define_new
             #
             # @api private
             # @since 2.1.0
             def initialize( # rubocop:disable Metrics/ParameterLists
               inflector: nil,
-              settings: nil,
               routes: nil,
               assets: nil,
               request: nil,
               **args
             )
               @inflector = inflector
-              @settings = settings
               @routes = routes
               @assets = assets
               @request = request
@@ -177,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/slice_configured_context.rb

@@ -37,18 +37,15 @@ module Hanami
         #
         # This includes the following app components:
         #   - the configured inflector as `inflector`
-        #   - "settings" from the app container as `settings`
         #   - "routes" from the app container as `routes`
         #   - "assets" from the app container as `assets`
         def define_new
           inflector = slice.inflector
-          resolve_settings = method(:resolve_settings)
           resolve_routes = method(:resolve_routes)
           resolve_assets = method(:resolve_assets)
 
           define_method :new do |**kwargs|
             kwargs[:inflector] ||= inflector
-            kwargs[:settings] ||= resolve_settings.()
             kwargs[:routes] ||= resolve_routes.()
             kwargs[:assets] ||= resolve_assets.()
 
@@ -56,10 +53,6 @@ module Hanami
           end
         end
 
-        def resolve_settings
-          slice["settings"] if slice.key?("settings")
-        end
-
         def resolve_routes
           slice["routes"] if slice.key?("routes")
         end

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
@@ -36,14 +37,14 @@ module Hanami
       def initialize(action_key, slice)
         action_path = action_key.gsub(CONTAINER_KEY_DELIMITER, PATH_DELIMITER)
         action_constant = slice.inflector.camelize(
-          "#{slice.inflector.underscore(slice.namespace.to_s)}#{PATH_DELIMITER}#{action_path}"
+          slice.inflector.underscore(slice.namespace.to_s) + PATH_DELIMITER + action_path
         )
-        action_file = slice.root.join("#{action_path}#{RB_EXT}")
+        action_file_path = slice.relative_source_path.join(action_path).to_s.concat(RB_EXT)
 
         super(<<~MSG)
           Could not find action with key #{action_key.inspect} in #{slice}
 
-          To fix this, define the action class #{action_constant} in #{action_file}
+          To fix this, define the action class #{action_constant} in #{action_file_path}
         MSG
       end
     end