warbler-exec 0.1.0

data/.gitignore

@@ -0,0 +1 @@
+warbler-exec*.gem

data/README.md

@@ -0,0 +1,31 @@
+# warbler-exec
+
+This gem allows you to run commands within the context of a Warbler created WAR file.  It will use the JRuby runtime packaged with the WAR file even when this tool is executed from a different runtime.
+
+## How to Use
+
+This tool provides the `warbler-exec` command that takes this form:
+
+    $ warbler-exec <war-file> <command> <arguments>
+
+But it will only run with the JRuby runtime, so you will need to include everything that's needed in your WAR file.  For example, let's say you want to run Rails migrations from your WAR file.  First, you'll need something like this in your `warble.rb`:
+
+    Warbler::Config.new do |config|      
+      config.dirs << "bin"
+      config.includes = FileList["Rakefile"]  
+      config.bundle_without = [] # bundler will get fussy if we leave out dev and test    
+    end
+
+Then run Bundler the with `--binstubs` option, and use `warbler-exec` to run the Rake task:
+
+    $ bundle --binstubs
+    $ warble war
+    $ gem install warbler-exec
+    $ warbler-exec myapp.war bin/rake db:migrate
+
+Every time that `warbler-exec` runs, it extracts the WAR file. Don't expect it to be fast.
+
+# Roadmap
+
+It would be a lot easier if we didn't have to run Bundler with the `--binstubs` option.  Eventually, someone (probably the person writing this) will submit a patch to Warbler that gets around this.
+

data/bin/warbler-exec

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+
+require 'zip/zip'
+require 'tmpdir'
+
+path_to_war = ARGV.shift 
+
+destination = Dir.mktmpdir
+Zip::ZipFile.open(path_to_war) do |zipfile|
+  zipfile.each do |f|
+    f_path = File.join(destination, f.name)
+    FileUtils.mkdir_p(File.dirname(f_path))
+    zipfile.extract(f, f_path)
+  end
+end
+
+Dir.chdir(File.join(destination, "WEB-INF"))
+ENV["CLASSPATH"] = Dir["#{Dir.pwd}/lib/*.jar"].join(":")
+ENV["GEM_PATH"] = "#{Dir.pwd}/gems"
+ENV["GEM_HOME"] = "#{Dir.pwd}/gems"
+
+begin
+  Kernel.exec("java -Xmx512m -cp $CLASSPATH org.jruby.Main #{ARGV.join(" ")}")
+rescue Errno::EACCES
+  puts "warbler-exec: not executable: #{ARGV.first}"
+  exit 126
+rescue Errno::ENOENT
+  puts "warbler-exec: command not found: #{ARGV.first}"
+  exit 127
+rescue ArgumentError
+  puts "warbler-exec: exec needs a command to run"
+  exit 128
+end
+
+

data/warbler-exec.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "warbler-exec"
+  s.version     = "0.1.0"
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Joe Kutner"]
+  s.email       = ["jpkutner@gmail.com"]
+  s.homepage    = "https://github.com/jkutner/warbler-exec"
+  s.summary     = %q{Allows execution of commands from a Warbler WAR file}
+  s.description = %q{This utility allows you to execute commands with the context of a Warbler WAR file}
+
+  s.rubyforge_project = "warbler-exec"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency(%q<rubyzip>, [">= 0.9.4"])
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: warbler-exec
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+  - Joe Kutner
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-03-26 00:00:00 Z
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: rubyzip
+    prerelease: false
+    requirement: &id001 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: 0.9.4
+    type: :runtime
+    version_requirements: *id001
+description: This utility allows you to execute commands with the context of a Warbler WAR file
+email: 
+  - jpkutner@gmail.com
+executables: 
+  - warbler-exec
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+  - .gitignore
+  - README.md
+  - bin/warbler-exec
+  - warbler-exec.gemspec
+homepage: https://github.com/jkutner/warbler-exec
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+  - lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+requirements: []
+
+rubyforge_project: warbler-exec
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Allows execution of commands from a Warbler WAR file
+test_files: []
+