jar-dependencies 0.6.0.pre3-java

data/lib/jars/maven_exec.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require 'jar_dependencies'
+require 'jars/gemspec_artifacts'
+
+module Jars
+  class MavenExec
+    def find_spec(allow_no_file)
+      specs = Dir['*.gemspec']
+      case specs.size
+      when 0
+        raise 'no gemspec found' unless allow_no_file
+      when 1
+        specs.first
+      else
+        raise 'more than one gemspec found; please specify a specfile' unless allow_no_file
+      end
+    end
+    private :find_spec
+
+    attr_reader :basedir, :spec, :specfile
+
+    def initialize(spec = nil)
+      setup(spec)
+    rescue StandardError, LoadError => e
+      Jars.warn "unable to load gemspec (#{e.message}); skipping jar dependency discovery"
+      Jars.debug(e)
+    end
+
+    def setup(spec = nil, allow_no_file: false)
+      spec ||= find_spec(allow_no_file)
+
+      case spec
+      when String
+        @specfile = File.expand_path(spec)
+        @basedir = File.dirname(@specfile)
+        Dir.chdir(@basedir) do
+          spec = eval(File.read(@specfile), TOPLEVEL_BINDING, @specfile) # rubocop:disable Security/Eval
+        end
+      when Gem::Specification
+        if File.exist?(spec.loaded_from)
+          @basedir = spec.gem_dir
+          @specfile = spec.loaded_from
+        else
+          # this happens with bundle and local gems
+          # there spec_file is "not installed" but is inside the gem_dir directory
+          Dir.chdir(spec.gem_dir) do
+            setup(nil, allow_no_file: true)
+          end
+        end
+      when nil
+        # ignore
+      else
+        Jars.debug "unsupported spec argument #{spec.class}; expected String or Gem::Specification"
+      end
+      @spec = spec
+    end
+
+    def resolve_dependencies_list(file)
+      require 'jars/mima'
+
+      artifacts = GemspecArtifacts.new(@spec)
+      is_local_file = File.expand_path(File.dirname(@specfile)) == File.expand_path(Dir.pwd)
+
+      resolved = Jars::Mima.resolve_artifacts(artifacts.artifacts, all_dependencies: is_local_file)
+
+      # Write output in Maven dependency:list format for Installer::Dependency compatibility
+      allowed_types = %w[jar pom].freeze
+      File.open(file, 'w') do |f|
+        f.puts
+        f.puts 'The following files have been resolved:'
+        resolved.each do |dep|
+          next unless allowed_types.include?(dep.type)
+
+          line = +"   #{dep.group_id}:#{dep.artifact_id}:#{dep.type}:"
+          line << "#{dep.classifier}:" if dep.classifier
+          line << "#{dep.version}:#{dep.scope}:#{dep.file}"
+          f.puts line
+        end
+      end
+    end
+  end
+end

data/lib/jars/maven_settings.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Jars
+  class MavenSettings
+    class << self
+      def local_settings
+        @_jars_maven_local_settings_ = nil unless instance_variable_defined?(:@_jars_maven_local_settings_)
+        if @_jars_maven_local_settings_.nil?
+          settings = Jars.absolute('settings.xml')
+          @_jars_maven_local_settings_ =
+            if settings && File.exist?(settings)
+              settings
+            else
+              false
+            end
+        end
+        @_jars_maven_local_settings_ || nil
+      end
+
+      def user_settings
+        @_jars_maven_user_settings_ = nil unless instance_variable_defined?(:@_jars_maven_user_settings_)
+        if @_jars_maven_user_settings_.nil?
+          if (settings = Jars.absolute(Jars.to_prop(MAVEN_SETTINGS)))
+            unless File.exist?(settings)
+              Jars.warn { "configured ENV['#{MAVEN_SETTINGS}'] = '#{settings}' not found" }
+              settings = false
+            end
+          else # use maven default (user) settings
+            settings = File.join(Jars.user_home, '.m2', 'settings.xml')
+            settings = false unless File.exist?(settings)
+          end
+          @_jars_maven_user_settings_ = settings
+        end
+        @_jars_maven_user_settings_ || nil
+      end
+
+      def settings
+        @_jars_maven_settings_ = nil unless instance_variable_defined?(:@_jars_maven_settings_)
+        local_settings || user_settings if @_jars_maven_settings_.nil?
+      end
+
+      def global_settings
+        @_jars_maven_global_settings_ = nil unless instance_variable_defined?(:@_jars_maven_global_settings_)
+        if @_jars_maven_global_settings_.nil?
+          if (mvn_home = ENV['M2_HOME'] || ENV['MAVEN_HOME'])
+            settings = File.join(mvn_home, 'conf/settings.xml')
+            settings = false unless File.exist?(settings)
+          else
+            settings = false
+          end
+          @_jars_maven_global_settings_ = settings
+        end
+        @_jars_maven_global_settings_ || nil
+      end
+
+      def reset
+        instance_variables.each { |var| instance_variable_set(var, nil) }
+      end
+    end
+  end
+end

data/lib/jars/mima/version.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Jars
+  module Mima
+    MIMA_VERSION = '2.4.42'
+    SLF4J_VERSION = '2.0.17'
+
+    MAVEN_CENTRAL = 'https://repo.maven.apache.org/maven2'
+    MIMA_DIR = 'lib/jars/mima'
+
+    # GAV and SHA-1 checksum (as published on Maven Central) for each jar
+    jars = %w[
+      org.slf4j:slf4j-api:2.0.17
+      d9e58ac9c7779ba3bf8142aff6c830617a7fe60f
+
+      org.slf4j:slf4j-simple:2.0.17
+      9872a3fd794ffe7b18d17747926a64d61526ca96
+
+      org.slf4j:jcl-over-slf4j:2.0.17
+      76ea503eb688f06556a9ba69995d7eab63e34531
+
+      eu.maveniverse.maven.mima:context:2.4.42
+      72aa4d9ccef7a329f473e43752ec863c5194c72c
+
+      eu.maveniverse.maven.mima.runtime:standalone-static-uber:2.4.42
+      43666099e6eb31610f9d3b146811479dd3e4aef1
+    ]
+
+    JARS = jars.each_slice(2).to_h do |gav, sha1|
+      group, artifact, version = gav.split(':')
+      group = group.tr('.', '/')
+      jar_file = "#{artifact}-#{version}.jar"
+      [
+        jar_file,
+        {
+          url: "#{MAVEN_CENTRAL}/#{group}/#{artifact}/#{version}/#{jar_file}",
+          sha1: sha1
+        }
+      ]
+    end
+  end
+end

data/lib/jars/mima.rb

@@ -0,0 +1,382 @@
+# frozen_string_literal: true
+
+require 'jars/mima/version'
+require 'jars/gemspec_artifacts'
+
+module Jars
+  # Resolver backed by the Mima Java library (MIni MAven).
+  # Replaces the previous ruby-maven based resolution pipeline.
+  #
+  # Mima wraps the Maven Resolver (Aether) API as a standalone library (no Maven process is spawned).
+  module Mima
+    class << self
+      @@jars_loaded = nil # rubocop:disable Style/ClassVars
+
+      # Loads the bundled Mima jars onto the classpath.
+      # Safe to call multiple times; only loads once.
+      def ensure_jars_loaded
+        return if @@jars_loaded
+
+        configure_logging if Jars.debug?
+
+        mima_dir = File.expand_path('mima', File.dirname(__FILE__))
+
+        load File.join(mima_dir, "slf4j-api-#{SLF4J_VERSION}.jar")
+        load File.join(mima_dir, "slf4j-simple-#{SLF4J_VERSION}.jar")
+        load File.join(mima_dir, "jcl-over-slf4j-#{SLF4J_VERSION}.jar")
+        load File.join(mima_dir, "context-#{MIMA_VERSION}.jar")
+        load File.join(mima_dir, "standalone-static-uber-#{MIMA_VERSION}.jar")
+
+        @@jars_loaded = true # rubocop:disable Style/ClassVars
+      end
+
+      # Builds a +ContextOverrides+ from jar-dependencies configuration
+      # (local repo, user/global settings.xml).
+      #
+      # @return [Java::eu.maveniverse.maven.mima.context.ContextOverrides]
+      def context_overrides
+        ensure_jars_loaded
+
+        builder = Java::eu.maveniverse.maven.mima.context.ContextOverrides.create
+        builder.withUserSettings(true)
+
+        # Local repository override
+        local_repo = ::Jars.local_maven_repo
+        builder.withLocalRepositoryOverride(java.nio.file.Paths.get(local_repo)) if local_repo
+
+        # User settings.xml override
+        settings = ::Jars::MavenSettings.settings
+        builder.withUserSettingsXmlOverride(java.nio.file.Paths.get(settings)) if settings
+
+        # Global settings.xml override
+        global = ::Jars::MavenSettings.global_settings
+        builder.withGlobalSettingsXmlOverride(java.nio.file.Paths.get(global)) if global
+
+        builder.repositoryListener(aether_repository_listener)
+        builder.transferListener(aether_transfer_listener)
+        builder.build
+      end
+
+      # Creates a Mima Context. Caller is responsible for closing it.
+      #
+      # @param overrides [Java::eu.maveniverse.maven.mima.context.ContextOverrides, nil]
+      #   optional overrides; when +nil+, {#context_overrides} is used
+      # @return [Java::eu.maveniverse.maven.mima.context.Context]
+      def create_context(overrides = nil)
+        ensure_jars_loaded
+
+        overrides ||= context_overrides
+        runtime = Java::eu.maveniverse.maven.mima.context.Runtimes::INSTANCE.getRuntime
+        runtime.create(overrides)
+      end
+
+      # Resolves transitive dependencies for the given artifacts.
+      # Creates (and closes) its own Mima context.
+      #
+      # @param artifacts [Array<Jars::GemspecArtifacts::Artifact>] jar dependency declarations
+      # @param all_dependencies [Boolean] when +true+, include provided/test scoped artifacts
+      # @return [Array<ResolvedDependency>] resolved artifacts with local file paths
+      def resolve_artifacts(artifacts, all_dependencies: false)
+        context = create_context
+        begin
+          resolve_with_context(context, artifacts, all_dependencies: all_dependencies)
+        ensure
+          context.close
+        end
+      end
+
+      # Resolves transitive dependencies using an existing Mima context.
+      #
+      # @param context [Java::eu.maveniverse.maven.mima.context.Context] an open Mima context
+      # @param artifacts [Array<Jars::GemspecArtifacts::Artifact>] jar dependency declarations
+      # @param all_dependencies [Boolean] when +true+, include provided/test scoped artifacts
+      # @return [Array<ResolvedDependency>] resolved artifacts with local file paths
+      def resolve_with_context(context, artifacts, all_dependencies: false)
+        deps = artifacts_to_dependencies(artifacts, all_dependencies: all_dependencies)
+        return [] if deps.empty?
+
+        collect_request = org.eclipse.aether.collection.CollectRequest.new
+        deps.each { |d| collect_request.addDependency(d) }
+        collect_request.setRepositories(context.remoteRepositories)
+
+        dependency_request = org.eclipse.aether.resolution.DependencyRequest.new
+        dependency_request.setCollectRequest(collect_request)
+
+        result = context.repositorySystem.resolveDependencies(
+          context.repositorySystemSession, dependency_request
+        )
+        collect_resolved(result.getRoot)
+      end
+
+      private
+
+      def configure_logging
+        return unless Object.const_defined?(:ENV_JAVA)
+
+        set_default_java_property('org.slf4j.simpleLogger.defaultLogLevel', 'info')
+        set_default_java_property('org.slf4j.simpleLogger.showThreadName', 'false')
+        set_default_java_property('org.slf4j.simpleLogger.log.org.apache.maven', 'debug')
+      end
+
+      def set_default_java_property(key, value)
+        ENV_JAVA[key] = value unless ENV_JAVA[key]
+      end
+
+      def aether_repository_listener
+        org.eclipse.aether.RepositoryListener.impl do |method, event|
+          case method
+          when :artifactDescriptorInvalid
+            Jars.debug { "[mima] invalid artifact descriptor #{artifact_label(event.getArtifact)}" }
+          when :artifactDescriptorMissing
+            Jars.debug { "[mima] missing artifact descriptor #{artifact_label(event.getArtifact)}" }
+          when :metadataInvalid
+            Jars.debug { "[mima] invalid metadata #{metadata_label(event.getMetadata)}" }
+          when :artifactResolving
+            progress_dot
+            Jars.debug { "[mima] resolving artifact #{artifact_label(event.getArtifact)}" }
+          when :artifactResolved
+            Jars.debug { resolved_message('artifact', event) }
+          when :metadataResolving
+            progress_dot
+            Jars.debug { "[mima] resolving metadata #{metadata_label(event.getMetadata)}" }
+          when :metadataResolved
+            Jars.debug { resolved_message('metadata', event) }
+          when :artifactDownloading
+            progress_dot
+            Jars.debug { download_message('artifact', event) }
+          when :artifactDownloaded
+            Jars.debug { downloaded_message('artifact', event) }
+          when :metadataDownloading
+            progress_dot
+            Jars.debug { download_message('metadata', event) }
+          when :metadataDownloaded
+            Jars.debug { downloaded_message('metadata', event) }
+          end
+        end
+      end
+
+      def aether_transfer_listener
+        org.eclipse.aether.transfer.TransferListener.impl do |method, event|
+          case method
+          when :transferInitiated
+            Jars.debug { transfer_message('initiated', event) }
+          when :transferStarted
+            Jars.debug { transfer_message('started', event) }
+          when :transferCorrupted
+            Jars.debug { transfer_message('corrupted', event) }
+          when :transferSucceeded
+            Jars.debug { transfer_message('succeeded', event, bytes: true) }
+          when :transferFailed
+            Jars.debug { transfer_message('failed', event) }
+          end
+        end
+      end
+
+      # Emits a single progress dot (no newline) unless in debug mode
+      def progress_dot
+        Jars.info('.', newline: false) unless Jars.debug?
+      end
+
+      def resolved_message(kind, event)
+        message = +"[mima] resolved #{kind} #{repository_item_label(event)}"
+        message << " -> #{event.getFile.getAbsolutePath}" if event.getFile
+        message << " (#{event.getException.message})" if event.getException
+        message
+      end
+
+      def download_message(kind, event)
+        message = +"[mima] downloading #{kind} #{repository_item_label(event)}"
+        repository = event.getRepository
+        message << " from #{repository}" if repository
+        message
+      end
+
+      def downloaded_message(kind, event)
+        message = +"[mima] downloaded #{kind} #{repository_item_label(event)}"
+        message << " -> #{event.getFile.getAbsolutePath}" if event.getFile
+        message << " (#{event.getException.message})" if event.getException
+        message
+      end
+
+      def repository_item_label(event)
+        artifact = event.getArtifact
+        return artifact_label(artifact) if artifact
+
+        metadata_label(event.getMetadata)
+      end
+
+      def artifact_label(artifact)
+        artifact&.to_s || 'unknown'
+      end
+
+      def metadata_label(metadata)
+        metadata&.to_s || 'unknown'
+      end
+
+      def transfer_message(action, event, bytes: false)
+        resource = event.getResource
+        location = "#{resource.getRepositoryUrl}#{resource.getResourceName}"
+        message = +"[mima] transfer #{action} #{event.getRequestType.to_s.downcase} #{location}"
+        message << " (#{format_bytes(event.getTransferredBytes)})" if bytes
+        message << " (#{event.getException})" if event.getException
+        message
+      end
+
+      def format_bytes(bytes)
+        return "#{bytes} B" if bytes < 1024
+
+        "#{(bytes / 1024.0).round(1)} KB"
+      end
+
+      # Converts {GemspecArtifacts::Artifact} objects to Aether +Dependency+ list,
+      # filtering by scope unless +all_dependencies+ is set.
+      #
+      # @param artifacts [Array<Jars::GemspecArtifacts::Artifact>]
+      # @param all_dependencies [Boolean]
+      # @return [Array<org.eclipse.aether.graph.Dependency>]
+      def artifacts_to_dependencies(artifacts, all_dependencies: false)
+        filtered_artifacts = artifacts.select do |artifact|
+          all_dependencies || (artifact.scope != 'provided' && artifact.scope != 'test')
+        end
+
+        filtered_artifacts.map do |artifact|
+          aether_artifact = build_aether_artifact(artifact)
+          scope = artifact.scope || 'compile'
+          dep = org.eclipse.aether.graph.Dependency.new(aether_artifact, scope)
+
+          if artifact.exclusions && !artifact.exclusions.empty?
+            exclusions = artifact.exclusions.map do |ex|
+              org.eclipse.aether.graph.Exclusion.new(ex.group_id, ex.artifact_id, '*', '*')
+            end
+            dep = dep.setExclusions(exclusions)
+          end
+
+          dep
+        end
+      end
+
+      # Converts a single {GemspecArtifacts::Artifact} to an Aether +DefaultArtifact+.
+      #
+      # @param artifact [Jars::GemspecArtifacts::Artifact]
+      # @return [org.eclipse.aether.artifact.DefaultArtifact]
+      def build_aether_artifact(artifact)
+        version = Jars::MavenVersion.resolve(artifact.version) || artifact.version
+        if artifact.classifier
+          org.eclipse.aether.artifact.DefaultArtifact.new(
+            artifact.group_id, artifact.artifact_id, artifact.classifier,
+            artifact.type || 'jar', version
+          )
+        else
+          org.eclipse.aether.artifact.DefaultArtifact.new(
+            artifact.group_id, artifact.artifact_id,
+            artifact.type || 'jar', version
+          )
+        end
+      end
+
+      # Walks the resolved dependency tree and collects {ResolvedDependency} objects.
+      #
+      # @param node [org.eclipse.aether.graph.DependencyNode] root of the resolved tree
+      # @param result [Array<ResolvedDependency>] accumulator
+      # @return [Array<ResolvedDependency>]
+      def collect_resolved(node, result = [])
+        node.getChildren.each do |child|
+          dep = child.getDependency
+          next unless dep
+
+          artifact = dep.getArtifact
+          next unless artifact.getFile # skip unresolved
+
+          result << ResolvedDependency.new(
+            artifact.getGroupId,
+            artifact.getArtifactId,
+            artifact.getVersion,
+            artifact.getClassifier.to_s.empty? ? nil : artifact.getClassifier,
+            artifact.getExtension,
+            dep.getScope,
+            artifact.getFile.getAbsolutePath
+          )
+
+          collect_resolved(child, result)
+        end
+        result
+      end
+    end
+
+    # Structured result from dependency resolution.
+    #
+    # @!attribute [r] group_id
+    #   @return [String] Maven group ID
+    # @!attribute [r] artifact_id
+    #   @return [String] Maven artifact ID
+    # @!attribute [r] version
+    #   @return [String] resolved version
+    # @!attribute [r] classifier
+    #   @return [String, nil] Maven classifier (e.g. +"sources"+, +"no_aop"+)
+    # @!attribute [r] type
+    #   @return [String] artifact type/extension (e.g. +"jar"+, +"pom"+)
+    # @!attribute [r] scope
+    #   @return [String] Maven scope (+"compile"+, +"runtime"+, +"test"+, +"provided"+, +"system"+)
+    # @!attribute [r] file
+    #   @return [String] absolute path to the resolved artifact in the local repository
+    ResolvedDependency = Struct.new(:group_id, :artifact_id, :version, :classifier, :type, :scope, :file) do
+      # @return [Boolean] true if scope is neither +test+ nor +provided+
+      def runtime?
+        scope != 'test' && scope != 'provided'
+      end
+
+      # @return [Boolean] true if scope is +system+
+      def system?
+        scope == 'system'
+      end
+
+      # Maven repository layout path relative to repo root.
+      #
+      # @return [String] e.g. +"org/slf4j/slf4j-api/1.7.36/slf4j-api-1.7.36.jar"+
+      def path
+        parts = group_id.split('.')
+        parts << artifact_id
+        parts << version
+        filename = +"#{artifact_id}-#{version}"
+        filename << "-#{classifier}" if classifier
+        filename << ".#{type || 'jar'}"
+        parts << filename
+        File.join(parts)
+      end
+
+      # Formats a line suitable for the +Jars.lock+ file.
+      #
+      # @return [String] e.g. +"org.slf4j:slf4j-api:1.7.36:compile:"+
+      def to_lock_entry
+        entry = +"#{group_id}:#{artifact_id}:"
+        entry << "#{classifier}:" if classifier
+        entry << "#{version}:#{scope}:"
+        entry
+      end
+
+      # Colon-separated GAV string suitable for +require_jar+ calls.
+      #
+      # @return [String] e.g. +"org.slf4j:slf4j-api:1.7.36"+
+      def gav
+        parts = [group_id, artifact_id]
+        parts << classifier if classifier
+        parts << version
+        parts.join(':')
+      end
+
+      # Relative jar path for vendoring / +require_jar+.
+      #
+      # @return [String] e.g. +"org/slf4j/slf4j-api/1.7.36/slf4j-api-1.7.36.jar"+
+      def jar_path
+        parts = group_id.split('.')
+        parts << artifact_id
+        parts << version
+        filename = +"#{artifact_id}-#{version}"
+        filename << "-#{classifier}" if classifier
+        filename << '.jar'
+        parts << filename
+        File.join(parts)
+      end
+    end
+  end
+end

data/lib/jars/post_install_hook.rb

@@ -0,0 +1,32 @@
+# 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.
+#
+
+if defined?(JRUBY_VERSION) && Gem.post_install_hooks.empty?
+  Gem.post_install do |gem_installer|
+    if ENV['JARS_SKIP'] != 'true' && ENV_JAVA['jars.skip'] != 'true'
+      require 'jars/installer'
+      jars = Jars::Installer.new(gem_installer.spec)
+      jars.vendor_jars
+    end
+  end
+end

data/lib/jars/setup.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# to do as bundler does and allow to load Jars.lock via
+# require 'jars/setup'. can be useful via commandline -rjars/setup
+# or tell bundler autorequire to load it
+
+require 'jar_dependencies'
+
+Jars.setup

data/lib/jars/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Jars
+  VERSION = '0.6.0.pre3'
+end

data/lib/rubygems_plugin.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'