aspera-cli 4.25.3 → 4.26.0.pre

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

@@ -3,6 +3,8 @@
 require 'aspera/cli/plugins/basic_auth'
 require 'aspera/cli/plugins/node'
 require 'aspera/assert'
+require 'aspera/rest_list'
+
 module Aspera
   module Cli
     module Plugins
@@ -128,7 +130,7 @@ module Aspera
           when :admin
             api_shares_admin = basic_auth_api(ADMIN_API_PATH)
             admin_command = options.get_next_command(%i[node share transfer_settings user group].freeze)
-            lookup_share = ->(field, value){lookup_entity_generic(entity: 'share', field: field, value: value){api_shares_admin.read('data/shares')}['id']}
+            lookup_share = ->(field, value){RestList.lookup_entity_generic(entity: 'share', field: field, value: value){api_shares_admin.read('data/shares')}['id']}
             case admin_command
             when :node
               return entity_execute(api: api_shares_admin, entity: 'data/nodes')
@@ -177,7 +179,7 @@ module Aspera
                 entity_commands = %i[import].freeze
               end
               entity_verb = options.get_next_command(entity_commands)
-              lookup_block = ->(field, value){lookup_entity_generic(entity: entity_type, field: field, value: value){api_shares_admin.read(entities_path)}['id']}
+              lookup_block = ->(field, value){RestList.lookup_entity_generic(entity: entity_type, field: field, value: value){api_shares_admin.read(entities_path)}['id']}
               case entity_verb
               when *ALL_OPS # list, show, delete, create, modify
                 display_fields = entity_type.eql?(:user) ? %w[id user_id username first_name last_name email] : nil

data/lib/aspera/cli/special_values.rb

@@ -8,6 +8,7 @@ module Aspera
       INIT = 'INIT'
       ALL = 'ALL'
       DEF = 'DEF'
+      EOA = 'END'
     end
   end
 end

data/lib/aspera/cli/transfer_agent.rb

@@ -33,6 +33,9 @@ module Aspera
         :DEFAULT_TRANSFER_NOTIFY_TEMPLATE
 
       class << self
+        # Analyze transfer session statuses and return a global status
+        #
+        # @param statuses [Array] list of session status, each status is :success or an error message string
         # @return [:success]  if all sessions statuses returned by "start" are success
         # @return [Exception] if one sessions statuses returned by "start" is failed
         def session_status(statuses)

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.25.3'
+    VERSION = '4.26.0.pre'
   end
 end

data/lib/aspera/cli/wizard.rb

@@ -62,7 +62,7 @@ module Aspera
           detection_info = nil
           begin
             Log.log.debug{"detecting #{plugin_name_sym} at #{app_url}"}
-            formatter.long_operation_running("#{plugin_name_sym}\r")
+            RestParameters.instance.spinner_cb.call(plugin_name_sym.to_s)
             detection_info = plugin_klass.detect(app_url)
           rescue OpenSSL::SSL::SSLError => e
             Log.log.warn(e.message)
@@ -78,6 +78,7 @@ module Aspera
           # If there is a redirect, then the detector can override the url.
           found_apps.push({product: plugin_name_sym, name: app_name, url: app_url, version: 'unknown'}.merge(detection_info))
         end
+        RestParameters.instance.spinner_cb.call(action: :success)
         raise "No known application found at #{app_url}" if found_apps.empty?
         Aspera.assert(found_apps.all?{ |a| a.keys.all?(Symbol)})
         return found_apps

data/lib/aspera/dot_container.rb

@@ -7,13 +7,14 @@ module Aspera
   class DotContainer
     class << self
       # Insert extended value `value` into struct `result` at `path`
-      # @param path   [String] Dotted path in container
-      # @param value  [String] Last value to insert
-      # @param result [NilClass, Hash, Array] current value
-      # @return [Hash, Array]
+      # @param path   [Array<String>] Path in container
+      # @param value  [Object]        Value to insert in deep container
+      # @param result [nil, Hash, Array] Current container to use (or nil to create a new one)
+      # @return [Hash, Array] Container
       def dotted_to_container(path, value, result = nil)
+        Aspera.assert_array_all(path, String)
         # Typed keys
-        keys = path.split(OPTION_DOTTED_SEPARATOR).map{ |k| int_or_string(k)}
+        keys = path.map{ |k| int_or_string(k)}
         # Create, or re-use first level container
         current = (result ||= new_hash_or_array_from_key(keys.first))
         # walk the path, and create sub-containers if necessary
@@ -78,7 +79,7 @@ module Aspera
               to_insert = current.map{ |i| i['name']}
             # Array of Hashes with only 'name' and 'value' keys -> Hash of key/values
             elsif current.all?{ |i| i.is_a?(Hash) && i.keys.sort == %w[name value]}
-              add_elements(path, current.each_with_object({}){ |i, h| h[i['name']] = i['value']})
+              add_elements(path, current.to_h{ |i| [i['name'], i['value']]})
             else
               add_elements(path, current.each_with_index.map{ |v, i| [i, v]})
             end
@@ -86,7 +87,7 @@ module Aspera
             to_insert = current
           end
         end
-        result[path.map(&:to_s).join(OPTION_DOTTED_SEPARATOR)] = to_insert unless to_insert.nil?
+        result[path.join(SEPARATOR)] = to_insert unless to_insert.nil?
       end
       result
     end
@@ -101,8 +102,7 @@ module Aspera
       nil
     end
 
-    # "."
-    OPTION_DOTTED_SEPARATOR = '.'
-    private_constant :OPTION_DOTTED_SEPARATOR
+    # Dot-path separator: `.`
+    SEPARATOR = '.'
   end
 end

data/lib/aspera/log.rb

@@ -26,7 +26,7 @@ class Logger
   # Hash
   # key   [Integer] Log level (e.g. 0 for DEBUG)
   # value [Symbol]  Uppercase log level label (e.g. :DEBUG)
-  SEVERITY_LABEL = Severity.constants.each_with_object({}){ |name, hash| hash[Severity.const_get(name)] = name}
+  SEVERITY_LABEL = Severity.constants.to_h{ |name| [Severity.const_get(name), name]}
 
   # Override
   # @param severity [Integer] Log severity as int

data/lib/aspera/markdown.rb

@@ -33,7 +33,7 @@ module Aspera
 
       # type: NOTE CAUTION WARNING IMPORTANT TIP INFO
       def admonition(lines, type: 'INFO')
-        "> [!{type}]\n#{lines.map{ |l| "> #{l}"}.join("\n")}\n\n"
+        "> [!#{type}]\n#{lines.map{ |l| "> #{l}"}.join("\n")}\n\n"
       end
 
       def code(lines, type: 'shell')

data/lib/aspera/persistency_folder.rb

@@ -79,7 +79,7 @@ module Aspera
     end
 
     def current_items(persist_category)
-      current_files(persist_category).each_with_object({}){ |i, h| h[File.basename(i, FILE_SUFFIX)] = File.read(i)}
+      current_files(persist_category).to_h{ |i| [File.basename(i, FILE_SUFFIX), File.read(i)]}
     end
 
     private

data/lib/aspera/rest.rb

@@ -33,7 +33,7 @@ module Aspera
   class RestParameters
     include Singleton
 
-    attr_accessor :user_agent, :download_partial_suffix, :retry_on_error, :retry_on_timeout, :retry_on_unavailable, :retry_max, :retry_sleep, :session_cb, :progress_bar
+    attr_accessor :user_agent, :download_partial_suffix, :retry_on_error, :retry_on_timeout, :retry_on_unavailable, :retry_max, :retry_sleep, :session_cb, :progress_bar, :spinner_cb
 
     private
 
@@ -47,6 +47,7 @@ module Aspera
       @retry_sleep = 4
       @session_cb = nil
       @progress_bar = nil
+      @spinner_cb = nil
     end
   end
 
@@ -88,8 +89,9 @@ module Aspera
         query
       end
 
-      # Build URI from URL and parameters and check it is http or https
-      # Check iof php style is specified
+      # Build URI from URL and parameters and check it is `http` or `https`.
+      # Check if php style is specified.
+      # `nil` values in query result in key without value, e.g. `?a`, while empty string values result in `?a=`.
       # @param url   [String]            The URL without query.
       # @param query [Hash,Array,String] The query.
       def build_uri(url, query)
@@ -105,18 +107,19 @@ module Aspera
             URI.encode_www_form(h_to_query_array(query))
           when Array
             Aspera.assert(query.all?{ |i| i.is_a?(Array) && i.length.eql?(2)}){'Query must be array of arrays of 2 elements'}
-            URI.encode_www_form(query)
+            URI.encode_www_form(query) # remove nil values
           else Aspera.error_unexpected_value(query.class){'query type'}
           end.gsub('%5B%5D=', '[]=')
         # [] is allowed in url parameters
         uri
       end
 
+      # Support array for query parameter, there is no standard.
+      # Either p=1&p=2 (default)
+      # or p[]=1&p[]=2 (if `:x_array_php_style` is set to true in query)
       # @param query [Hash] HTTP query as hash
       def h_to_query_array(query)
         Aspera.assert_type(query, Hash)
-        # Support array for query parameter, there is no standard.
-        # Either p[]=1&p[]=2, or p=1&p=2
         suffix = query.delete(:x_array_php_style) ? '[]' : nil
         query.each_with_object([]) do |(k, v), query_array|
           case v
@@ -368,8 +371,11 @@ module Aspera
       end
       result_http = nil
       result_data = nil
+      # initialize with number of initial retries allowed, nil gives zero
+      tries_remain_redirect = @redirect_max
       # start a block to be able to retry the actual HTTP request in case of OAuth token expiration
       begin
+        Log.log.debug("send request (retries=#{tries_remain_redirect})")
         # TODO: shall we percent encode subpath (spaces) test with access key delete with space in id
         # URI.escape()
         separator = ['', '/'].include?(subpath) ? '' : '/'
@@ -403,16 +409,13 @@ module Aspera
         Log.dump(:req_body, req.body, level: :trace1)
         # we try the call, and will retry on some error types
         error_tries ||= 1 + RestParameters.instance.retry_max
-        # initialize with number of initial retries allowed, nil gives zero
-        tries_remain_redirect = @redirect_max if tries_remain_redirect.nil?
-        Log.log.debug("send request (retries=#{tries_remain_redirect})")
         result_mime = nil
         file_saved = false
         # make http request (pipelined)
         http_session.request(req) do |response|
           result_http = response
           result_mime = self.class.parse_header(result_http['Content-Type'] || Mime::TEXT)[:type]
-          Log.log.debug{"response: code=#{result_http.code}, mime=#{result_mime}, mime2= #{response['Content-Type']}"}
+          Log.log.debug{"response: code=#{result_http.code}, mime=#{result_mime}, content-type=#{response['Content-Type']}"}
           # JSON data needs to be parsed, in case it contains an error code
           if !save_to_file.nil? &&
               result_http.code.to_s.start_with?('2') &&
@@ -453,12 +456,10 @@ module Aspera
         # TODO : related to mime type encoding ?
         # result_http.body.force_encoding('UTF-8') if result_http.body.is_a?(String)
         # Log.log.debug{"result: body=#{result_http.body}"}
-        if Mime.json?(result_mime)
-          result_data = JSON.parse(result_http.body) rescue result_http.body
-          Log.dump(:result_data, result_data)
-        else # Mime::TEXT
-          result_data = result_http.body
-        end
+        result_data = result_http.body
+        Log.dump(:result_data_raw, result_data, level: :trace1)
+        result_data = JSON.parse(result_data) if Mime.json?(result_mime) && !result_data.nil? && !result_data.empty?
+        Log.dump(:result_data, result_data)
         RestErrorAnalyzer.instance.raise_on_error(req, result_data, result_http)
         unless file_saved || save_to_file.nil?
           FileUtils.mkdir_p(File.dirname(save_to_file))
@@ -536,55 +537,39 @@ module Aspera
 
     # Create: `POST`
     def create(subpath, params, **kwargs)
-      return call(operation: 'POST', subpath: subpath, headers: {'Accept' => Mime::JSON}, body: params, content_type: Mime::JSON, **kwargs)
+      kwargs[:headers] ||= {}
+      kwargs[:headers]['Accept'] = Mime::JSON unless kwargs[:headers].key?('Accept')
+      kwargs[:content_type] = Mime::JSON unless kwargs.key?(:content_type)
+      return call(operation: 'POST', subpath: subpath, body: params, **kwargs)
     end
 
     # Read: `GET`
     def read(subpath, query = nil, **kwargs)
-      return call(operation: 'GET', subpath: subpath, headers: {'Accept' => Mime::JSON}, query: query, **kwargs)
+      kwargs[:headers] ||= {}
+      kwargs[:headers]['Accept'] = Mime::JSON unless kwargs[:headers].key?('Accept')
+      return call(operation: 'GET', subpath: subpath, query: query, **kwargs)
     end
 
     # Update: `PUT`
     def update(subpath, params, **kwargs)
-      return call(operation: 'PUT', subpath: subpath, headers: {'Accept' => Mime::JSON}, body: params, content_type: Mime::JSON, **kwargs)
+      kwargs[:headers] ||= {}
+      kwargs[:headers]['Accept'] = Mime::JSON unless kwargs[:headers].key?('Accept')
+      kwargs[:content_type] = Mime::JSON unless kwargs.key?(:content_type)
+      return call(operation: 'PUT', subpath: subpath, body: params, **kwargs)
     end
 
     # Delete: `DELETE`
     def delete(subpath, params = nil, **kwargs)
-      return call(operation: 'DELETE', subpath: subpath, headers: {'Accept' => Mime::JSON}, query: params, **kwargs)
+      kwargs[:headers] ||= {}
+      kwargs[:headers]['Accept'] = Mime::JSON unless kwargs[:headers].key?('Accept')
+      return call(operation: 'DELETE', subpath: subpath, query: params, **kwargs)
     end
 
     # Cancel: `CANCEL`
     def cancel(subpath, **kwargs)
-      return call(operation: 'CANCEL', subpath: subpath, headers: {'Accept' => Mime::JSON}, **kwargs)
-    end
-
-    # Query entity by general search (read with parameter `q`)
-    # TODO: not generic enough ? move somewhere ? inheritance ?
-    # @param subpath     [String] Path of entity in API
-    # @param search_name [String] Name of searched entity
-    # @param query       [Hash]   Additional search query parameters
-    # @returns [Hash] A single entity matching the search, or an exception if not found or multiple found
-    def lookup_by_name(subpath, search_name, query: nil)
-      query = {} if query.nil?
-      # returns entities matching the query (it matches against several fields in case insensitive way)
-      matching_items = read(subpath, query.merge({'q' => search_name}))
-      # API style: {totalcount:, ...} cspell: disable-line
-      matching_items = matching_items[subpath] if matching_items.is_a?(Hash)
-      Aspera.assert_type(matching_items, Array)
-      case matching_items.length
-      when 1 then return matching_items.first
-      when 0 then raise EntityNotFound, %Q{No such #{subpath}: "#{search_name}"}
-      else
-        # multiple case insensitive partial matches, try case insensitive full match
-        # (anyway AoC does not allow creation of 2 entities with same case insensitive name)
-        name_matches = matching_items.select{ |i| i['name'].casecmp?(search_name)}
-        case name_matches.length
-        when 1 then return name_matches.first
-        when 0 then raise %Q(#{subpath}: Multiple case insensitive partial match for: "#{search_name}": #{matching_items.map{ |i| i['name']}} but no case insensitive full match. Please be more specific or give exact name.)
-        else raise "Two entities cannot have the same case insensitive name: #{name_matches.map{ |i| i['name']}}"
-        end
-      end
+      kwargs[:headers] ||= {}
+      kwargs[:headers]['Accept'] = Mime::JSON unless kwargs[:headers].key?('Accept')
+      return call(operation: 'CANCEL', subpath: subpath, **kwargs)
     end
 
     UNAVAILABLE_CODES = ['503']

data/lib/aspera/rest_list.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+module Aspera
+  # List and lookup methods for Rest
+  # include in classes inheriting Rest
+  module RestList
+    # Query entity by general search (read with parameter `q`)
+    #
+    # @param subpath     [String] Path of entity in API
+    # @param search_name [String] Name of searched entity
+    # @param query       [Hash]   Optional additional search query parameters
+    # @returns [Hash] A single entity matching the search, or an exception if not found or multiple found
+    def lookup_by_name(subpath, search_name, query: nil)
+      query = {} if query.nil?
+      # returns entities matching the query (it matches against several fields in case insensitive way)
+      matching_items = read(subpath, query.merge({'q' => search_name}))
+      # API style: {totalcount:, ...} cspell: disable-line
+      matching_items = matching_items[subpath] if matching_items.is_a?(Hash)
+      Aspera.assert_type(matching_items, Array)
+      case matching_items.length
+      when 1 then return matching_items.first
+      when 0 then raise EntityNotFound, %Q{No such #{subpath}: "#{search_name}"}
+      else
+        # multiple case insensitive partial matches, try case insensitive full match
+        # (anyway AoC does not allow creation of 2 entities with same case insensitive name)
+        name_matches = matching_items.select{ |i| i['name'].casecmp?(search_name)}
+        case name_matches.length
+        when 1 then return name_matches.first
+        when 0 then raise %Q(#{subpath}: Multiple case insensitive partial match for: "#{search_name}": #{matching_items.map{ |i| i['name']}} but no case insensitive full match. Please be more specific or give exact name.)
+        else raise "Two entities cannot have the same case insensitive name: #{name_matches.map{ |i| i['name']}}"
+        end
+      end
+    end
+
+    # Get a (full or partial) list of all entities of a given type with query: offset/limit
+    # @param entity    [String,Symbol] API endpoint of entity to list
+    # @param items_key [String]        Key in the result to get the list of items (Default: same as `entity`)
+    # @param query     [Hash,nil]      Additional query parameters
+    # @return [Array<(Array<Hash>, Integer)>] items, total_count
+    def list_entities_limit_offset_total_count(
+      entity:,
+      items_key: nil,
+      query: nil
+    )
+      entity = entity.to_s if entity.is_a?(Symbol)
+      items_key = entity.split('/').last if items_key.nil?
+      query = {} if query.nil?
+      Aspera.assert_type(entity, String)
+      Aspera.assert_type(items_key, String)
+      Aspera.assert_type(query, Hash)
+      Log.log.debug{"list_entities t=#{entity} k=#{items_key} q=#{query}"}
+      result = []
+      offset = 0
+      max_items = query.delete(MAX_ITEMS)
+      remain_pages = query.delete(MAX_PAGES)
+      # Merge default parameters, by default 100 per page
+      query = {'limit'=> PER_PAGE_DEFAULT}.merge(query)
+      total_count = nil
+      loop do
+        query['offset'] = offset
+        page_result = read(entity, query)
+        Aspera.assert_type(page_result[items_key], Array)
+        result.concat(page_result[items_key])
+        # Reach the limit set by user ?
+        if !max_items.nil? && (result.length >= max_items)
+          result = result.slice(0, max_items)
+          break
+        end
+        total_count ||= page_result['total_count']
+        break if result.length >= total_count
+        remain_pages -= 1 unless remain_pages.nil?
+        break if remain_pages == 0
+        offset += page_result[items_key].length
+        RestParameters.instance.spinner_cb.call("#{result.length} / #{total_count || '?'}")
+      end
+      RestParameters.instance.spinner_cb.call(action: :success)
+      return result, total_count
+    end
+
+    # Lookup an entity id from its name.
+    # Uses query `q` if `query` is `:default` and `field` is `name`.
+    # @param entity    [String] Type of entity to lookup, by default it is the path, and it is also the field name in result
+    # @param value     [String] Value to lookup
+    # @param field     [String] Field to match, by default it is `'name'`
+    # @param items_key [String] Key in the result to get the list of items (override entity)
+    # @param query     [Hash]   Additional query parameters (Default: `:default`)
+    def lookup_entity_by_field(entity:, value:, field: 'name', items_key: nil, query: :default)
+      if query.eql?(:default)
+        Aspera.assert(field.eql?('name')){'Default query is on name only'}
+        query = {'q'=> value}
+      end
+      lookup_entity_generic(entity: entity, field: field, value: value){list_entities_limit_offset_total_count(entity: entity, items_key: items_key, query: query).first}
+    end
+
+    # Lookup entity by field and value.
+    # Extracts a single result from the list returned by the block.
+    #
+    # @param entity [String] Type of entity to lookup (path, and by default it is also the field name in result)
+    # @param value  [String] Value to match against the field.
+    # @param field  [String] Field to match in the hashes (defaults to 'name').
+    # @yield []              A mandatory block that returns an Array of Hashes.
+    # @return [Hash] The unique matching object.
+    # @raise  [Cli::BadIdentifier] If 0 or >1 matches are found.
+    def lookup_entity_generic(entity:, value:, field: 'name')
+      Aspera.assert(block_given?)
+      found = yield
+      Aspera.assert_array_all(found, Hash)
+      found = found.select{ |i| i[field].eql?(value)}
+      return found.first if found.length.eql?(1)
+      raise Cli::BadIdentifier.new(entity, value, field: field, count: found.length)
+    end
+    PER_PAGE_DEFAULT = 1000
+    private_constant :PER_PAGE_DEFAULT
+    module_function :lookup_entity_generic
+  end
+end

data/lib/aspera/sync/operations.rb

@@ -342,7 +342,7 @@ module Aspera
       CONF_SCHEMA = CommandLineBuilder.read_schema(__dir__, 'conf')
       CMDLINE_PARAMS_KEYS = %w[instance sessions].freeze
       ASYNC_ADMIN_EXECUTABLE = 'asyncadmin'
-      PRIVATE_FOLDER = '.private-asp'
+      PRIVATE_FOLDER = "#{Environment.instance.os.eql?(Environment::OS_WINDOWS) ? '~' : '.'}private-asp"
       ASYNC_DB = 'snap.db'
       PARAM_KEYS = %w[local sessions].freeze
 

data/lib/aspera/transfer/parameters.rb

@@ -38,19 +38,19 @@ module Aspera
           @file_list_folder ||= TempFileManager.instance.new_file_path_global('asession_filelists')
         end
 
-        # File list is provided directly with ascp arguments
-        # @columns ascp_args [Array,NilClass] ascp arguments
+        # File list is provided directly with `ascp` arguments
+        # @columns ascp_args [Array,NilClass] `ascp` arguments
         def ascp_args_file_list?(ascp_args)
           ascp_args&.any?{ |i| FILE_LIST_OPTIONS.include?(i)}
         end
       end
 
-      # @param job_spec        [Hash]    Transfer spec
-      # @param ascp_args       [Array]   Other ascp args
-      # @param quiet           [Boolean] Remove ascp output
-      # @param trusted_certs   [Array]   Trusted certificates
-      # @param client_ssh_key  [:rsa,:dsa] :rsa or :dsa
-      # @param check_ignore_cb [Proc]    Callback
+      # @param job_spec        [Hash]          Transfer specification
+      # @param ascp_args       [Array]         Other `ascp` args
+      # @param quiet           [Boolean]       Remove `ascp` progress bar if `true`
+      # @param client_ssh_key  [:rsa,:dsa]     Type of Aspera Client SSH key to use.
+      # @param trusted_certs   [Array<String>] List of path to trusted certificates stores when using WSS
+      # @param check_ignore_cb [Proc]          Callback to check if WSS connection shall ignore certificate validity
       def initialize(
         job_spec,
         ascp_args:       nil,

data/lib/aspera/transfer/spec.rb

@@ -25,6 +25,7 @@ module Aspera
       TRANSPORT_FIELDS = (%w[remote_host] + AK_TSPEC_BASE.keys + WSS_FIELDS).freeze
       # reserved tag for Aspera
       TAG_RESERVED = 'aspera'
+      SPECIFIC = %w{token paths direction source_root destination_root}.freeze
       class << self
         # wrong def in transferd
         POLICY_FIX = {

data/lib/aspera/yaml.rb

@@ -25,7 +25,7 @@ module Aspera
         counts.each do |key_str, count|
           next if count <= 1
           path = (parent_path + [key_str]).join('.')
-          occurrences = key_nodes[key_str].map{ |kn| kn.start_line ? kn.start_line + 1 : 'unknown'}.map(&:to_s).join(', ')
+          occurrences = key_nodes[key_str].map{ |kn| kn.start_line ? kn.start_line + 1 : 'unknown'}.join(', ')
           duplicate_keys << "#{path}: #{occurrences}"
         end
       else

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aspera-cli
 version: !ruby/object:Gem::Version
-  version: 4.25.3
+  version: 4.26.0.pre
 platform: ruby
 authors:
 - Laurent Martin
@@ -424,6 +424,7 @@ files:
 - lib/aspera/rest_call_error.rb
 - lib/aspera/rest_error_analyzer.rb
 - lib/aspera/rest_errors_aspera.rb
+- lib/aspera/rest_list.rb
 - lib/aspera/secret_hider.rb
 - lib/aspera/ssh.rb
 - lib/aspera/ssl.rb
@@ -456,7 +457,7 @@ metadata:
   source_code_uri: https://github.com/IBM/aspera-cli/tree/main/lib/aspera
   changelog_uri: https://github.com/IBM/aspera-cli/blob/main/CHANGELOG.md
   rubygems_uri: https://rubygems.org/gems/aspera-cli
-  documentation_uri: https://www.rubydoc.info/gems/aspera-cli
+  documentation_uri: https://ibm.biz/ascli-doc
 rdoc_options: []
 require_paths:
 - lib
@@ -472,7 +473,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - Read the manual for any requirement
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: 'Execute actions using command line on IBM Aspera Server products: Aspera
   on Cloud, Faspex, Shares, Node, Console, Orchestrator, High Speed Transfer Server'