jar-dependencies 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2f27be364d8c8f32d577aef905556c4cd660fe8e
-  data.tar.gz: 3e7a4d1af9b4156354f47be93a4b03f7c333a6f2
+  metadata.gz: 2bd8d100f1b60a90cfe7a66415f8413dcdf93dfa
+  data.tar.gz: 655a3e16c92bc6f43023d139c64935b096b0e18f
 SHA512:
-  metadata.gz: 6d1c68ce4acf5dfb0e95c919761ba653cb1bf24088744cba40a3801395b80f9db27091bbe922f4edef80367e8f37252349a276f4883895b4fd9d6d34fe26d074
-  data.tar.gz: 031880f018fe453260aaa5f8e852c93a512d22adbb613df1e1176368527b58c69db2167c2663c5474b383c124ff43bc3dd612088466e12604b64805351243439
+  metadata.gz: a0a071dd5b2d2950b227b19f8a3f66f54e5d51581ba580cbf3b731a47b052f5d3ff40a44a683e3a18bcc4c9867adf452734427acc19bea0986ed0044791be813
+  data.tar.gz: dcf7a0895ae39e501d2e6a61bff7f4e6ae5ebd6fa3ece8f0976dc6c3b73f912ef8cea23e86550ad919e5a0a4add03687a9b6aa4b23e641728e996285b0e5d51d

data/Gemfile

@@ -0,0 +1,10 @@
+#-*- mode: ruby -*-
+source 'https://rubygems.org'
+
+gemspec
+
+gem "copyright-header", "1.0.8", :platform => :mri, :group => :copyright
+
+gem 'rake', '~> 10.0'
+gem 'minitest', '~> 5.3'
+

data/Rakefile

@@ -0,0 +1,33 @@
+#-*- mode: ruby -*-
+
+task :default => [ :specs ]
+
+desc 'run specs'
+task :specs do
+  $LOAD_PATH << "specs"
+
+  Dir['specs/*_spec.rb'].each do |f| 
+    require File.basename( f.sub(/.rb$/, '' ) )
+  end
+end
+
+task :headers do
+  require 'copyright_header'
+
+  s = Gem::Specification.load( Dir["*gemspec"].first )
+
+  args = {
+    :license => s.license, 
+    :copyright_software => s.name,
+    :copyright_software_description => s.description,
+    :copyright_holders => s.authors,
+    :copyright_years => [Time.now.year],
+    :add_path => "lib",
+    :output_dir => './'
+  }
+
+  command_line = CopyrightHeader::CommandLine.new( args )
+  command_line.execute
+end
+
+# vim: syntax=Ruby

data/Readme.md

@@ -1,26 +1,53 @@
 # jar-dependencies #
 
-manage jar dependencies for gems and keep track which jar was already loaded using maven artifact coordinates. it warns on version conflicts and loads only ONE jar assuming the first one is compatible to the second one otherwise your project needs to lock down the right version.
-
-via environment variable or system properties the jar loading can be switched of completely, allowing the servlet container or jbundler or any other container to take care of the jar loading.
-
-in case the jars are vendored using the following path convention
-
-**{group\_id}/{artifact\_id}-{version}.jar**
-
-it will be loaded in case the local maven repository does not have it (maybe the preference should be the other way around ?).
-
-the gem is tiny on purpose since the all gems with jar dependencies should use and funny double loaded jars can be avoided in future. also java project using the jruby ScriptingContainer can manage their jar dependencies including those coming from the gem files.
-
-# create a gem with jar dependencies #
-
-see add you jar dependency declaration in gemspec via the **requirements**, see [example.gemspec](example/example.gemspec). create an extension **ext/extconf.rb** and use the **setup** from [ruby-maven](http://rubygems.org/gem/ruby-maven) to install the jar dependencies on installation of the gem - see [ext/extconf.rb](example/ext/extconf.rb). this setup will create **{gem.name}\_jars.rb** inside the lib directory (**require_path** of the gemspec) of your gem .
-
-note: you need ruby-maven-3.1.1.0.3.dev or newer for the GemSetup class
-
-your gem just need require this **{gem.name}_jars.rb** in your code whenever you want to load these jars (see [lib/example.rb](example/lib/example.rb)).
-
-the gem itself also needs the **jar-dependencies** gem as runtime-dependency since that is used to load the jar or let [jbundler](http://rubygems.org/gem/jbundler) or similar frameworks deal with the jar dependencies.
+* [![Build Status](https://secure.travis-ci.org/mkristian/jar-dependencies.png)](http://travis-ci.org/mkristian/jar-dependencies)
+* [![Code Climate](https://codeclimate.com/github/mkristian/jar-dependencies.png)](https://codeclimate.com/github/mkristian/jar-dependencies)
+
+add gem dependencies for jar files to ruby gems.
+
+## features ##
+
+    * vendors jar dependencies during installion of the gem
+	* jar dependencies are declared in the gemspec of the gem
+	* jar declaration uses the same notation as jbundler
+	* transitive jar dependencies will be resolved as well using (ruby-)maven
+	* when there are two gems with different versions of the same jar dependency an warning will be given and the first version wins, i.e. **only one** version of the a library inside the jruby-classloader
+	* it hooks into gem, i.e. once the jar-dependency gem is installed the feature can be used by any gem
+	* offer 'bundle-with-jars' command which hooks the jar_installer into rubytems before delegating all arguments to bundler
+	* it integrates with an existing maven local repository and obeys the maven setup in ~/.m2/settings.xml, like mirrors, proxieds, etc
+
+## some drawbacks ##
+
+    * first you need to install the jar-dependency gem with its development dependencies installed (then ruby-maven gets installed as well)
+	* bundler does not install the jar-dependencies
+	* gems need an extra dependency on jar-dependencies during runtime and for development and installation you need ruby-maven installed as well (which you get via the development dependencies)
+
+## just look at the example ##
+
+the [readme.md](example/Readme.md) walks you through an example and shows how development works and shows what happens during installation.
+
+# configuration #
+
+<table border='1'>
+<tr>
+<td>ENV</td><td>java system property</td><td>default</td><td>description</td>
+</tr>
+<tr>
+<td>`JARS_DEBUG`</td><td>jars.debug</td><td>false</td><td>if set to true it will produce lots of debug out (maven -X switch)</td>
+</tr>
+<tr>
+<td>`JARS_VERBOSE`</td><td>jars.verbose</td><td>false</td><td>if set to true it will produce some extra output</td>
+</tr>
+<tr>
+<td>`JARS_HOME`</td><td>jars.home</td><td>$HOME/.m2/repository</td><td>filesystem location where to store the jar files and some metadata</td>
+</tr>
+<tr>
+<td>`JARS_MAVEN_SETTINGS`</td><td>jars.maven.settings</td><td>$HOME/.m2/settings.xml</td><td>setting.xml for maven to use</td>
+</tr>
+<tr>
+<td>`JARS_VENDOR`</td><td>jars.vendor</td><td>true</td><td>set to true means that the jars will be stored in JARS_HOME only</td>
+</tr>
+</table>
 
 # motivation #
 

data/bin/bundle-with-jars

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+if defined?( JRUBY_VERSION ) && Gem.post_install_hooks.empty?
+  Gem.post_install do |gem_installer|
+    require 'jar_installer'
+    ::JarInstaller.new( gem_installer.spec ).vendor_jars
+  end
+end
+   
+load Gem.bin_path('bundler', 'bundle') 

data/jar-dependencies.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = 'jar-dependencies'
-  s.version = "0.0.2"
+  s.version = "0.0.3"
   s.author = 'christian meier'
   s.email = [ 'mkristian@web.de' ]
   s.summary = 'manage jar dependencies for gems'
@@ -10,13 +10,16 @@ Gem::Specification.new do |s|
 
   s.license = 'MIT'
 
+  s.executable = 'bundle-with-jars'
+
   s.files = Dir[ 'lib/*rb' ]
+  s.files += Dir[ '*file' ]
   s.files += [ 'Readme.md', 'jar-dependencies.gemspec', 'MIT-LICENSE' ]
 
   s.description = 'manage jar dependencies for gems and keep track which jar was already loaded using maven artifact coordinates. it warns on version conflicts and loads only ONE jar assuming the first one is compatible to the second one otherwise your project needs to lock down the right version.'
 
-  s.add_runtime_dependency 'rake', '~> 10.2.2'
-  s.add_runtime_dependency 'ruby-maven', '~> 3.1.1.0'
+  s.add_development_dependency 'rake', '~> 10.2.2'
+  s.add_development_dependency 'ruby-maven', '~> 3.1.1.0'
 end
 
 # vim: syntax=Ruby

data/lib/jar_dependencies.rb

@@ -19,39 +19,113 @@
 # CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #
 
-def require_jar( group_id, artifact_id, *classifier_version )
-  require_jarfile( nil, group_id, artifact_id, *classifier_version )
-end
+module Jars
+  HOME = 'JARS_HOME'
+  MAVEN_SETTINGS = 'JARS_MAVEN_SETTINGS'
+
+  if defined? JRUBY_VERSION
+    def self.to_prop( key )
+      java.lang.System.getProperty( key.downcase.gsub( /_/, '.' ) ) ||
+        ENV[key.upcase.gsub( /[.]/, '_' ) ]
+    end
+  else
+    def self.to_prop( key )
+      ENV[ key.upcase.gsub( /[.]/, '_' ) ]
+    end
+  end
 
-def require_jarfile( file, group_id, artifact_id, *classifier_version )
-  skip = java.lang.System.get_property( 'jruby.jars.skip' ) || ENV[ 'JRUBY_JARS_SKIP' ] || java.lang.System.get_property( 'jbundler.skip' ) || ENV[ 'JBUNDLER_SKIP' ]
-  return false if skip == 'true'
+  def self.absolute( file )
+    File.expand_path( file ) if file
+  end
+
+  def self.reset
+    @_jars_maven_settings_ = nil
+    @_jars_home_ = nil
+    @@jars ||= {}
+    @@jars.clear
+  end
 
-  version = classifier_version[ -1 ]
-  classifier = classifier_version[ -2 ]
+  def self.maven_settings
+    if @_jars_maven_settings_.nil?
+      unless @_jars_maven_settings_ = absolute( to_prop( MAVEN_SETTINGS ) )
+        # use maven default settings
+        @_jars_maven_settings_ = File.join( ENV[ 'HOME' ], 
+                                            '.m2', 'settings.xml' )
+      end
+    end
+    @_jars_maven_settings_
+  end
 
-  # if no file given than it is vendored
-  # if the file does not exists we assume it is vendored
-  if file.nil? || !File.exists?( file )
+  def self.home
+    if @_jars_home_.nil?
+      unless @_jars_home_ = absolute( to_prop( HOME ) )
+        begin
+          require 'rexml/document'
+          doc = REXML::Document.new( File.read( maven_settings ) )
+          REXML::XPath.first( doc, "//settings/localRepository").tap do |e|  
+            @_jars_home_ = e.text.sub( /\\/, '/') if e
+          end
+        rescue
+          # ignore
+        end
+      end
+      # use maven default repository
+      @_jars_home_ ||= File.join( ENV[ 'HOME' ], '.m2', 'repository' )
+    end
+    @_jars_home_
+  end
+
+  def self.require_jar( group_id, artifact_id, *classifier_version )
+    version = classifier_version[ -1 ]
+    classifier = classifier_version[ -2 ]
+
+    @@jars ||= {}
+    coordinate = "#{group_id}:#{artifact_id}"
+    coordinate += ":#{classifier}" if classifier
+    if @@jars.key? coordinate
+      if @@jars[ coordinate ] == version
+        false
+      else
+        # version of already registered jar
+        @@jars[ coordinate ]
+      end
+    else
+      do_require( group_id, artifact_id, version, classifier )
+      @@jars[ coordinate ] = version
+      return true
+    end
+  end
+
+  private
+
+  def self.to_jar( group_id, artifact_id, version, classifier )
     file = "#{group_id.gsub( /\./, '/' )}/#{artifact_id}/#{version}/#{artifact_id}-#{version}"
     file += "-#{classifier}" if classifier
     file += '.jar'
+    file
   end
 
-  @@jars ||= {}
-  coordinate = "#{group_id}:#{artifact_id}"
-  coordinate += ":#{classifier}" if classifier
-  if @@jars.key? coordinate
-    if @@jars[ coordinate ] != version
-      warn "coordinate #{coordinate} already loaded with version #{@@jars[ coordinate ]}"
+  def self.do_require( *args )
+    jar = to_jar( *args )
+    file = File.join( home, jar )
+    # use jar from local repository if exists
+    if File.exists?( file )
+      require file
+    else
+      # otherwise try to find it on the load path
+      require jar
     end
-    false
-  else
-    require file
-    @@jars[ coordinate ] = version
-    true
   end
+end
+
+def require_jar( *args )
+  result = Jars.require_jar( *args )
+  if result.is_a? String
+    warn "jar coordinate #{args[0..-2].join( ':' )} already loaded with version #{result}"
+    return false
+  end
+  result
 rescue LoadError => e
-  warn 'you might need to reinstall the gem which depends on the missing jar'
+  warn 'you might need to reinstall the gem which depends on the missing jar.'
   raise e
 end

data/lib/jar_installer.rb

@@ -1,153 +1,206 @@
-class JarInstaller
+require 'jar_dependencies'
+module Jars
+  class JarInstaller
 
-  class Dependency
-    
-    attr_reader :path, :file, :gav, :scope, :type, :coord
+    class Dependency
+      
+      attr_reader :path, :file, :gav, :scope, :type, :coord
+
+      def self.new( line )
+        if line.match /:jar:|:pom:/
+          super
+        end
+      end
 
-    def self.new( line )
-      if line.match /:jar:|:pom:/
-        super
+      def setup_type( line )
+        if line.match /:pom:/
+          @type = :pom
+        elsif line.match /:jar:/
+          @type = :jar
+        end
+      end
+      private :setup_type
+
+      def setup_scope( line )
+        @scope = 
+          case line
+          when /:provided:/
+            :provided
+          when /:test:/
+            :test
+          else
+            :runtime
+          end
       end
+      private :setup_scope
+
+      def initialize( line )
+        setup_type( line )
+
+        line.sub!( /^\s+/, '' )
+        @coord = line.sub( /:[^:]+:[^:]+$/, '' )
+        first, second = line.sub( /:[^:]+:[^:]+$/, '' ).split( /:#{type}:/ )
+        group_id, artifact_id = first.split( /:/ ) 
+        parts = group_id.split( '.' ) 
+        parts << artifact_id
+        parts << second.split( /:/ )[ -1 ]
+        parts << File.basename( line.sub /.:/, '' ) 
+        @path = File.join( parts ).strip
+        
+        setup_scope( line )
+
+        line.gsub!( /:jar:|:pom:|:test:|:compile:|:runtime:|:provided:/, ':' )
+        @file = line.sub( /^.*:/, '' ).strip
+        @gav = line.sub( /:[^:]+$/, '' )
+      end
+    end
+
+    def self.install_jars
+      new.install_jars
     end
 
-    def initialize( line )
-      if line.match /:pom:/
-        @type = :pom
-      elsif line.match /:jar:/
-        @type = :jar
+    def self.load_from_maven( file )
+      result = []
+      File.read( file ).each_line do |line|
+        dep = Dependency.new( line )
+        result << dep if dep
       end
-      line.sub!( /^\s+/, '' )
-      @coord = line.sub( /:[^:]+:[^:]+$/, '' )
-      first, second = line.sub( /:[^:]+:[^:]+$/, '' ).split( /:#{type}:/ )
-      group_id, artifact_id = first.split( /:/ ) 
-      parts = group_id.split( '.' ) 
-      parts << artifact_id
-      parts << second.split( /:/ )[ -1 ]
-      parts << File.basename( line.sub /.:/, '' ) 
-      @path = File.join( parts ).strip
-      
-      @scope = 
-        case line
-        when /:provided:/
-          :provided
-        when /:test:/
-          :test
-        else
-          :runtime
-        end
-      line.gsub!( /:jar:|:pom:|:test:|:compile:|:runtime:|:provided:/, ':' )
-      @file = line.sub( /^.*:/, '' ).strip
-      @gav = line.sub( /:[^:]+$/, '' )
+      result
     end
-  end
 
-  def self.install_jars
-    new.install_jars
-  end
+    def self.write_require_file( require_filename )
+      FileUtils.mkdir_p( File.dirname( require_filename ) )
+      comment = '# this is a generated file, to avoid over-writing it just delete this comment'
+      if ! File.exists?( require_filename ) || File.read( require_filename ).match( comment )
+        f = File.open( require_filename, 'w' )
+        f.puts comment
+        f.puts "require 'jar_dependencies'"
+        f.puts
+        f
+      end
+    end
 
-  def self.load_from_maven( file )
-    result = []
-    File.read( file ).each_line do |line|
-      dep = Dependency.new( line )
-      result << dep if dep
+    def self.vendor_file( dir, dep )
+      vendored = File.join( dir, dep.path )
+      FileUtils.mkdir_p( File.dirname( vendored ) )
+      FileUtils.cp( dep.file, vendored )
     end
-    result
-  end
 
-  def self.install_deps( deps, dir, require_filename, vendor )
-    FileUtils.mkdir_p( File.dirname( require_filename ) )
-    File.open( require_filename, 'w' ) do |f|
-      f.puts "require 'jar_dependencies'"
-      f.puts
+    def self.install_deps( deps, dir, require_filename, vendor )
+      f = write_require_file( require_filename ) if require_filename
       deps.each do |dep|
         next if dep.type != :jar || dep.scope != :runtime
         args = dep.gav.gsub( /:/, "', '" )
-        if vendor
-          vendored = File.join( dir, dep.path )
-          FileUtils.mkdir_p( File.dirname( vendored ) )
-          FileUtils.cp( dep.file, vendored )
-          f.puts( "require_jar( '#{args}' )" )
-        else
-          f.puts( "require_jarfile( '#{dep.file}', '#{args}' )" )
-        end
+        vendor_file( dir, dep ) if vendor
+        f.puts( "require_jar( '#{args}' )" ) if f
       end
+    ensure
+      f.close if f
     end
-  end
 
-  def initialize( spec = nil )
-    if spec.nil?
+    def find_spec
       specs = Dir[ '*.gemspec' ]
       case specs.size
       when 0
         raise 'no gemspec found'
       when 1
-        spec = specs.first
+        specs.first
       else
         raise 'more then one gemspec found. please specify a specfile' 
       end
     end
-    if spec.is_a? String
-      @basedir = File.dirname( File.expand_path( spec ) )
-      @specfile = spec
-      spec =  eval( File.read( spec ) )
-    else
-      @basedir = spec.gem_dir
-      @specfile = spec.spec_file
+    private :find_spec
+
+    def initialize( spec = nil )
+      spec ||= find_spec
+
+      case spec
+      when String
+        @basedir = File.dirname( File.expand_path( spec ) )
+        @specfile = spec
+        spec =  eval( File.read( spec ) )
+      else
+        @basedir = spec.gem_dir
+        @specfile = spec.spec_file
+      end
+
+      @spec = spec
     end
-    @spec = spec
-  end
 
-  def vendor_jars
-    return if @spec.requirements.empty?
-    really_vendor = java.lang.System.get_property( 'jruby.jars.vendor' ) || ENV[ 'JRUBY_JARS_VENDOR' ] || 'true'
-    do_install( really_vendor == 'true' )
-  end
+    def vendor_jars
+      return if @spec.requirements.empty?
+      really_vendor = Jars.to_prop( "JARS_VENDOR" ) || 'true'
+      do_install( really_vendor == 'true', false )
+    end
 
-  def install_jars
-    return if @spec.requirements.empty?
-    do_install( false )
-  end
+    def install_jars
+      return if @spec.requirements.empty?
+      do_install( false, true )
+    end
 
-  private
+    private
 
-  def do_install( vendor )
-    vendor_dir = File.join( @basedir, @spec.require_path )
-    jars_file = File.join( vendor_dir, "#{@spec.name}_jars.rb" )
+    def do_install( vendor, write_require_file )
+      vendor_dir = File.join( @basedir, @spec.require_path )
+      if write_require_file
+        jars_file = File.join( vendor_dir, "#{@spec.name}_jars.rb" )
 
-    return if File.exists?( jars_file ) && 
-      File.mtime( @specfile ) < File.mtime( jars_file )
+        # do not generate file if specfile is older then the generated file
+        if File.exists?( jars_file ) && 
+            File.mtime( @specfile ) < File.mtime( jars_file )
+          jars_file = nil
+        end
+      end
+      self.class.install_deps( install_dependencies, vendor_dir,
+                               jars_file, vendor )
+    end
 
-    self.class.install_deps( install_dependencies, vendor_dir, 
-                             jars_file, vendor )
-  end
+    def setup_arguments( deps )
+      args = [ 'dependency:list', "-DoutputFile=#{deps}", '-DincludeScope=runtime', '-DoutputAbsoluteArtifactFilename=true', '-DincludeTypes=jar', '-DoutputScope=true', '-f', @specfile ]
+      
+      verbose = Jars.to_prop( 'JARS_VERBOSE' ) == 'true'
+      debug = Jars.to_prop( 'JARS_DEBUG' ) == 'true'
 
-  def install_dependencies
-    deps = File.join( @basedir, 'deps.lst' )
+      if debug
+        args << '-X'
+      elsif ! verbose
+        args << '--quiet'
+      end
 
-    # lazy load ruby-maven
-    begin
+      args << "-Dmaven.repo.local=#{java.io.File.new( Jars.home ).absolute_path}"
+      args
+    end
 
+    def lazy_load_maven
       require 'maven/ruby/maven'
-
     rescue LoadError
-      raise 'please install ruby-maven gem so the jar dependencies can be installed'
+      raise "please install ruby-maven gem which is needed to install the jar dependencies\n\n\tgem install ruby-maven\n\n"
     end
-   
-    # monkey patch to NOT include gem dependencies
-    require 'maven/tools/gemspec_dependencies'
-    eval <<EOF
+
+    def monkey_path_gem_dependencies
+      # monkey patch to NOT include gem dependencies
+      require 'maven/tools/gemspec_dependencies'
+      eval <<EOF
       class ::Maven::Tools::GemspecDependencies
         def runtime; []; end
         def development; []; end
       end
 EOF
+    end
 
-    maven = Maven::Ruby::Maven.new
-    maven.exec 'dependency:list', "-DoutputFile=#{deps}", '-DincludeScope=runtime', '-DoutputAbsoluteArtifactFilename=true', '-DincludeTypes=jar', '-DoutputScope=true', '-f', @specfile, '--quiet'
+    def install_dependencies
+      lazy_load_maven
+      
+      monkey_path_gem_dependencies
+
+      deps = File.join( @basedir, 'deps.lst' )
+
+      maven = Maven::Ruby::Maven.new
+      maven.exec( *setup_arguments( deps ) )
 
-    self.class.load_from_maven( deps )
-  ensure
-    FileUtils.rm_f( deps ) if deps
+      self.class.load_from_maven( deps )
+    ensure
+      FileUtils.rm_f( deps ) if deps
+    end
   end
 end
-

data/lib/rubygems_plugin.rb

@@ -22,6 +22,6 @@
 if defined?( JRUBY_VERSION ) && Gem.post_install_hooks.empty?
   Gem.post_install do |gem_installer|
     require 'jar_installer'
-    ::JarInstaller.new( gem_installer.spec ).vendor_jars
+    Jars::JarInstaller.new( gem_installer.spec ).vendor_jars
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jar-dependencies
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - christian meier
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2014-04-10 00:00:00.000000000 Z
+date: 2014-05-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -23,7 +23,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 10.2.2
   prerelease: false
-  type: :runtime
+  type: :development
 - !ruby/object:Gem::Dependency
   name: ruby-maven
   version_requirements: !ruby/object:Gem::Requirement
@@ -37,11 +37,12 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 3.1.1.0
   prerelease: false
-  type: :runtime
+  type: :development
 description: manage jar dependencies for gems and keep track which jar was already loaded using maven artifact coordinates. it warns on version conflicts and loads only ONE jar assuming the first one is compatible to the second one otherwise your project needs to lock down the right version.
 email:
 - mkristian@web.de
-executables: []
+executables:
+- bundle-with-jars
 extensions: []
 extra_rdoc_files: []
 files:
@@ -49,6 +50,9 @@ files:
 - lib/jar_installer.rb
 - lib/jar-dependencies.rb
 - lib/rubygems_plugin.rb
+- bin/bundle-with-jars
+- Rakefile
+- Gemfile
 - Readme.md
 - jar-dependencies.gemspec
 - MIT-LICENSE