jar-dependencies 0.6.0.pre3-java

data/lib/jar_dependencies.rb

@@ -0,0 +1,408 @@
+# frozen_string_literal: true
+
+#
+# Copyright (C) 2014 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 Jars
+  # rubocop:disable Style/RedundantFreeze
+  MAVEN_SETTINGS = 'JARS_MAVEN_SETTINGS'.freeze
+  LOCAL_MAVEN_REPO = 'JARS_LOCAL_MAVEN_REPO'.freeze
+  # lock file to use
+  LOCK = 'JARS_LOCK'.freeze
+  # where the locally stored jars are search for or stored
+  HOME = 'JARS_HOME'.freeze
+  # skip the gem post install hook
+  SKIP = 'JARS_SKIP'.freeze
+  # skip Jars.lock mainly to run lock_jars
+  SKIP_LOCK = 'JARS_SKIP_LOCK'.freeze
+  # do not require any jars if set to false
+  REQUIRE = 'JARS_REQUIRE'.freeze
+  # @private
+  NO_REQUIRE = 'JARS_NO_REQUIRE'.freeze
+  # no more warnings on conflict. this still requires jars but will
+  # not warn. it is needed to load jars from (default) gems which
+  # do contribute to any dependency manager (maven, gradle, jbundler)
+  QUIET = 'JARS_QUIET'.freeze
+  # show resolver output
+  VERBOSE = 'JARS_VERBOSE'.freeze
+  # show jar-dependencies debug output
+  DEBUG = 'JARS_DEBUG'.freeze
+  # vendor jars inside gem when installing gem
+  VENDOR = 'JARS_VENDOR'.freeze
+  # string used when the version is unknown
+  UNKNOWN = 'unknown'.freeze
+  # rubocop:enable Style/RedundantFreeze
+
+  autoload :Classpath, 'jars/classpath'
+  autoload :MavenSettings, 'jars/maven_settings'
+  autoload :Mima, 'jars/mima'
+
+  @jars = {}
+  @jars_lock = false
+  @jars_locked = nil
+
+  class JarLoadError < LoadError; end
+
+  class << self
+    def lock_down(debug: nil, verbose: nil, **kwargs)
+      previous_debug = ENV[DEBUG]
+      previous_verbose = ENV[VERBOSE]
+      previous_skip_lock = ENV[SKIP_LOCK]
+      ENV[DEBUG] = debug.to_s unless debug.nil?
+      ENV[VERBOSE] = verbose.to_s unless verbose.nil?
+      ENV[SKIP_LOCK] = 'true'
+      require 'jars/lock_down' # do this lazy to keep things clean
+      Jars::LockDown.new.lock_down(kwargs.delete(:vendor_dir), **kwargs)
+    ensure
+      ENV[DEBUG] = previous_debug unless debug.nil?
+      ENV[VERBOSE] = previous_verbose unless verbose.nil?
+      ENV[SKIP_LOCK] = previous_skip_lock
+    end
+
+    if defined? JRUBY_VERSION
+      def to_prop(key)
+        key = key.tr('_', '.')
+        ENV_JAVA[(key.downcase!
+                  key)] ||
+          ENV[(key.tr!('.', '_')
+               key.upcase!
+               key)]
+      end
+    else
+      def to_prop(key)
+        ENV[key.tr('.', '_').upcase]
+      end
+    end
+
+    def to_boolean(key)
+      return nil if (prop = to_prop(key)).nil?
+
+      prop.empty? || prop.eql?('true')
+    end
+
+    def skip?
+      to_boolean(SKIP)
+    end
+
+    def require?
+      if @require.nil?
+        if (require = to_boolean(REQUIRE)).nil?
+          no_require = to_boolean(NO_REQUIRE)
+          @require = no_require.nil? || !no_require
+        else
+          @require = require
+        end
+      end
+      @require
+    end
+    attr_writer :require
+
+    def quiet?
+      @quiet = to_boolean(QUIET) if @quiet.nil?
+      @quiet
+    end
+
+    # @deprecated
+    def no_more_warnings
+      @quiet = true
+    end
+
+    def locked_jar?(coordinate)
+      @jars_locked&.include?(coordinate)
+    end
+
+    def jarfile
+      ENV['JARFILE'] || ENV_JAVA['jarfile'] || ENV['JBUNDLER_JARFILE'] || ENV_JAVA['jbundler.jarfile'] || 'Jarfile'
+    end
+
+    def verbose?
+      verbose = to_boolean(VERBOSE)
+      verbose.nil? ? debug? : (verbose || !!debug?)
+    end
+
+    def debug?
+      to_boolean(DEBUG)
+    end
+
+    def vendor?
+      to_boolean(VENDOR)
+    end
+
+    def freeze_loading
+      self.require = false
+    end
+
+    def skip_lock?
+      to_prop(SKIP_LOCK) || false
+    end
+
+    def lock
+      @lock ||= to_prop(LOCK) || 'Jars.lock'
+    end
+
+    def jars_lock_from_class_loader
+      return unless defined?(JRUBY_VERSION)
+
+      JRuby::Util.class_loader_resources('Jars.lock')
+    end
+
+    def lock_path(basedir = nil)
+      return lock if File.exist?(lock)
+
+      basedir ||= '.'
+      ['.', 'jars', 'vendor/jars'].each do |dir|
+        file = File.join(basedir, dir, lock)
+        return file if File.exist?(file)
+      end
+      nil
+    end
+
+    def reset
+      instance_variables.each do |var|
+        next if var == :@jars_lock
+
+        instance_variable_set(var, nil)
+      end
+      Jars::MavenSettings.reset
+      @jars = {}
+      @jars_locked = nil
+    end
+
+    def maven_local_settings
+      Jars::MavenSettings.local_settings
+    end
+
+    def maven_user_settings
+      Jars::MavenSettings.user_settings
+    end
+
+    def maven_settings
+      Jars::MavenSettings.settings
+    end
+
+    def maven_global_settings
+      Jars::MavenSettings.global_settings
+    end
+
+    def local_maven_repo
+      @local_maven_repo ||= absolute(to_prop(LOCAL_MAVEN_REPO)) ||
+                            detect_local_repository(maven_local_settings) ||
+                            detect_local_repository(maven_user_settings) ||
+                            detect_local_repository(maven_global_settings) ||
+                            File.join(user_home, '.m2', 'repository')
+    end
+
+    def home
+      @home ||= absolute(to_prop(HOME)) || local_maven_repo
+    end
+
+    def require_jars_lock!(scope = :runtime)
+      urls = jars_lock_from_class_loader if to_prop(LOCK).nil?
+      pre_lock_jars = @jars.keys.dup
+      if urls && !urls.empty?
+        @jars_lock = true
+
+        done = []
+        while done != urls
+          urls.each do |url|
+            next if done.member?(url)
+
+            Jars.debug { "--- load jars from uri #{url}" }
+            classpath = Jars::Classpath.new(nil, "uri:#{url}")
+            classpath.require(scope)
+            done << url
+          end
+        end
+      elsif (jars_lock = Jars.lock_path)
+        Jars.debug { "--- load jars from #{jars_lock}" }
+        @jars_lock = jars_lock
+
+        classpath = Jars::Classpath.new(nil, jars_lock)
+        classpath.require(scope)
+      end
+
+      return unless @jars_lock
+
+      @jars_locked = (@jars.keys - pre_lock_jars).freeze
+      return if @jars_locked.empty?
+
+      Jars.debug do
+        loaded = @jars.collect { |k, v| "#{k}:#{v}" }
+        "--- loaded jars ---\n\t#{loaded.join("\n\t")}"
+      end
+    end
+
+    def setup(options = nil)
+      case options
+      when Symbol
+        require_jars_lock!(options)
+      when Hash
+        @home = options[:jars_home]
+        @lock = options[:jars_lock]
+        require_jars_lock!(options[:scope] || :runtime)
+      else
+        require_jars_lock!
+      end
+    end
+
+    def require_jars_lock
+      return if @jars_lock
+
+      require_jars_lock!
+      @jars_lock ||= true # rubocop:disable Naming/MemoizedInstanceVariableName
+    end
+
+    def mark_as_required(group_id, artifact_id, *classifier_version)
+      require_jar_with_block(group_id, artifact_id, *classifier_version) do
+        # ignore
+      end
+    end
+
+    def require_jar(group_id, artifact_id, *classifier_version)
+      require_jars_lock unless skip_lock?
+      if classifier_version.empty? && block_given?
+        classifier_version = [yield].compact
+        return mark_as_required(group_id, artifact_id, UNKNOWN) || false if classifier_version.empty?
+      end
+      require_jar_with_block(group_id, artifact_id, *classifier_version) do |gid, aid, version, classifier|
+        do_require(gid, aid, version, classifier)
+      end
+    end
+
+    def info(msg = nil, newline: true)
+      return if quiet?
+
+      msg = yield if msg.nil? && block_given?
+      Kernel.print("#{msg}#{"\n" if newline}")
+    end
+
+    def warn(msg = nil)
+      return if quiet? && !debug?
+
+      Kernel.warn(msg || yield)
+    end
+
+    def debug(msg = nil)
+      return unless debug?
+
+      msg = "#{msg.inspect}\n\t#{(msg.backtrace || []).join("\n\t")}" if msg.is_a?(Exception)
+      Kernel.warn(msg || yield)
+    end
+
+    def absolute(file)
+      File.expand_path(file) if file
+    end
+
+    def user_home
+      ENV['HOME'] || begin
+        user_home = Dir.home if Dir.respond_to?(:home)
+        user_home = ENV_JAVA['user.home'] if !user_home && Object.const_defined?(:ENV_JAVA)
+        user_home
+      end
+    end
+
+    private
+
+    def require_jar_with_block(group_id, artifact_id, *classifier_version)
+      version = classifier_version[-1]
+      classifier = classifier_version[-2]
+
+      coordinate = "#{group_id}:#{artifact_id}#{":#{classifier}" if classifier}"
+      if @jars.key?(coordinate)
+        if @jars[coordinate] == version
+          false
+        else
+          @jars[coordinate] # version of already registered jar
+        end
+      else
+        yield group_id, artifact_id, version, classifier
+        @jars[coordinate] = version
+        true
+      end
+    end
+
+    def detect_local_repository(settings)
+      return nil unless settings
+
+      doc = File.read(settings)
+      # TODO: filter out xml comments
+      local_repo = doc.sub(%r{</localRepository>.*}m, '').sub(/.*<localRepository>/m, '')
+      # replace maven like system properties embedded into the string
+      local_repo.gsub!(/\$\{[a-zA-Z.]+\}/) do |a|
+        ENV_JAVA[a[2..-2]] || a
+      end
+      local_repo = nil if local_repo.empty? || !File.exist?(local_repo)
+      local_repo
+    rescue => e
+      Jars.warn "error reading or parsing local settings from: #{settings}"
+      Jars.debug(e)
+      nil
+    end
+
+    def to_jar(group_id, artifact_id, version, classifier = nil)
+      file = +"#{group_id.tr('.', '/')}/#{artifact_id}/#{version}/#{artifact_id}-#{version}"
+      file << "-#{classifier}" if classifier
+      file << '.jar'
+      file
+    end
+
+    def do_require(group_id, artifact_id, version, classifier)
+      jar = to_jar(group_id, artifact_id, version, classifier)
+      # use jar from PWD/vendor/jars if exists
+      if File.exist?(vendor = File.join(Dir.pwd, 'vendor', 'jars', jar))
+        require vendor
+      # use jar from PWD/jars if exists
+      elsif File.exist?(local = File.join(Dir.pwd, 'jars', jar))
+        require local
+      # use jar from local repository if exists
+      elsif File.exist?(file = File.join(home, jar))
+        require file
+      else
+        # otherwise try to find it on the load path
+        require jar
+      end
+    rescue LoadError => e
+      Jars.warn "failed to load jar: #{jar} (#{e.message})"
+      Jars.debug(e)
+      raise JarLoadError, "failed to load jar: #{jar}; run `lock_jars` or reinstall the gem"
+    end
+  end
+end
+
+def require_jar(*args, &block)
+  return unless Jars.require?
+
+  result = Jars.require_jar(*args, &block)
+  if result.is_a?(String)
+    args << (yield || Jars::UNKNOWN) if args.size == 2 && block
+    coordinate = args[0..-2].join(':')
+    unless Jars.locked_jar?(coordinate)
+      Jars.warn do
+        "jar conflict: #{coordinate} already loaded with version #{result}; " \
+          "skipping requested version #{args[-1]}"
+      end
+    end
+    Jars.debug("\n\t#{caller.join("\n\t")}") if Jars.debug?
+    return false
+  end
+  Jars.debug { "jar registration: #{args.inspect}; loaded=#{result}" }
+  result
+end

data/lib/jar_install_post_install_hook.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+#
+# Copyright (C) 2014 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 'jars/post_install_hook'

data/lib/jars/classpath.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'jars/maven_exec'
+require 'jars/lock'
+require 'fileutils'
+
+module Jars
+  class Classpath
+    # convenient method
+    def self.require(scope = nil)
+      new.require(scope)
+    end
+
+    # convenient method
+    def self.classpath(scope = nil)
+      new.classpath(scope)
+    end
+
+    # convenient method
+    def self.classpath_string(scope = nil)
+      new.classpath_string(scope)
+    end
+
+    def initialize(spec = nil, deps = nil)
+      @spec = spec
+      @deps = deps
+    end
+
+    def mvn
+      @mvn ||= MavenExec.new(@spec)
+    end
+
+    def workdir(dirname)
+      dir = File.join(mvn.basedir, dirname)
+      dir if File.directory?(dir)
+    end
+
+    def dependencies_list
+      if @deps.nil?
+        deps = Jars.lock_path(mvn.basedir)
+        @deps = deps if deps && File.exist?(deps)
+      end
+      @deps || resolve_dependencies
+    end
+    private :dependencies_list
+
+    DEPENDENCY_LIST = 'dependencies.list'
+    def resolve_dependencies
+      basedir = workdir('pkg') || workdir('target') || workdir('')
+      deps = File.join(basedir, DEPENDENCY_LIST)
+      mvn.resolve_dependencies_list(deps)
+      deps
+    end
+    private :resolve_dependencies
+
+    def require(scope = nil)
+      process(scope) do |jar|
+        if jar.scope == :system
+          Kernel.require jar.path
+        else
+          require_jar(*jar.gacv)
+        end
+      end
+      return unless scope.nil? || scope == :runtime
+
+      process(:provided) do |jar|
+        Jars.mark_as_required(*jar.gacv)
+      end
+    end
+
+    def classpath(scope = nil)
+      classpath = []
+      process(scope) do |jar|
+        classpath << jar.file
+      end
+      classpath
+    end
+
+    def process(scope, &block)
+      deps = dependencies_list
+      Lock.new(deps).process(scope, &block)
+    ensure
+      # just delete the temporary file if it exists
+      FileUtils.rm_f(DEPENDENCY_LIST)
+    end
+    private :process
+
+    def classpath_string(scope = nil)
+      classpath(scope).join(File::PATH_SEPARATOR)
+    end
+  end
+end