aspera-cli 4.20.0 → 4.21.0

data/lib/aspera/products/connect.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'aspera/environment'
+
+module Aspera
+  module Products
+    class Connect
+      APP_NAME = 'IBM Aspera Connect'
+      class << self
+        # standard folder locations
+        def locations
+          case Aspera::Environment.os
+          when Aspera::Environment::OS_WINDOWS then [{
+            app_root: File.join(ENV.fetch('LOCALAPPDATA', nil), 'Programs', 'Aspera', 'Aspera Connect'),
+            log_root: File.join(ENV.fetch('LOCALAPPDATA', nil), 'Aspera', 'Aspera Connect', 'var', 'log'),
+            run_root: File.join(ENV.fetch('LOCALAPPDATA', nil), 'Aspera', 'Aspera Connect')
+          }]
+          when Aspera::Environment::OS_MACOS then [{
+            app_root: File.join(Dir.home, 'Applications', 'Aspera Connect.app'),
+            log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera_Connect'),
+            run_root: File.join(Dir.home, 'Library', 'Application Support', 'Aspera', 'Aspera Connect'),
+            sub_bin:  File.join('Contents', 'Resources')
+          }, {
+            app_root: File.join('', 'Applications', 'Aspera Connect.app'),
+            log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera_Connect'),
+            run_root: File.join(Dir.home, 'Library', 'Application Support', 'Aspera', 'Aspera Connect'),
+            sub_bin:  File.join('Contents', 'Resources')
+          }, {
+            app_root: File.join(Dir.home, 'Applications', 'IBM Aspera Connect.app'),
+            log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera_Connect'),
+            run_root: File.join(Dir.home, 'Library', 'Application Support', 'Aspera', 'Aspera Connect'),
+            sub_bin:  File.join('Contents', 'Resources')
+          }, {
+            app_root: File.join('', 'Applications', 'IBM Aspera Connect.app'),
+            log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera_Connect'),
+            run_root: File.join(Dir.home, 'Library', 'Application Support', 'Aspera', 'Aspera Connect'),
+            sub_bin:  File.join('Contents', 'Resources')
+          }]
+          else [{ # other: Linux and Unix family
+            app_root: File.join(Dir.home, '.aspera', 'connect'),
+            run_root: File.join(Dir.home, '.aspera', 'connect')
+          }]
+          end.map { |i| i.merge({ expected: APP_NAME }) }
+        end
+      end
+    end
+  end
+end

data/lib/aspera/products/other.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+# cspell:ignore LOCALAPPDATA
+require 'aspera/environment'
+
+module Aspera
+  # Location of Aspera products, for which an Agent is not proposed
+  module Products
+    # other Aspera products with ascp
+    class Other
+      CLI_V3 = 'Aspera CLI (deprecated)'
+      DRIVE = 'Aspera Drive (deprecated)'
+      HSTS = 'IBM Aspera High-Speed Transfer Server'
+
+      private_constant :CLI_V3, :DRIVE, :HSTS
+      # product information manifest: XML (part of aspera product)
+      INFO_META_FILE = 'product-info.mf'
+
+      # :expected  M app name is taken from the manifest if present, else defaults to this value
+      # :app_root  M main folder for the application
+      # :log_root  O location of log files (Linux uses syslog)
+      # :run_root  O only for Connect Client, location of http port file
+      # :sub_bin   O subfolder with executables, default : bin
+      LOCATION_ON_THIS_OS = case Aspera::Environment.os
+      when Aspera::Environment::OS_WINDOWS then [{
+        expected: CLI_V3,
+        app_root: File.join('C:', 'Program Files', 'Aspera', 'cli'),
+        log_root: File.join('C:', 'Program Files', 'Aspera', 'cli', 'var', 'log')
+      }, {
+        expected: HSTS,
+        app_root: File.join('C:', 'Program Files', 'Aspera', 'Enterprise Server'),
+        log_root: File.join('C:', 'Program Files', 'Aspera', 'Enterprise Server', 'var', 'log')
+      }]
+      when Aspera::Environment::OS_MACOS then [{
+        expected: CLI_V3,
+        app_root: File.join(Dir.home, 'Applications', 'Aspera CLI'),
+        log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera')
+      }, {
+        expected: HSTS,
+        app_root: File.join('', 'Library', 'Aspera'),
+        log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera')
+      }, {
+        expected: DRIVE,
+        app_root: File.join('', 'Applications', 'Aspera Drive.app'),
+        log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera_Drive'),
+        sub_bin:  File.join('Contents', 'Resources')
+      }]
+      else [{ # other: Linux and Unix family
+        expected: CLI_V3,
+        app_root: File.join(Dir.home, '.aspera', 'cli')
+      }, {
+        expected: HSTS,
+        app_root: File.join('', 'opt', 'aspera')
+      }]
+      end
+      class << self
+        def find(scan_locations)
+          scan_locations.select do |item|
+            # skip if not main folder
+            Log.log.trace1{"Checking #{item[:app_root]}"}
+            next false unless Dir.exist?(item[:app_root])
+            Log.log.debug{"Found #{item[:expected]}"}
+            sub_bin = item[:sub_bin] || 'bin'
+            item[:ascp_path] = File.join(item[:app_root], sub_bin, Environment.exe_file('ascp'))
+            # skip if no ascp
+            next false unless File.exist?(item[:ascp_path])
+            # read info from product info file if present
+            product_info_file = "#{item[:app_root]}/#{INFO_META_FILE}"
+            if File.exist?(product_info_file)
+              res_s = XmlSimple.xml_in(File.read(product_info_file), {'ForceArray' => false})
+              item[:name] = res_s['name']
+              item[:version] = res_s['version']
+            else
+              item[:name] = item[:expected]
+            end
+            true # select this version
+          end
+        end
+      end
+    end
+  end
+end

data/lib/aspera/products/trsdk.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Aspera
+  module Products
+    class Trsdk
+      APP_NAME = 'IBM Aspera Transfer Daemon'
+      class << self
+        # standard folder locations
+        def locations
+          [{
+            app_root: sdk_directory,
+            sub_bin:  ''
+          }].map { |i| i.merge({ expected: APP_NAME }) }
+        end
+
+        # location of SDK files
+        def sdk_directory=(v)
+          Log.log.debug{"sdk_directory=#{v}"}
+          @sdk_dir = v
+          sdk_directory
+        end
+
+        # @return the path to folder where SDK is installed
+        def sdk_directory
+          Aspera.assert(!@sdk_dir.nil?){'SDK path was not initialized'}
+          FileUtils.mkdir_p(@sdk_dir)
+          @sdk_dir
+        end
+
+        def transferd_path
+          return File.join(sdk_directory, Environment.exe_file('asperatransferd')) # cspell:disable-line
+        end
+
+        # Well, the port number is only in log file
+        def daemon_port_from_log(log_file)
+          result = nil
+          # if port is zero, a dynamic port was created, get it
+          File.open(log_file, 'r') do |file|
+            file.each_line do |line|
+              # Well, it's tricky to depend on log
+              if (m = line.match(/Info: API Server: Listening on ([^:]+):(\d+) /))
+                result = m[2].to_i
+                # no "break" , need to read last matching log line
+              end
+            end
+          end
+          raise 'Port not found in daemon logs' if result.nil?
+          Log.log.debug{"Got port #{result} from log"}
+          return result
+        end
+      end
+    end
+  end
+end

data/lib/aspera/rest.rb

@@ -10,7 +10,6 @@ require 'net/http'
 require 'net/https'
 require 'json'
 require 'base64'
-require 'cgi'
 require 'singleton'
 require 'securerandom'
 
@@ -22,11 +21,13 @@ class Net::HTTP::Cancel < Net::HTTPRequest # rubocop:disable Style/ClassAndModul
 end
 
 module Aspera
-  # Global settings
+  # Global settings for Rest object
+  # For example to remove certificate verification globally:
+  # `RestParameters.instance.session_cb = lambda{|http|http.verify_mode=OpenSSL::SSL::VERIFY_NONE}`
   # @param user_agent [String] HTTP request header: 'User-Agent'
   # @param download_partial_suffix [String] suffix for partial download
   # @param session_cb [lambda] lambda called on new HTTP session. Takes the Net::HTTP as arg. Used to change parameters on creation.
-  # @param progress_bar [Object] progress bar object
+  # @param progress_bar [Object] progress bar object called for file transfer
   class RestParameters
     include Singleton
 
@@ -200,6 +201,9 @@ module Aspera
       }
     end
 
+    # Create a REST object for API calls
+    # HTTP sessions parameters can be modified using global parameters in RestParameters
+    # For example, TLS verification can be skipped.
     # @param base_url [String] base URL of REST API
     # @param auth [Hash] authentication parameters:
     #     :type (:none, :basic, :url, :oauth2)
@@ -207,14 +211,15 @@ module Aspera
     #     :password   [:basic]
     #     :url_query  [:url]    a hash
     #     :*          [:oauth2] see OAuth::Factory class
-    # @param not_auth_codes [Array] codes that trigger a refresh/regeneration of bearer token
-    # @param redirect_max [int] max redirection allowed
+    # @param not_auth_codes [Array]   codes that trigger a refresh/regeneration of bearer token
+    # @param redirect_max   [Integer] max redirection allowed
+    # @param headers        [Hash]    default headers to include in all calls
     def initialize(
       base_url:,
-      auth: nil,
-      not_auth_codes: nil,
+      auth: {type: :none},
+      not_auth_codes: ['401'],
       redirect_max: 0,
-      headers: nil
+      headers: {}
     )
       Aspera.assert_type(base_url, String)
       # base url with no trailing slashes (note: string may be frozen)
@@ -224,20 +229,20 @@ module Aspera
       @base_url = @base_url.gsub(/:80$/, '') if @base_url.start_with?('http://')
       Log.log.debug{"Rest.new(#{@base_url})"}
       # default is no auth
-      @auth_params = auth.nil? ? {type: :none} : auth
+      @auth_params = auth
       Aspera.assert_type(@auth_params, Hash)
       Aspera.assert(@auth_params.key?(:type)){'no auth type defined'}
-      @not_auth_codes = not_auth_codes.nil? ? ['401'] : not_auth_codes
+      @not_auth_codes = not_auth_codes
       Aspera.assert_type(@not_auth_codes, Array)
       # persistent session
       @http_session = nil
-      # OAuth object (created on demand)
-      @oauth = nil
       @redirect_max = redirect_max
       Aspera.assert_type(@redirect_max, Integer)
-      @headers = headers.nil? ? {} : headers
+      @headers = headers
       Aspera.assert_type(@headers, Hash)
       @headers['User-Agent'] ||= RestParameters.instance.user_agent
+      # OAuth object (created on demand)
+      @oauth = nil
     end
 
     # @return the OAuth object (create, or cached if already created)

data/lib/aspera/ssh.rb

@@ -1,33 +1,38 @@
 # frozen_string_literal: true
 
 require 'net/ssh'
-
-if ENV.fetch('ASCLI_ENABLE_ED25519', 'false').eql?('false')
-  # HACK: deactivate ed25519 and ecdsa private keys from SSH identities, as it usually causes problems
-  old_verbose = $VERBOSE
-  $VERBOSE = nil
-  begin
-    module Net; module SSH; module Authentication; class Session; private; def default_keys; %w[~/.ssh/id_dsa ~/.ssh/id_rsa ~/.ssh2/id_dsa ~/.ssh2/id_rsa]; end; end; end; end; end # rubocop:disable Layout/AccessModifierIndentation, Layout/EmptyLinesAroundAccessModifier, Layout/LineLength, Style/Semicolon
-  rescue StandardError
-    # ignore errors
-  end
-  $VERBOSE = old_verbose
-end
-
-if defined?(JRUBY_VERSION) && ENV.fetch('ASCLI_ENABLE_ECDSHA2', 'false').eql?('false')
-  Net::SSH::Transport::Algorithms::ALGORITHMS.each_value { |a| a.reject! { |a| a =~ /^ecd(sa|h)-sha2/ } }
-  Net::SSH::KnownHosts::SUPPORTED_TYPE.reject! { |t| t =~ /^ecd(sa|h)-sha2/ }
-end
+require 'aspera/assert'
 
 module Aspera
   # A simple wrapper around Net::SSH
   # executes one command and get its result from stdout
   class Ssh
+    class << self
+      def disable_ed25519_keys
+        old_verbose = $VERBOSE
+        $VERBOSE = nil
+        Net::SSH::Authentication::Session.class_eval do
+          define_method(:default_keys) do
+            %w[~/.ssh/id_dsa ~/.ssh/id_rsa ~/.ssh2/id_dsa ~/.ssh2/id_rsa].freeze
+          end
+          private(:default_keys)
+        end rescue nil
+        $VERBOSE = old_verbose
+      end
+
+      def disable_ecd_sha2_algorithms
+        Net::SSH::Transport::Algorithms::ALGORITHMS.each_value { |a| a.reject! { |a| a =~ /^ecd(sa|h)-sha2/ } }
+        Net::SSH::KnownHosts::SUPPORTED_TYPE.reject! { |t| t =~ /^ecd(sa|h)-sha2/ }
+      end
+    end
     # ssh_options: same as Net::SSH.start
     # see: https://net-ssh.github.io/net-ssh/classes/Net/SSH.html#method-c-start
     def initialize(host, username, ssh_options)
       Log.log.debug{"ssh:#{username}@#{host}"}
       Log.log.debug{"ssh_options:#{ssh_options}"}
+      Aspera.assert_type(host, String)
+      Aspera.assert_type(username, String)
+      Aspera.assert_type(ssh_options, Hash)
       @host = host
       @username = username
       @ssh_options = ssh_options
@@ -35,10 +40,7 @@ module Aspera
     end
 
     def execute(cmd, input=nil)
-      if cmd.is_a?(Array)
-        # concatenate arguments, enclose in double quotes
-        cmd = cmd.map{|v|%Q("#{v}")}.join(' ')
-      end
+      Aspera.assert_type(cmd, String)
       Log.log.debug{"cmd=#{cmd}"}
       response = []
       Net::SSH.start(@host, @username, @ssh_options) do |session|
@@ -49,9 +51,7 @@ module Aspera
           channel.on_extended_data do |_chan, _type, data|
             error_message = "#{cmd}: [#{data.chomp}]"
             # Happens when windows user hasn't logged in and created home account.
-            if data.include?('Could not chdir to home directory')
-              error_message += "\nHint: home not created in Windows?"
-            end
+            error_message += "\nHint: home not created in Windows?" if data.include?('Could not chdir to home directory')
             raise error_message
           end
           # send command to SSH channel (execute) cspell: disable-next-line
@@ -67,3 +67,7 @@ module Aspera
     end
   end
 end
+
+# HACK: deactivate ed25519 and ecdsa private keys from SSH identities, as it usually causes problems
+Aspera::Ssh.disable_ed25519_keys if ENV.fetch('ASCLI_ENABLE_ED25519', 'false').eql?('false')
+Aspera::Ssh.disable_ecd_sha2_algorithms if defined?(JRUBY_VERSION) && ENV.fetch('ASCLI_ENABLE_ECDSHA2', 'false').eql?('false')

data/lib/aspera/transfer/spec.yaml

@@ -1,13 +1,13 @@
-# desc           : description
-# accepted_types : accepted types for non-enum
-# default        : default value if not specified
-# enum           : set with list of values for enum types accepted in transfer spec
-# agents         : supported agents (for doc only), if not specified: all
-# required       : optional, default: false
-# cli.type       : ascp: type of parameter, one of CLI_OPTION_TYPES
-# cli.switch     : ascp: switch for ascp command line
-# cli.convert    : ascp: transform value: either a Hash with conversion values, or name of class
-# cli.variable   : ascp: name of env var
+# desc           [String] description
+# accepted_types [Symbol, Array(Symbol)] accepted types for non-enum
+# default        [String] default value if not specified
+# enum           [Array]  set with list of values for enum types accepted in transfer spec
+# agents         [Array]  supported agents (for doc only), if not specified: all
+# required       [bool]   optional, default: false
+# cli.type       [Symbol] ascp: type of parameter, one of CLI_OPTION_TYPES (opt_without_arg opt_with_arg special ignore envvar)
+# cli.switch     [String] ascp: switch for ascp command line
+# cli.convert    [String] ascp: transform value: either a Hash with conversion values, or name of class
+# cli.variable   [String] ascp: name of env var
 # cspell:words dgram dnat dnats faspmgr asperanoded xattrs keepalive datagram
 ---
 cipher:
@@ -102,17 +102,13 @@ direction:
       receive: recv
       send: send
 exclude_newer_than:
-  :desc: skip src files with mtime > arg
-  :accepted_types: :int
-  :agents:
-  - :direct
+  :desc: Exclude files, but not directories, from the transfer if they are newer than the specified number of seconds added to the source computer's epoch. e.g. "-86400" for newer than a day back.
+  :accepted_types: :string
   :cli:
     :type: :opt_with_arg
 exclude_older_than:
-  :desc: skip src files with mtime < arg
-  :accepted_types: :int
-  :agents:
-  - :direct
+  :desc: Exclude files, but not directories, from the transfer if they are older than the specified number of seconds added to the source computer's epoch. e.g. "-86400" for older than a day back.
+  :accepted_types: :string
   :cli:
     :type: :opt_with_arg
 fasp_port:
@@ -213,7 +209,6 @@ password:
     Windows only, node api only.
 
 
-  :required: false
   :accepted_types: :string
   :agents:
   - :node
@@ -419,7 +414,7 @@ symlink_policy:
     :type: :opt_with_arg
     :switch: "--symbolic-links"
 tags:
-  :desc: Metadata for transfer as JSON
+  :desc: Metadata for transfer as JSON. Key `aspera` is reserved. Key `aspera.xfer_retry` specified a retry timeout for node api initiated transfers.
   :accepted_types: :hash
   :cli:
     :type: :opt_with_arg
@@ -714,3 +709,10 @@ write_threads:
   - :unknown
   :cli:
     :type: :ignore
+xfer_max_retries:
+  :desc: maximum number of retries, for node API initiated transfers. Shall not exceed aspera.conf `transfer_manager_max_retries` (default 5).
+  :accepted_types: :int
+  :agents:
+  - :node
+  :cli:
+    :type: :ignore

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aspera-cli
 version: !ruby/object:Gem::Version
-  version: 4.20.0
+  version: 4.21.0
 platform: ruby
 authors:
 - Laurent Martin
@@ -37,7 +37,7 @@ cert_chain:
   eTf9kxhVM40wGQOECVNA8UsEEZHD48eF+csUYZtAJOF5oxTI8UyV9T/o6CgO0c9/
   Gzz+Qm5ULOUcPiJLjSpaiTrkiIVYiDGnqNSr6R1Hb1c=
   -----END CERTIFICATE-----
-date: 2025-01-21 00:00:00.000000000 Z
+date: 2025-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: blankslate
@@ -123,6 +123,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: openssl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.0
 - !ruby/object:Gem::Dependency
   name: rainbow
   requirement: !ruby/object:Gem::Requirement
@@ -426,7 +440,6 @@ files:
 - lib/aspera/ascmd.rb
 - lib/aspera/ascp/installation.rb
 - lib/aspera/ascp/management.rb
-- lib/aspera/ascp/products.rb
 - lib/aspera/assert.rb
 - lib/aspera/cli/basic_auth_plugin.rb
 - lib/aspera/cli/error.rb
@@ -496,6 +509,10 @@ files:
 - lib/aspera/preview/terminal.rb
 - lib/aspera/preview/utils.rb
 - lib/aspera/preview/video_error.png
+- lib/aspera/products/alpha.rb
+- lib/aspera/products/connect.rb
+- lib/aspera/products/other.rb
+- lib/aspera/products/trsdk.rb
 - lib/aspera/proxy_auto_config.js
 - lib/aspera/proxy_auto_config.rb
 - lib/aspera/rest.rb
@@ -538,7 +555,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.6'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/lib/aspera/ascp/products.rb

@@ -1,168 +0,0 @@
-# frozen_string_literal: true
-
-# cspell:ignore LOCALAPPDATA
-require 'aspera/environment'
-
-module Aspera
-  module Ascp
-    # find Aspera standard products installation in standard paths
-    class Products
-      # known product names
-      CONNECT = 'IBM Aspera Connect'
-      ASPERA = 'IBM Aspera (Client)'
-      CLI_V1 = 'Aspera CLI (deprecated)'
-      DRIVE = 'Aspera Drive (deprecated)'
-      HSTS = 'IBM Aspera High-Speed Transfer Server'
-      # product information manifest: XML (part of aspera product)
-      INFO_META_FILE = 'product-info.mf'
-      BIN_SUBFOLDER = 'bin'
-      ETC_SUBFOLDER = 'etc'
-      VAR_RUN_SUBFOLDER = File.join('var', 'run')
-
-      @@found_products = nil # rubocop:disable Style/ClassVars
-      class << self
-        # @return product folders depending on OS fields
-        # :expected  M app name is taken from the manifest if present, else defaults to this value
-        # :app_root  M main folder for the application
-        # :log_root  O location of log files (Linux uses syslog)
-        # :run_root  O only for Connect Client, location of http port file
-        # :sub_bin   O subfolder with executables, default : bin
-        def product_locations_on_current_os
-          result =
-            case Aspera::Environment.os
-            when Aspera::Environment::OS_WINDOWS then [{
-              expected: CONNECT,
-              app_root: File.join(ENV.fetch('LOCALAPPDATA', nil), 'Programs', 'Aspera', 'Aspera Connect'),
-              log_root: File.join(ENV.fetch('LOCALAPPDATA', nil), 'Aspera', 'Aspera Connect', 'var', 'log'),
-              run_root: File.join(ENV.fetch('LOCALAPPDATA', nil), 'Aspera', 'Aspera Connect')
-            }, {
-              expected: CLI_V1,
-              app_root: File.join('C:', 'Program Files', 'Aspera', 'cli'),
-              log_root: File.join('C:', 'Program Files', 'Aspera', 'cli', 'var', 'log')
-            }, {
-              expected: HSTS,
-              app_root: File.join('C:', 'Program Files', 'Aspera', 'Enterprise Server'),
-              log_root: File.join('C:', 'Program Files', 'Aspera', 'Enterprise Server', 'var', 'log')
-            }]
-            when Aspera::Environment::OS_MACOS then [{
-              expected: CONNECT,
-              app_root: File.join(Dir.home, 'Applications', 'Aspera Connect.app'),
-              log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera_Connect'),
-              run_root: File.join(Dir.home, 'Library', 'Application Support', 'Aspera', 'Aspera Connect'),
-              sub_bin:  File.join('Contents', 'Resources')
-            }, {
-              expected: CONNECT,
-              app_root: File.join('', 'Applications', 'Aspera Connect.app'),
-              log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera_Connect'),
-              run_root: File.join(Dir.home, 'Library', 'Application Support', 'Aspera', 'Aspera Connect'),
-              sub_bin:  File.join('Contents', 'Resources')
-            }, {
-              expected: CONNECT,
-              app_root: File.join(Dir.home, 'Applications', 'IBM Aspera Connect.app'),
-              log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera_Connect'),
-              run_root: File.join(Dir.home, 'Library', 'Application Support', 'Aspera', 'Aspera Connect'),
-              sub_bin:  File.join('Contents', 'Resources')
-            }, {
-              expected: CONNECT,
-              app_root: File.join('', 'Applications', 'IBM Aspera Connect.app'),
-              log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera_Connect'),
-              run_root: File.join(Dir.home, 'Library', 'Application Support', 'Aspera', 'Aspera Connect'),
-              sub_bin:  File.join('Contents', 'Resources')
-            }, {
-              expected: CLI_V1,
-              app_root: File.join(Dir.home, 'Applications', 'Aspera CLI'),
-              log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera')
-            }, {
-              expected: HSTS,
-              app_root: File.join('', 'Library', 'Aspera'),
-              log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera')
-            }, {
-              expected: DRIVE,
-              app_root: File.join('', 'Applications', 'Aspera Drive.app'),
-              log_root: File.join(Dir.home, 'Library', 'Logs', 'Aspera_Drive'),
-              sub_bin:  File.join('Contents', 'Resources')
-            }, {
-              expected: ASPERA,
-              app_root: File.join('', 'Applications', 'IBM Aspera.app'),
-              log_root: File.join(Dir.home, 'Library', 'Logs', 'IBM Aspera'),
-              sub_bin:  File.join('Contents', 'Resources', 'sdk', 'aspera', 'bin')
-            }]
-            else [{ # other: Linux and Unix family
-              expected: CONNECT,
-              app_root: File.join(Dir.home, '.aspera', 'connect'),
-              run_root: File.join(Dir.home, '.aspera', 'connect')
-            }, {
-              expected: CLI_V1,
-              app_root: File.join(Dir.home, '.aspera', 'cli')
-            }, {
-              expected: HSTS,
-              app_root: File.join('', 'opt', 'aspera')
-            }]
-            end
-          result # .each {|item| item.deep_do {|h, _k, _v, _m|h.freeze}}.freeze
-        end
-
-        # @return the list of installed products in format of product_locations_on_current_os
-        def installed_products
-          if @@found_products.nil?
-            scan_locations = product_locations_on_current_os.clone
-            # add SDK as first search path
-            scan_locations.unshift({
-              expected: 'SDK',
-              app_root: Installation.instance.sdk_folder,
-              sub_bin:  ''
-            })
-            # search installed products: with ascp
-            @@found_products = scan_locations.select! do |item| # rubocop:disable Style/ClassVars
-              # skip if not main folder
-              next false unless Dir.exist?(item[:app_root])
-              Log.log.debug{"Found #{item[:app_root]}"}
-              sub_bin = item[:sub_bin] || BIN_SUBFOLDER
-              item[:ascp_path] = File.join(item[:app_root], sub_bin, ascp_filename)
-              # skip if no ascp
-              next false unless File.exist?(item[:ascp_path])
-              # read info from product info file if present
-              product_info_file = "#{item[:app_root]}/#{INFO_META_FILE}"
-              if File.exist?(product_info_file)
-                res_s = XmlSimple.xml_in(File.read(product_info_file), {'ForceArray' => false})
-                item[:name] = res_s['name']
-                item[:version] = res_s['version']
-              else
-                item[:name] = item[:expected]
-              end
-              true # select this version
-            end
-          end
-          return @@found_products
-        end
-
-        # filename for ascp with optional extension (Windows)
-        def ascp_filename
-          return "ascp#{Environment.exe_extension}"
-        end
-
-        # @return folder paths for specified applications
-        # @param name Connect or CLI
-        def folders(name)
-          found = Products.installed_products.select{|i|i[:expected].eql?(name) || i[:name].eql?(name)}
-          raise "Product: #{name} not found, please install." if found.empty?
-          return found.first
-        end
-
-        # @return the file path of local connect where API's URI can be read
-        def connect_uri
-          connect = folders(CONNECT)
-          folder = File.join(connect[:run_root], VAR_RUN_SUBFOLDER)
-          ['', 's'].each do |ext|
-            uri_file = File.join(folder, "http#{ext}.uri")
-            Log.log.debug{"checking connect port file: #{uri_file}"}
-            if File.exist?(uri_file)
-              return File.open(uri_file, &:gets).strip
-            end
-          end
-          raise "no connect uri file found in #{folder}"
-        end
-      end
-    end
-  end
-end