hanami-controller 2.0.1 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19de4a7e13f8845b766110c62f3fafef0d600cdc7e2ae12c0083f73f91fa0224
-  data.tar.gz: fe8adf8eaff82024d6dcdfaff5e7e0a41c210e138419807af89a74babc10a6d4
+  metadata.gz: 477af228e710dc40efbe4387c47f5cd04d24680f5041e0218390ad22e64fe349
+  data.tar.gz: f70b9d82c375465cfebabcd00db19fb13243ea5888bc8096fbdeac3f01e86c9c
 SHA512:
-  metadata.gz: 85493e28f9f323982bffd69c89e2ffeceaed9d284f21776f118e36cfc6b52ce7355e450c37d67212fc2bc135d60925a2bb7287f123892fabc81148fba076e1ec
-  data.tar.gz: 37a1e25fd2ea272ef88f203f001830729c40102462be05681a3669c38ece703827948f08d901f2ad93092739b546a23b8714dd79452466be49619e72bf3e9fe3
+  metadata.gz: 202511cc4ae1c987c1990a93b6041b3dc3edf8c9391d3938499aea83fe672d43f69d8cf90420d4b222de88124c1222e2aea8fbf7d981ada5a0cf0b8c8d9a40a3
+  data.tar.gz: 4af98190f0ea03130a595cfa2cb222d321b77f22d3e9003daa932786b1bb2de68984d0175cb107b10af656e1e9409c38f4096959f570c2d5aaf168502481d435

data/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 Complete, fast and testable actions for Rack
 
+## v2.0.2 - 2023-02-01
+
+### Added
+
+- [Adam Lassek] Params Pattern Matching
+- [Adam Lassek, Luca Guidi] Allow to `halt` using a `Symbol`: `halt :unauthorized`
+- [Adam Lassek, Luca Guidi] Introduce `Hanami::Action::Response#status=` to accept an `Integer` or a `Symbol`
+
+### Fixed
+
+- [Pat Allan] Ensure action accepting the request with a custom MIME Type
+- [Luca Guidi] Halting with an unknown HTTP code will raise a `Hanami::Action::UnknownHttpStatusError`
+- [Luca Guidi] Fix error message for missing format (MIME Type)
+
 ## v2.0.1 - 2022-12-25
 
 ### Added

data/lib/hanami/action/cache/directives.rb

@@ -88,9 +88,9 @@ module Hanami
           @directives = []
           values.each do |directive_key|
             if directive_key.is_a? Hash
-              directive_key.each { |name, value| self.<< ValueDirective.new(name, value) }
+              directive_key.each { |name, value| self << ValueDirective.new(name, value) }
             else
-              self.<< NonValueDirective.new(directive_key)
+              self << NonValueDirective.new(directive_key)
             end
           end
         end

data/lib/hanami/action/errors.rb

@@ -9,6 +9,20 @@ module Hanami
     class Error < ::StandardError
     end
 
+    # Unknown status HTTP Status error
+    #
+    # @since 2.0.2
+    #
+    # @see Hanami::Action::Response#status=
+    # @see https://guides.hanamirb.org/v2.0/actions/status-codes/
+    class UnknownHttpStatusError < Error
+      # @since 2.0.2
+      # @api private
+      def initialize(code)
+        super("unknown HTTP status: `#{code.inspect}'")
+      end
+    end
+
     # Unknown format error
     #
     # This error is raised when a action sets a format that it isn't recognized
@@ -21,14 +35,26 @@ module Hanami
       # @since 2.0.0
       # @api private
       def initialize(format)
-        msg =
-          if format.to_s != "" # rubocop:disable Style/NegatedIfElseCondition
-            "Cannot find a corresponding MIME type for format #{format.inspect}. Configure one via `config.formats.add(#{format}: \"MIME_TYPE_HERE\")`." # rubocop:disable Layout/LineLength
-          else
-            "Cannot find a corresponding MIME type for `nil` format."
-          end
+        message = <<~MSG
+          Cannot find a corresponding MIME type for format `#{format.inspect}'.
+        MSG
+
+        unless blank?(format)
+          message += <<~MSG
+
+            Configure one via: `config.actions.formats.add(:#{format}, "MIME_TYPE_HERE")' in `config/app.rb' to share between actions of a Hanami app.
+
+            Or make it available only in the current action: `config.formats.add(:#{format}, "MIME_TYPE_HERE")'.
+          MSG
+        end
+
+        super(message)
+      end
+
+      private
 
-        super(msg)
+      def blank?(format)
+        format.to_s.match(/\A[[:space:]]*\z/)
       end
     end
 

data/lib/hanami/action/halt.rb

@@ -10,8 +10,8 @@ module Hanami
       # @api private
       # @since 2.0.0
       def self.call(status, body = nil)
-        body ||= Http::Status.message_for(status)
-        throw :halt, [status, body]
+        code, message = Http::Status.for_code(status)
+        throw :halt, [code, body || message]
       end
     end
   end

data/lib/hanami/action/mime.rb

@@ -237,7 +237,7 @@ module Hanami
         # @api private
         def accepted_mime_type?(mime_type, config)
           accepted_mime_types(config).any? { |accepted_mime_type|
-            ::Rack::Mime.match?(accepted_mime_type, mime_type)
+            ::Rack::Mime.match?(mime_type, accepted_mime_type)
           }
         end
 

data/lib/hanami/action/params.rb

@@ -243,6 +243,15 @@ module Hanami
         @params
       end
       alias_method :to_hash, :to_h
+
+      # Pattern-matching support
+      #
+      # @return [::Hash]
+      #
+      # @since 2.0.2
+      def deconstruct_keys(*)
+        to_hash
+      end
     end
   end
 end

data/lib/hanami/action/response.rb

@@ -81,6 +81,27 @@ module Hanami
         end
       end
 
+      # Set the response status
+      #
+      # @param code [Integer, Symbol] the status code
+      #
+      # @since 2.0.2
+      # @api public
+      #
+      # @raise [Hanami::Action::UnknownHttpStatusError] if the given code
+      #   cannot be associated to a known HTTP status
+      #
+      # @example
+      #   response.status = :unprocessable_entity
+      #
+      # @example
+      #   response.status = 422
+      #
+      # @see https://guides.hanamirb.org/v2.0/actions/status-codes/
+      def status=(code)
+        super(Http::Status.lookup(code))
+      end
+
       # This is NOT RELEASED with 2.0.0
       #
       # @api private

data/lib/hanami/controller/version.rb

@@ -8,6 +8,6 @@ module Hanami
     #
     # @since 0.1.0
     # @api public
-    VERSION = "2.0.1"
+    VERSION = "2.0.2"
   end
 end

data/lib/hanami/http/status.rb

@@ -17,31 +17,127 @@ module Hanami
       # @api private
       ALL = ::Rack::Utils::HTTP_STATUS_CODES
 
+      # Symbolic names for status codes
+      #
+      # @since 2.0.2
+      # @api private
+      SYMBOLS = ::Rack::Utils::SYMBOL_TO_STATUS_CODE
+
       # Return a status for the given code
       #
-      # @param code [Integer] a valid HTTP code
+      # @param code [Integer, Symbol] a valid HTTP code
       #
       # @return [Array] a pair of code and message for an HTTP status
       #
+      # @raise [Hanami::Action::UnknownHttpStatusError] if the given code
+      #   cannot be associated to a known HTTP status
+      #
       # @since 0.1.0
       # @api private
       #
-      # @example
-      #   require 'hanami/http/status'
+      # @see https://guides.hanamirb.org/v2.0/actions/status-codes/
+      #
+      # @example Integer HTTP Status
+      #   require "hanami/http/status"
+      #
+      #   Hanami::Http::Status.for_code(401)
+      #     # => [401, "Unauthorized"]
+      #
+      # @example Symbol HTTP Status
+      #   require "hanami/http/status"
+      #
+      #   Hanami::Http::Status.for_code(:unauthorized)
+      #     # => [401, "Unauthorized"]
+      #
+      # @example Unknown HTTP Status
+      #   require "hanami/http/status"
       #
-      #   Hanami::Http::Status.for_code(418) # => [418, "I'm a teapot"]
+      #   Hanami::Http::Status.for_code(999)
+      #     # => raise Hanami::Action::UnknownHttpStatusError
+      #
+      #   Hanami::Http::Status.for_code(:foo)
+      #     # => raise Hanami::Action::UnknownHttpStatusError
       def self.for_code(code)
-        ALL.assoc(code)
+        case code
+        when Integer
+          ALL.assoc(code)
+        when Symbol
+          ALL.assoc(SYMBOLS[code])
+        end or raise ::Hanami::Action::UnknownHttpStatusError.new(code)
+      end
+
+      # Return a status code for the given code
+      #
+      # @param code [Integer,Symbol] a valid HTTP code
+      #
+      # @return [Integer] a message for the given status code
+      #
+      # @raise [Hanami::Action::UnknownHttpStatusError] if the given code
+      #   cannot be associated to a known HTTP status
+      #
+      # @see https://guides.hanamirb.org/v2.0/actions/status-codes/
+      #
+      # @since 2.0.2
+      # @api private
+      #
+      # @example Integer HTTP Status
+      #   require "hanami/http/status"
+      #
+      #   Hanami::Http::Status.lookup(401)
+      #     # => 401
+      #
+      # @example Symbol HTTP Status
+      #   require "hanami/http/status"
+      #
+      #   Hanami::Http::Status.lookup(:unauthorized)
+      #     # => 401
+      #
+      # @example Unknown HTTP Status
+      #   require "hanami/http/status"
+      #
+      #   Hanami::Http::Status.lookup(999)
+      #     # => raise Hanami::Action::UnknownHttpStatusError
+      #
+      #   Hanami::Http::Status.lookup(:foo)
+      #     # => raise Hanami::Action::UnknownHttpStatusError
+      def self.lookup(code)
+        for_code(code)[0]
       end
 
       # Return a message for the given status code
       #
-      # @param code [Integer] a valid HTTP code
+      # @param code [Integer,Symbol] a valid HTTP code
       #
       # @return [String] a message for the given status code
       #
+      # @raise [Hanami::Action::UnknownHttpStatusError] if the given code
+      #   cannot be associated to a known HTTP status
+      #
+      # @see https://guides.hanamirb.org/v2.0/actions/status-codes/
+      #
       # @since 0.3.2
       # @api private
+      #
+      # @example Integer HTTP Status
+      #   require "hanami/http/status"
+      #
+      #   Hanami::Http::Status.message_for(401)
+      #     # => "Unauthorized"
+      #
+      # @example Symbol HTTP Status
+      #   require "hanami/http/status"
+      #
+      #   Hanami::Http::Status.message_for(:unauthorized)
+      #     # => "Unauthorized"
+      #
+      # @example Unknown HTTP Status
+      #   require "hanami/http/status"
+      #
+      #   Hanami::Http::Status.message_for(999)
+      #     # => raise Hanami::Action::UnknownHttpStatusError
+      #
+      #   Hanami::Http::Status.message_for(:foo)
+      #     # => raise Hanami::Action::UnknownHttpStatusError
       def self.message_for(code)
         for_code(code)[1]
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hanami-controller
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.0.2
 platform: ruby
 authors:
 - Luca Guidi
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-12-25 00:00:00.000000000 Z
+date: 2023-02-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -222,7 +222,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.1
+rubygems_version: 3.4.5
 signing_key:
 specification_version: 4
 summary: Complete, fast and testable actions for Rack and Hanami