Sha256: 018642b3c784548d31edeeb0b9eacfaf9c52e8932c6ffb1d6867936210684834

Contents?: true

Size: 1.56 KB

Versions: 6

Compression:

Stored size: 1.56 KB

Contents

# frozen-string-literal: true

#
class Roda
  module RodaPlugins
    # The static plugin loads the Rack::Static middleware into the application.
    # It mainly exists to make serving static files simpler, by supplying
    # defaults to Rack::Static that are appropriate for Roda.
    #
    # The static plugin recognizes the application's :root option, and by default
    # sets the Rack::Static +:root+ option to the +public+ subfolder of the application's
    # +:root+ option.  Additionally, if a relative path is provided as the :root
    # option to the plugin, it will be considered relative to the application's
    # +:root+ option.
    #
    # Since the :urls option for Rack::Static is always required, the static plugin
    # uses a separate option for it.
    #
    # Users of this plugin may want to consider using the public plugin instead.
    # 
    # Examples:
    #
    #   opts[:root] = '/path/to/app'
    #   plugin :static, ['/js', '/css'] # path: /path/to/app/public
    #   plugin :static, ['/images'], :root=>'pub'  # path: /path/to/app/pub
    #   plugin :static, ['/media'], :root=>'/path/to/public' # path: /path/to/public
    module Static
      # Load the Rack::Static middleware.  Use the paths given as the :urls option,
      # and set the :root option to be relative to the application's :root option.
      def self.configure(app, paths, opts={})
        opts = opts.dup
        opts[:urls] = paths
        opts[:root] =  app.expand_path(opts[:root]||"public")
        app.use ::Rack::Static, opts
      end
    end

    register_plugin(:static, Static)
  end
end

Version data entries

6 entries across 6 versions & 1 rubygems

Version Path
roda-2.29.0 lib/roda/plugins/static.rb
roda-2.28.0 lib/roda/plugins/static.rb
roda-2.27.0 lib/roda/plugins/static.rb
roda-2.26.0 lib/roda/plugins/static.rb
roda-2.25.0 lib/roda/plugins/static.rb
roda-2.24.0 lib/roda/plugins/static.rb