aspera-cli 4.27.2 → 4.27.3

data/lib/aspera/web_auth/server.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require 'aspera/web_server_simple'
+require 'aspera/assert'
+require 'erb'
+
+module Aspera
+  module WebAuth
+    # servlet called on callback: it records the callback request
+    class Servlet < WEBrick::HTTPServlet::AbstractServlet
+      # @param server [WEBrick::HTTPServer] the HTTP server instance
+      # @param web_auth [Server] the Server instance to record the callback
+      def initialize(server, web_auth)
+        Log.log.debug('Servlet initialize')
+        super(server)
+        @web_auth = web_auth
+      end
+
+      # called on request
+
+      def service(request, response)
+        Log.log.debug { "received request from browser #{request.request_method} #{request.path}" }
+        Aspera.assert_values(request.request_method, ['GET'], type: WEBrick::HTTPStatus::MethodNotAllowed) { "Unsupported method: #{req.request_method}" }
+        Aspera.assert_values(request.path, ['/'], type: WEBrick::HTTPStatus::NotFound) { "Unsupported path: #{req.request_method}" }
+        # response to browser
+        response.status = 200
+        response.content_type = 'text/html'
+        response.body = File.read("#{__dir__}/index.html").gsub('__ADD_INFO__', @web_auth.info_html)
+        # continue internal processing
+        @web_auth.signal_request(request)
+        nil
+      end
+    end
+
+    # start a local web server
+    # then start a browser that will callback the local server upon authentication
+    # store the final query
+    class Server < WebServerSimple
+      attr_reader :info_html
+
+      # @param endpoint_url    [String] e.g. 'https://127.0.0.1:12345'
+      # @param additional_info [String] Information in web page
+      def initialize(endpoint_url, additional_info = nil)
+        uri = URI.parse(endpoint_url)
+        super(uri)
+        @mutex = Mutex.new
+        @cond = ConditionVariable.new
+        @expected_path = uri.path.empty? ? '/' : uri.path
+        @query = nil
+        @info_html = additional_info.to_s
+        @info_html = "<p>#{ERB::Util.html_escape(@info_html)}</p>" unless @info_html.empty?
+        # last argument (self) is provided to constructor of servlet
+        mount(@expected_path, Servlet, self)
+        # server runs in thread
+        Thread.new { start }
+      end
+
+      # Called by web server thread on received request
+      # @return [nil]
+      def signal_request(request)
+        raise WEBrick::HTTPStatus::NotFound, "unexpected path: #{request.path}" unless request.path.eql?(@expected_path)
+        # acquire lock and signal change
+        @mutex.synchronize do
+          @query = request.query
+          @cond.signal
+        end
+        nil
+      end
+
+      # wait for request on web server (main thread)
+      # @return [Hash] the query
+      def received_request
+        # wait for signal from thread
+        @mutex.synchronize { @cond.wait(@mutex) }
+        # tell server thread to stop
+        shutdown
+        return @query
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aspera-cli
 version: !ruby/object:Gem::Version
-  version: 4.27.2
+  version: 4.27.3
 platform: ruby
 authors:
 - Laurent Martin
@@ -94,6 +94,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: json_schemer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
 - !ruby/object:Gem::Dependency
   name: jwt
   requirement: !ruby/object:Gem::Requirement
@@ -346,9 +360,14 @@ files:
 - lib/aspera/cli/ascp_actions.rb
 - lib/aspera/cli/async_transfer_store.rb
 - lib/aspera/cli/bootstrapper.rb
+- lib/aspera/cli/command_line.rb
 - lib/aspera/cli/command_registry.rb
 - lib/aspera/cli/command_spec.rb
+- lib/aspera/cli/completion/ascli.bash
+- lib/aspera/cli/completion/ascli.fish
+- lib/aspera/cli/completion/ascli.zsh
 - lib/aspera/cli/context.rb
+- lib/aspera/cli/deprecation.rb
 - lib/aspera/cli/error.rb
 - lib/aspera/cli/extended_value.rb
 - lib/aspera/cli/formatter.rb
@@ -359,6 +378,9 @@ files:
 - lib/aspera/cli/mailer.rb
 - lib/aspera/cli/mcp_tool.rb
 - lib/aspera/cli/option_declarator.rb
+- lib/aspera/cli/option_registry.rb
+- lib/aspera/cli/option_types.rb
+- lib/aspera/cli/option_value.rb
 - lib/aspera/cli/options.schema.yaml
 - lib/aspera/cli/parser.rb
 - lib/aspera/cli/plugins/alee.rb
@@ -382,6 +404,7 @@ files:
 - lib/aspera/cli/plugins/shares.rb
 - lib/aspera/cli/preset_actions.rb
 - lib/aspera/cli/preset_manager.rb
+- lib/aspera/cli/prompt.rb
 - lib/aspera/cli/result.rb
 - lib/aspera/cli/runner.rb
 - lib/aspera/cli/secret_finder.rb
@@ -394,7 +417,6 @@ files:
 - lib/aspera/cli/vault_manager.rb
 - lib/aspera/cli/version.rb
 - lib/aspera/cli/wizard.rb
-- lib/aspera/colors.rb
 - lib/aspera/command_line_builder.rb
 - lib/aspera/command_line_converter.rb
 - lib/aspera/coverage.rb
@@ -428,6 +450,7 @@ files:
 - lib/aspera/link_header.rb
 - lib/aspera/log.rb
 - lib/aspera/markdown.rb
+- lib/aspera/mime.rb
 - lib/aspera/nagios.rb
 - lib/aspera/node_simulator.rb
 - lib/aspera/oauth.rb
@@ -453,23 +476,31 @@ files:
 - lib/aspera/products/transferd.rb
 - lib/aspera/proxy_auto_config.js
 - lib/aspera/proxy_auto_config.rb
+- lib/aspera/rainbow.rb
 - lib/aspera/rest.rb
-- 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/rest/aspera_errors.rb
+- lib/aspera/rest/call_error.rb
+- lib/aspera/rest/client.rb
+- lib/aspera/rest/error_analyzer.rb
+- lib/aspera/rest/list.rb
+- lib/aspera/rest/parameters.rb
+- lib/aspera/rest/util.rb
+- lib/aspera/schema/IBM Aspera Console-enhanced.yaml
 - lib/aspera/schema/IBM Aspera Faspex API-5.0-enhanced.yaml
 - lib/aspera/schema/IBM Aspera Node API-4.4.6.yaml
 - lib/aspera/schema/IBM Aspera faspio Gateway API-1.0.0.yaml
 - lib/aspera/schema/IBM Aspera on Cloud API-0.2.6-enhanced.yaml
+- lib/aspera/schema/IBM Aspera on Cloud Automation API-1.0.5-enhanced.yaml
 - lib/aspera/schema/IBM_Aspera_Shares.yaml
 - lib/aspera/schema/async_tables.yaml
 - lib/aspera/schema/documentation.rb
 - lib/aspera/schema/reader.rb
 - lib/aspera/schema/registry.rb
+- lib/aspera/schema/validator.rb
 - lib/aspera/secret_hider.rb
 - lib/aspera/ssh.rb
 - lib/aspera/ssl.rb
+- lib/aspera/string_ext.rb
 - lib/aspera/sync/args.schema.yaml
 - lib/aspera/sync/conf.schema.yaml
 - lib/aspera/sync/database.rb
@@ -484,7 +515,8 @@ files:
 - lib/aspera/transfer/spec.rb
 - lib/aspera/transfer/spec.schema.yaml
 - lib/aspera/uri_reader.rb
-- lib/aspera/web_auth.rb
+- lib/aspera/web_auth/index.html
+- lib/aspera/web_auth/server.rb
 - lib/aspera/web_server_simple.rb
 - lib/aspera/yaml.rb
 - lib/transferd_pb.rb

data/lib/aspera/colors.rb

@@ -1,79 +0,0 @@
-# frozen_string_literal: true
-
-# cspell:words
-
-# simple vt100 colors
-class String
-  class << self
-    private
-
-    def vt_cmd(code); "\e[#{code}m"; end
-  end
-  # see https://en.wikipedia.org/wiki/ANSI_escape_code
-  # symbol is the method name added to String, e.g. "hello".bold
-  # it adds control chars to set color (and reset at the end).
-  VT_STYLES = {
-    bold:          1,
-    dim:           2,
-    italic:        3,
-    underline:     4,
-    blink:         5,
-    reverse_color: 7,
-    invisible:     8,
-    strike:        9,
-    black:         30,
-    red:           31,
-    green:         32,
-    brown:         33,
-    blue:          34,
-    magenta:       35,
-    cyan:          36,
-    gray:          37,
-    bg_black:      40,
-    bg_red:        41,
-    bg_green:      42,
-    bg_brown:      43,
-    bg_blue:       44,
-    bg_magenta:    45,
-    bg_cyan:       46,
-    bg_gray:       47
-  }.freeze
-  private_constant :VT_STYLES
-  # Defines methods to String, one per entry in VT_STYLES
-  VT_STYLES.each do |name, code|
-    if $stdout.tty?
-      begin_seq = vt_cmd(code)
-      end_seq = vt_cmd(
-        if code <= 2 then 22
-        elsif code <= 8 then code + 20
-        elsif code <= 37 then 39
-        elsif code <= 47 then 49
-        else
-          0 # by default reset all
-        end
-      )
-      define_method(name) { "#{begin_seq}#{self}#{end_seq}" }
-    else
-      define_method(name) { self }
-    end
-  end
-
-  # Applies the provided list of string decoration (colors).
-  # @param colors [Array<Symbol>] List of decorations.
-  # @return [String] Enhanced String.
-  def apply(*colors)
-    colors.reduce(self) { |s, c| s.public_send(c) }
-  end
-
-  # Transform capitalized to snake case
-  def capital_to_snake
-    return gsub(/([a-z\d])([A-Z])/, '\1_\2')
-        .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
-        .downcase
-  end
-
-  # Transform snake case to capitalized
-  def snake_to_capital
-    split('_').map(&:capitalize).join
-  end
-end

data/lib/aspera/rest_call_error.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-module Aspera
-  # raised on error after REST call
-  class RestCallError < StandardError
-    def request
-      @context[:request]
-    end
-
-    def response
-      @context[:response]
-    end
-
-    def data
-      @context[:data]
-    end
-
-    # @param context [Hash,String] with keys :messages, :request, :response, :data
-    def initialize(context)
-      context = {messages: [context]} if context.is_a?(String)
-      @context = context
-      super(@context[:messages].join("\n"))
-    end
-  end
-end

data/lib/aspera/rest_error_analyzer.rb

@@ -1,111 +0,0 @@
-# frozen_string_literal: true
-
-require 'aspera/rest_call_error'
-require 'aspera/log'
-require 'singleton'
-require 'net/http'
-
-module Aspera
-  # analyze error codes returned by REST calls and raise ruby exception
-  #
-  # @!method self.instance
-  #   Returns the singleton instance of RestErrorAnalyzer
-  #   @return [RestErrorAnalyzer] the singleton instance
-  class RestErrorAnalyzer
-    include Singleton
-
-    attr_accessor :log_file
-
-    # the singleton object is registered with application specific handlers
-    def initialize
-      # list of handlers
-      @error_handlers = []
-      @log_file = nil
-      add_handler('Type Generic') do |type, context|
-        if !context[:response].code.start_with?('2')
-          # add generic information
-          RestErrorAnalyzer.add_error(context, type, "#{context[:request]['host']} #{context[:response].code} #{context[:response].message}")
-        end
-      end
-    end
-
-    # Use this method to analyze a EST result and raise an exception
-    # Analyzes REST call response and raises a RestCallError exception
-    # if HTTP result code is not 2XX
-    # @param req  [Net::HTTPRequest]  the HTTP request
-    # @param data [Object]            the parsed response body
-    # @param http [Net::HTTPResponse] the raw HTTP response
-    def raise_on_error(req, data, http)
-      Log.log.debug { "raise_on_error #{req.method} #{req.path} #{http.code}" }
-      context = {
-        messages: [],
-        request:  req,
-        response: http,
-        data:     data
-      }
-      # multiple error messages can be found
-      # analyze errors from provided handlers
-      # note that there can be an error even if code is 2XX
-      @error_handlers.each do |handler|
-        handler[:block].call(handler[:name], context)
-      rescue StandardError => e
-        Log.log.error { "ERROR in handler:\n#{e.message}\n#{e.backtrace}" }
-      end
-      raise RestCallError, context unless context[:messages].empty?
-    end
-
-    # Add a new error handler (done at application initialization)
-    # @param name  [String] name of error handler (for logs)
-    # @param block [Proc]   processing of response: takes two parameters: `name`, `context`
-    # name is the one provided here
-    # context is built in method raise_on_error
-    def add_handler(name, &block)
-      @error_handlers.unshift({name: name, block: block})
-      nil
-    end
-
-    # Add a simple error handler
-    # Check that key exists and is string under specified path (hash)
-    # Adds other keys as secondary information
-    # @param name   [String]  name of error handler (for logs)
-    # @param always [Boolean] if true, always add error message, even if response code is 2XX
-    # @param path   [Array]   path to error message in response
-    def add_simple_handler(name:, always: false, path:)
-      path.freeze
-      add_handler(name) do |type, context|
-        if context[:data].is_a?(Hash) && (!context[:response].code.start_with?('2') || always)
-          # Log.log.debug{"simple_handler: #{type} #{path} #{path.last}"}
-          # dig and find hash containing error message
-          error_struct = path.length.eql?(1) ? context[:data] : context[:data].dig(*path[0..-2])
-          # Log.log.debug{"found: #{error_struct.class} #{error_struct}"}
-          if error_struct.is_a?(Hash) && error_struct[path.last].is_a?(String)
-            RestErrorAnalyzer.add_error(context, type, error_struct[path.last])
-            error_struct.each do |k, v|
-              next if k.eql?(path.last)
-              RestErrorAnalyzer.add_error(context, "#{type}(sub)", "#{k}: #{v}") if [String, Integer].include?(v.class)
-            end
-          end
-        end
-      end
-    end
-
-    class << self
-      # Used by handler to add an error description to list of errors
-      # For logging and tracing : collect error descriptions (create file to activate)
-      # @param context [Hash]   the result context, provided to handler
-      # @param type    [String] type of exception, for logging purpose
-      # @param message [String] one error message  to add to list
-      def add_error(context, type, message)
-        context[:messages].push(message)
-        Log.log.trace1 { "Found error: #{type}: #{message}" }
-        log_file = instance.log_file
-        # log error for further analysis (file must exist to activate)
-        return if log_file.nil? || !File.exist?(log_file)
-        File.open(log_file, 'a+') do |f|
-          f.write("\n=#{type}=====\n#{context[:request].method} #{context[:request].path}\n#{context[:response].code}\n" \
-            "#{JSON.generate(context[:data])}\n#{context[:messages].join("\n")}")
-        end
-      end
-    end
-  end
-end

data/lib/aspera/rest_errors_aspera.rb

@@ -1,58 +0,0 @@
-# frozen_string_literal: true
-
-require 'aspera/rest_error_analyzer'
-require 'aspera/log'
-
-module Aspera
-  # REST error handlers for various Aspera REST APIs
-  class RestErrorsAspera
-    class << self
-      # handlers should probably be defined by plugins for modularity
-      def register_handlers
-        Log.log.debug('registering Aspera REST error handlers')
-        # Faspex 4: both user_message and internal_message, and code 200
-        # example: missing meta data on package creation
-        RestErrorAnalyzer.instance.add_simple_handler(name: 'Type 1: error:user_message', path: %w[error user_message], always: true)
-        RestErrorAnalyzer.instance.add_simple_handler(name: 'Type 2: error:description', path: %w[error description])
-        RestErrorAnalyzer.instance.add_simple_handler(name: 'Type 3: error:internal_message', path: %w[error internal_message])
-        RestErrorAnalyzer.instance.add_simple_handler(name: 'Type 5', path: ['error_description'])
-        RestErrorAnalyzer.instance.add_simple_handler(name: 'Type 6', path: ['message'])
-        RestErrorAnalyzer.instance.add_simple_handler(name: 'Type 6', path: ['failure'], always: true)
-        # AoC Automation
-        RestErrorAnalyzer.instance.add_simple_handler(name: 'AoC Automation', path: ['error'])
-        RestErrorAnalyzer.instance.add_handler('Type 7: errors[]') do |type, context|
-          next unless context[:data].is_a?(Hash) && context[:data]['errors'].is_a?(Hash)
-          # special for Shares: false positive ? (update global transfer_settings)
-          next if context[:data].key?('min_connect_version')
-          context[:data]['errors'].each do |k, v|
-            RestErrorAnalyzer.add_error(context, type, "#{k}: #{v}")
-          end
-        end
-        # call to upload_setup and download_setup of node api
-        RestErrorAnalyzer.instance.add_handler('T8:node: *_setup') do |type, context|
-          next unless context[:data].is_a?(Hash)
-          d_t_s = context[:data]['transfer_specs']
-          next unless d_t_s.is_a?(Array)
-          d_t_s.each do |res|
-            r_err = res.dig(*%w[transfer_spec error]) || res['error']
-            next unless r_err.is_a?(Hash)
-            RestErrorAnalyzer.add_error(context, type, r_err.values.join(': '))
-          end
-        end
-        RestErrorAnalyzer.instance.add_simple_handler(name: 'T9:IBM cloud IAM', path: ['errorMessage'])
-        RestErrorAnalyzer.instance.add_simple_handler(name: 'T10:faspex v4', path: ['user_message'])
-        RestErrorAnalyzer.instance.add_handler('Orchestrator') do |type, context|
-          next if context[:response].code.start_with?('2')
-          data = context[:data]
-          next unless data.is_a?(Hash)
-          work_order = data['work_order']
-          next unless work_order.is_a?(Hash)
-          RestErrorAnalyzer.add_error(context, type, work_order['statusDetails'])
-          data['missing_parameters']&.each do |param|
-            RestErrorAnalyzer.add_error(context, type, "missing parameter: #{param}")
-          end
-        end
-      end
-    end
-  end
-end

data/lib/aspera/rest_list.rb

@@ -1,136 +0,0 @@
-# frozen_string_literal: true
-
-module Aspera
-  # List and lookup methods for Rest
-  # To be included in classes inheriting Rest that require those methods.
-  module RestList
-    # `max`: special query parameter: max number of items for list command
-    MAX_ITEMS = 'max'
-    # `pmax`: special query parameter: max number of pages for list command
-    MAX_PAGES = 'pmax'
-
-    # Query entity by general search (read with parameter `q`)
-    #
-    # @param entity [String] Path of entity in API
-    # @param value [String] Value of field of searched entity
-    # @param field [String] Field of searched entity
-    # @param query [Hash] Optional additional search query parameters
-    # @return [Hash] A single entity matching the search, or an exception if not found or multiple found
-    def lookup_with_q(entity, value:, field: 'name', query: {})
-      Aspera.assert_type(query, Hash) { 'query' }
-      Aspera.assert_type(field, String) { 'field' }
-      # returns entities matching the query (it matches against several fields in case insensitive way)
-      # We don't do paging, as anyway, we look for only one match
-      matching_items = read(entity, query.merge({'q' => value}))
-      # API style: {totalcount:, ...} cspell: disable-line: TODO: is that total_count ?
-      # @type [Array<Hash{String => String}>]
-      matching_items = matching_items[entity] 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 #{entity}: "#{value}"}
-      else
-        # multiple case insensitive partial matches, try case insensitive full match
-        # (anyway AoC does not allow creation of 2 entities with same case insensitive field value)
-        value_matches = matching_items.select { |i| i[field].casecmp?(value) }
-        case value_matches.length
-        when 1 then return value_matches.first
-        when 0 then raise Error, "#{entity}: Multiple case insensitive partial match for: \"#{value}\" in #{matching_items.map { |i| i[field] }.join(', ')} but no case insensitive full match. Please be more specific or give exact #{field}."
-        else raise Error, "Two entities cannot have the same case insensitive #{field}: #{value_matches.map { |i| i[field] }}"
-        end
-      end
-    end
-
-    # Get a (full or partial) list of all entities of a given type.
-    # Using query: `offset` + `limit`
-    # And response `total_count`
-    # @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:,
-      operation: 'GET',
-      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}" }
-      Log.dump(:query, 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
-      call_args = {
-        operation: operation,
-        subpath:   entity,
-        query:     query,
-        headers:   {'Accept' => Mime::JSON}
-      }
-      loop do
-        query['offset'] = offset
-        page_result = call(**call_args)
-        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_values(field, ['name']) { 'Default query field' }
-        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?, 'block required for lookup_entity_generic')
-      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