[chore] Replace examples approach for running from source with simpler validated approach

Author: chadlwilson

examples/README.md

@@ -41,3 +41,16 @@ As an executable jar within Jetty:
 | Sinatra | Streaming Demo                | http://localhost:8080/stream      | http://localhost:8080/sinatra/stream     |
 | Camping | Demo Index                    | http://localhost:8080/            | http://localhost:8080/camping            |
 | Camping | Snoop Dump                    | http://localhost:8080/snoop       | http://localhost:8080/camping/snoop      |
+
+## Development
+
+You can run the examples using local source for warbler or jruby-rack using env vars, e.g
+
+```shell
+export WARBLER_SRC=true JRUBY_RACK_SRC=true && bundle && bundle exec warble executable war && java -Dwarbler.debug=true -jar rails*.war
+```
+
+- Warbler can run directly from source
+- jruby-rack needs to be built, since it does not define a gemspec
+  - There are alternate ways to do this by replacing the jruby-rack jar within the warbled jar/war, however this is more
+    complex and error-prone that using the gem and ensuring compatibility since warbler itself depends on the jruby-rack gem. 

examples/camping/Gemfile

@@ -6,6 +6,7 @@ gem 'camping'
 gem 'rack', '~> 2.2'
 
 group :development do
-  gem 'warbler', '~> 2.1'
+  if !ENV['WARBLER_SRC']; gem 'warbler' else gem 'warbler', path: '../../../warbler' end
+  if !ENV['JRUBY_RACK_SRC']; gem 'jruby-rack' else gem 'jruby-rack', path: '../../target' end
   gem 'jruby-jars', '< 10'
 end

examples/camping/config/warble.rb

@@ -17,10 +17,6 @@
   # JRuby and JRuby-Rack are pre-loaded in this list.  Be sure to include your
   # own versions if you directly set the value
   # config.java_libs += FileList["lib/java/*.jar"]
-  if ENV['JRUBY_RACK_SRC']
-    config.java_libs.delete_if {|f| f =~ /jruby-rack[^\/]+\.jar/}
-    config.java_libs += FileList["../../target/jruby-rack*.jar"]
-  end
 
   # Loose Java classes and miscellaneous files to be placed in WEB-INF/classes.
   # config.java_classes = FileList["target/classes/**.*"]

examples/rails7/Gemfile

@@ -7,6 +7,7 @@ gem 'rack', '~> 2.2'
 gem 'sprockets-rails'
 
 group :development do
-  gem 'warbler', '~> 2.1'
-  gem 'jruby-jars', '< 10'
+  if !ENV['WARBLER_SRC']; gem 'warbler' else gem 'warbler', path: '../../../warbler' end
+  if !ENV['JRUBY_RACK_SRC']; gem 'jruby-rack' else gem 'jruby-rack', path: '../../target' end
+  gem 'jruby-jars', '~> 10'
 end

examples/rails7/config/warble.rb

@@ -25,14 +25,6 @@
   # JRuby and JRuby-Rack are pre-loaded in this list.  Be sure to include your
   # own versions if you directly set the value
   # config.java_libs += FileList["lib/java/*.jar"]
-  if ENV['JRUBY_RACK_SRC']
-    config.java_libs.delete_if {|f| f =~ /jruby-rack[^\/]+\.jar/}
-    config.java_libs += FileList["../../target/jruby-rack*.jar"]
-  end
-  if ENV['JRUBY_COMPLETE_SRC']
-    config.java_libs.delete_if {|f| f =~ /jruby-(core|stdlib|complete)/}
-    config.java_libs += FileList[ENV['JRUBY_COMPLETE_SRC']]
-  end
 
   # Loose Java classes and miscellaneous files to be included.
   # config.java_classes = FileList["target/classes/**.*"]

examples/sinatra/Gemfile

@@ -6,6 +6,7 @@ gem 'sinatra'
 gem 'rack', '~> 2.2'
 
 group :development do
-  gem 'warbler', '~> 2.1'
+  if !ENV['WARBLER_SRC']; gem 'warbler' else gem 'warbler', path: '../../../warbler' end
+  if !ENV['JRUBY_RACK_SRC']; gem 'jruby-rack' else gem 'jruby-rack', path: '../../target' end
   gem 'jruby-jars', '< 10'
 end

examples/sinatra/config/warble.rb

@@ -2,10 +2,6 @@
 Warbler::Config.new do |config|
   config.features += ['executable']
 
-  if ENV['JRUBY_RACK_SRC']
-    config.java_libs.delete_if {|f| f =~ /jruby-rack[^\/]+\.jar/}
-    config.java_libs += FileList["../../target/jruby-rack*.jar"]
-  end
   config.dirs += ['views']
   require 'socket'
   config.webxml.ENV_OUTPUT = File.expand_path('../../servers', __FILE__)