rackup 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a0b31e72267a0dc7a7cc3bbe41d06b49ea16ec3612edc7474fe5c99c97e568cf
-  data.tar.gz: 6b9b9f197c6929bed47b7bb3c81f13f956427e1d078ab2a4b12afc0c4400f881
+  metadata.gz: 500a1eebb3f2dc73a7f4e0b50753603f19f4b2c841a55c01c047188ed6d2214f
+  data.tar.gz: 7e51b56d52e396e9c208b06c7a25be3389d0df9c55c3c3333f0379e5aec73719
 SHA512:
-  metadata.gz: 21aba248befe16cd582ac7c867bc28cecd41155e2f8979e8cecba248e2f1623894c3f943484a85a189d3e2bdec45c836ad8f9f2995a2362809332b1b99dcd3d5
-  data.tar.gz: 258c30b02fc3d454df9dcd1d6285f0f3b6d592728f856c53e761c37db2a56925bc0a90bf0b3330441c754fddec280501abc13aa2032a120f3ce5917bd38c817f
+  metadata.gz: 9aa96ee4990bf4d93f23c4d3d2b16b28c793e9f4fabc2a24a007f241067262168608bcf0e2091368131563dfe9bb4b7fc2845330a75e96c7886b956a12e5f933
+  data.tar.gz: 62821749a10a8f337c3f0b4dde6f83fab067c68a1d3864f74a8cd1b28fb62d8be8430a571112ea5f5b60b753ad278140d130ec3f73c3a67f739345b288f73a49

data/lib/rackup/stream.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2022, by Samuel Williams.
+# Copyright, 2023-2024, 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.

data/lib/rackup/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2022-2023, by Samuel Williams.
 
 module Rackup
-  VERSION = "2.1.0"
+  VERSION = "2.2.0"
 end

data/lib/rackup.rb

@@ -1,11 +1,8 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022-2023, by Samuel Williams.
+# Copyright, 2022-2024, by Samuel Williams.
 
 require_relative 'rackup/handler'
 require_relative 'rackup/server'
 require_relative 'rackup/version'
-
-require_relative 'rackup/handler/webrick'
-require_relative 'rackup/handler/cgi'

data/license.md

@@ -7,7 +7,7 @@ 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 Yehuda Katz.  
 Copyright, 2009, by Carl Lerche.  
 Copyright, 2010, by Julik Tarkhanov.  
 Copyright, 2010-2016, by James Tucker.  
@@ -24,9 +24,9 @@ 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 Uchio Kondo.  
 Copyright, 2013, by Tim Moore.  
-Copyright, 2013, by Postmodern.  
+Copyright, 2013, by Hal Brodigan.  
 Copyright, 2013, by Bas Vodde.  
 Copyright, 2013, by Joe Fiorini.  
 Copyright, 2014, by Wyatt Pan.  
@@ -34,30 +34,32 @@ 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-2019, by Rafael 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 Martin Hrdlicka.  
 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, 2017-2024, 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 Katsuhiko Yoshida.  
+Copyright, 2021, by Kang Sheng.  
 Copyright, 2021, by Stephen Paul Weber.  
 Copyright, 2022, by Akira Matsuda.  
 Copyright, 2022, by Andrew Hoglund.  
+Copyright, 2024, by Olle Jonsson.  
+Copyright, 2024, by Geremia Taglialatela.  
+Copyright, 2024, by Petrik de Heus.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -1,13 +1,17 @@
 # Rackup
 
-`rackup` provides a command line interface for running a Rack-compatible application.
+`rackup` provides a command line interface for running a Rack-compatible application. It also provides a generic interface for starting a `rack`-compatible server: `Rackup::Handler`. It is not designed for production use.
 
 [![Development Status](https://github.com/rack/rackup/workflows/Test/badge.svg)](https://github.com/rack/rackup/actions?workflow=Test)
 
 ## Installation
 
 ``` bash
-$ gem install rackup
+-- For Puma
+$ gem install rackup puma
+
+-- For Falcon
+$ gem install rackup falcon
 ```
 
 ## Usage
@@ -20,6 +24,35 @@ $ rackup
 
 Your application should now be available locally, typically `http://localhost:9292`.
 
+## (Soft) Deprecation
+
+For a long time, `rackup` (the executable and implementation) was part of `rack`, and `webrick` was the default server, included with Ruby. It made it easy to run a Rack application without having to worry about the details of the server - great for documentation and demos.
+
+When `webrick` was removed from the Ruby standard library, `rack` started depending on `webrick` as a default server. Every web application and server would pull in `webrick` as a dependency, even if it was not used. To avoid this, the `rackup` component of `rack` was moved to this gem, which depended on `webrick`.
+
+However, many libraries (e.g. `rails`) still depend on `rackup` and end up pulling in `webrick` as a dependency. To avoid this, the decision was made to cut `webrick` as a dependency of `rackup`. This means that `rackup` no longer depends on `webrick`, and you need to install it separately if you want to use it.
+
+As a consequence of this, the value of the `rackup` gem is further diminished. In other words, why would you do this:
+
+``` bash
+$ gem install rackup puma
+$ rackup ...
+```
+
+when you can do this:
+
+``` bash
+$ gem install puma
+$ puma ...
+```
+
+In summary, the maintainers of `rack` recommend the following:
+
+  - Libraries should not depend on `rackup` if possible. `rackup` as an executable made sense when webrick shipped with Ruby, so there was always a fallback. But that hasn't been true since Ruby 3.0.
+  - Frameworks and applications should focus on providing `config.ru` files, so that users can use the webserver program of their choice directly (e.g. puma, falcon).
+  - There is still some value in the generic `rackup` and `Rackup::Handler` interfaces, but we encourage users to invoke the server command directly if possible.
+  - Webrick should be avoided if possible.
+
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -0,0 +1,7 @@
+# Releases
+
+All notable changes to this project will be documented in this file. For info on how to format all future additions to this file please reference [Keep A Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## v2.2.0
+
+  - Remove old rack shims.

metadata

@@ -1,15 +1,73 @@
 --- !ruby/object:Gem::Specification
 name: rackup
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.2.0
 platform: ruby
 authors:
 - Samuel Williams
+- James Tucker
+- Leah Neukirchen
 - Jeremy Evans
+- Joshua Peek
+- Megan Batty
+- Rafael França
+- Anurag Priyam
+- Max Cantor
+- Michael Fellinger
+- Sophie Deziel
+- Yoshiyuki Hirano
+- Aaron Patterson
+- Jean Boussier
+- Katsuhiko Yoshida
+- Konstantin Haase
+- Krzysztof Rybka
+- Martin Hrdlicka
+- Nick LaMuro
+- Aaron Pfeifer
+- Akira Matsuda
+- Andrew Bortz
+- Andrew Hoglund
+- Bas Vodde
+- Blake Mizerany
+- Carl Lerche
+- David Celis
+- Dillon Welch
+- Genki Takiuchi
+- Geremia Taglialatela
+- Hal Brodigan
+- Hrvoje Šimić
+- Igor Bochkariov
+- Jeremy Kemper
+- Joe Fiorini
+- John Barnette
+- John Sumsion
+- Julik Tarkhanov
+- Kang Sheng
+- Kazuya Hotta
+- Lenny Marks
+- Loren Segal
+- Marc-André Cournoyer
+- Misaki Shioi
+- Olle Jonsson
+- Peter Wilmott
+- Petrik de Heus
+- Richard Schneeman
+- Ryunosuke Sato
+- Sean McGivern
+- Stephen Paul Weber
+- Tadashi Saito
+- Tim Moore
+- Timur Batyrshin
+- Trevor Wennblom
+- Tsutomu Kuroda
+- Uchio Kondo
+- Wyatt Pan
+- Yehuda Katz
+- Zachary Scott
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-27 00:00:00.000000000 Z
+date: 2024-11-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -25,90 +83,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3'
-- !ruby/object:Gem::Dependency
-  name: webrick
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.8'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.8'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-- !ruby/object:Gem::Dependency
-  name: minitest-global_expectations
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: minitest-sprint
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 description:
 email:
 executables:
@@ -117,8 +91,6 @@ 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
@@ -129,11 +101,14 @@ files:
 - lib/rackup/version.rb
 - license.md
 - readme.md
+- releases.md
 - security.md
 homepage: https://github.com/rack/rackup
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/rack/rackup.git
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -142,14 +117,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.1
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: A general server command for Rack applications.

data/lib/rack/handler.rb

@@ -1,10 +0,0 @@
-# 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

@@ -1,10 +0,0 @@
-# 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