aspera-cli 4.26.1 → 4.26.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bffa626f5f4970bf91f90b15e594315d3c81a1ed92c8eff2f9533f7faef71aab
-  data.tar.gz: 552c9b1d9225d3c1360f83d920bface08022314c7227bf36e7af439310e51c75
+  metadata.gz: 3959459dc4ecd6fbc28e485b7665744293691d275d7597375b9ee2e80dfb9477
+  data.tar.gz: 62fe6561296d5a6f35473e7c7e831a3089e54fecdbd364a4042e01f993db180e
 SHA512:
-  metadata.gz: 2b655e7eaeee027e393fc7136c3f3b1a8d679a0825fb7d92baa6fa854d5cd68b11c01ecbeb9c32c457044f6eef3ae2bdbf22afa324b3d79643ec169aaad8f632
-  data.tar.gz: eeb29fc5c14cbe809e31ee229b79cd650632987d93af8a892001e49aea06aa68ace8f7f660345dc27edf0a1ad6350a85e285ba449d8cc39774f9f4c1d4832a8a
+  metadata.gz: 95a052413af5c03a31e74c5b71f359b4dcd7f2af34e59be7c5c2fb49af862b45ce76be92d464419da1c9c944e1d140cd5b957a72916f53384e95317faf08fbcf
+  data.tar.gz: ed1aaa7ac2079839f69b506044ca7129e16cc4eb2c371d3311deb598aa91c6ed22c15bac03f8398062768cbdfc8131dc4fcafe84b637ce2a8357fb8c3af5c515

data/CHANGELOG.md

@@ -1,6 +1,24 @@
 # Changes (Release notes)
 
-<!-- markdownlint-configure-file { "no-duplicate-heading": { "siblings_only": true } } -->
+## 4.26.2
+
+Released: 2026-07-17
+
+### New Features
+
+* `faspex5`: New commands `admin file_processing` and `packages file_processing`.
+* `aoc`: Command `user settings` now support `create`, `delete`, `list`, `show`, `modify`.
+* `aoc`: New command `network_policy` and `configuration_policy` in `admin`.
+* `sync` : New command `admin query` to execute an arbitrary SQL command on the snap DB.
+* `sync` : Option `sql` to add arbitrary SQL suffixes to sync actions with snapshot DB.
+
+### Issues Fixed
+
+* `aoc`: Fixed `admin application membership create`.
+
+### Breaking Changes
+
+**global**: Replaced option `--bash-comp` with `config completion bash`.
 
 ## 4.26.1
 

data/CONTRIBUTING.md

@@ -72,7 +72,7 @@ The `aspera-cli` architecture is designed to be modular and extensible.
 
 - **Entry Point**:
 
-  `lib/aspera/cli/main.rb` contains the core CLI startup logic.
+  `lib/aspera/cli/runner.rb` contains the core CLI startup logic.
 
 - **Plugins**:
 
@@ -112,15 +112,12 @@ The following environment variables and macros control specific build behaviors:
 | `LOG_SECRETS`               | `yes`/`no` | Toggles the logging of secrets in `rake` tasks.              |
 | `LOG_LEVEL`                 | `debug`, ... | Sets the logging verbosity for `rake` tasks.                 |
 | `ENABLE_COVERAGE`           | set/unset  | Enables test coverage analysis when defined.                 |
-| `SIGNING_KEY`               | File path  | Path to the signing key used for building the gem file.      |
-| `SIGNING_KEY_PEM`           | PEM Value  | The PEM content of the signing key.                          |
+| `SIGNING_KEY`               | File path or PEM | Path to the signing key file, or PEM content (starts with `-----BEGIN`). |
 | `DRY_RUN`                   | `1`        | Simulates execution without performing actual operations (`git`, `gh`). |
 | `DEBUG`                     | `1`        | Shows stack trace on errors during documentation generation. |
 
 These values can be set as standard environment variables or passed directly to the `rake` command.
 
-Setting `SIGNING_KEY_PEM` automatically generates a file at `$HOME/.gem/signing_key.pem` and sets the `SIGNING_KEY` variable accordingly.
-
 > [!NOTE]
 > `ASPERA_CLI_TEST_CONF_URL` is typically defined in your shell profile for development, while others are usually for ad-hoc command-line use.
 

data/bin/ascli

@@ -31,6 +31,6 @@ end
 
 require 'aspera/coverage'
 require 'aspera/environment'
-require 'aspera/cli/main'
+require 'aspera/cli/runner'
 Aspera::Environment.instance.fix_home
-Aspera::Cli::Main.new(ARGV).process_command_line
+Aspera::Cli::Runner.new(ARGV).run

data/lib/aspera/agent/direct.rb

@@ -294,7 +294,7 @@ module Aspera
           Log.log.debug{"before select, timeout: #{@spawn_timeout_sec}"}
           readable, _, _ = IO.select([mgt_server_socket], nil, nil, @spawn_timeout_sec)
           Log.log.debug('after select, before accept')
-          Aspera.assert(readable, type: Transfer::Error){'timeout waiting mgt port connect (select not readable)'}
+          Aspera.assert(readable, 'timeout waiting mgt port connect (select not readable)', type: Transfer::Error)
           # There is a connection to accept
           client_socket, _client_addrinfo = mgt_server_socket.accept
           Log.log.debug('after accept')

data/lib/aspera/agent/factory.rb

@@ -6,6 +6,10 @@ require 'aspera/environment'
 module Aspera
   module Agent
     # Factory for Agents
+    #
+    # @!method self.instance
+    #   Returns the singleton instance of Factory
+    #   @return [Factory] the singleton instance
     class Factory
       include Singleton
 

data/lib/aspera/agent/httpgw.rb

@@ -32,7 +32,7 @@ module Aspera
       # HTTP download only supports file list
       # :reek:UnusedParameters token_regenerator
       def start_transfer(transfer_spec, token_regenerator: nil)
-        Aspera.assert(!@gw_api.nil?){'GW URL must be set'}
+        Aspera.assert(!@gw_api.nil?, 'GW URL must be set')
         Aspera.assert_type(transfer_spec['paths'], Array){'paths'}
         Aspera.assert_type(transfer_spec['token'], String){'only token based transfer is supported in GW'}
         Log.dump(:user_spec, transfer_spec)

data/lib/aspera/agent/node.rb

@@ -30,7 +30,7 @@ module Aspera
         @root_id = root_id
         rest_params = {base_url: url}
         if OAuth::Factory.bearer_auth?(password)
-          Aspera.assert(!@root_id.nil?){'root_id not allowed for access key'}
+          Aspera.assert(!@root_id.nil?, 'root_id not allowed for access key')
           rest_params[:headers] = Api::Node.bearer_headers(password, access_key: username)
         else
           rest_params[:auth] = {
@@ -117,7 +117,7 @@ module Aspera
 
       # used internally to ensure node api is set before using.
       def node_api_
-        Aspera.assert(!@node_api.nil?){'Before using this object, set the node_api attribute to a Aspera::Rest object'}
+        Aspera.assert(!@node_api.nil?, 'Before using this object, set the node_api attribute to a Aspera::Rest object')
         return @node_api
       end
     end

data/lib/aspera/api/aoc.rb

@@ -113,8 +113,10 @@ module Aspera
           return client_key, DataRepository.instance.item(client_key)
         end
 
-        # base API url depends on domain, which could be "qa.xxx" or self-managed domain
-        def api_base_url(api_domain: SAAS_DOMAIN_PROD)
+        # Base API url depends on domain, which could be "qa.xxx" or self-managed domain
+        # @param api_domain [String] the AoC domain (e.g. "ibmaspera.com" (SAAS_DOMAIN_PROD) or a self-managed domain)
+        # @return [String] the base URL for the AoC API
+        def api_base_url(api_domain)
           return "https://api.#{api_domain}"
         end
 
@@ -197,7 +199,7 @@ module Aspera
         # @option return [Integer] :total The total number of items
         def call_paging(query: {})
           Aspera.assert_type(query, Hash){'query'}
-          Aspera.assert(block_given?)
+          Aspera.assert(block_given?, 'block required for call_paging')
           # set default large page if user does not specify own parameters. AoC Caps to 1000 anyway
           query['per_page'] = 1000 unless query.key?('per_page')
           max_items = query.delete(RestList::MAX_ITEMS)
@@ -211,7 +213,7 @@ module Aspera
             new_query = query.clone
             new_query['page'] = current_page
             result_data, result_http = yield(new_query)
-            Aspera.assert(result_http)
+            Aspera.assert(result_http, 'expected HTTP result from paging block')
             total_count = result_http[HEADER_X_TOTAL_COUNT]&.to_i
             page_count += 1
             current_page += 1
@@ -267,11 +269,12 @@ module Aspera
       attr_accessor :ws_ids
 
       # By default: no workspace
+      # @param
       def initialize(
         scope: nil,
         subpath: API_V1,
         secret_finder: nil,
-        # below: OAuth::AUTH_OPTIONS
+        # parameters below: OAuth::AUTH_OPTIONS
         url:,
         auth:,
         client_id: nil,
@@ -284,7 +287,14 @@ module Aspera
       )
         # Test here because link may set url
         Aspera.assert(url, 'Missing mandatory option: url', type: ParameterError)
-        Aspera.assert(scope, 'Missing mandatory option: scope', type: ParameterError)
+        # analyze type of url
+        url_info = self.class.link_info(url)
+        Log.dump(:url_info, url_info)
+        @private_link = url_info[:private_link]
+        Aspera.assert(auth, 'Missing mandatory option: auth', type: ParameterError) unless url_info.key?(:token)
+        # this is the base API url
+        api_url_base = self.class.api_base_url(url_info[:instance_domain])
+        Aspera.assert(scope, 'Missing mandatory option: scope', type: ParameterError) unless auth.eql?(:none)
         # default values for client id
         client_id, client_secret = self.class.get_client_info if client_id.nil?
         # access key secrets are provided out of band to get node api access
@@ -298,28 +308,21 @@ module Aspera
         # Used only for init: provided by user
         @ws_ids = {id: nil, name: nil}
         @home_info = nil
-        auth_params = {
-          type:   :oauth2,
-          params: {
-            client_id:     client_id,
-            client_secret: client_secret,
-            scope:         scope
+        base_args = {
+          base_url: "#{api_url_base}/#{subpath}",
+          auth:     {
+            type:         :oauth2,
+            grant_method: url_info.key?(:token) ? :url_json : auth,
+            base_url:     "#{api_url_base}/#{OAUTH_API_SUBPATH}/#{url_info[:organization]}",
+            params:       {
+              client_id:     client_id,
+              client_secret: client_secret,
+              scope:         scope
+            }
           }
         }
-        # analyze type of url
-        url_info = AoC.link_info(url)
-        Log.dump(:url_info, url_info)
-        @private_link = url_info[:private_link]
-        auth_params[:grant_method] = if url_info.key?(:token)
-          :url_json
-        else
-          Aspera.assert(auth, 'Missing mandatory option: auth', type: ParameterError)
-          auth
-        end
-        # this is the base API url
-        api_url_base = self.class.api_base_url(api_domain: url_info[:instance_domain])
-        # auth URL
-        auth_params[:base_url] = "#{api_url_base}/#{OAUTH_API_SUBPATH}/#{url_info[:organization]}"
+        # shortcut alias
+        auth_params = base_args[:auth]
         # fill other auth parameters based on OAuth method
         case auth_params[:grant_method]
         when :web
@@ -344,12 +347,16 @@ module Aspera
           auth_params[:json][:password] = password unless password.nil?
           # basic auth required for /token
           auth_params[:auth] = {type: :basic, username: client_id, password: client_secret}
-        else Aspera.error_unexpected_value(auth_params[:grant_method]){'auth, use one of: :web, :jwt'}
+        when :boot
+          # cookie is optional: if absent, existing cache is used
+          auth_params[:cookie] = password unless password.nil?
+          auth_params[:username] = username unless username.nil?
+        when :none
+          auth_params.clear
+          auth_params[:type] = :none
+        else Aspera.error_unexpected_value(auth_params[:grant_method]){'auth, use one of: web, jwt, boot'}
         end
-        super(
-          base_url: "#{api_url_base}/#{subpath}",
-          auth: auth_params
-          )
+        super(**base_args)
       end
 
       # Read using the query and paging
@@ -483,7 +490,7 @@ module Aspera
         ak_secret = @secret_finder&.lookup_secret(url: node_info['url'], username: node_info['access_key'])
         # If secret is available, or no scope, use basic auth
         if scope.nil? || ak_secret
-          Aspera.assert(ak_secret, "Secret not found for access key #{node_info['access_key']}@#{node_info['url']}", type: Error)
+          Aspera.assert(ak_secret, type: Error){"Secret not found for access key #{node_info['access_key']}@#{node_info['url']}"}
           node_params[:auth] = {
             type:     :basic,
             username: node_info['access_key'],
@@ -520,10 +527,10 @@ module Aspera
         Log.dump(:metadata, pkg_meta)
         pkg_meta.each do |field|
           Aspera.assert_type(field, Hash){'metadata field'}
-          Aspera.assert(field.key?('name')){'metadata field must have name'}
-          Aspera.assert(field.key?('values')){'metadata field must have values'}
+          Aspera.assert(field.key?('name'), 'metadata field must have name')
+          Aspera.assert(field.key?('values'), 'metadata field must have values')
           Aspera.assert_type(field['values'], Array){'metadata field values'}
-          Aspera.assert(!meta_schema.none?{ |i| i['name'].eql?(field['name'])}){"unknown metadata field: #{field['name']}"}
+          Aspera.assert(meta_schema.any?{ |i| i['name'].eql?(field['name'])}){"unknown metadata field: #{field['name']}"}
         end
         meta_schema.each do |field|
           provided = pkg_meta.select{ |i| i['name'].eql?(field['name'])}
@@ -749,7 +756,7 @@ module Aspera
       # @param types [Array] event types
       def permissions_send_event(event_data:, app_info:, types: PERMISSIONS_CREATED)
         Aspera.assert_type(types, Array)
-        Aspera.assert(!types.empty?)
+        Aspera.assert(!types.empty?, 'types must not be empty')
         event_creation = {
           'types'        => types,
           'node_id'      => app_info.node_info['id'],

data/lib/aspera/api/cos_node.rb

@@ -63,7 +63,7 @@ module Aspera
         ats_info = XmlSimple.xml_in(xml_result_text, {'ForceArray' => false})
         Log.dump(:ats_info, ats_info)
         Aspera.assert_hash_all(ats_info, String, nil){'ats_info'}
-        Aspera.assert((FASP_INFO_KEYS - ats_info.keys).empty?){'ats_info missing required keys'}
+        Aspera.assert((FASP_INFO_KEYS - ats_info.keys).empty?, 'ats_info missing required keys')
         Aspera.assert_hash_all(ats_info['AccessKey'], String, String){'ats_info'}
         @storage_credentials = {
           'type'  => 'token',

data/lib/aspera/api/faspex.rb

@@ -45,7 +45,7 @@ module Aspera
       info = Rest.query_to_h(URI.parse(http['Location']).query)
       Log.dump(:info, info)
       raise Error, info['action_message'] if info['action_message']
-      Aspera.assert(info['code']){'Missing code in answer'}
+      Aspera.assert(info['code'], 'Missing code in answer')
       # Exchange code for token
       return create_token_call(base_params.merge(
         grant_type:   'authorization_code',
@@ -87,6 +87,7 @@ module Aspera
         email_notifications
         alternate_addresses
         webhooks
+        file_processing
       ].freeze
       # states for jobs not in final state
       JOB_RUNNING = %w[queued working].freeze
@@ -193,15 +194,15 @@ module Aspera
             }
           # old: headers:  {'Passcode' => @pub_link_context['passcode']}
           when :boot
-            Aspera.assert(password, type: ParameterError){'Missing password'}
+            Aspera.assert(password, 'Missing password', type: ParameterError)
             # the password here is the token copied directly from browser in developer mode
             {
               base_url: "#{url}/#{root}",
               headers:  {'Authorization' => password}
             }
           when :web
-            Aspera.assert(client_id, type: ParameterError){'Missing client_id'}
-            Aspera.assert(redirect_uri, type: ParameterError){'Missing redirect_uri'}
+            Aspera.assert(client_id, 'Missing client_id', type: ParameterError)
+            Aspera.assert(redirect_uri, 'Missing redirect_uri', type: ParameterError)
             # opens a browser and ask user to auth using web
             {
               base_url: "#{url}/#{root}",
@@ -216,8 +217,8 @@ module Aspera
               }
             }
           when :jwt
-            Aspera.assert(client_id, type: ParameterError){'Missing client_id'}
-            Aspera.assert(private_key, type: ParameterError){'Missing private_key'}
+            Aspera.assert(client_id, 'Missing client_id', type: ParameterError)
+            Aspera.assert(private_key, 'Missing private_key', type: ParameterError)
             {
               base_url: "#{url}/#{root}",
               auth:     {

data/lib/aspera/api/node.rb

@@ -174,9 +174,9 @@ module Aspera
         # @param private_key [OpenSSL::PKey::RSA] Private key to sign the token
         def bearer_token(access_key:, payload:, private_key:)
           Aspera.assert_type(payload, Hash)
-          Aspera.assert(payload.key?('user_id'))
+          Aspera.assert(payload.key?('user_id'), 'payload must have user_id')
           Aspera.assert_type(payload['user_id'], String)
-          Aspera.assert(!payload['user_id'].empty?)
+          Aspera.assert(!payload['user_id'].empty?, 'user_id must not be empty')
           Aspera.assert_type(private_key, OpenSSL::PKey::RSA)
           # Manage convenience parameters
           expiration_sec = payload['_validity'] || BEARER_TOKEN_VALIDITY_DEFAULT
@@ -205,7 +205,7 @@ module Aspera
           # If username is not provided, use the access key from the token
           if access_key.nil?
             access_key = Node.decode_scope(Node.decode_bearer_token(OAuth::Factory.bearer_token(bearer_auth))['scope'])[:access_key]
-            Aspera.assert(!access_key.nil?)
+            Aspera.assert(!access_key.nil?, 'access_key could not be determined from token')
           end
           return {
             HEADER_X_ASPERA_ACCESS_KEY => access_key,
@@ -337,7 +337,7 @@ module Aspera
       # @param top_file_path [String] path of top folder (default = /)
       # @para query [Hash, nil] optional query for `read`
       def process_folder_tree(method_sym:, state:, top_file_id:, top_file_path: '/', query: nil)
-        Aspera.assert(!top_file_path.nil?){'top_file_path not set'}
+        Aspera.assert(!top_file_path.nil?, 'top_file_path not set')
         Log.log.debug{"process_folder_tree: node=#{@app_info ? @app_info.node_info['id'] : 'nil'}, file id=#{top_file_id},  path=#{top_file_path}"}
         # Start at top folder
         folders_to_explore = [{id: top_file_id, path: top_file_path}]
@@ -405,7 +405,7 @@ module Aspera
       #     - 'destination' [String]: Destination path (optional)
       def resolve_api_fid_paths(top_file_id, paths)
         Aspera.assert_type(paths, Array)
-        Aspera.assert(paths.size.positive?)
+        Aspera.assert(paths.size.positive?, 'paths must not be empty')
         split_sources = paths.map{ |p| Pathname(p['source']).each_filename.to_a}
         root = []
         split_sources.map(&:size).min.times do |i|
@@ -490,7 +490,7 @@ module Aspera
         case auth_params[:type]
         when :basic
           ak_name = auth_params[:username]
-          Aspera.assert(auth_params[:password]){'no secret in node object'}
+          Aspera.assert(auth_params[:password], 'no secret in node object')
           ak_token = Rest.basic_authorization(auth_params[:username], auth_params[:password])
         when :oauth2
           ak_name = params[:headers][HEADER_X_ASPERA_ACCESS_KEY]
@@ -551,7 +551,7 @@ module Aspera
       def read_with_paging(subpath, query = nil, iteration: nil, **call_args)
         Aspera.assert_type(iteration, Array, NilClass){'iteration'}
         Aspera.assert_type(query, Hash, NilClass){'query'}
-        Aspera.assert(!call_args.key?(:query))
+        Aspera.assert(!call_args.key?(:query), ':query must not be in call_args (use query parameter)')
         query = {} if query.nil?
         query[:iteration_token] = iteration[0] unless iteration.nil? || iteration[0].nil?
         max = query.delete(RestList::MAX_ITEMS)

data/lib/aspera/ascmd.rb

@@ -129,10 +129,10 @@ module Aspera
       Log.log.trace1{"execute_single:#{stdin_input}"}
       # execute, get binary output
       byte_buffer = @command_executor.execute(remote_cmd, input: stdin_input).unpack('C*')
-      Aspera.assert(!byte_buffer.empty?){'empty answer from server'}
+      Aspera.assert(!byte_buffer.empty?, 'empty answer from server')
       # get hash or table result
       result = self.class.parse(byte_buffer, :result)
-      Aspera.assert(byte_buffer.empty?){'unparsed bytes remaining'}
+      Aspera.assert(byte_buffer.empty?, 'unparsed bytes remaining')
       # get and delete info,always present in results
       system_info = result[:info]
       result.delete(:info)
@@ -187,7 +187,7 @@ module Aspera
         case type_descr[:decode]
         when :base
           num_bytes = type_name.eql?(:zstr) ? buffer.length : type_descr[:size]
-          Aspera.assert(buffer.length >= num_bytes){'not enough bytes'}
+          Aspera.assert(buffer.length >= num_bytes, 'not enough bytes')
           byte_array = buffer.shift(num_bytes)
           byte_array = [byte_array] unless byte_array.is_a?(Array)
           result = byte_array.pack('C*').unpack1(type_descr[:unpack])
@@ -200,7 +200,7 @@ module Aspera
           until buffer.empty?
             btype = parse(buffer, :int8, indent_level)
             length = parse(buffer, :int32, indent_level)
-            Aspera.assert(buffer.length >= length){'not enough bytes'}
+            Aspera.assert(buffer.length >= length, 'not enough bytes')
             value = buffer.shift(length)
             result.push({btype: btype, buffer: value})
             Log.log.trace1{"#{'   .' * indent_level}:buffer_list[#{result.length - 1}] #{result.last}"}

data/lib/aspera/ascp/installation.rb

@@ -27,6 +27,10 @@ module Aspera
     # It is used by object : AgentDirect to find necessary resources
     # By default it takes the first Aspera product found
     # The user can specify `ascp` location by calling: `sdk_folder=` method
+    #
+    # @!method self.instance
+    #   Returns the singleton instance of Installation
+    #   @return [Installation] the singleton instance
     class Installation
       include Singleton
 
@@ -57,7 +61,7 @@ module Aspera
       # - "product:FIRST" to use ascp from first found product
       def sdk_folder=(ascp_location)
         Aspera.assert_type(ascp_location, String){'ascp_location'}
-        Aspera.assert(!ascp_location.empty?){'ascp location cannot be empty: check your config file'}
+        Aspera.assert(!ascp_location.empty?, 'ascp location cannot be empty: check your config file')
         folder =
           if ascp_location.start_with?(USE_PRODUCT_PREFIX)
             product_name = ascp_location.delete_prefix(USE_PRODUCT_PREFIX)
@@ -247,7 +251,7 @@ module Aspera
       # @yieldparam entry_stream [IO, Gem::Package::TarReader::Entry] Data stream
       # @yieldparam link_target [String, nil] Link target if symlink, nil otherwise
       def extract_archive_files(sdk_archive_path)
-        Aspera.assert(block_given?){'missing block'}
+        Aspera.assert(block_given?, 'missing block')
         case sdk_archive_path
         # Windows and Mac use zip
         when /\.zip$/

data/lib/aspera/cli/context.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'aspera/assert'
+
+module Aspera
+  module Cli
+    # Global objects shared with plugins
+    class Context
+      # @type [Array<Symbol>]
+      MEMBERS = %i[options transfer config formatter persistency man_header presets http_config].freeze
+      # @!attribute [rw] options
+      #   @return [Manager] the command line options manager
+      # @!attribute [rw] transfer
+      #   @return [TransferAgent] the transfer agent, used by transfer plugins
+      # @!attribute [rw] config
+      #   @return [Plugins::Config] the configuration plugin, used by plugins to get configuration values and presets
+      # @!attribute [rw] formatter
+      #   @return [Formatter] the formatter, used by plugins to display results and messages
+      # @!attribute [rw] persistency
+      #   @return [Object] # whatever the type is
+      # @!attribute [rw] man_header
+      #   @return [Boolean] whether to display the manual header in plugin help
+      # @!attribute [rw] presets
+      #   @return [PresetManager] manages the YAML config file and preset resolution
+      # @!attribute [rw] http_config
+      #   @return [Http] manages HTTP/S and TLS runtime options
+      attr_accessor(*MEMBERS)
+
+      # Initialize all members to nil, so that they are defined and can be validated later
+      # @return [nil]
+      def initialize
+        MEMBERS.each{ |i| instance_variable_set(:"@#{i}", nil)}
+      end
+
+      # Validate that all members are set, raise exception if not
+      # @raise [Aspera::AssertionError] if any member is not set
+      # @return [nil]
+      def validate
+        MEMBERS.each do |i|
+          Aspera.assert(instance_variable_defined?(:"@#{i}")){"context member @#{i} is not defined"}
+          Aspera.assert(!instance_variable_get(:"@#{i}").nil?){"context member @#{i} is nil"}
+        end
+      end
+
+      # Check if the context is in manual-only mode
+      # @return [Boolean] true if in manual-only mode
+      def only_manual?
+        transfer.eql?(:only_manual)
+      end
+
+      # Set the context to manual-only mode
+      # @return [Symbol] :only_manual
+      def only_manual!
+        @transfer = :only_manual
+      end
+    end
+  end
+end

data/lib/aspera/cli/extended_value.rb

@@ -86,6 +86,7 @@ module Aspera
         # Base handlers
         # Other handlers can be set using `on`
         # e.g. `preset` is reader in config plugin
+        # @type [Hash{Symbol => Proc}]
         @handlers = {
           val:    lambda{ |i| i},
           base64: lambda{ |i| Base64.decode64(i)},
@@ -100,7 +101,7 @@ module Aspera
           path:   lambda{ |i| File.expand_path(i)},
           re:     lambda{ |i| Regexp.new(i, Regexp::MULTILINE)},
           ruby:   lambda{ |i| Environment.secure_eval(i, __FILE__, __LINE__)},
-          s:      lambda{ |i| i.to_s},
+          s:      lambda(&:to_s),
           secret: lambda{ |i| prompt = i.empty? ? 'secret' : i; $stdin.getpass("#{prompt}> ")}, # rubocop:disable Style/Semicolon
           stdin:  lambda{ |i| ExtendedValue.read_stdin(i)},
           yaml:   lambda{ |i| YAML.load(i)},
@@ -137,7 +138,7 @@ module Aspera
       # Add a new handler
       def on(name, &block)
         Aspera.assert_type(name, Symbol){'name'}
-        Aspera.assert(block)
+        Aspera.assert(block){"block required when registering handler for #{name}"}
         Log.log.debug{"Setting handler for #{name}"}
         @handlers[name] = block
         update_regex