rackup 1.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92bf342afdd0c82df66b17a4d0a18102b82ff4f6fe0d6c0a9c6c448c1833b020
-  data.tar.gz: '0803347f74697ae828f519c5ec3bb3c9d52aa67605c1cc86c918e460ef3b2f22'
+  metadata.gz: a0b31e72267a0dc7a7cc3bbe41d06b49ea16ec3612edc7474fe5c99c97e568cf
+  data.tar.gz: 6b9b9f197c6929bed47b7bb3c81f13f956427e1d078ab2a4b12afc0c4400f881
 SHA512:
-  metadata.gz: ccc75df436ba2fba6a7971d0eb0db09714cf90364eeca96d380f3cc86b57845e5d4c38fb1bb9d91cce47207656926de42ebec03d2688dad292fc00c48f76dcf0
-  data.tar.gz: 074af927d0ed8d981ad74d02139e7493269d6406b3426675aab136d051e4d93e7355f98ca5ae4081458e35572efa8360db47fe657e6dce6ab57a7cf711bae626
+  metadata.gz: 21aba248befe16cd582ac7c867bc28cecd41155e2f8979e8cecba248e2f1623894c3f943484a85a189d3e2bdec45c836ad8f9f2995a2362809332b1b99dcd3d5
+  data.tar.gz: 258c30b02fc3d454df9dcd1d6285f0f3b6d592728f856c53e761c37db2a56925bc0a90bf0b3330441c754fddec280501abc13aa2032a120f3ce5917bd38c817f

data/bin/rackup

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/rackup"
+Rackup::Server.start

data/lib/rack/handler.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2022-2023, by Samuel Williams.
+
+warn "Rack::Handler is deprecated and replaced by Rackup::Handler"
+require_relative '../rackup/handler'
+module Rack
+	Handler = ::Rackup::Handler
+end

data/lib/rack/server.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2022-2023, by Samuel Williams.
+
+warn "Rack::Server is deprecated and replaced by Rackup::Server"
+require_relative '../rackup/server'
+module Rack
+	Server = ::Rackup::Server
+end

data/lib/rackup/handler/cgi.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2022-2023, by Samuel Williams.
+
+module Rackup
+  module Handler
+    class CGI
+      include Rack
+
+      def self.run(app, **options)
+        $stdin.binmode
+        serve app
+      end
+
+      def self.serve(app)
+        env = ENV.to_hash
+        env.delete "HTTP_CONTENT_LENGTH"
+
+        env[SCRIPT_NAME] = ""  if env[SCRIPT_NAME] == "/"
+
+        env.update(
+          RACK_INPUT        => $stdin,
+          RACK_ERRORS       => $stderr,
+          RACK_URL_SCHEME   => ["yes", "on", "1"].include?(ENV[HTTPS]) ? "https" : "http"
+        )
+
+        env[QUERY_STRING] ||= ""
+        env[REQUEST_PATH] ||= "/"
+
+        status, headers, body = app.call(env)
+        begin
+          send_headers status, headers
+          send_body body
+        ensure
+          body.close  if body.respond_to? :close
+        end
+      end
+
+      def self.send_headers(status, headers)
+        $stdout.print "Status: #{status}\r\n"
+        headers.each { |k, vs|
+          vs.split("\n").each { |v|
+            $stdout.print "#{k}: #{v}\r\n"
+          }
+        }
+        $stdout.print "\r\n"
+        $stdout.flush
+      end
+
+      def self.send_body(body)
+        body.each { |part|
+          $stdout.print part
+          $stdout.flush
+        }
+      end
+    end
+
+    register :cgi, CGI
+  end
+end

data/lib/rackup/handler/webrick.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2022-2023, by Samuel Williams.
+# Copyright, 2022, by Jeremy Evans.
+
+require 'webrick'
+require 'stringio'
+
+require 'rack/constants'
+require_relative '../handler'
+require_relative '../version'
+
+require_relative '../stream'
+
+module Rackup
+  module Handler
+    class WEBrick < ::WEBrick::HTTPServlet::AbstractServlet
+      def self.run(app, **options)
+        environment  = ENV['RACK_ENV'] || 'development'
+        default_host = environment == 'development' ? 'localhost' : nil
+
+        if !options[:BindAddress] || options[:Host]
+          options[:BindAddress] = options.delete(:Host) || default_host
+        end
+        options[:Port] ||= 8080
+        if options[:SSLEnable]
+          require 'webrick/https'
+        end
+
+        @server = ::WEBrick::HTTPServer.new(options)
+        @server.mount "/", Rackup::Handler::WEBrick, app
+        yield @server if block_given?
+        @server.start
+      end
+
+      def self.valid_options
+        environment  = ENV['RACK_ENV'] || 'development'
+        default_host = environment == 'development' ? 'localhost' : '0.0.0.0'
+
+        {
+          "Host=HOST" => "Hostname to listen on (default: #{default_host})",
+          "Port=PORT" => "Port to listen on (default: 8080)",
+        }
+      end
+
+      def self.shutdown
+        if @server
+          @server.shutdown
+          @server = nil
+        end
+      end
+
+      def initialize(server, app)
+        super server
+        @app = app
+      end
+
+      # This handles mapping the WEBrick request to a Rack input stream.
+      class Input
+        include Stream::Reader
+
+        def initialize(request)
+          @request = request
+
+          @reader = Fiber.new do
+            @request.body do |chunk|
+              Fiber.yield(chunk)
+            end
+
+            Fiber.yield(nil)
+
+            # End of stream:
+            @reader = nil
+          end
+        end
+
+        def close
+          @request = nil
+          @reader = nil
+        end
+
+        private
+
+        # Read one chunk from the request body.
+        def read_next
+          @reader&.resume
+        end
+      end
+
+      def service(req, res)
+        env = req.meta_vars
+        env.delete_if { |k, v| v.nil? }
+
+        input = Input.new(req)
+
+        env.update(
+          ::Rack::RACK_INPUT => input,
+          ::Rack::RACK_ERRORS => $stderr,
+          ::Rack::RACK_URL_SCHEME => ["yes", "on", "1"].include?(env[::Rack::HTTPS]) ? "https" : "http",
+          ::Rack::RACK_IS_HIJACK => true,
+        )
+
+        env[::Rack::QUERY_STRING] ||= ""
+        unless env[::Rack::PATH_INFO] == ""
+          path, n = req.request_uri.path, env[::Rack::SCRIPT_NAME].length
+          env[::Rack::PATH_INFO] = path[n, path.length - n]
+        end
+        env[::Rack::REQUEST_PATH] ||= [env[::Rack::SCRIPT_NAME], env[::Rack::PATH_INFO]].join
+
+        status, headers, body = @app.call(env)
+        begin
+          res.status = status
+
+          if value = headers[::Rack::RACK_HIJACK]
+            io_lambda = value
+            body = nil
+          elsif !body.respond_to?(:to_path) && !body.respond_to?(:each)
+            io_lambda = body
+            body = nil
+          end
+
+          if value = headers.delete('set-cookie')
+            res.cookies.concat(Array(value))
+          end
+
+          headers.each do |key, value|
+            # Skip keys starting with rack., per Rack SPEC
+            next if key.start_with?('rack.')
+
+            # Since WEBrick won't accept repeated headers,
+            # merge the values per RFC 1945 section 4.2.
+            value = value.join(", ") if Array === value
+            res[key] = value
+          end
+
+          if io_lambda
+            protocol = headers['rack.protocol'] || headers['upgrade']
+
+            if protocol
+              # Set all the headers correctly for an upgrade response:
+              res.upgrade!(protocol)
+            end
+            res.body = io_lambda
+          elsif body.respond_to?(:to_path)
+            res.body = ::File.open(body.to_path, 'rb')
+          else
+            buffer = String.new
+            body.each do |part|
+              buffer << part
+            end
+            res.body = buffer
+          end
+        ensure
+          body.close if body.respond_to?(:close)
+        end
+      end
+    end
+
+    register :webrick, WEBrick
+  end
+end

data/lib/rackup/handler.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2022-2023, by Samuel Williams.
+
+module Rackup
+  # *Handlers* connect web servers with Rack.
+  #
+  # Rackup includes Handlers for WEBrick and CGI.
+  #
+  # Handlers usually are activated by calling <tt>MyHandler.run(myapp)</tt>.
+  # A second optional hash can be passed to include server-specific
+  # configuration.
+  module Handler
+    @handlers = {}
+
+    # Register a named handler class.
+    def self.register(name, klass)
+      if klass.is_a?(String)
+        warn "Calling Rackup::Handler.register with a string is deprecated, use the class/module itself.", uplevel: 1
+
+        klass = self.const_get(klass, false)
+      end
+
+      name = name.to_sym
+
+      @handlers[name] = klass
+    end
+
+    def self.[](name)
+      name = name.to_sym
+
+      begin
+        @handlers[name] || self.const_get(name, false)
+      rescue NameError
+        # Ignore.
+      end
+    end
+
+    def self.get(name)
+      return nil unless name
+
+      name = name.to_sym
+
+      if server = self[name]
+        return server
+      end
+
+      begin
+        require_handler("rackup/handler", name)
+      rescue LoadError
+        require_handler("rack/handler", name)
+      end
+
+      return self[name]
+    end
+
+    RACK_HANDLER = 'RACK_HANDLER'
+    RACKUP_HANDLER = 'RACKUP_HANDLER'
+
+    SERVER_NAMES = %i(puma falcon webrick).freeze
+    private_constant :SERVER_NAMES
+
+    # Select first available Rack handler given an `Array` of server names.
+    # Raises `LoadError` if no handler was found.
+    #
+    #   > pick ['puma', 'webrick']
+    #   => Rackup::Handler::WEBrick
+    def self.pick(server_names)
+      server_names = Array(server_names)
+
+      server_names.each do |server_name|
+        begin
+          server = self.get(server_name)
+         return server if server
+        rescue LoadError
+          # Ignore.
+        end
+      end
+
+      raise LoadError, "Couldn't find handler for: #{server_names.join(', ')}."
+    end
+
+    def self.default
+      if rack_handler = ENV[RACKUP_HANDLER]
+        self.get(rack_handler)
+      elsif rack_handler = ENV[RACK_HANDLER]
+        warn "RACK_HANDLER is deprecated, use RACKUP_HANDLER."
+        self.get(rack_handler)
+      else
+        pick SERVER_NAMES
+      end
+    end
+
+    # Transforms server-name constants to their canonical form as filenames,
+    # then tries to require them but silences the LoadError if not found
+    #
+    # Naming convention:
+    #
+    #   Foo # => 'foo'
+    #   FooBar # => 'foo_bar.rb'
+    #   FooBAR # => 'foobar.rb'
+    #   FOObar # => 'foobar.rb'
+    #   FOOBAR # => 'foobar.rb'
+    #   FooBarBaz # => 'foo_bar_baz.rb'
+    def self.require_handler(prefix, const_name)
+      file = const_name.to_s.gsub(/^[A-Z]+/) { |pre| pre.downcase }.
+        gsub(/[A-Z]+[^A-Z]/, '_\&').downcase
+
+      require(::File.join(prefix, file))
+    end
+  end
+end

data/lib/rackup/lobster.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2022-2023, by Samuel Williams.
+
+require 'zlib'
+
+require 'rack/constants'
+require 'rack/request'
+require 'rack/response'
+
+module Rackup
+  # Paste has a Pony, Rack has a Lobster!
+  class Lobster
+    include Rack
+
+    LobsterString = Zlib::Inflate.inflate("eJx9kEEOwyAMBO99xd7MAcytUhPlJyj2
+    P6jy9i4k9EQyGAnBarEXeCBqSkntNXsi/ZCvC48zGQoZKikGrFMZvgS5ZHd+aGWVuWwhVF0
+    t1drVmiR42HcWNz5w3QanT+2gIvTVCiE1lm1Y0eU4JGmIIbaKwextKn8rvW+p5PIwFl8ZWJ
+    I8jyiTlhTcYXkekJAzTyYN6E08A+dk8voBkAVTJQ==".delete("\n ").unpack("m*")[0])
+
+    LambdaLobster = lambda { |env|
+      if env[QUERY_STRING].include?("flip")
+        lobster = LobsterString.split("\n").
+          map { |line| line.ljust(42).reverse }.
+          join("\n")
+        href = "?"
+      else
+        lobster = LobsterString
+        href = "?flip"
+      end
+
+      content = ["<title>Lobstericious!</title>",
+                 "<pre>", lobster, "</pre>",
+                 "<a href='#{href}'>flip!</a>"]
+      length = content.inject(0) { |a, e| a + e.size }.to_s
+      [200, { CONTENT_TYPE => "text/html", CONTENT_LENGTH => length }, content]
+    }
+
+    def call(env)
+      req = Request.new(env)
+      if req.GET["flip"] == "left"
+        lobster = LobsterString.split("\n").map do |line|
+          line.ljust(42).reverse.
+            gsub('\\', 'TEMP').
+            gsub('/', '\\').
+            gsub('TEMP', '/').
+            gsub('{', '}').
+            gsub('(', ')')
+        end.join("\n")
+        href = "?flip=right"
+      elsif req.GET["flip"] == "crash"
+        raise "Lobster crashed"
+      else
+        lobster = LobsterString
+        href = "?flip=left"
+      end
+
+      res = Response.new
+      res.write "<title>Lobstericious!</title>"
+      res.write "<pre>"
+      res.write lobster
+      res.write "</pre>"
+      res.write "<p><a href='#{href}'>flip!</a></p>"
+      res.write "<p><a href='?flip=crash'>crash!</a></p>"
+      res.finish
+    end
+
+  end
+end
+
+if $0 == __FILE__
+  # :nocov:
+  require_relative 'server'
+  require_relative 'show_exceptions'
+  require_relative 'lint'
+  Rackup::Server.start(
+    app: Rack::ShowExceptions.new(Rack::Lint.new(Rackup::Lobster.new)), Port: 9292
+  )
+  # :nocov:
+end

data/lib/rackup/server.rb

@@ -0,0 +1,462 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2022-2023, by Samuel Williams.
+
+require 'optparse'
+require 'fileutils'
+
+require 'rack/builder'
+require 'rack/common_logger'
+require 'rack/content_length'
+require 'rack/show_exceptions'
+require 'rack/lint'
+require 'rack/tempfile_reaper'
+
+require 'rack/version'
+
+require_relative 'version'
+require_relative 'handler'
+
+module Rackup
+  class Server
+    class Options
+      def parse!(args)
+        options = {}
+        opt_parser = OptionParser.new("", 24, '  ') do |opts|
+          opts.banner = "Usage: rackup [ruby options] [rack options] [rackup config]"
+
+          opts.separator ""
+          opts.separator "Ruby options:"
+
+          lineno = 1
+          opts.on("-e", "--eval LINE", "evaluate a LINE of code") { |line|
+            eval line, TOPLEVEL_BINDING, "-e", lineno
+            lineno += 1
+          }
+
+          opts.on("-d", "--debug", "set debugging flags (set $DEBUG to true)") {
+            options[:debug] = true
+          }
+          opts.on("-w", "--warn", "turn warnings on for your script") {
+            options[:warn] = true
+          }
+          opts.on("-q", "--quiet", "turn off logging") {
+            options[:quiet] = true
+          }
+
+          opts.on("-I", "--include PATH",
+                  "specify $LOAD_PATH (may be used more than once)") { |path|
+            (options[:include] ||= []).concat(path.split(":"))
+          }
+
+          opts.on("-r", "--require LIBRARY",
+                  "require the library, before executing your script") { |library|
+            (options[:require] ||= []) << library
+          }
+
+          opts.separator ""
+          opts.separator "Rack options:"
+          opts.on("-b", "--builder BUILDER_LINE", "evaluate a BUILDER_LINE of code as a builder script") { |line|
+            options[:builder] = line
+          }
+
+          opts.on("-s", "--server SERVER", "serve using SERVER (thin/puma/webrick)") { |s|
+            options[:server] = s
+          }
+
+          opts.on("-o", "--host HOST", "listen on HOST (default: localhost)") { |host|
+            options[:Host] = host
+          }
+
+          opts.on("-p", "--port PORT", "use PORT (default: 9292)") { |port|
+            options[:Port] = port
+          }
+
+          opts.on("-O", "--option NAME[=VALUE]", "pass VALUE to the server as option NAME. If no VALUE, sets it to true. Run '#{$0} -s SERVER -h' to get a list of options for SERVER") { |name|
+            name, value = name.split('=', 2)
+            value = true if value.nil?
+            options[name.to_sym] = value
+          }
+
+          opts.on("-E", "--env ENVIRONMENT", "use ENVIRONMENT for defaults (default: development)") { |e|
+            options[:environment] = e
+          }
+
+          opts.on("-D", "--daemonize", "run daemonized in the background") { |d|
+            options[:daemonize] ||= true
+          }
+
+          opts.on("--daemonize-noclose", "run daemonized in the background without closing stdout/stderr") {
+            options[:daemonize] = :noclose
+          }
+
+          opts.on("-P", "--pid FILE", "file to store PID") { |f|
+            options[:pid] = ::File.expand_path(f)
+          }
+
+          opts.separator ""
+          opts.separator "Profiling options:"
+
+          opts.on("--heap HEAPFILE", "Build the application, then dump the heap to HEAPFILE") do |e|
+            options[:heapfile] = e
+          end
+
+          opts.on("--profile PROFILE", "Dump CPU or Memory profile to PROFILE (defaults to a tempfile)") do |e|
+            options[:profile_file] = e
+          end
+
+          opts.on("--profile-mode MODE", "Profile mode (cpu|wall|object)") do |e|
+            unless %w[cpu wall object].include?(e)
+              raise OptionParser::InvalidOption, "unknown profile mode: #{e}"
+            end
+            options[:profile_mode] = e.to_sym
+          end
+
+          opts.separator ""
+          opts.separator "Common options:"
+
+          opts.on_tail("-h", "-?", "--help", "Show this message") do
+            puts opts
+            puts handler_opts(options)
+
+            exit
+          end
+
+          opts.on_tail("--version", "Show version") do
+            puts "Rack #{Rack::RELEASE}"
+            exit
+          end
+        end
+
+        begin
+          opt_parser.parse! args
+        rescue OptionParser::InvalidOption => e
+          warn e.message
+          abort opt_parser.to_s
+        end
+
+        options[:config] = args.last if args.last && !args.last.empty?
+        options
+      end
+
+      def handler_opts(options)
+        info = []
+        server = Rackup::Handler.get(options[:server]) || Rackup::Handler.default
+        if server && server.respond_to?(:valid_options)
+          info << ""
+          info << "Server-specific options for #{server.name}:"
+
+          has_options = false
+          server.valid_options.each do |name, description|
+            next if /^(Host|Port)[^a-zA-Z]/.match?(name.to_s) # ignore handler's host and port options, we do our own.
+            info << sprintf("  -O %-21s %s", name, description)
+            has_options = true
+          end
+          return "" if !has_options
+        end
+        info.join("\n")
+      rescue NameError, LoadError
+        return "Warning: Could not find handler specified (#{options[:server] || 'default'}) to determine handler-specific options"
+      end
+    end
+
+    # Start a new rack server (like running rackup). This will parse ARGV and
+    # provide standard ARGV rackup options, defaulting to load 'config.ru'.
+    #
+    # Providing an options hash will prevent ARGV parsing and will not include
+    # any default options.
+    #
+    # This method can be used to very easily launch a CGI application, for
+    # example:
+    #
+    #  Rack::Server.start(
+    #    :app => lambda do |e|
+    #      [200, {'content-type' => 'text/html'}, ['hello world']]
+    #    end,
+    #    :server => 'cgi'
+    #  )
+    #
+    # Further options available here are documented on Rack::Server#initialize
+    def self.start(options = nil)
+      new(options).start
+    end
+
+    attr_writer :options
+
+    # Options may include:
+    # * :app
+    #     a rack application to run (overrides :config and :builder)
+    # * :builder
+    #     a string to evaluate a Rack::Builder from
+    # * :config
+    #     a rackup configuration file path to load (.ru)
+    # * :environment
+    #     this selects the middleware that will be wrapped around
+    #     your application. Default options available are:
+    #       - development: CommonLogger, ShowExceptions, and Lint
+    #       - deployment: CommonLogger
+    #       - none: no extra middleware
+    #     note: when the server is a cgi server, CommonLogger is not included.
+    # * :server
+    #     choose a specific Rackup::Handler, e.g. cgi, fcgi, webrick
+    # * :daemonize
+    #     if truthy, the server will daemonize itself (fork, detach, etc)
+    #     if :noclose, the server will not close STDOUT/STDERR
+    # * :pid
+    #     path to write a pid file after daemonize
+    # * :Host
+    #     the host address to bind to (used by supporting Rackup::Handler)
+    # * :Port
+    #     the port to bind to (used by supporting Rackup::Handler)
+    # * :AccessLog
+    #     webrick access log options (or supporting Rackup::Handler)
+    # * :debug
+    #     turn on debug output ($DEBUG = true)
+    # * :warn
+    #     turn on warnings ($-w = true)
+    # * :include
+    #     add given paths to $LOAD_PATH
+    # * :require
+    #     require the given libraries
+    #
+    # Additional options for profiling app initialization include:
+    # * :heapfile
+    #     location for ObjectSpace.dump_all to write the output to
+    # * :profile_file
+    #     location for CPU/Memory (StackProf) profile output (defaults to a tempfile)
+    # * :profile_mode
+    #     StackProf profile mode (cpu|wall|object)
+    def initialize(options = nil)
+      @ignore_options = []
+
+      if options
+        @use_default_options = false
+        @options = options
+        @app = options[:app] if options[:app]
+      else
+        @use_default_options = true
+        @options = parse_options(ARGV)
+      end
+    end
+
+    def options
+      merged_options = @use_default_options ? default_options.merge(@options) : @options
+      merged_options.reject { |k, v| @ignore_options.include?(k) }
+    end
+
+    def default_options
+      environment  = ENV['RACK_ENV'] || 'development'
+      default_host = environment == 'development' ? 'localhost' : '0.0.0.0'
+
+      {
+        environment: environment,
+        pid: nil,
+        Port: 9292,
+        Host: default_host,
+        AccessLog: [],
+        config: "config.ru"
+      }
+    end
+
+    def app
+      @app ||= options[:builder] ? build_app_from_string : build_app_and_options_from_config
+    end
+
+    class << self
+      def logging_middleware
+        lambda { |server|
+          /CGI/.match?(server.server.name) || server.options[:quiet] ? nil : [Rack::CommonLogger, $stderr]
+        }
+      end
+
+      def default_middleware_by_environment
+        m = Hash.new {|h, k| h[k] = []}
+        m["deployment"] = [
+          [Rack::ContentLength],
+          logging_middleware,
+          [Rack::TempfileReaper]
+        ]
+        m["development"] = [
+          [Rack::ContentLength],
+          logging_middleware,
+          [Rack::ShowExceptions],
+          [Rack::Lint],
+          [Rack::TempfileReaper]
+        ]
+
+        m
+      end
+
+      def middleware
+        default_middleware_by_environment
+      end
+    end
+
+    def middleware
+      self.class.middleware
+    end
+
+    def start(&block)
+      if options[:warn]
+        $-w = true
+      end
+
+      if includes = options[:include]
+        $LOAD_PATH.unshift(*includes)
+      end
+
+      Array(options[:require]).each do |library|
+        require library
+      end
+
+      if options[:debug]
+        $DEBUG = true
+        require 'pp'
+        p options[:server]
+        pp wrapped_app
+        pp app
+      end
+
+      check_pid! if options[:pid]
+
+      # Touch the wrapped app, so that the config.ru is loaded before
+      # daemonization (i.e. before chdir, etc).
+      handle_profiling(options[:heapfile], options[:profile_mode], options[:profile_file]) do
+        wrapped_app
+      end
+
+      daemonize_app if options[:daemonize]
+
+      write_pid if options[:pid]
+
+      trap(:INT) do
+        if server.respond_to?(:shutdown)
+          server.shutdown
+        else
+          exit
+        end
+      end
+
+      server.run(wrapped_app, **options, &block)
+    end
+
+    def server
+      @_server ||= Handler.get(options[:server]) || Handler.default
+    end
+
+    private
+      def build_app_and_options_from_config
+        if !::File.exist? options[:config]
+          abort "configuration #{options[:config]} not found"
+        end
+
+        return Rack::Builder.parse_file(self.options[:config])
+      end
+
+      def handle_profiling(heapfile, profile_mode, filename)
+        if heapfile
+          require "objspace"
+          ObjectSpace.trace_object_allocations_start
+          yield
+          GC.start
+          ::File.open(heapfile, "w") { |f| ObjectSpace.dump_all(output: f) }
+          exit
+        end
+
+        if profile_mode
+          require "stackprof"
+          require "tempfile"
+
+          make_profile_name(filename) do |filename|
+            ::File.open(filename, "w") do |f|
+              StackProf.run(mode: profile_mode, out: f) do
+                yield
+              end
+              puts "Profile written to: #{filename}"
+            end
+          end
+          exit
+        end
+
+        yield
+      end
+
+      def make_profile_name(filename)
+        if filename
+          yield filename
+        else
+          ::Dir::Tmpname.create("profile.dump") do |tmpname, _, _|
+            yield tmpname
+          end
+        end
+      end
+
+      def build_app_from_string
+        Rack::Builder.new_from_string(self.options[:builder])
+      end
+
+      def parse_options(args)
+        # Don't evaluate CGI ISINDEX parameters.
+        args.clear if ENV.include?(Rack::REQUEST_METHOD)
+
+        @options = opt_parser.parse!(args)
+        @options[:config] = ::File.expand_path(options[:config])
+        ENV["RACK_ENV"] = options[:environment]
+        @options
+      end
+
+      def opt_parser
+        Options.new
+      end
+
+      def build_app(app)
+        middleware[options[:environment]].reverse_each do |middleware|
+          middleware = middleware.call(self) if middleware.respond_to?(:call)
+          next unless middleware
+          klass, *args = middleware
+          app = klass.new(app, *args)
+        end
+        app
+      end
+
+      def wrapped_app
+        @wrapped_app ||= build_app app
+      end
+
+      def daemonize_app
+        # Cannot be covered as it forks
+        # :nocov:
+        Process.daemon(true, options[:daemonize] == :noclose)
+        # :nocov:
+      end
+
+      def write_pid
+        ::File.open(options[:pid], ::File::CREAT | ::File::EXCL | ::File::WRONLY ){ |f| f.write("#{Process.pid}") }
+        at_exit { ::FileUtils.rm_f(options[:pid]) }
+      rescue Errno::EEXIST
+        check_pid!
+        retry
+      end
+
+      def check_pid!
+        return unless ::File.exist?(options[:pid])
+
+        pid = ::File.read(options[:pid]).to_i
+        raise Errno::ESRCH if pid == 0
+
+        Process.kill(0, pid)
+        exit_with_pid(pid)
+      rescue Errno::ESRCH
+        ::File.delete(options[:pid])
+      rescue Errno::EPERM
+        exit_with_pid(pid)
+      end
+
+      def exit_with_pid(pid)
+        $stderr.puts "A server is already running (pid: #{pid}, file: #{options[:pid]})."
+        exit(1)
+      end
+  end
+
+end

data/lib/rackup/stream.rb

@@ -0,0 +1,199 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2019-2022, by Samuel Williams.
+
+module Rackup
+  # The input stream is an IO-like object which contains the raw HTTP POST data. When applicable, its external encoding must be “ASCII-8BIT” and it must be opened in binary mode, for Ruby 1.9 compatibility. The input stream must respond to gets, each, read and rewind.
+  class Stream
+    def initialize(input = nil, output = Buffered.new)
+      @input = input
+      @output = output
+
+      raise ArgumentError, "Non-writable output!" unless output.respond_to?(:write)
+
+      # Will hold remaining data in `#read`.
+      @buffer = nil
+      @closed = false
+    end
+
+    attr :input
+    attr :output
+
+    # This provides a read-only interface for data, which is surprisingly tricky to implement correctly.
+    module Reader
+      # rack.hijack_io must respond to:
+      # read, write, read_nonblock, write_nonblock, flush, close, close_read, close_write, closed?
+
+      # read behaves like IO#read. Its signature is read([length, [buffer]]). If given, length must be a non-negative Integer (>= 0) or nil, and buffer must be a String and may not be nil. If length is given and not nil, then this method reads at most length bytes from the input stream. If length is not given or nil, then this method reads all data until EOF. When EOF is reached, this method returns nil if length is given and not nil, or “” if length is not given or is nil. If buffer is given, then the read data will be placed into buffer instead of a newly created String object.
+      # @param length [Integer] the amount of data to read
+      # @param buffer [String] the buffer which will receive the data
+      # @return a buffer containing the data
+      def read(length = nil, buffer = nil)
+        return '' if length == 0
+
+        buffer ||= String.new.force_encoding(Encoding::BINARY)
+
+        # Take any previously buffered data and replace it into the given buffer.
+        if @buffer
+          buffer.replace(@buffer)
+          @buffer = nil
+        else
+          buffer.clear
+        end
+
+        if length
+          while buffer.bytesize < length and chunk = read_next
+            buffer << chunk
+          end
+
+          # This ensures the subsequent `slice!` works correctly.
+          buffer.force_encoding(Encoding::BINARY)
+
+          # This will be at least one copy:
+          @buffer = buffer.byteslice(length, buffer.bytesize)
+
+          # This should be zero-copy:
+          buffer.slice!(length, buffer.bytesize)
+
+          if buffer.empty?
+            return nil
+          else
+            return buffer
+          end
+        else
+          while chunk = read_next
+            buffer << chunk
+          end
+
+          return buffer
+        end
+      end
+
+      # Read at most `length` bytes from the stream. Will avoid reading from the underlying stream if possible.
+      def read_partial(length = nil)
+        if @buffer
+          buffer = @buffer
+          @buffer = nil
+        else
+          buffer = read_next
+        end
+
+        if buffer and length
+          if buffer.bytesize > length
+            # This ensures the subsequent `slice!` works correctly.
+            buffer.force_encoding(Encoding::BINARY)
+
+            @buffer = buffer.byteslice(length, buffer.bytesize)
+            buffer.slice!(length, buffer.bytesize)
+          end
+        end
+
+        return buffer
+      end
+
+      def gets
+        read_partial
+      end
+
+      def each
+        while chunk = read_partial
+          yield chunk
+        end
+      end
+
+      def read_nonblock(length, buffer = nil)
+        @buffer ||= read_next
+        chunk = nil
+
+        unless @buffer
+          buffer&.clear
+          return
+        end
+
+        if @buffer.bytesize > length
+          chunk = @buffer.byteslice(0, length)
+          @buffer = @buffer.byteslice(length, @buffer.bytesize)
+        else
+          chunk = @buffer
+          @buffer = nil
+        end
+
+        if buffer
+          buffer.replace(chunk)
+        else
+          buffer = chunk
+        end
+
+        return buffer
+      end
+    end
+
+    include Reader
+
+    def write(buffer)
+      if @output
+        @output.write(buffer)
+        return buffer.bytesize
+      else
+        raise IOError, "Stream is not writable, output has been closed!"
+      end
+    end
+
+    def write_nonblock(buffer)
+      write(buffer)
+    end
+
+    def <<(buffer)
+      write(buffer)
+    end
+
+    def flush
+    end
+
+    def close_read
+      @input&.close
+      @input = nil
+    end
+
+    # close must never be called on the input stream. huh?
+    def close_write
+      if @output.respond_to?(:close)
+        @output&.close
+      end
+
+      @output = nil
+    end
+
+    # Close the input and output bodies.
+    def close(error = nil)
+      self.close_read
+      self.close_write
+
+      return nil
+    ensure
+      @closed = true
+    end
+
+    # Whether the stream has been closed.
+    def closed?
+      @closed
+    end
+
+    # Whether there are any output chunks remaining?
+    def empty?
+      @output.empty?
+    end
+
+    private
+
+    def read_next
+      if @input
+        return @input.read
+      else
+        @input = nil
+        raise IOError, "Stream is not readable, input has been closed!"
+      end
+    end
+  end
+end

data/lib/rackup/version.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022, by Samuel Williams.
+# Copyright, 2022-2023, by Samuel Williams.
 
 module Rackup
-  VERSION = "1.0.0"
+  VERSION = "2.1.0"
 end

data/lib/rackup.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022, by Samuel Williams.
+# Copyright, 2022-2023, by Samuel Williams.
 
 require_relative 'rackup/handler'
 require_relative 'rackup/server'

data/license.md

@@ -1,7 +1,63 @@
 # MIT License
 
-Copyright, 2022, by Samuel Williams.  
-Copyright, 2022, by Jeremy Evans.  
+Copyright, 2007-2009, by Leah Neukirchen.  
+Copyright, 2008, by Marc-André Cournoyer.  
+Copyright, 2009, by Aaron Pfeifer.  
+Copyright, 2009-2010, by Megan Batty.  
+Copyright, 2009-2010, by Michael Fellinger.  
+Copyright, 2009, by Genki Takiuchi.  
+Copyright, 2009, by Joshua Peek.  
+Copyright, 2009, by Yehuda Katz + Carl Lerche.  
+Copyright, 2009, by Carl Lerche.  
+Copyright, 2010, by Julik Tarkhanov.  
+Copyright, 2010-2016, by James Tucker.  
+Copyright, 2010, by Timur Batyrshin.  
+Copyright, 2010, by Loren Segal.  
+Copyright, 2010, by Andrew Bortz.  
+Copyright, 2010, by John Barnette.  
+Copyright, 2010, by John Sumsion.  
+Copyright, 2011-2018, by Aaron Patterson.  
+Copyright, 2011, by Konstantin Haase.  
+Copyright, 2011, by Blake Mizerany.  
+Copyright, 2011, by Tsutomu Kuroda.  
+Copyright, 2012, by Jean Boussier.  
+Copyright, 2012, by Trevor Wennblom.  
+Copyright, 2012, by Anurag Priyam.  
+Copyright, 2012, by Hrvoje Šimić.  
+Copyright, 2013, by Uchio KONDO.  
+Copyright, 2013, by Tim Moore.  
+Copyright, 2013, by Postmodern.  
+Copyright, 2013, by Bas Vodde.  
+Copyright, 2013, by Joe Fiorini.  
+Copyright, 2014, by Wyatt Pan.  
+Copyright, 2014, by Lenny Marks.  
+Copyright, 2014, by Igor Bochkariov.  
+Copyright, 2014, by Max Cantor.  
+Copyright, 2014, by David Celis.  
+Copyright, 2014, by Rafael Mendonça França.  
+Copyright, 2014, by Jeremy Kemper.  
+Copyright, 2014, by Richard Schneeman.  
+Copyright, 2015, by Peter Wilmott.  
+Copyright, 2015, by Sean McGivern.  
+Copyright, 2015, by Tadashi Saito.  
+Copyright, 2015, by deepj.  
+Copyright, 2015, by Zachary Scott.  
+Copyright, 2016, by Sophie Deziel.  
+Copyright, 2016, by Kazuya Hotta.  
+Copyright, 2017, by Ryunosuke Sato.  
+Copyright, 2017-2023, by Samuel Williams.  
+Copyright, 2018, by Dillon Welch.  
+Copyright, 2018, by Yoshiyuki Hirano.  
+Copyright, 2018, by Nick LaMuro.  
+Copyright, 2019, by Rafael França.  
+Copyright, 2019, by Krzysztof Rybka.  
+Copyright, 2019, by Misaki Shioi.  
+Copyright, 2020-2022, by Jeremy Evans.  
+Copyright, 2021, by Katsuhiko YOSHIDA.  
+Copyright, 2021, by KS.  
+Copyright, 2021, by Stephen Paul Weber.  
+Copyright, 2022, by Akira Matsuda.  
+Copyright, 2022, by Andrew Hoglund.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rackup
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -9,36 +9,36 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-18 00:00:00.000000000 Z
+date: 2023-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3'
 - !ruby/object:Gem::Dependency
   name: webrick
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.8'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -111,11 +111,21 @@ dependencies:
         version: '0'
 description:
 email:
-executables: []
+executables:
+- rackup
 extensions: []
 extra_rdoc_files: []
 files:
+- bin/rackup
+- lib/rack/handler.rb
+- lib/rack/server.rb
 - lib/rackup.rb
+- lib/rackup/handler.rb
+- lib/rackup/handler/cgi.rb
+- lib/rackup/handler/webrick.rb
+- lib/rackup/lobster.rb
+- lib/rackup/server.rb
+- lib/rackup/stream.rb
 - lib/rackup/version.rb
 - license.md
 - readme.md