jruby-rack 1.2.5 → 1.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: deb522e122e0c6e6cdb44b3cc48f1998c8faa022b6f9f40155f3443f9b29b8f7
-  data.tar.gz: 4575c6ef77f6fab741703a667fa04471d5190bf09736a9655c0ac74c600c8f0f
+  metadata.gz: 24de58d357962944b8e2dd77cf34c3af33e5e5f93a68ebf4f75c86666795a9a1
+  data.tar.gz: 3e19c76e147b46be50552f6df538588e023ea1fb2556c964633c16320493e84b
 SHA512:
-  metadata.gz: e5f36e4650ed62c243e66747fda304a83a8205bc8fab59f5fc53ce6bbb77a7146d033930c13e09d26d86ae9217a661d47c3bf548900727ec54e50e29fa78d270
-  data.tar.gz: 04c00aedf47df518653664142bcfa0e7e667d8203bbad4b5cc595ee1ef1cac8f60008594c741463c78660959786875e6f2224f205d250568f38cd49a88aea9f8
+  metadata.gz: 78c1c3a405e8858a390963ab7311a81ce31e3265936949b4900cd5d91b35f6b11f79b214ed46a7ce0951f9ae4f0492bfeef2379e1dedd48077038e943c70c2ba
+  data.tar.gz: e0462a4181218c7cbec0ffbb9d4dae3d0bf0fc0de80b8e971fa991056c281976afaa33a6ec873583d582b585a7dcfce8a7c79f2095d2cb445cf5598c13dbac8a

data/{History.md → CHANGELOG.md}

@@ -1,3 +1,18 @@
+## 1.2.7 (UNRELEASED)
+
+- Ensure compatibility with JRuby 10.0 and 10.1 (#419, #423)
+- Ensure compatibility with Rails 8.0 (#419)
+- Fix ability to include and forward to JSPs under Rails (#370)
+- Update (bundled) rack to 2.2.23 (#417)
+
+## 1.2.6
+
+- Add missing block-only signature for debug logging
+- update (bundled) rack to 2.2.20
+- Ensure rack boot process leaves ENV['GEM_PATH'] and Gem.paths in a consistent state
+- Remove undocumented and unsafe jruby.rack.env.gem_path = false option (unusable on Bundler 1.6+)
+- Fix unintended Rubygems initialization too early in boot process with JRuby 9.4+
+
 ## 1.2.5
 
 - Fix use of jruby-rack under Java 8 (#324)

data/README.md

@@ -1,8 +1,10 @@
 # JRuby-Rack
 
-[![Gem Version](https://badge.fury.io/rb/jruby-rack.png)][5]
-[![Build Status](https://github.com/jruby/jruby-rack/actions/workflows/maven.yml/badge.svg)][6]
-
+[![Gem Version](https://img.shields.io/gem/v/jruby-rack)](https://rubygems.org/gems/jruby-rack)
+[![Jar Version](https://img.shields.io/maven-central/v/org.jruby.rack/jruby-rack)](https://central.sonatype.com/artifact/org.jruby.rack/jruby-rack)
+[![master Build Status](https://github.com/jruby/jruby-rack/actions/workflows/maven.yml/badge.svg)](https://github.com/jruby/jruby-rack/actions/workflows/maven.yml?query=branch%3Amaster) (master)
+[![1.2.x Build Status](https://github.com/jruby/jruby-rack/actions/workflows/maven.yml/badge.svg?branch=1.2-stable)](https://github.com/jruby/jruby-rack/actions/workflows/maven.yml?query=branch%3A1.2-stable) (1.2.x)
+ 
 JRuby-Rack is a lightweight adapter for the Java Servlet environment that allows
 any (Ruby) Rack-based application to run unmodified in a Java Servlet container.
 JRuby-Rack supports Rails as well as any Rack-compatible Ruby web framework.
@@ -11,11 +13,11 @@ For more information on Rack, visit http://rack.github.io/.
 
 ## Compatibility
 
-| JRuby-Rack Series                                          | Status     | Rack      | JRuby      | Java | Rails     | Target Servlet API  | Notes                                      |
-|------------------------------------------------------------|------------|-----------|------------|------|-----------|---------------------|--------------------------------------------|
-| [1.2](https://github.com/jruby/jruby-rack/tree/1.2-stable) | Maintained | 2.2       | 9.3 → 9.4  | 8+   | 5.0 → 7.2 | 3.0 (Java EE 6)     | Servlet 3.1 → 4.0 OK with some containers. |
-| [1.1](https://github.com/jruby/jruby-rack/tree/1.1-stable) | EOL        | 1.x → 2.2 | 1.6 → 9.4  | 6+   | 2.1 → 5.2 | 2.5 (Java EE 5)     | Servlet 3.0 → 4.0 OK with some containers. |
-| 1.0                                                        | EOL        | 0.9 → 1.x | 1.1 → 1.9  | 5+   | 2.1 → 3.x | 2.5 (Java EE 5)     |                                            |
+| JRuby-Rack Series                                              | Status        | Rack      | JRuby      | Java | Rails     | Target Servlet API | Notes                                                          |
+|----------------------------------------------------------------|---------------|-----------|------------|------|-----------|--------------------|----------------------------------------------------------------|
+| [**1.2**](https://github.com/jruby/jruby-rack/tree/1.2-stable) | Maintained    | 2.2       | 9.3 → 10.1 | 8+   | 5.0 → 8.0 | 3.0 (Java EE 6)    | ✅ _Unofficial_: Servlet 3.1 → 4.0 also OK with most containers |
+| [**1.1**](https://github.com/jruby/jruby-rack/tree/1.1-stable) | EOL @ 2024-05 | 1.x → 2.2 | 1.6 → 9.4  | 6+   | 2.1 → 5.2 | 2.5 (Java EE 5)    | ✅ _Unofficial_: Servlet 3.0 → 4.0 also OK with most containers |
+| [**1.0**](https://github.com/jruby/jruby-rack/tree/1.0.10)     | EOL @ 2011-11 | 0.9 → 1.x | 1.1 → 1.9  | 5+   | 2.1 → 3.x | 2.5 (Java EE 5)    |                                                                |
 
 ## Getting Started
 
@@ -27,16 +29,18 @@ in your WAR file when it gets built.
 If you're assembling your own WAR using other means, you can install the
 **jruby-rack** gem. It provides a method to locate the jar file:
 
-    require 'jruby-rack'
-    FileUtils.cp JRubyJars.jruby_rack_jar_path, '.'
+```ruby
+require 'jruby-rack'
+FileUtils.cp JRubyJars.jruby_rack_jar_path, '.'
+```
 
 Otherwise you'll need to download the latest [jar release][2], drop it into the
-*WEB-INF/lib* directory and configure the `RackFilter` in your application's
-*web.xml* (see following examples).
+`WEB-INF/lib` directory and configure the `RackFilter` in your application's
+`web.xml` (see following examples).
 
 ### Rails
 
-Here's sample *web.xml* configuration for Rails. Note the environment and
+Here's sample `web.xml` configuration for Rails. Note the environment and
 min/max runtime parameters. For **multi-threaded** (a.k.a. `threadsafe!`)
 Rails with a single runtime, set min/max both to 1. Otherwise, define the size
 of the runtime pool as you wish.
@@ -85,8 +89,8 @@ of the runtime pool as you wish.
 ### (Other) Rack Applications
 
 The main difference when using a non-Rails Rack application is that JRuby-Rack
-looks for a "rackup" file named **config.ru** in  `WEB-INF/config.ru` or
-`WEB-INF/*/config.ru`. Here's a sample *web.xml* configuration :
+looks for a "rackup" file named `config.ru` in  `WEB-INF/config.ru` or
+`WEB-INF/*/config.ru`. Here's a sample `web.xml` configuration :
 
 ```xml
 <filter>
@@ -104,8 +108,8 @@ looks for a "rackup" file named **config.ru** in  `WEB-INF/config.ru` or
 </listener>
 ```
 
-If you don't have a *config.ru* or don't want to include it in your web app, you
-can embed it directly in the *web.xml* as follows (using Sinatra as an example):
+If you don't have a `config.ru` or don't want to include it in your web app, you
+can embed it directly in the `web.xml` as follows (using Sinatra as an example):
 
 ```xml
 <context-param>
@@ -121,7 +125,7 @@ can embed it directly in the *web.xml* as follows (using Sinatra as an example):
 </context-param>
 ```
 
-Be sure to escape angle-brackets for XML !
+Be sure to escape angle-brackets for XML!
 
 
 ## Servlet Filter
@@ -140,7 +144,11 @@ using is `org.jruby.rack.RackFilter`, the filter supports the following
   gets reset (accepts  values "true", "false" and "buffer" to reset the buffer
   only), by default "true"
 - **addsHtmlToPathInfo** controls whether the .html suffix is added to the URI
-  when checking if the request is for a static page
+  when checking if the request is for a static page. The default behavior for 
+  Rails and many other Ruby applications is to add an `.html` extension to the 
+  resource and attempt to handle it before serving a dynamic request on the 
+  original URI.  However, this behavior may confuse other servlets in your 
+  application that have a wildcard mapping. Defaults to true.
 - **verifiesHtmlResource** used with the previous parameter to make sure the
   requested static resource exists before adding the .html request URI suffix
 
@@ -150,9 +158,9 @@ a filter, the servlet class name is `org.jruby.rack.RackServlet`.
 ## Servlet Environment Integration
 
 - servlet context is accessible to any application through the Rack environment
-  variable *java.servlet_context* (as well as the `$servlet_context` global).
+  variable `java.servlet_context` (as well as the `$servlet_context` global).
 - the (native) servlet request and response objects could be obtained via the
-  *java.servlet_request* and *java.servlet_response* keys
+  `java.servlet_request` and `java.servlet_response` keys
 - all servlet request attributes are passed through to the Rack environment (and
   thus might override request headers or Rack environment variables)
 - servlet sessions can be used as a (java) session store for Rails, session
@@ -171,16 +179,15 @@ Several aspects of Rails are automatically set up for you.
 ## JRuby Runtime Management
 
 JRuby runtime management and pooling is done automatically by the framework.
-In the case of Rails, runtimes are pooled by default (the default will most
-likely change with the adoption of Rails 4.0). For other Rack applications a
+In the case of Rails, runtimes are pooled by default. For other Rack applications a
 single shared runtime is created and shared for every request by default.
-If *jruby.min.runtimes* and *jruby.max.runtimes* values are
+If `jruby.min.runtimes` and `jruby.max.runtimes` values are
 specified pooling is supported for plain Rack applications as well.
 
 We do recommend to boot your runtimes up-front to avoid the cost of initializing
 one while a request kicks in and find the pool empty, this can be easily avoided
-by setting *jruby.min.runtimes* equal to *jruby.max.runtimes*. You might also
-want to consider tuning the *jruby.runtime.acquire.timeout* parameter to not
+by setting `jruby.min.runtimes` equal to `jruby.max.runtimes`. You might also
+want to consider tuning the `jruby.runtime.acquire.timeout` parameter to not
 wait too long when all (max) runtimes from the pool are busy.
 
 ## JRuby-Rack Configuration
@@ -190,20 +197,18 @@ as context init parameters in web.xml or as VM-wide system properties.
 
 - `rackup`: Rackup script for configuring how the Rack application is mounted.
   Required for Rack-based applications other than Rails. Can be omitted if a
-  *config.ru* is included in the application root.
+  `config.ru` is included in the application root.
 - `public.root`: Relative path to the location of your application's static
-  assets. Defaults to */*.
+  assets. Defaults to `*/*`.
 - `rails.root`: Root path to the location of the Rails application files.
-  Defaults to */WEB-INF*.
+  Defaults to `*/WEB-INF*`.
 - `rails.env`: Specify the Rails environment to run. Defaults to 'production'.
 - `rails.relative_url_append`: Specify a path to be appended to the
   `ActionController::Base.relative_url_root` after the context path. Useful
   for running a rails app from the same war as an existing app, under a
   sub-path of the main servlet context root.
 - `gem.path`: Relative path to the bundled gem repository. Defaults to
-  */WEB-INF/gems*.
-- `jruby.compat.version`: Set to "1.8" or "1.9" to make JRuby run a specific
-  version of Ruby (same as the --1.8 / --1.9 command line flags).
+  `/WEB-INF/gems`.
 - `jruby.min.runtimes`: For non-threadsafe Rails applications using a runtime
   pool, specify an integer minimum number of runtimes to hold in the pool.
 - `jruby.max.runtimes`: For non-threadsafe Rails applications, an integer
@@ -226,6 +231,12 @@ as context init parameters in web.xml or as VM-wide system properties.
 - `jruby.runtime.env.rubyopt`: This option is used for compatibility with the
   (deprecated) `jruby.rack.ignore.env` option since it cleared out the ENV after
   RUBYOPT has been processed, by setting it to true ENV['RUBYOPT'] will be kept.
+- `jruby.rack.env.gem_path`: If set to `true` (the default) jruby-rack will
+  ensure ENV['GEM_PATH'] is altered to include the `gem.path` above. If you set it to a
+  value, this value will be used as GEM_PATH, overriding the environment and
+  ignoring `gem.path` etc. By setting this option to en empty string the ENV['GEM_PATH'] will
+  not be modified by jruby-rack at all and will retain its original values implied by
+  the process environment and `jruby.runtime.env` setting.
 - `jruby.rack.logging`: Specify the logging device to use. Defaults to
   `servlet_context`. See below.
 - `jruby.rack.request.size.initial.bytes`: Initial size for request body memory
@@ -263,17 +274,17 @@ as context init parameters in web.xml or as VM-wide system properties.
 
 There are often cases where you need to perform custom initialization of the
 Ruby environment before booting the application. You can create a file called
-*META-INF/init.rb* or *WEB-INF/init.rb* inside the war file for this purpose.
+`META-INF/init.rb` or `WEB-INF/init.rb` inside the war file for this purpose.
 These files, if found, will be evaluated before booting the Rack environment,
 allowing you to set environment variables, load scripts, etc.
 
 For plain Rack applications, JRuby-Rack also supports a magic comment to solve
 the "rackup" chicken-egg problem (you need Rack's builder loaded before loading
-the *config.ru*, yet you may want to setup the gem version from within the rackup
+the `config.ru`, yet you may want to setup the gem version from within the rackup
  file). As we ship with the Rack gem bundled, otherwise when executing the
-provided *config.ru* the bundled (latest) version of Rack will get loaded.
+provided `config.ru` the bundled (latest) version of Rack will get loaded.
 
-Use **rack.version** to specify the Rack gem version to be loaded before rackup :
+Use `rack.version` to specify the Rack gem version to be loaded before rackup :
 
 ```ruby
 # encoding: UTF-8
@@ -306,6 +317,9 @@ logging system, configure `jruby.rack.logging` as follows:
 For those loggers that require a specific named logger, set it with the
 `jruby.rack.logging.name` option, by default "jruby.rack" name will be used.
 
+## Examples
+
+Some example demo applications are available at [./examples](./examples).
 
 ## Building
 
@@ -324,7 +338,7 @@ Build the .jar using Maven :
 ./mvnw install
 ```
 
-the generated jar should be located at **target/jruby-rack-*.jar**
+the generated jar should be located at `target/jruby-rack-*.jar`
 
 Alternatively use Rake, e.g. to build the gem (skipping specs) :
 
@@ -339,11 +353,17 @@ package and push the .jar every time a commit changes a source file).
 
 ## Releasing
 
+Releasing must be done by users authorized to push to the `org.jruby` group ID on https://central.sonatype.org and to push the `jruby-rack` gem to https://rubygems.org.
+
 * Make sure auth is configured for "central" repository ID in your `.m2/settings.xml`
-* Update the version in `src/main/ruby/jruby/rack/version.rb` to the release version
-* `./mvnw release:prepare`
-* `./mvnw release:perform` (possibly with `-DuseReleaseProfile=false` due to Javadoc doclint failures for now)
+* Update the versions in `pom.xml` and `src/main/ruby/jruby/rack/version.rb` to the release version
+* Commit the version update locally
+* Run `./mvnw deploy -Prelease` to build, sign, and push all artifacts to Maven Central staging
+* Confirm the release completes publishing at `https://central.sonatype.org`
 * `rake clean gem SKIP_SPECS=true` and push the gem
+* Tag the release version in git
+* Update the versions again to the next dev version (`-SNAPSHOT` for the Maven artifact in `pom.xml` and `.SNAPSHOT` for the gem in `version.rb`)
+* Push all commits and tags to GitHub
 
 ## Adding testing for new Rails versions
 
@@ -364,9 +384,7 @@ package and push the .jar every time a commit changes a source file).
 Please use [github][3] to file bugs, patches and/or pull requests.
 More information at the [wiki][4] or ask us at **#jruby**'s IRC channel.
 
-[1]: https://github.com/jruby/warbler#warbler--
+[1]: https://github.com/jruby/warbler
 [2]: https://central.sonatype.com/artifact/org.jruby.rack/jruby-rack
 [3]: https://github.com/jruby/jruby-rack/issues
 [4]: https://github.com/jruby/jruby-rack/wiki
-[5]: http://badge.fury.io/rb/jruby-rack
-[6]: https://github.com/jruby/jruby-rack/actions/workflows/maven.yml

data/lib/jruby/rack/version.rb

@@ -8,6 +8,6 @@
 
 module JRuby
   module Rack
-    VERSION = '1.2.5'
+    VERSION = '1.2.7'
   end
 end

data/lib/jruby-rack.rb

@@ -1,7 +1,7 @@
 
 module JRubyJars
   def self.jruby_rack_jar_path
-    File.expand_path("../jruby-rack-1.2.5.jar", __FILE__)
+    File.expand_path("../jruby-rack-1.2.7.jar", __FILE__)
   end
   require jruby_rack_jar_path if defined?(JRUBY_VERSION)
 end

metadata

@@ -1,16 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: jruby-rack
 version: !ruby/object:Gem::Version
-  version: 1.2.5
+  version: 1.2.7
 platform: ruby
 authors:
 - Nick Sieger
 - Karol Bucek
 - JRuby contributors
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-08 00:00:00.000000000 Z
+date: 2026-05-19 00:00:00.000000000 Z
 dependencies: []
 description: JRuby-Rack is a combined Java and Ruby library that adapts the Java Servlet
   API to Rack. For JRuby only.
@@ -20,17 +19,16 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- History.md
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
-- lib/jruby-rack-1.2.5.jar
+- lib/jruby-rack-1.2.7.jar
 - lib/jruby-rack.rb
 - lib/jruby/rack/version.rb
 homepage: http://jruby.org
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -45,8 +43,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Rack adapter for JRuby and Servlet Containers
 test_files: []