aspera-cli 4.17.0 → 4.18.0

data/lib/aspera/cli/plugins/faspio.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require 'aspera/rest'
+require 'aspera/nagios'
+require 'aspera/cli/basic_auth_plugin'
+
+module Aspera
+  module Cli
+    module Plugins
+      class Faspio < BasicAuthPlugin
+        class << self
+          def application_name
+            'faspio Gateway'
+          end
+
+          def detect(base_url)
+            api = Rest.new(base_url: base_url)
+            ping_result = api.read('ping')
+            server_type = ping_result[:http]['Server']
+            return nil unless ping_result[:data].is_a?(Hash) && ping_result[:data].empty?
+            return nil unless server_type.is_a?(String) && server_type.include?('faspio')
+            return {
+              version: server_type.gsub(%r{^.*/}, ''),
+              url:     base_url
+            }
+          end
+        end
+        ACTIONS = %i[health bridges].freeze
+
+        def initialize(**env)
+          super
+          options.declare(:auth, 'OAuth type of authentication', values: %i[jwt basic])
+          options.declare(:client_id, 'OAuth client identifier')
+          options.declare(:private_key, 'OAuth JWT RSA private key PEM value (prefix file path with @file:)')
+          options.declare(:passphrase, 'OAuth JWT RSA private key passphrase')
+          options.parse_options!
+        end
+
+        def execute_action
+          base_url = options.get_option(:url, mandatory: true)
+          api =
+            case options.get_option(:auth, mandatory: true)
+            when :basic
+              basic_auth_api
+            when :jwt
+              app_client_id = options.get_option(:client_id, mandatory: true)
+              Rest.new(
+                base_url: base_url,
+                auth:     {
+                  type:            :oauth2,
+                  grant_method:    :jwt,
+                  base_url:        "#{base_url}/auth",
+                  client_id:       app_client_id,
+                  use_query:       true,
+                  payload:         {
+                    iss: app_client_id, # issuer
+                    sub: app_client_id  # subject
+                  },
+                  private_key_obj: OpenSSL::PKey::RSA.new(options.get_option(:private_key, mandatory: true), options.get_option(:passphrase)),
+                  headers:         {typ: 'JWT'}
+                })
+            end
+          command = options.get_next_command(ACTIONS)
+          case command
+          when :health
+            nagios = Nagios.new
+            begin
+              result = api.read('ping')[:data]
+              if result.is_a?(Hash) && result.empty?
+                nagios.add_ok('api', 'answered ok')
+              else
+                nagios.add_critical('api', 'not expected answer')
+              end
+            rescue StandardError => e
+              nagios.add_critical('api', e.to_s)
+            end
+            return nagios.result
+          when :bridges
+            return entity_action(api, 'bridges')
+          end
+        end
+      end
+    end
+  end
+end

data/lib/aspera/cli/plugins/httpgw.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'aspera/rest'
+require 'aspera/api/httpgw'
+require 'aspera/nagios'
+
+module Aspera
+  module Cli
+    module Plugins
+      class Httpgw < Plugin
+        class << self
+          def application_name
+            'HTTP Gateway'
+          end
+
+          def detect(base_url)
+            api = Api::Httpgw.new(url: base_url)
+            api_info = api.info
+            return {
+              url:     base_url,
+              version: api_info['version']
+            } if api_info.is_a?(Hash) && api_info.key?('download_endpoint')
+            return nil
+          end
+        end
+        ACTIONS = %i[health info].freeze
+
+        def initialize(**env)
+          super
+          options.declare(:url, 'URL of application, e.g. https://app.example.com/aspera/app')
+          options.parse_options!
+        end
+
+        def execute_action
+          base_url = options.get_option(:url, mandatory: true)
+          command = options.get_next_command(ACTIONS)
+          case command
+          when :health
+            nagios = Nagios.new
+            begin
+              Api::Httpgw.new(url: base_url)
+              nagios.add_ok('api', 'answered ok')
+            rescue StandardError => e
+              nagios.add_critical('api', e.to_s)
+            end
+            return nagios.result
+          when :info
+            api_v1 = Api::Httpgw.new(url: base_url)
+            return {type: :single_object, data: api_v1.info}
+          end
+        end
+      end
+    end
+  end
+end

data/lib/aspera/cli/plugins/node.rb

@@ -44,7 +44,8 @@ module Aspera
               next unless result[:http].body.eql?('')
               url_length = -2 - test_endpoint.length
               return {
-                url: result[:http].uri.to_s[0..url_length]
+                url:     result[:http].uri.to_s[0..url_length],
+                version: 'requires authentication'
               }
             rescue StandardError => e
               error = e
@@ -92,7 +93,7 @@ module Aspera
         SEARCH_REMOVE_FIELDS = %w[basename permissions].freeze
 
         # actions in execute_command_gen3
-        COMMANDS_GEN3 = %i[search space mkdir mklink mkfile rename delete browse upload download http_node_download sync]
+        COMMANDS_GEN3 = %i[search space mkdir mklink mkfile rename delete browse upload download http_node_download sync transport]
 
         BASE_ACTIONS = %i[api_details].concat(COMMANDS_GEN3).freeze
 
@@ -187,6 +188,68 @@ module Aspera
           raise StandardError, 'expect: nil, String or Array'
         end
 
+        # directory: node, container: shares
+        FOLDER_TYPE = %w[directory container].freeze
+
+        def browse_gen3(prefix_path)
+          folders_to_process = [get_next_arg_add_prefix(prefix_path, 'path')]
+          query = options.get_option(:query, default: {})
+          # special parameter: max number of entries in result
+          max_items = query.delete('max')
+          # special parameter: recursive browsing
+          recursive = query.delete('recursive')
+          # special parameter: only return one entry for the path, even if folder
+          only_path = query.delete('self')
+          # allow user to specify a single call, and not recursive
+          single_call = query.key?('skip')
+          # API default is 100, so use 1000 for default
+          query['count'] ||= 1000
+          raise Cli::BadArgument, 'options recursive and skip cannot be used together' if recursive && single_call
+          all_items = []
+          until folders_to_process.empty?
+            path = folders_to_process.shift
+            query['path'] = path
+            offset = 0
+            total_count = nil
+            result = nil
+            loop do
+              # example: send_result={'items'=>[{'file'=>"filename1","permissions"=>[{'name'=>'read'},{'name'=>'write'}]}]}
+              response = @api_node.call(
+                operation:   'POST',
+                subpath:     'files/browse',
+                headers:     {'Accept' => 'application/json'},
+                body:        query,
+                body_type:   :json)
+              # 'file','symbolic_link'
+              if only_path || !FOLDER_TYPE.include?(response[:data]['self']['type'])
+                result = { type: :single_object, data: response[:data]['self']}
+                break
+              end
+              items = response[:data]['items']
+              total_count ||= response[:data]['total_count']
+              all_items.concat(items)
+              if single_call
+                formatter.display_item_count(response[:data]['item_count'], total_count)
+                break
+              end
+              if recursive
+                folders_to_process.concat(items.select{|i|FOLDER_TYPE.include?(i['type'])}.map{|i|i['path']})
+              end
+              if !max_items.nil? && (all_items.count >= max_items)
+                all_items = all_items.slice(0, max_items) if all_items.count > max_items
+                break
+              end
+              break if all_items.count >= total_count
+              offset += items.count
+              query['skip'] = offset
+              formatter.long_operation_running(all_items.count)
+            end
+            query.delete('skip')
+          end
+          result ||= {type: :object_list, data: all_items}
+          return c_result_remove_prefix_path(result, 'path', prefix_path)
+        end
+
         # file and folder related commands
         def execute_command_gen3(command, prefix_path)
           case command
@@ -235,20 +298,7 @@ module Aspera
             resp = @api_node.create('files/rename', { 'paths' => [{ 'path' => path_base, 'source' => path_src, 'destination' => path_dst }] })
             return c_result_translate_rem_prefix(resp, 'entry', 'moved', prefix_path)
           when :browse
-            query = { path: get_next_arg_add_prefix(prefix_path, 'path')}
-            additional_query = options.get_option(:query)
-            query.merge!(additional_query) unless additional_query.nil?
-            send_result = @api_node.create('files/browse', query)[:data]
-            # example: send_result={'items'=>[{'file'=>"filename1","permissions"=>[{'name'=>'read'},{'name'=>'write'}]}]}
-            # if there is no items
-            case send_result['self']['type']
-            when 'directory', 'container' # directory: node, container: shares
-              result = { data: send_result['items'], type: :object_list }
-              formatter.display_item_count(send_result['item_count'], send_result['total_count'])
-            else # 'file','symbolic_link'
-              result = { data: send_result['self'], type: :single_object}
-            end
-            return c_result_remove_prefix_path(result, 'path', prefix_path)
+            return browse_gen3(prefix_path)
           when :sync
             return execute_sync_action do |sync_direction, local_path, remote_path|
               # Gen3 API
@@ -303,6 +353,8 @@ module Aspera
               subpath: "files/#{URI.encode_www_form_component(remote_path)}/contents",
               save_to_file: File.join(transfer.destination_folder(Transfer::Spec::DIRECTION_RECEIVE), file_name))
             return Main.result_status("downloaded: #{file_name}")
+          when :transport
+            return {type: :single_object, data: @api_node.transport_params}
           end
           Aspera.error_unreachable_line
         end
@@ -358,9 +410,10 @@ module Aspera
             begin
               @api_node.call(
                 operation: 'POST',
-                subpath: 'services/soap/Transfer-201210',
-                headers: {'Content-Type' => 'text/xml;charset=UTF-8', 'SOAPAction' => 'FASPSessionNET-200911#GetSessionInfo'},
-                text_body_params: CENTRAL_SOAP_API_TEST)[:http].body
+                subpath:   'services/soap/Transfer-201210',
+                headers:   {'Content-Type' => 'text/xml;charset=UTF-8', 'SOAPAction' => 'FASPSessionNET-200911#GetSessionInfo'},
+                body:      CENTRAL_SOAP_API_TEST,
+                body_type: :text)[:http].body
               nagios.add_ok('central', 'accessible by node')
             rescue StandardError => e
               nagios.add_critical('central', e.to_s)
@@ -420,7 +473,7 @@ module Aspera
               result[:password] = apifid[:api].auth_params[:password]
             when :oauth2
               result[:username] = apifid[:api].params[:headers][Api::Node::HEADER_X_ASPERA_ACCESS_KEY]
-              result[:password] = apifid[:api].oauth_token
+              result[:password] = apifid[:api].oauth.token
             else Aspera.error_unreachable_line
             end
             return {type: :single_object, data: result} if command_repo.eql?(:node_info)
@@ -431,7 +484,7 @@ module Aspera
             apifid = @api_node.resolve_api_fid(top_file_id, options.get_next_argument('path'))
             file_info = apifid[:api].read("files/#{apifid[:file_id]}")[:data]
             if file_info['type'].eql?('folder')
-              result = apifid[:api].read("files/#{apifid[:file_id]}/files", old_query_read_delete)
+              result = apifid[:api].read("files/#{apifid[:file_id]}/files", query_read_delete)
               items = result[:data]
               formatter.display_item_count(result[:data].length, result[:http]['X-Total-Count'])
             else
@@ -538,7 +591,7 @@ module Aspera
               subpath: "files/#{apifid[:file_id]}/preview",
               headers: {'Accept' => 'image/png'}
             )
-            return Main.result_picture_in_terminal(options, result[:http].body)
+            return Main.result_image(result[:http].body, formatter: formatter)
           when :permission
             apifid = apifid_from_next_arg(top_file_id)
             command_perm = options.get_next_command(%i[list create delete])
@@ -574,9 +627,9 @@ module Aspera
             else Aspera.error_unreachable_line
             end
           else Aspera.error_unreachable_line
-          end # command_repo
+          end
           Aspera.error_unreachable_line
-        end # execute_command_gen4
+        end
 
         # This is older API
         def execute_async
@@ -695,11 +748,15 @@ module Aspera
             when *Plugin::ALL_OPS then return entity_command(sync_command, @api_node, 'asyncs', item_list_key: 'ids'){|field, value|ssync_lookup(field, value)}
             else
               asyncs_id = instance_identifier {|field, value|ssync_lookup(field, value)}
-              parameters = nil
               if %i[start stop].include?(sync_command)
-                @api_node.create("asyncs/#{asyncs_id}/#{sync_command}", parameters)
+                @api_node.call(
+                  operation: 'POST',
+                  subpath:   "asyncs/#{asyncs_id}/#{sync_command}",
+                  body:      '',
+                  body_type: :text)[:http].body
                 return Main.result_status('Done')
               end
+              parameters = nil
               parameters = query_option(default: {}) if %i[bandwidth counters files].include?(sync_command)
               return { type: :single_object, data: @api_node.read("asyncs/#{asyncs_id}/#{sync_command}", parameters)[:data] }
             end
@@ -707,7 +764,7 @@ module Aspera
             command = options.get_next_command(%i[list create show modify cancel])
             case command
             when :list
-              resp = @api_node.read('ops/transfers', old_query_read_delete)
+              resp = @api_node.read('ops/transfers', query_read_delete)
               return { type: :object_list, data: resp[:data], fields: %w[id status] } # TODO: useful?
             when :create
               resp = @api_node.create('streams', value_create_modify(command: command))
@@ -841,7 +898,7 @@ module Aspera
               resp = @api_node.create(res_class_path, value_create_modify(command: command))
               return Main.result_status("#{resp[:data]['id']} created")
             when :list
-              resp = @api_node.read(res_class_path, old_query_read_delete)
+              resp = @api_node.read(res_class_path, query_read_delete)
               return { type: :value_list, data: resp[:data]['ids'], name: 'id' }
             when :show
               return { type: :single_object, data: @api_node.read(one_res_path)[:data]}
@@ -914,7 +971,7 @@ module Aspera
             server.mount(uri.path, NodeSimulatorServlet, parameters[:credentials], transfer)
             server.start
             return Main.result_status('Simulator terminated')
-          end # case command
+          end
           raise 'ERROR: shall not reach this line'
         end
       end

data/lib/aspera/cli/plugins/orchestrator.rb

@@ -60,33 +60,37 @@ module Aspera
 
         ACTIONS = %i[health info workflow plugins processes].freeze
 
-        def call_ao(endpoint, opt={})
-          opt[:prefix] = 'api' unless opt.key?(:prefix)
+        # call orchestrator api
+        # @param endpoint [String] the endpoint to call
+        # @param prefix [String] the prefix to add to the endpoint
+        # @param id [String] the id to add to the endpoint
+        # @param ret_style [Symbol] the return style, :header, :arg, :ext(extension)
+        # @param format [String] the format to request, 'json', 'xml', nil
+        # @param args [Hash] the arguments to pass
+        # @param xml_arrays [Boolean] if true, force arrays in xml parsing
+        def call_ao(endpoint, prefix: 'api', id: nil, ret_style: nil, format: 'json', args: nil, xml_arrays: true)
           # calls are GET
           call_args = {operation: 'GET', subpath: endpoint}
           # specify prefix if necessary
-          call_args[:subpath] = "#{opt[:prefix]}/#{call_args[:subpath]}" unless opt[:prefix].nil?
+          call_args[:subpath] = "#{prefix}/#{call_args[:subpath]}" unless prefix.nil?
           # specify id if necessary
-          call_args[:subpath] = "#{call_args[:subpath]}/#{opt[:id]}" if opt.key?(:id)
-          call_type = options.get_option(:ret_style, mandatory: true)
-          call_type = opt[:ret_style] if opt.key?(:ret_style)
-          format = 'json'
-          format = opt[:format] if opt.key?(:format)
-          call_args[:url_params] = opt[:args] unless opt[:args].nil?
+          call_args[:subpath] = "#{call_args[:subpath]}/#{id}" unless id.nil?
+          ret_style = options.get_option(:ret_style, mandatory: true) if ret_style.nil?
+          call_args[:query] = args unless args.nil?
           unless format.nil?
-            case call_type
+            case ret_style
             when :header
               call_args[:headers] = {'Accept' => "application/#{format}" }
             when :arg
-              call_args[:url_params] ||= {}
-              call_args[:url_params][:format] = format
+              call_args[:query] ||= {}
+              call_args[:query][:format] = format
             when :ext
               call_args[:subpath] = "#{call_args[:subpath]}.#{format}"
-            else Aspera.error_unexpected_value(call_type)
+            else Aspera.error_unexpected_value(ret_style)
             end
           end
           result = @api_orch.call(**call_args)
-          result[:data] = XmlSimple.xml_in(result[:http].body, opt[:xml_opt] || {'ForceArray' => true}) if format.eql?('xml')
+          result[:data] = XmlSimple.xml_in(result[:http].body, {'ForceArray' => xml_arrays}) if format.eql?('xml')
           Log.log.debug{Log.dump(:data, result[:data])}
           return result
         end
@@ -121,7 +125,7 @@ module Aspera
           when :health
             nagios = Nagios.new
             begin
-              info = call_ao('remote_node_ping', format: 'xml', xml_opt: {'ForceArray' => false})[:data]
+              info = call_ao('remote_node_ping', format: 'xml', xml_arrays: false)[:data]
               nagios.add_ok('api', 'accessible')
               nagios.check_product_version('api', 'orchestrator', info['orchestrator-version'])
             rescue StandardError => e
@@ -129,7 +133,7 @@ module Aspera
             end
             return nagios.result
           when :info
-            result = call_ao('remote_node_ping', format: 'xml', xml_opt: {'ForceArray' => false})[:data]
+            result = call_ao('remote_node_ping', format: 'xml', xml_arrays: false)[:data]
             return {type: :single_object, data: result}
           when :processes
             # TODO: Bug ? API has only XML format
@@ -146,9 +150,8 @@ module Aspera
             end
             case command
             when :status
-              call_opts = {}
-              call_opts[:id] = wf_id unless wf_id.eql?(ExtendedValue::ALL)
-              result = call_ao('workflows_status', call_opts)[:data]
+              wf_id = nil if wf_id.eql?(ExtendedValue::ALL)
+              result = call_ao('workflows_status', id: wf_id)[:data]
               return {type: :object_list, data: result['workflows']['workflow']}
             when :list
               result = call_ao('workflows_list', id: 0)[:data]
@@ -172,7 +175,6 @@ module Aspera
                 data: nil
               }
               call_params = {format: :json}
-              override_accept = nil
               # get external parameters if any
               options.get_next_argument('external_parameters', mandatory: false, type: Hash, default: {}).each do |name, value|
                 call_params["external_parameters[#{name}]"] = value
@@ -192,15 +194,15 @@ module Aspera
               end
               if call_params['synchronous']
                 result[:type] = :text
-                override_accept = 'text/plain'
               end
-              result[:data] = call_ao('initiate', id: wf_id, args: call_params, accept: override_accept)[:data]
+              result[:data] = call_ao('initiate', id: wf_id, args: call_params)[:data]
               return result
-            end # wf command
+            end
           else Aspera.error_unexpected_value(command)
-          end # case command
-        end # execute_action
-      end # Orchestrator
-    end # Plugins
-  end # Cli
-end # Aspera
+          end
+        end
+        private :call_ao
+      end
+    end
+  end
+end

data/lib/aspera/cli/plugins/preview.rb

@@ -128,7 +128,11 @@ module Aspera
         def get_folder_entries(file_id, request_args=nil)
           headers = {'Accept' => 'application/json'}
           headers['X-Aspera-Cache-Control'] = 'no-cache' if @option_folder_reset_cache.eql?(:header)
-          return @api_node.call(operation: 'GET', subpath: "files/#{file_id}/files", headers: headers, url_params: request_args)[:data]
+          return @api_node.call(
+            operation: 'GET',
+            subpath:   "files/#{file_id}/files",
+            headers:   headers,
+            query:     request_args)[:data]
           # return @api_node.read("files/#{file_id}/files",request_args)[:data]
         end
 
@@ -338,7 +342,7 @@ module Aspera
         rescue StandardError => e
           Log.log.error{"Ignore: #{e.message}"}
           Log.log.debug(e.backtrace.join("\n").red)
-        end # generate_preview
+        end
 
         # scan all files in provided folder entry
         # @param top_path subpath to start folder scan inside

data/lib/aspera/cli/plugins/server.rb

@@ -251,8 +251,8 @@ module Aspera
             end
           else Aspera.error_unreachable_line
           end
-        end # execute_action
-      end # Server
-    end # Plugins
-  end # Cli
-end # Aspera
+        end
+      end
+    end
+  end
+end

data/lib/aspera/cli/plugins/shares.rb

@@ -7,7 +7,7 @@ module Aspera
     module Plugins
       # Plugin for Aspera Shares v1
       class Shares < Cli::BasicAuthPlugin
-        API_BASE = 'node_api'
+        NODE_API_PREFIX = 'node_api'
         class << self
           def detect(address_or_url)
             address_or_url = "https://#{address_or_url}" unless address_or_url.match?(%r{^[a-z]{1,6}://})
@@ -16,7 +16,7 @@ module Aspera
             begin
               # shall fail: shares requires auth, but we check error message
               # TODO: use ping instead ?
-              api.read("#{API_BASE}/app")
+              api.read("#{NODE_API_PREFIX}/app")
             rescue RestCallError => e
               if e.response.code.to_s.eql?('401') && e.response.body.eql?('{"error":{"user_message":"API user authentication failed"}}')
                 found = true
@@ -64,22 +64,24 @@ module Aspera
           when :health
             nagios = Nagios.new
             begin
-              Rest
-                .new(base_url: "#{options.get_option(:url, mandatory: true)}/#{API_BASE}")
+              res = Rest
+                .new(base_url: "#{options.get_option(:url, mandatory: true)}/#{NODE_API_PREFIX}")
                 .call(
                   operation: 'GET',
                   subpath: 'ping',
-                  headers: {'content-type': 'application/json'},
-                  return_error: true)
+                  headers: {'content-type': 'application/json'})
+              raise 'Shares not detected' unless res[:http].body.eql?(' ')
               nagios.add_ok('shares api', 'accessible')
             rescue StandardError => e
-              nagios.add_critical('node api', e.to_s)
+              nagios.add_critical('API', e.to_s)
             end
             return nagios.result
           when :repository, :files
-            api_shares_node = basic_auth_api(API_BASE)
+            api_shares_node = basic_auth_api(NODE_API_PREFIX)
             repo_command = options.get_next_command(Node::COMMANDS_SHARES)
-            return Node.new(**init_params, api: api_shares_node).execute_action(repo_command)
+            return Node
+                .new(**init_params, api: api_shares_node)
+                .execute_action(repo_command)
           when :admin
             api_shares_admin = basic_auth_api('api/v1')
             admin_command = options.get_next_command(%i[node share transfer_settings user group].freeze)
@@ -150,8 +152,8 @@ module Aspera
               end
             end
           end
-        end # execute action
-      end # Shares
-    end # Plugins
-  end # Cli
-end # Aspera
+        end
+      end
+    end
+  end
+end

data/lib/aspera/cli/sync_actions.rb

@@ -60,9 +60,9 @@ module Aspera
             sync_session_name = options.get_next_argument('name of sync session', mandatory: false, type: String)
             async_params = options.get_option(:sync_info, mandatory: true)
             return {type: :single_object, data: Transfer::Sync.admin_status(async_params, sync_session_name)}
-          end # command2
-        end # command
-      end # execute_action
-    end # SyncActions
-  end # Cli
-end # Aspera
+          end
+        end
+      end
+    end
+  end
+end

data/lib/aspera/cli/transfer_agent.rb

@@ -26,6 +26,7 @@ module Aspera
 
         <%=ts.to_yaml%>
       END_OF_TEMPLATE
+      CP4I_REMOTE_HOST_LB = 'N/A'
       # % (formatting bug in eclipse)
       private_constant :FILE_LIST_FROM_ARGS,
         :FILE_LIST_FROM_TRANSFER_SPEC,
@@ -101,8 +102,6 @@ module Aspera
       def agent_instance
         return @agent unless @agent.nil?
         agent_type = @opt_mgr.get_option(:transfer, mandatory: true)
-        # agent plugin is loaded on demand to avoid loading unnecessary dependencies
-        require "aspera/agent/#{agent_type}"
         # set keys as symbols
         agent_options = @opt_mgr.get_option(:transfer_info).symbolize_keys
         # special cases
@@ -126,8 +125,7 @@ module Aspera
         end
         agent_options[:progress] = @config.progress_bar
         # get agent instance
-        new_agent = Kernel.const_get("Aspera::Agent::#{agent_type.capitalize}").new(agent_options)
-        self.agent_instance = new_agent
+        self.agent_instance = Agent::Base.factory_create(agent_type, agent_options)
         Log.log.debug{"transfer agent is a #{@agent.class}"}
         return @agent
       end
@@ -218,6 +216,9 @@ module Aspera
       def start(transfer_spec, rest_token: nil)
         # check parameters
         Aspera.assert_type(transfer_spec, Hash){'transfer_spec'}
+        if transfer_spec['remote_host'].eql?(CP4I_REMOTE_HOST_LB)
+          raise "Wrong remote host: #{CP4I_REMOTE_HOST_LB}"
+        end
         # process :src option
         case transfer_spec['direction']
         when Transfer::Spec::DIRECTION_RECEIVE

data/lib/aspera/cli/version.rb

@@ -4,6 +4,6 @@ module Aspera
   module Cli
     # for beta add extension : .beta1
     # for dev version add extension : .pre
-    VERSION = '4.17.0'
+    VERSION = '4.18.0'
   end
 end

data/lib/aspera/environment.rb

@@ -27,6 +27,7 @@ module Aspera
     BYTES_PER_MEBIBIT = MEBI / BITS_PER_BYTE
 
     class << self
+      @terminal_supports_unicode = nil
       def ruby_version
         return RbConfig::CONFIG['RUBY_PROGRAM_VERSION']
       end
@@ -121,10 +122,10 @@ module Aspera
       end
 
       # @return true if we can display Unicode characters
-      def use_unicode?
-        @use_unicode = terminal? && ENV.values_at('LC_ALL', 'LC_CTYPE', 'LANG').compact.first.include?('UTF-8') if @use_unicode.nil?
-        return @use_unicode
+      def terminal_supports_unicode?
+        @terminal_supports_unicode = terminal? && ENV.values_at('LC_ALL', 'LC_CTYPE', 'LANG').compact.first.include?('UTF-8') if @terminal_supports_unicode.nil?
+        return @terminal_supports_unicode
       end
-    end # self
-  end # Environment
-end # Aspera
+    end
+  end
+end