jruby-bundler 0.9.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4f3add68c62109a3250bcd286ccf61638a78cd778b0b9f58cc7b3c676898094c
+  data.tar.gz: 817023ab4df35852a5bae8142810f03f6ff57da0928e87b06775be887a7967ca
+SHA512:
+  metadata.gz: 2d903df8f998a8c188d727a9352f053c0e0209d8af4401ce675a801b14bf66ab230fd1eab120c3d47dc1c4e458df52c4848cd0392ed0ca9f2da77d81655b74da
+  data.tar.gz: 49e52ae1d3fb2a3cff153ec23e24060942b18d537da6bbcadfaacfe628aea6d7b99071605d37762a7cf0de75ba2462e04d018599918c88f3986a32f4937169b1

data/Gemfile

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

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Christian Meier
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Readme.md

@@ -0,0 +1,117 @@
+# jbundler
+
+* [![Build Status](https://secure.travis-ci.org/mkristian/jbundler.svg)](http://travis-ci.org/mkristian/jbundler)
+
+Manage jar dependencies similar to how **bundler** manages gem dependencies:
+
+* the DSL mimics the one from bundler
+* you can use maven-like version declarations or rubygems/bundler version ranges
+* it locks down the jar versions inside "Jarfile.lock"
+* you can declare jar dependencies within a gem using the requirements directive of the gem specification. jbundler will include those jar dependencies into its classpath
+
+differences compared to **bundler**
+
+* you need to run ```bundle install``` first if any of the gems have jar dependencies.
+* all one command ```jbundle```, see ```jbundle help``` on the possible options and how to update a single jar, etc.
+
+## Get started
+
+Install JBundler with:
+```bash
+jruby -S gem install jbundler
+```
+
+First, create a **Jarfile**, something like:
+```bash
+jar 'org.yaml:snakeyaml', '1.14'
+jar 'org.slf4j:slf4j-simple', '>1.1'
+```
+
+Install jar dependencies
+```bash
+jruby -S jbundle install
+```
+
+Loading the jar files
+```bash
+require 'jbundler'
+```
+
+It will add all the jar dependencies in the java classpath from the `Jarfile.lock`.
+
+### Jarfile
+
+More info about the **[Jarfile](https://github.com/torquebox/maven-tools/wiki/Jarfile)** and about [versions](https://github.com/torquebox/maven-tools/wiki/Versions).
+
+For adding a maven repository see [Jarfile](https://github.com/torquebox/maven-tools/wiki/Jarfile).
+
+## Building the jbundler gem
+
+Running the integration test
+
+```bash
+./mvnw verify
+./mvnw clean verify
+```
+or a single integration test
+```bash
+./mvnw verify -Dinvoker.test=running_rspec_via_rake
+./mvnw clean verify -Dinvoker.test=running_rspec_via_rake
+```
+
+Building the gem (see ./pkg)
+```bash
+./mvnw package -Dinvoker.skip
+```
+
+Or just
+```bash
+gem build jbundler.gemspec
+```
+
+## Usage
+
+Here is an example usage of the AliasEvent class from the snakeyaml package
+
+```ruby
+#test_file.rb
+require 'jbundler'
+require 'java'
+
+java_import 'org.yaml.snakeyaml.events.AliasEvent'
+
+class TestClass
+  def my_method
+    puts AliasEvent.methods
+  end
+end
+
+TestClass.new.my_method
+```
+
+## Limitations
+
+Since the version resolution happens in two steps - first the gems, and then the jars/poms - it is possible in case of a failure that there is a valid gems/jars version resolution which satisfies all version contraints. So there is plenty of space for improvements (like maven could resolve the gems as well, etc).
+
+## Special thanks
+
+The whole project actually started with a controversial discussion on a [pull request on bundler](https://github.com/carlhuda/bundler/pull/1683). This very same pull request were the starting point of that project here. Probably by now there is not much left of the original code, but many thanks to [ANithian](https://github.com/ANithian) for giving the seed of that project.
+
+License
+-------
+
+Almost all code is under the MIT license but the java class (AetherSettings.java)[https://github.com/mkristian/jbundler/blob/master/src/main/java/jbundler/AetherSettings.java] which was derived from EPL licensed code.
+
+Contributing
+------------
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+Meta-fu
+-------
+
+enjoy :)

data/bin/jbundle

@@ -0,0 +1,51 @@
+#!/usr/bin/env ruby
+if ARGV[0] == 'help'
+
+  # ensure we use the right version
+  gem 'ruby-maven', '>=3.3.3'
+
+  require 'jbundler/cli'
+
+  JBundler::Cli.start
+
+else
+
+  if ARGV == [] || ARGV.all?{ |a| a.match( /^-/ ) }
+    ARGV.unshift 'install'
+  end
+
+  if ARGV[0] == 'console'
+    # ensure we use the right version
+    gem 'ruby-maven', '>=3.3.3'
+
+    require 'irb'
+    require 'jbundler'
+    require 'jbundler/lazy'
+    include JBundler::Lazy
+
+    ARGV.shift
+    require 'jbundler'
+    if defined? JBUNDLER_CLASSPATH
+      warn 'Jarfile dependencies loaded'
+    else
+      warn 'Could not locate a Jarfile'
+    end
+
+    if defined? JBUNDLER_CLASSPATH
+      warn 'Jarfile dependencies loaded'
+    else
+      warn 'Could not locate a Jarfile'
+    end
+
+    IRB.start
+
+  else
+    # ensure we use the right version
+    gem 'ruby-maven', '>=3.3.3'
+    
+    require 'jbundler/cli'
+    JBundler::Cli.start
+  end
+
+end
+

data/lib/jbundler/aether.rb

@@ -0,0 +1,139 @@
+#
+# Copyright (C) 2013 Christian Meier
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of
+# this software and associated documentation files (the "Software"), to deal in
+# the Software without restriction, including without limitation the rights to
+# use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+# the Software, and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+# FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+# COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+# IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+require 'yaml'
+require 'jbundler/config'
+require 'maven/ruby'
+
+module JBundler
+
+  class AetherRuby
+
+    def self.setup_classloader
+      require 'java'
+
+      Dir.glob( File.join( Maven.lib, '*.jar' ) ).each do |path|
+        require path
+      end
+      begin
+        require 'jbundler.jar'
+      rescue LoadError
+        # allow the classes already be added to the classloader
+        begin
+          java_import 'jbundler.Aether'
+        rescue NameError
+          # assume this happens only when working on the git clone
+          raise "jbundler.jar is missing - maybe you need to build it first ? use\n$ rmvn prepare-package -Dmaven.test.skip\n"
+        end
+      end
+      java_import 'jbundler.Aether'
+    end
+
+    def initialize( config = Config.new )
+      unless defined? Aether
+        self.class.setup_classloader
+      end
+      @aether = Aether.new( config.verbose )
+      @aether.add_proxy( config.proxy ) if config.proxy
+      @aether.add_mirror( config.mirror ) if config.mirror
+      @aether.offline = config.offline 
+      if config.settings
+        @aether.user_settings = java.io.File.new( config.settings )
+      end
+      if config.local_repository
+        @aether.local_repository = java.io.File.new(config.local_repository)
+      end
+    rescue NativeException => e
+      e.cause.print_stack_trace
+      raise e
+    end
+
+    def local_jars
+      @local_jars ||= []
+    end
+
+    def add_local_jar( path )
+       local_jars << File.expand_path( path )
+    end
+
+    def add_artifact(coordinate, extension = nil)
+      if extension
+        coord = coordinate.split(/:/)
+        coord.insert(2, extension)
+        @aether.add_artifact(coord.join(":"))
+      else
+        @aether.add_artifact(coordinate)
+      end
+    end
+
+    def add_repository(name, url)
+      @aether.add_repository(name, url)
+    end
+
+    def add_snapshot_repository(name, url)
+      @aether.add_snapshot_repository(name, url)
+    end
+
+    def resolve
+      @aether.resolve unless artifacts.empty?
+    rescue NativeException => e
+      e.cause.print_stack_trace
+      raise e
+    end
+
+    def classpath
+      if artifacts.empty? and local_jars.empty?
+        ''
+      else
+        path = [ @aether.classpath ] 
+        path = path + @local_jars if @local_jars
+        path.join( File::PATH_SEPARATOR )
+      end
+    end
+
+    def classpath_array
+      classpath.split(/#{File::PATH_SEPARATOR}/)
+    end
+
+    def repositories
+      @aether.repositories
+    end
+
+    def artifacts
+      @aether.artifacts
+    end
+
+    def resolved_coordinates
+      if @aether.artifacts.empty?
+        []
+      else
+        @aether.resolved_coordinates
+      end
+    end
+
+    def install(coordinate, file)
+      @aether.install(coordinate, file)
+    rescue NativeException => e
+      e.cause.print_stack_trace
+      raise e
+    end
+
+  end
+end

data/lib/jbundler/classpath_file.rb

@@ -0,0 +1,115 @@
+#
+# Copyright (C) 2013 Christian Meier
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of
+# this software and associated documentation files (the "Software"), to deal in
+# the Software without restriction, including without limitation the rights to
+# use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+# the Software, and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+# FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+# COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+# IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+module JBundler
+
+  class ClasspathFile
+
+    def initialize(classpathfile = '.jbundler/classpath.rb')
+      @classpathfile = classpathfile
+    end
+    
+    def file
+      @classpathfile
+    end
+
+    def load_classpath
+      load File.expand_path @classpathfile
+    end
+
+    def require_classpath
+      load_classpath
+      JBUNDLER_CLASSPATH.each { |c| require c }
+    end
+
+    def require_test_classpath
+      load_classpath
+      JBUNDLER_TEST_CLASSPATH.each { |c| require c }
+    end
+
+    def mtime
+      File.mtime(@classpathfile)
+    end
+
+    def exists?
+      File.exists?(@classpathfile)
+    end
+
+    def missing?( jarfile )
+      !exists? || !jarfile.exists_lock?
+    end
+
+    def jarfile_newer?( jarfile )
+      jarfile.exists? && (jarfile.mtime > mtime)
+    end
+
+    def jarlock_newer?( jarfile )
+      jarfile.exists_lock? && (jarfile.mtime_lock > mtime)
+    end
+       
+    def needs_update?(jarfile, gemfile_lock)
+      if ( jarfile.exists? || gemfile_lock.exists? || jarfile.exists_lock? )
+        missing?( jarfile ) || jarfile_newer?( jarfile ) || jarlock_newer?( jarfile ) || gemfile_lock.newer?( mtime )
+      else
+        false
+      end
+    end
+
+    def generate( classpath_array, test_array = [], jruby_array = [], local_repo = nil )
+      FileUtils.mkdir_p(File.dirname(@classpathfile))
+      File.open(@classpathfile, 'w') do |f|
+        if local_repo
+          local_repo = File.expand_path( local_repo )
+          f.puts "require 'jar_dependencies'"
+          f.puts "JBUNDLER_LOCAL_REPO = Jars.home"
+        end
+        dump_array( f, jruby_array || [], 'JRUBY_', local_repo )
+        dump_array( f, test_array || [], 'TEST_', local_repo )
+        dump_array( f, classpath_array || [], '', local_repo )
+        f.close
+      end
+    end
+    
+    private
+    def dump_array( file, array, prefix, local_repo )
+      file.puts "JBUNDLER_#{prefix}CLASSPATH = []"
+      array.each do |path|
+        dump_jar( file, path, prefix, local_repo )
+      end
+      file.puts "JBUNDLER_#{prefix}CLASSPATH.freeze"
+    end
+
+    def dump_jar( file, path, prefix, local_repo )
+      return if path =~ /pom$/
+      if local_repo
+        path = path.sub( /#{local_repo}/, '' )
+        unless File.exists?( path )
+          file.puts "JBUNDLER_#{prefix}CLASSPATH << (JBUNDLER_LOCAL_REPO + '#{path}')"
+          path = nil
+        end
+      end
+      if path
+        # either we do not have a local_repo or the path is a absolute
+        # path from system artifact
+        file.puts "JBUNDLER_#{prefix}CLASSPATH << '#{path}'"        
+      end
+    end
+  end
+end

data/lib/jbundler/cli.rb

@@ -0,0 +1,148 @@
+#
+# Copyright (C) 2013 Christian Meier
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of
+# this software and associated documentation files (the "Software"), to deal in
+# the Software without restriction, including without limitation the rights to
+# use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+# the Software, and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+# FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+# COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+# IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+require 'bundler/vendored_thor'
+require 'jbundler/config'
+require 'jbundler/tree'
+require 'jbundler/lock_down'
+require 'jbundler/jruby_complete'
+module JBundler
+  # As of v1.9.0, bundler's vendored version of thor is namespaced
+  Thor = Bundler::Thor if Gem.loaded_specs['bundler'].version >= Gem::Version.new('1.9.0')
+
+  class Cli < Thor
+    no_tasks do
+      def config
+        @config ||= JBundler::Config.new
+      end
+
+      def unvendor
+        vendor = JBundler::Vendor.new( config.vendor_dir )
+        vendor.clear
+      end
+
+      def vendor
+        vendor = JBundler::Vendor.new( config.vendor_dir )
+        if vendor.vendored?
+          raise "already vendored. please 'jbundle install --no-deployment before."
+        else
+          vendor.setup( JBundler::ClasspathFile.new( config.classpath_file ) )
+        end
+      end
+
+      def say_bundle_complete
+        puts ''
+        puts 'Your jbundle is complete! Use `jbundle show` to see where the bundled jars are installed.'
+      end
+    end
+
+    desc 'tree', 'display a graphical representation of the dependency tree'
+    #method_option :details, :type => :boolean, :default => false
+    def tree
+      JBundler::Tree.new( config ).show_it
+    end
+
+    desc 'install', "first `bundle install` is called and then the jar dependencies will be installed. for more details see `bundle help install`, jbundler will ignore most options. the install command is also the default when no command is given."
+    method_option :vendor, :type => :boolean, :default => false, :desc => 'vendor jars into vendor directory (jbundler only).'
+    method_option :debug, :type => :boolean, :default => false, :desc => 'enable maven debug output (jbundler only).'
+    method_option :verbose, :type => :boolean, :default => false, :desc => 'enable maven output (jbundler only).'
+    method_option :deployment, :type => :boolean, :default => false, :desc => "copy the jars into the vendor/jars directory (or as configured). these vendored jars have preference before the classpath jars !"
+    method_option :no_deployment, :type => :boolean, :default => false, :desc => 'clears the vendored jars'
+    method_option :path, :type => :string
+    method_option :without, :type => :array
+    method_option :system, :type => :boolean
+    method_option :local, :type => :boolean
+    method_option :binstubs, :type => :string
+    method_option :trust_policy, :type => :string
+    method_option :gemfile, :type => :string
+    method_option :jobs, :type => :string
+    method_option :retry, :type => :string
+    method_option :no_cache, :type => :boolean
+    method_option :quiet, :type => :boolean
+    def install
+      msg = JBundler::LockDown.new( config ).lock_down( options[ :vendor ],
+                                                        options[ :debug ] ,
+                                                        options[ :verbose ] )
+      config.verbose = ! options[ :quiet ]
+      Show.new( config ).show_classpath
+      unless options[ :quiet ]
+        puts 'jbundle complete !'
+        puts
+      end
+      puts msg if msg
+    end
+
+    desc 'console', 'irb session with gems and/or jars and with lazy jar loading.'
+    def console
+      # dummy - never executed !!!
+    end
+
+    desc 'lock_down', "first `bundle install` is called and then the jar dependencies will be installed. for more details see `bundle help install`, jbundler will ignore all options. the install command is also the default when no command is given. that is kept as fall back in cases where the new install does not work as before."
+    method_option :deployment, :type => :boolean, :default => false, :desc => "copy the jars into the vendor/jars directory (or as configured). add the vendor/jars $LOAD_PATH and Jars.require_jars_lock! - no need for any jbundler files at runtime !"
+    method_option :no_deployment, :type => :boolean, :default => false, :desc => 'clears the vendored jars'
+    method_option :path, :type => :string
+    method_option :without, :type => :array
+    method_option :system, :type => :boolean
+    method_option :local, :type => :boolean
+    method_option :binstubs, :type => :string
+    method_option :trust_policy, :type => :string
+    method_option :gemfile, :type => :string
+    method_option :jobs, :type => :string
+    method_option :retry, :type => :string
+    method_option :no_cache, :type => :boolean
+    method_option :quiet, :type => :boolean
+    def lock_down
+      require 'jbundler'
+
+      unvendor if options[ :no_deployment ]
+
+      vendor if options[ :deployment ]
+
+      config.verbose = ! options[ :quiet ]
+
+      Show.new( config ).show_classpath
+
+      say_bundle_complete unless options[ :quiet ]
+    end
+
+    desc 'update', "first `bundle update` is called and if there are no options then the jar dependencies will be updated. for more details see `bundle help update`."
+    method_option :debug,   :type => :boolean, :default => false, :desc => 'enable maven debug output (jbundler only).'
+    method_option :verbose, :type => :boolean, :default => false, :desc => 'enable maven output (jbundler only).'
+    method_option :quiet,   :type => :boolean
+    def update
+      msg = JBundler::LockDown.new( config ).update( options[ :debug ] ,
+                                                     options[ :verbose ] )
+
+      config.verbose = ! options[ :quiet ]
+      Show.new( config ).show_classpath
+      unless options[ :quiet ]
+        puts ''
+        puts 'Your jbundle is updated! Use `jbundle show` to see where the bundled jars are installed.'
+      end
+      puts msg if msg
+    end
+
+    desc 'show', "first `bundle show` is called and if there are no options then the jar dependencies will be displayed. for more details see `bundle help show`."
+    def show
+      config.verbose = true
+      Show.new( config ).show_classpath
+    end
+  end
+end