Contents

# frozen_string_literal: true

require "rack/static"

module Hanami
  # Serve static assets in deployment environments (production, staging) where
  # the stack doesn't include a web server.
  #
  # Web servers like Nginx are the ideal candidate to serve static assets.
  # They are faster than Ruby application servers (eg. Puma) and they should be
  # always preferred for this specific task.
  #
  # But there are some PaaS that don't allow to use web servers in front of Ruby
  # web applications. A classical example is Heroku, which requires the web
  # application to serve static assets.
  #
  # Hanami::Static is designed for this specific scenario.
  #
  # To enable it set the env variable `SERVE_STATIC_ASSETS` on `true`.
  #
  # NOTE: Please remember to precompile the assets at the deploy time with
  # `bundle exec hanami assets precompile`.
  #
  # @since 0.6.0
  # @api private
  #
  # @see http://www.rubydoc.info/gems/rack/Rack/Static
  class Static < ::Rack::Static
    # @since 0.8.0
    # @api private
    MAX_AGE      = 60 * 60 * 24 * 365 # One year

    # @since 0.8.0
    # @api private
    HEADER_RULES = [[:all, { "Cache-Control" => "public, max-age=#{MAX_AGE}" }]].freeze

    # @since 0.8.0
    # @api private
    URL_PREFIX = "/"

    # @since 0.6.0
    # @api private
    def initialize(app, root: Hanami.public_directory, header_rules: HEADER_RULES)
      super(app, urls: _urls(root), root: root, header_rules: header_rules)
    end

    private

    # @since 0.8.0
    # @api private
    def _urls(root)
      return [] unless root.exist?

      asset_files = Pathname.glob(root.join("**", "*"))
                            .select(&:file?)

      asset_files.each_with_object({}) do |path, result|
        path = path.relative_path_from(root)
        result["#{URL_PREFIX}#{path}"] = path
      end
    end
  end
end

Version data entries

7 entries across 7 versions & 1 rubygems

Version	Path
hanami-1.3.5	lib/hanami/static.rb
hanami-1.3.4	lib/hanami/static.rb
hanami-1.3.3	lib/hanami/static.rb
hanami-1.3.2	lib/hanami/static.rb
hanami-1.3.1	lib/hanami/static.rb
hanami-1.3.0	lib/hanami/static.rb
hanami-1.3.0.beta1	lib/hanami/static.rb