hanami-controller 1.3.2 → 2.0.0.alpha3

data/lib/hanami/action/configuration.rb

@@ -0,0 +1,428 @@
+# frozen_string_literal: true
+
+require "dry/configurable"
+require "hanami/utils/kernel"
+require "pathname"
+require_relative "mime"
+
+module Hanami
+  class Action
+    class Configuration
+      include Dry::Configurable
+
+      # Initialize the Configuration
+      #
+      # @yield [config] the configuration object
+      #
+      # @return [Configuration]
+      #
+      # @since 2.0.0
+      # @api private
+      def initialize(*)
+        super
+        yield self if block_given?
+      end
+
+      # Returns the list of available settings
+      #
+      # @return [Set]
+      #
+      # @since 2.0.0
+      # @api private
+      def settings
+        self.class.settings
+      end
+
+      # @!method handled_exceptions=(exceptions)
+      #
+      #   Specifies how to handle exceptions with an HTTP status
+      #
+      #   Raised exceptions will return the corresponding HTTP status
+      #
+      #   @param exceptions [Hash{Exception=>Integer}] exception classes as
+      #     keys and HTTP statuses as values
+      #
+      #   @return [void]
+      #
+      #   @since 0.2.0
+      #
+      #   @example
+      #     configuration.handled_exceptions = {ArgumentError => 400}
+      #
+      # @!method handled_exceptions
+      #
+      #   Returns the configured handled exceptions
+      #
+      #   @return [Hash{Exception=>Integer}]
+      #
+      #   @see handled_exceptions=
+      #
+      #   @since 0.2.0
+      setting :handled_exceptions, default: {}
+
+      # Specifies how to handle exceptions with an HTTP status
+      #
+      # Raised exceptions will return the corresponding HTTP status
+      #
+      # The specified exceptions will be merged with any previously configured
+      # exceptions
+      #
+      # @param exceptions [Hash{Exception=>Integer}] exception classes as keys
+      #   and HTTP statuses as values
+      #
+      # @return [void]
+      #
+      # @since 0.2.0
+      #
+      # @see handled_exceptions=
+      #
+      # @example
+      #   configuration.handle_exceptions(ArgumentError => 400}
+      def handle_exception(exceptions)
+        self.handled_exceptions = handled_exceptions
+          .merge(exceptions)
+          .sort { |(ex1, _), (ex2, _)| ex1.ancestors.include?(ex2) ? -1 : 1 }
+          .to_h
+      end
+
+      # Default MIME type to format mapping
+      #
+      # @since 0.2.0
+      # @api private
+      DEFAULT_FORMATS = {
+        'application/octet-stream' => :all,
+        '*/*'                      => :all,
+        'text/html'                => :html
+      }.freeze
+
+      # @!method formats=(formats)
+      #
+      #   Specifies the MIME type to format mapping
+      #
+      #   @param formats [Hash{String=>Symbol}] MIME type strings as keys and
+      #     format symbols as values
+      #
+      #   @return [void]
+      #
+      #   @since 0.2.0
+      #
+      #   @see format
+      #   @see Hanami::Action::Mime
+      #
+      #   @example
+      #     configuration.formats = {"text/html" => :html}
+      #
+      # @!method formats
+      #
+      #   Returns the configured MIME type to format mapping
+      #
+      #   @return [Symbol,nil] the corresponding format, if present
+      #
+      #   @see format
+      #   @see formats=
+      #
+      #   @since 0.2.0
+      setting :formats, default: DEFAULT_FORMATS.dup
+
+      # Registers a MIME type to format mapping
+      #
+      # @param hash [Hash{Symbol=>String}] format symbols as keys and the MIME
+      #   type strings must as values
+      #
+      # @return [void]
+      #
+      # @since 0.2.0
+      #
+      # @see Hanami::Action::Mime
+      #
+      # @example configuration.format html: "text/html"
+      def format(hash)
+        symbol, mime_type = *Utils::Kernel.Array(hash)
+        formats[Utils::Kernel.String(mime_type)] = Utils::Kernel.Symbol(symbol)
+      end
+
+      # Returns the configured format for the given MIME type
+      #
+      # @param mime_type [#to_s,#to_str] A mime type
+      #
+      # @return [Symbol,nil] the corresponding format, nil if not found
+      #
+      # @see format
+      #
+      # @since 0.2.0
+      # @api private
+      def format_for(mime_type)
+        formats[mime_type]
+      end
+
+      # Returns the configured format's MIME types
+      #
+      # @return [Array<String>] the format's MIME types
+      #
+      # @see formats=
+      # @see format
+      #
+      # @since 0.8.0
+      #
+      # @api private
+      def mime_types
+        # FIXME: this isn't efficient. speed it up!
+        ((formats.keys - DEFAULT_FORMATS.keys) +
+          Hanami::Action::Mime::TYPES.values).freeze
+      end
+
+      # Returns a MIME type for the given format
+      #
+      # @param format [#to_sym] a format
+      #
+      # @return [String,nil] the corresponding MIME type, if present
+      #
+      # @since 0.2.0
+      # @api private
+      def mime_type_for(format)
+        formats.key(format)
+      end
+
+      # @!method default_request_format=(format)
+      #
+      #   Sets a format as default fallback for all the requests without a strict
+      #   requirement for the MIME type.
+      #
+      #   The given format must be coercible to a symbol, and be a valid MIME
+      #   type alias. If it isn't, at runtime the framework will raise an
+      #   `Hanami::Controller::UnknownFormatError`.
+      #
+      #   By default, this value is nil.
+      #
+      #   @param format [Symbol]
+      #
+      #   @return [void]
+      #
+      #   @since 0.5.0
+      #
+      #   @see Hanami::Action::Mime
+      #
+      # @!method default_request_format
+      #
+      #   Returns the configured default request format
+      #
+      #   @return [Symbol] format
+      #
+      #   @see default_request_format=
+      #
+      #   @since 0.5.0
+      setting :default_request_format, constructor: -> format {
+        Utils::Kernel.Symbol(format) unless format.nil?
+      }
+
+      # @!method default_response_format=(format)
+      #
+      #   Sets a format to be used for all responses regardless of the request
+      #   type.
+      #
+      #   The given format must be coercible to a symbol, and be a valid MIME
+      #   type alias. If it isn't, at the runtime the framework will raise an
+      #   `Hanami::Controller::UnknownFormatError`.
+      #
+      #   By default, this value is nil.
+      #
+      #   @param format [Symbol]
+      #
+      #   @return [void]
+      #
+      #   @since 0.5.0
+      #
+      #   @see Hanami::Action::Mime
+      #
+      # @!method default_response_format
+      #
+      #   Returns the configured default response format
+      #
+      #   @return [Symbol] format
+      #
+      #   @see default_request_format=
+      #
+      #   @since 0.5.0
+      setting :default_response_format, constructor: -> format {
+        Utils::Kernel.Symbol(format) unless format.nil?
+      }
+
+      # @!method default_charset=(charset)
+      #
+      #   Sets a charset (character set) as default fallback for all the requests
+      #   without a strict requirement for the charset.
+      #
+      #   By default, this value is nil.
+      #
+      #   @param charset [String]
+      #
+      #   @return [void]
+      #
+      #   @since 0.3.0
+      #
+      #   @see Hanami::Action::Mime
+      #
+      # @!method default_charset
+      #
+      #   Returns the configured default charset.
+      #
+      #   @return [String,nil] the charset, if present
+      #
+      #   @see default_charset=
+      #
+      #   @since 0.3.0
+      setting :default_charset
+
+      # @!method default_headers=(headers)
+      #
+      #   Sets default headers for all responses.
+      #
+      #   By default, this is an empty hash.
+      #
+      #   @param headers [Hash{String=>String}] the headers
+      #
+      #   @return [void]
+      #
+      #   @since 0.4.0
+      #
+      #   @see default_headers
+      #
+      #   @example
+      #     configuration.default_headers = {'X-Frame-Options' => 'DENY'}
+      #
+      # @!method default_headers
+      #
+      #   Returns the configured headers
+      #
+      #   @return [Hash{String=>String}] the headers
+      #
+      #   @since 0.4.0
+      #
+      #   @see default_headers=
+      setting :default_headers, default: {}, constructor: -> headers { headers.compact }
+
+      # @!method cookies=(cookie_options)
+      #
+      #   Sets default cookie options for all responses.
+      #
+      #   By default this, is an empty hash.
+      #
+      #   @param cookie_options [Hash{Symbol=>String}] the cookie options
+      #
+      #   @return [void]
+      #
+      #   @since 0.4.0
+      #
+      #   @example
+      #     configuration.cookies = {
+      #       domain: 'hanamirb.org',
+      #       path: '/controller',
+      #       secure: true,
+      #       httponly: true
+      #     }
+      #
+      # @!method cookies
+      #
+      #   Returns the configured cookie options
+      #
+      #   @return [Hash{Symbol=>String}]
+      #
+      #   @since 0.4.0
+      #
+      #   @see cookies=
+      setting :cookies, default: {}, constructor: -> cookie_options {
+        # Call `to_h` here to permit `ApplicationConfiguration::Cookies` object to be
+        # provided when application actions are configured
+        cookie_options.to_h.compact
+      }
+
+      # @!method root_directory=(dir)
+      #
+      #   Sets the the for the public directory, which is used for file downloads.
+      #   This must be an existent directory.
+      #
+      #   Defaults to the current working directory.
+      #
+      #   @param dir [String] the directory path
+      #
+      #   @return [void]
+      #
+      #   @since 1.0.0
+      #
+      #   @api private
+      #
+      # @!method root_directory
+      #
+      #   Returns the configured root directory
+      #
+      #   @return [String] the directory path
+      #
+      #   @see root_directory=
+      #
+      #   @since 1.0.0
+      #
+      #   @api private
+      setting :root_directory, constructor: -> dir {
+        dir ||= Dir.pwd
+
+        Pathname(dir).realpath
+      }
+
+      # Default public directory
+      #
+      # This serves as the root directory for file downloads
+      #
+      # @since 1.0.0
+      #
+      # @api private
+      DEFAULT_PUBLIC_DIRECTORY = 'public'.freeze
+
+      # @!method public_directory=(directory)
+      #
+      #   Sets the path to public directory. This directory is used for file downloads.
+      #
+      #   This given directory will be appended onto the root directory.
+      #
+      #   By default, the public directory is "public".
+      #
+      #   @param directory [String] the public directory path
+      #
+      #   @return [void]
+      #
+      #   @see root_directory
+      #   @see public_directory
+      setting :public_directory, default: DEFAULT_PUBLIC_DIRECTORY
+
+      # Returns the configured public directory, appended onto the root directory.
+      #
+      # @return [String] the fill directory path
+      #
+      # @example
+      #   configuration.public_directory = "public"
+      #
+      #   configuration.public_directory
+      #   # => "/path/to/root/public"
+      #
+      # @see public_directory=
+      # @see root_directory=
+      def public_directory
+        # This must be a string, for Rack compatibility
+        root_directory.join(super).to_s
+      end
+
+      private
+
+      def method_missing(name, *args, &block)
+        if config.respond_to?(name)
+          config.public_send(name, *args, &block)
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(name, _incude_all = false)
+        config.respond_to?(name) || super
+      end
+    end
+  end
+end

data/lib/hanami/action/cookie_jar.rb

@@ -1,7 +1,7 @@
 require 'hanami/utils/hash'
 
 module Hanami
-  module Action
+  class Action
     # A set of HTTP Cookies
     #
     # It acts as an Hash
@@ -55,7 +55,7 @@ module Hanami
       # @since 0.1.0
       def initialize(env, headers, default_options)
         @_headers        = headers
-        @cookies         = Utils::Hash.new(extract(env)).deep_symbolize!
+        @cookies         = Utils::Hash.deep_symbolize(extract(env))
         @default_options = default_options
       end
 
@@ -166,7 +166,7 @@ module Hanami
       # @since 0.4.0
       # @api private
       def _merge_default_values(value)
-        cookies_options = if value.is_a? Hash
+        cookies_options = if value.is_a?(::Hash)
           value.merge! _add_expires_option(value)
         else
           { value: value }

data/lib/hanami/action/cookies.rb

@@ -1,7 +1,5 @@
-require 'hanami/action/cookie_jar'
-
 module Hanami
-  module Action
+  class Action
     # Cookies API
     #
     # This module isn't included by default.
@@ -10,63 +8,6 @@ module Hanami
     #
     # @see Hanami::Action::Cookies#cookies
     module Cookies
-      protected
-
-      # Gets the cookies from the request and expose them as an Hash
-      #
-      # It automatically sets options from global configuration, but it allows to
-      # override values case by case.
-      #
-      # For a list of options please have a look at <tt>Hanami::Controller::Configuration</tt>,
-      # and <tt>Hanami::Action::CookieJar</tt>.
-      #
-      # @return [Hanami::Action::CookieJar] cookies
-      #
-      # @since 0.1.0
-      #
-      # @see Hanami::Controller::Configuration#cookies
-      # @see Hanami::Action::CookieJar#[]=
-      #
-      # @example Basic Usage
-      #   require 'hanami/controller'
-      #   require 'hanami/action/cookies'
-      #
-      #   class Show
-      #     include Hanami::Action
-      #     include Hanami::Action::Cookies
-      #
-      #     def call(params)
-      #       # ...
-      #
-      #       # get a value
-      #       cookies[:user_id] # => '23'
-      #
-      #       # set a value
-      #       cookies[:foo] = 'bar'
-      #
-      #       # remove a value
-      #       cookies[:bax] = nil
-      #     end
-      #   end
-      #
-      # @example Cookies Options
-      #   require 'hanami/controller'
-      #   require 'hanami/action/cookies'
-      #
-      #   class Show
-      #     include Hanami::Action
-      #     include Hanami::Action::Cookies
-      #
-      #     def call(params)
-      #       # ...
-      #       # set a value
-      #       cookies[:foo] = { value: 'bar', max_age: 300, path: '/dashboard' }
-      #     end
-      #   end
-      def cookies
-        @cookies ||= CookieJar.new(@_env.dup, headers, configuration.cookies)
-      end
-
       private
 
       # Finalize the response by flushing cookies into the response
@@ -75,9 +16,9 @@ module Hanami
       # @api private
       #
       # @see Hanami::Action#finish
-      def finish
+      def finish(req, res, *)
+        res.cookies.finish
         super
-        cookies.finish
       end
     end
   end