sidekiq 7.3.9 → 8.0.1

data/lib/sidekiq/web/action.rb

@@ -1,115 +1,135 @@
 # frozen_string_literal: true
 
-module Sidekiq
-  class WebAction
-    RACK_SESSION = "rack.session"
+require "erb"
 
-    attr_accessor :env, :block, :type
+module Sidekiq
+  class Web
+    ##
+    # These instance methods are available to all executing ERB
+    # templates.
+    class Action
+      attr_accessor :env, :block
+
+      def initialize(env, block)
+        @_erb = false
+        @env = env
+        @block = block
+      end
 
-    def settings
-      Web.settings
-    end
+      def config
+        env[:web_config]
+      end
 
-    def request
-      @request ||= ::Rack::Request.new(env)
-    end
+      def request
+        @request ||= ::Rack::Request.new(env)
+      end
 
-    def halt(res)
-      throw :halt, [res, {Rack::CONTENT_TYPE => "text/plain"}, [res.to_s]]
-    end
+      def halt(res)
+        throw :halt, [res, {"content-type" => "text/plain"}, [res.to_s]]
+      end
 
-    def redirect(location)
-      throw :halt, [302, {Web::LOCATION => "#{request.base_url}#{location}"}, []]
-    end
+      # external redirect
+      def redirect_to(url)
+        throw :halt, [302, {"Location" => url}, []]
+      end
 
-    def reload_page
-      current_location = request.referer.gsub(request.base_url, "")
-      redirect current_location
-    end
+      def header(key, value)
+        env["response_headers"][key] = value
+      end
 
-    # deprecated, will warn in 8.0
-    def params
-      indifferent_hash = Hash.new { |hash, key| hash[key.to_s] if Symbol === key }
+      # internal redirect
+      def redirect(location)
+        throw :halt, [302, {"Location" => "#{request.base_url}#{location}"}, []]
+      end
 
-      indifferent_hash.merge! request.params
-      route_params.each { |k, v| indifferent_hash[k.to_s] = v }
+      def reload_page
+        current_location = request.referer.gsub(request.base_url, "")
+        redirect current_location
+      end
 
-      indifferent_hash
-    end
+      # stuff after ? or form input
+      # uses String keys, no Symbols!
+      def url_params(key)
+        warn { "URL parameter `#{key}` should be accessed via String, not Symbol (at #{caller(3..3).first})" } if key.is_a?(Symbol)
+        request.params[key.to_s]
+      end
 
-    # Use like `url_params("page")` within your action blocks
-    def url_params(key)
-      request.params[key]
-    end
+      # variables embedded in path, `/metrics/:name`
+      # uses Symbol keys, no Strings!
+      def route_params(key)
+        warn { "Route parameter `#{key}` should be accessed via Symbol, not String (at #{caller(3..3).first})" } if key.is_a?(String)
+        env["rack.route_params"][key.to_sym]
+      end
 
-    # Use like `route_params(:name)` within your action blocks
-    # key is required in 8.0, nil is only used for backwards compatibility
-    def route_params(key = nil)
-      if key
-        env[WebRouter::ROUTE_PARAMS][key]
-      else
-        env[WebRouter::ROUTE_PARAMS]
+      def params
+        warn { "Direct access to Rack parameters is discouraged, use `url_params` or `route_params` (at #{caller(3..3).first})" }
+        request.params
       end
-    end
 
-    def session
-      env[RACK_SESSION]
-    end
+      def session
+        env["rack.session"]
+      end
 
-    def erb(content, options = {})
-      if content.is_a? Symbol
-        unless respond_to?(:"_erb_#{content}")
-          views = options[:views] || Web.settings.views
-          filename = "#{views}/#{content}.erb"
-          src = ERB.new(File.read(filename)).src
-
-          # Need to use lineno less by 1 because erb generates a
-          # comment before the source code.
-          WebAction.class_eval <<-RUBY, filename, -1 # standard:disable Style/EvalWithLocation
-            def _erb_#{content}
-              #{src}
-            end
-          RUBY
+      def erb(content, options = {})
+        if content.is_a? Symbol
+          unless respond_to?(:"_erb_#{content}")
+            views = options[:views] || Web.views
+            filename = "#{views}/#{content}.erb"
+            src = ERB.new(File.read(filename)).src
+
+            # Need to use lineno less by 1 because erb generates a
+            # comment before the source code.
+            Action.class_eval <<-RUBY, filename, -1 # standard:disable Style/EvalWithLocation
+              def _erb_#{content}
+                #{src}
+              end
+            RUBY
+          end
         end
-      end
 
-      if @_erb
-        _erb(content, options[:locals])
-      else
-        @_erb = true
-        content = _erb(content, options[:locals])
+        if @_erb
+          _erb(content, options[:locals])
+        else
+          @_erb = true
+          content = _erb(content, options[:locals])
 
-        _render { content }
+          _render { content }
+        end
       end
-    end
 
-    def render(engine, content, options = {})
-      raise "Only erb templates are supported" if engine != :erb
+      def render(engine, content, options = {})
+        raise "Only erb templates are supported" if engine != :erb
 
-      erb(content, options)
-    end
+        erb(content, options)
+      end
 
-    def json(payload)
-      [200, {Rack::CONTENT_TYPE => "application/json", Rack::CACHE_CONTROL => "private, no-store"}, [Sidekiq.dump_json(payload)]]
-    end
+      def json(payload)
+        [200,
+          {"content-type" => "application/json", "cache-control" => "private, no-store"},
+          [Sidekiq.dump_json(payload)]]
+      end
 
-    def initialize(env, block)
-      @_erb = false
-      @env = env
-      @block = block
-      @files ||= {}
-    end
+      private
 
-    private
+      def warn
+        Sidekiq.logger.warn yield
+      end
 
-    def _erb(file, locals)
-      locals&.each { |k, v| define_singleton_method(k) { v } unless singleton_methods.include? k }
+      def _erb(file, locals)
+        locals&.each { |k, v| define_singleton_method(k) { v } unless singleton_methods.include? k }
 
-      if file.is_a?(String)
-        ERB.new(file).result(binding)
-      else
-        send(:"_erb_#{file}")
+        if file.is_a?(String)
+          ERB.new(file).result(binding)
+        else
+          send(:"_erb_#{file}")
+        end
       end
+
+      class_eval <<-RUBY, ::Sidekiq::Web::LAYOUT, -1 # standard:disable Style/EvalWithLocation
+        def _render
+          #{ERB.new(File.read(::Sidekiq::Web::LAYOUT)).src}
+        end
+      RUBY
     end
   end
 end