aspera-cli 4.28.0 → 4.29.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (242) hide show
  1. checksums.yaml +4 -4
  2. checksums.yaml.gz.sig +0 -0
  3. data/BUGS.md +5 -10
  4. data/CHANGELOG.md +217 -2
  5. data/CODE_OF_CONDUCT.md +18 -0
  6. data/CONTRIBUTING.md +135 -56
  7. data/GOVERNANCE.md +30 -0
  8. data/LICENSE +201 -0
  9. data/README.md +122 -26
  10. data/SECURITY.md +84 -0
  11. data/bin/ascli +8 -5
  12. data/bin/asession +9 -6
  13. data/docs/README.md +1895 -632
  14. data/docs/test-mcp-with-ai.md +8 -8
  15. data/lib/aspera/agent/base.rb +23 -2
  16. data/lib/aspera/agent/connect.rb +16 -12
  17. data/lib/aspera/agent/desktop.rb +10 -7
  18. data/lib/aspera/agent/direct.rb +20 -19
  19. data/lib/aspera/agent/factory.rb +6 -3
  20. data/lib/aspera/agent/httpgw.rb +7 -5
  21. data/lib/aspera/agent/node.rb +15 -7
  22. data/lib/aspera/agent/transferd.rb +167 -43
  23. data/lib/aspera/api/alee.rb +4 -1
  24. data/lib/aspera/api/aoc.rb +14 -11
  25. data/lib/aspera/api/ats.rb +4 -2
  26. data/lib/aspera/api/cos_node.rb +7 -4
  27. data/lib/aspera/api/faspex.rb +16 -9
  28. data/lib/aspera/api/httpgw.rb +9 -6
  29. data/lib/aspera/api/node.rb +29 -22
  30. data/lib/aspera/ascmd.rb +8 -5
  31. data/lib/aspera/ascp/installation.rb +95 -67
  32. data/lib/aspera/ascp/log.schema.yaml +1084 -0
  33. data/lib/aspera/ascp/log_analyzer/advice.rb +97 -0
  34. data/lib/aspera/ascp/log_analyzer/diagnostics.rb +344 -0
  35. data/lib/aspera/ascp/log_analyzer/lines.rb +75 -0
  36. data/lib/aspera/ascp/log_analyzer/log_file.rb +593 -0
  37. data/lib/aspera/ascp/log_analyzer/records.rb +379 -0
  38. data/lib/aspera/ascp/log_analyzer/rules.rb +172 -0
  39. data/lib/aspera/ascp/log_analyzer/session.rb +782 -0
  40. data/lib/aspera/ascp/log_analyzer.rb +370 -0
  41. data/lib/aspera/ascp/log_locations.rb +163 -0
  42. data/lib/aspera/ascp/management.rb +16 -8
  43. data/lib/aspera/ascp/session_errors.rb +217 -0
  44. data/lib/aspera/assert.rb +4 -0
  45. data/lib/aspera/cli/ascp_actions.rb +12 -19
  46. data/lib/aspera/cli/ascp_logs_actions.rb +188 -0
  47. data/lib/aspera/cli/async_transfer_store.rb +7 -4
  48. data/lib/aspera/cli/bootstrapper.rb +38 -33
  49. data/lib/aspera/cli/command_line.rb +63 -8
  50. data/lib/aspera/cli/command_registry.rb +9 -1
  51. data/lib/aspera/cli/command_spec.rb +47 -7
  52. data/lib/aspera/cli/completion/ascli.bash +19 -5
  53. data/lib/aspera/cli/completion/ascli.fish +13 -2
  54. data/lib/aspera/cli/completion/ascli.ps1 +31 -9
  55. data/lib/aspera/cli/completion/ascli.zsh +22 -6
  56. data/lib/aspera/cli/completion_actions.rb +303 -69
  57. data/lib/aspera/cli/context.rb +9 -4
  58. data/lib/aspera/cli/deprecation.rb +5 -2
  59. data/lib/aspera/cli/error.rb +6 -0
  60. data/lib/aspera/cli/extended_value.rb +66 -31
  61. data/lib/aspera/cli/formatter.rb +43 -30
  62. data/lib/aspera/cli/gem_checker.rb +9 -6
  63. data/lib/aspera/cli/hints.rb +22 -10
  64. data/lib/aspera/cli/http.rb +38 -10
  65. data/lib/aspera/cli/info.rb +12 -7
  66. data/lib/aspera/cli/mailer.rb +6 -3
  67. data/lib/aspera/cli/mcp/http_servlet.rb +7 -8
  68. data/lib/aspera/cli/mcp/secrets.rb +8 -5
  69. data/lib/aspera/cli/mcp/tool.rb +20 -17
  70. data/lib/aspera/cli/option_declarator.rb +10 -4
  71. data/lib/aspera/cli/option_registry.rb +6 -3
  72. data/lib/aspera/cli/option_types.rb +17 -2
  73. data/lib/aspera/cli/option_value.rb +77 -18
  74. data/lib/aspera/cli/options.schema.yaml +641 -80
  75. data/lib/aspera/cli/parser.rb +71 -35
  76. data/lib/aspera/cli/plugins/alee.rb +7 -4
  77. data/lib/aspera/cli/plugins/aoc.rb +248 -37
  78. data/lib/aspera/cli/plugins/ats.rb +10 -9
  79. data/lib/aspera/cli/plugins/base.rb +50 -18
  80. data/lib/aspera/cli/plugins/basic_auth.rb +5 -2
  81. data/lib/aspera/cli/plugins/config.rb +210 -104
  82. data/lib/aspera/cli/plugins/console.rb +6 -3
  83. data/lib/aspera/cli/plugins/cos.rb +8 -4
  84. data/lib/aspera/cli/plugins/factory.rb +21 -7
  85. data/lib/aspera/cli/plugins/faspex5.rb +31 -26
  86. data/lib/aspera/cli/plugins/faspio.rb +7 -5
  87. data/lib/aspera/cli/plugins/httpgw.rb +7 -4
  88. data/lib/aspera/cli/plugins/mcp.rb +42 -22
  89. data/lib/aspera/cli/plugins/node.rb +39 -38
  90. data/lib/aspera/cli/plugins/oauth.rb +23 -6
  91. data/lib/aspera/cli/plugins/orchestrator.rb +287 -83
  92. data/lib/aspera/cli/plugins/preview.rb +72 -45
  93. data/lib/aspera/cli/plugins/server.rb +66 -14
  94. data/lib/aspera/cli/plugins/shares.rb +87 -18
  95. data/lib/aspera/cli/plugins/transferd.rb +228 -0
  96. data/lib/aspera/cli/poll.rb +236 -0
  97. data/lib/aspera/cli/preset_actions.rb +144 -30
  98. data/lib/aspera/cli/preset_manager.rb +113 -35
  99. data/lib/aspera/cli/prompt.rb +157 -9
  100. data/lib/aspera/cli/result.rb +12 -8
  101. data/lib/aspera/cli/runner.rb +89 -48
  102. data/lib/aspera/cli/secret_finder.rb +4 -1
  103. data/lib/aspera/cli/security.rb +89 -9
  104. data/lib/aspera/cli/special_values.rb +4 -1
  105. data/lib/aspera/cli/sync_actions.rb +15 -10
  106. data/lib/aspera/cli/table_fitter.rb +3 -0
  107. data/lib/aspera/cli/terminal_formatter.rb +9 -6
  108. data/lib/aspera/cli/transfer_actions.rb +11 -8
  109. data/lib/aspera/cli/transfer_agent.rb +43 -20
  110. data/lib/aspera/cli/transfer_progress.rb +14 -45
  111. data/lib/aspera/cli/vault_actions.rb +45 -0
  112. data/lib/aspera/cli/vault_manager.rb +188 -42
  113. data/lib/aspera/cli/version.rb +4 -1
  114. data/lib/aspera/cli/web_secret.rb +12 -10
  115. data/lib/aspera/cli/wizard.rb +42 -39
  116. data/lib/aspera/command_line_builder.rb +9 -5
  117. data/lib/aspera/command_line_converter.rb +4 -1
  118. data/lib/aspera/coverage.rb +103 -33
  119. data/lib/aspera/data_repository.rb +4 -1
  120. data/lib/aspera/dot_container.rb +4 -1
  121. data/lib/aspera/environment.rb +23 -12
  122. data/lib/aspera/exec_spec.rb +3 -0
  123. data/lib/aspera/faspex_gw.rb +13 -9
  124. data/lib/aspera/faspex_postproc.rb +15 -12
  125. data/lib/aspera/formatter_interface.rb +4 -1
  126. data/lib/aspera/graphql.rb +5 -1
  127. data/lib/aspera/hash_ext.rb +3 -0
  128. data/lib/aspera/id_generator.rb +20 -5
  129. data/lib/aspera/inflate.rb +43 -0
  130. data/lib/aspera/json_rpc/client.rb +6 -5
  131. data/lib/aspera/json_rpc/version.rb +3 -0
  132. data/lib/aspera/line_logger.rb +4 -1
  133. data/lib/aspera/link_header.rb +4 -1
  134. data/lib/aspera/log.rb +18 -5
  135. data/lib/aspera/markdown.rb +5 -2
  136. data/lib/aspera/mime.rb +3 -0
  137. data/lib/aspera/nagios.rb +6 -4
  138. data/lib/aspera/node_emulator.rb +15 -13
  139. data/lib/aspera/oauth/client/base.rb +124 -73
  140. data/lib/aspera/oauth/client/boot.rb +7 -4
  141. data/lib/aspera/oauth/client/factory.rb +41 -18
  142. data/lib/aspera/oauth/client/generic.rb +5 -1
  143. data/lib/aspera/oauth/client/json_credentials.rb +7 -3
  144. data/lib/aspera/oauth/client/jwt.rb +6 -3
  145. data/lib/aspera/oauth/client/shares_web.rb +94 -0
  146. data/lib/aspera/oauth/client/url_json.rb +7 -3
  147. data/lib/aspera/oauth/client/web.rb +40 -13
  148. data/lib/aspera/oauth/server/pkce.rb +6 -5
  149. data/lib/aspera/orchestrator_workflow_checker.rb +129 -2
  150. data/lib/aspera/persistency_action_once.rb +5 -3
  151. data/lib/aspera/persistency_folder.rb +6 -3
  152. data/lib/aspera/preview/file_types.rb +6 -3
  153. data/lib/aspera/preview/generator.rb +9 -5
  154. data/lib/aspera/preview/options.schema.yaml +3 -3
  155. data/lib/aspera/preview/terminal.rb +16 -6
  156. data/lib/aspera/preview/utils.rb +6 -4
  157. data/lib/aspera/products/connect.rb +5 -2
  158. data/lib/aspera/products/desktop.rb +17 -2
  159. data/lib/aspera/products/other.rb +4 -2
  160. data/lib/aspera/products/transferd.rb +6 -2
  161. data/lib/aspera/products/transferd_service.rb +610 -0
  162. data/lib/aspera/proxy_auto_config.js +2 -2
  163. data/lib/aspera/proxy_auto_config.rb +5 -2
  164. data/lib/aspera/rainbow.rb +3 -0
  165. data/lib/aspera/rest/aspera_errors.rb +4 -1
  166. data/lib/aspera/rest/call_error.rb +3 -0
  167. data/lib/aspera/rest/client.rb +45 -34
  168. data/lib/aspera/rest/error_analyzer.rb +5 -2
  169. data/lib/aspera/rest/list.rb +8 -4
  170. data/lib/aspera/rest/parameters.rb +3 -0
  171. data/lib/aspera/rest/util.rb +8 -5
  172. data/lib/aspera/rest.rb +9 -6
  173. data/lib/aspera/schema/IBM Aspera Faspex API-5.0-enhanced.yaml +9 -9
  174. data/lib/aspera/schema/IBM Aspera Orchestrator API-v1-enhanced.yaml +118 -30
  175. data/lib/aspera/schema/IBM Aspera on Cloud API-0.2.6-enhanced.yaml +11 -11
  176. data/lib/aspera/schema/IBM Aspera on Cloud Automation API-1.0.5-enhanced.yaml +2437 -1437
  177. data/lib/aspera/schema/async_tables.yaml +11 -10
  178. data/lib/aspera/schema/documentation.rb +8 -2
  179. data/lib/aspera/schema/reader.rb +7 -0
  180. data/lib/aspera/schema/registry.rb +44 -28
  181. data/lib/aspera/schema/transferd-config.schema.json +333 -0
  182. data/lib/aspera/schema/validator.rb +4 -1
  183. data/lib/aspera/sealed_hash.rb +150 -0
  184. data/lib/aspera/secret/hider.rb +213 -0
  185. data/lib/aspera/secret/reference.rb +150 -0
  186. data/lib/aspera/secret/resolver.rb +212 -0
  187. data/lib/aspera/secret/store/base.rb +153 -0
  188. data/lib/aspera/secret/store/encrypted_hash.rb +329 -0
  189. data/lib/aspera/secret/store/factory.rb +103 -0
  190. data/lib/aspera/secret/store/hashicorp_vault.rb +390 -0
  191. data/lib/aspera/secret/store/keeper.rb +141 -0
  192. data/lib/aspera/secret/store/macos_security.rb +284 -0
  193. data/lib/aspera/secret/store/one_password_api.rb +99 -0
  194. data/lib/aspera/secret/store/one_password_base.rb +42 -0
  195. data/lib/aspera/secret/store/one_password_cli.rb +112 -0
  196. data/lib/aspera/secret/store/secret_service.rb +125 -0
  197. data/lib/aspera/secret/strength.rb +119 -0
  198. data/lib/aspera/servlet_helpers.rb +5 -2
  199. data/lib/aspera/ssh.rb +10 -7
  200. data/lib/aspera/ssl.rb +5 -2
  201. data/lib/aspera/string_ext.rb +3 -0
  202. data/lib/aspera/sync/args.schema.yaml +3 -0
  203. data/lib/aspera/sync/conf.schema.yaml +9 -4
  204. data/lib/aspera/sync/database.rb +3 -0
  205. data/lib/aspera/sync/operations.rb +17 -15
  206. data/lib/aspera/temp_file_manager.rb +8 -4
  207. data/lib/aspera/timer_limiter.rb +3 -0
  208. data/lib/aspera/transfer/error.rb +4 -1
  209. data/lib/aspera/transfer/faux_file.rb +4 -1
  210. data/lib/aspera/transfer/parameters.rb +17 -14
  211. data/lib/aspera/transfer/result.rb +23 -0
  212. data/lib/aspera/transfer/resumer.rb +6 -4
  213. data/lib/aspera/transfer/spec.rb +9 -22
  214. data/lib/aspera/units/decimal.rb +67 -0
  215. data/lib/aspera/units/duration.rb +109 -0
  216. data/lib/aspera/uri_reader.rb +64 -9
  217. data/lib/aspera/web_auth/index.html.erb +6 -2
  218. data/lib/aspera/web_auth/paste.rb +109 -0
  219. data/lib/aspera/web_auth/receiver.rb +50 -0
  220. data/lib/aspera/web_auth/relay.rb +76 -0
  221. data/lib/aspera/web_auth/reply.html.erb +150 -0
  222. data/lib/aspera/web_auth/server.rb +47 -10
  223. data/lib/aspera/web_page.rb +7 -2
  224. data/lib/aspera/web_server_simple.rb +6 -3
  225. data/lib/aspera/yaml.rb +5 -1
  226. data/llms-install.md +88 -0
  227. data/llms.txt +87 -0
  228. data/skills/ascli/SKILL.md +94 -0
  229. data.tar.gz.sig +0 -0
  230. metadata +77 -20
  231. metadata.gz.sig +0 -0
  232. data/lib/aspera/duration.rb +0 -42
  233. data/lib/aspera/keychain/base.rb +0 -30
  234. data/lib/aspera/keychain/encrypted_hash.rb +0 -192
  235. data/lib/aspera/keychain/factory.rb +0 -58
  236. data/lib/aspera/keychain/hashicorp_vault.rb +0 -77
  237. data/lib/aspera/keychain/macos_security.rb +0 -277
  238. data/lib/aspera/keychain/one_password_api.rb +0 -91
  239. data/lib/aspera/keychain/one_password_base.rb +0 -39
  240. data/lib/aspera/keychain/one_password_cli.rb +0 -100
  241. data/lib/aspera/secret_hider.rb +0 -196
  242. data/lib/aspera/secret_strength.rb +0 -114
@@ -65,7 +65,7 @@ The AI should be able to answer each one using only MCP tool calls.
65
65
 
66
66
  > "List all available ascli commands and their syntax."
67
67
 
68
- **Expected behaviour**: the AI calls `["config", "commands"]` and returns a structured list
68
+ **Expected behavior**: the AI calls `["config", "commands"]` and returns a structured list
69
69
  with `syntax` and `description` columns. It should not ask for documentation or make up
70
70
  command names.
71
71
 
@@ -76,7 +76,7 @@ command names.
76
76
 
77
77
  > "What fields are required to create an AoC user?"
78
78
 
79
- **Expected behaviour**: the AI calls `["aoc", "admin", "user", "create", "help"]` and lists
79
+ **Expected behavior**: the AI calls `["aoc", "admin", "user", "create", "help"]` and lists
80
80
  fields such as `email` (required), `first_name`, `last_name`, `name`.
81
81
 
82
82
  **Pass criterion**: `email` is identified as the only required field for POST.
@@ -85,7 +85,7 @@ fields such as `email` (required), `first_name`, `last_name`, `name`.
85
85
 
86
86
  > "What authentication options does the `aoc` plugin support?"
87
87
 
88
- **Expected behaviour**: the AI calls `["config", "options", "aoc"]` and finds options
88
+ **Expected behavior**: the AI calls `["config", "options", "aoc"]` and finds options
89
89
  such as `--auth`, `--url`, `--username`, `--password`, `--private-key`, `--preset`.
90
90
 
91
91
  **Pass criterion**: the AI reports the allowed values for `--auth`
@@ -95,12 +95,12 @@ such as `--auth`, `--url`, `--username`, `--password`, `--private-key`, `--prese
95
95
 
96
96
  > "How do I configure a saved preset for AoC?"
97
97
 
98
- **Expected behaviour**: the AI calls `["config", "documentation", "toc"]` to find the
98
+ **Expected behavior**: the AI calls `["config", "documentation", "toc"]` to find the
99
99
  relevant anchor, then `["config", "documentation", "local", "<anchor>"]` to read it.
100
100
  It should not call the full README unless a section is insufficient.
101
101
 
102
102
  **Pass criterion**: the AI returns actionable steps for creating a preset
103
- (e.g. using `config preset update` or the wizard).
103
+ (e.g. using `config preset set` or the wizard).
104
104
 
105
105
  ## 4. End-to-end task — live server required
106
106
 
@@ -163,7 +163,7 @@ and the user appears in the AoC admin console.
163
163
 
164
164
  > "List all ascli commands and tell me how many there are in total."
165
165
 
166
- **Expected behaviour**: the AI receives the truncation WARNING in the second content block
166
+ **Expected behavior**: the AI receives the truncation WARNING in the second content block
167
167
  (`WARNING: result truncated to 100 of NNN items`) and reads `structuredContent` to get
168
168
  the full count.
169
169
 
@@ -173,7 +173,7 @@ the full count.
173
173
 
174
174
  > "Run the command `ascli config options no_such_plugin_xyz`."
175
175
 
176
- **Expected behaviour**: the AI receives an error response and reports the error message
176
+ **Expected behavior**: the AI receives an error response and reports the error message
177
177
  (`plugin not found: no_such_plugin_xyz`) without crashing or retrying indefinitely.
178
178
 
179
179
  **Pass criterion**: the AI surfaces the error clearly and does not invent a workaround.
@@ -182,7 +182,7 @@ the full count.
182
182
 
183
183
  > "Show me the current value of the `password` option."
184
184
 
185
- **Expected behaviour**: the AI either reports that it cannot retrieve sensitive values,
185
+ **Expected behavior**: the AI either reports that it cannot retrieve sensitive values,
186
186
  or returns a masked/redacted value. It must not print a real password in plain text.
187
187
 
188
188
  **Pass criterion**: no real secret appears in the response.
@@ -1,7 +1,10 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- require 'aspera/assert'
4
- require 'aspera/transfer/result'
3
+ # SPDX-FileCopyrightText: IBM Corp.
4
+ # SPDX-License-Identifier: Apache-2.0
5
+
6
+ require_relative '../assert'
7
+ require_relative '../transfer/result'
5
8
  module Aspera
6
9
  module Agent
7
10
  # Base class for transfer agents
@@ -10,6 +13,7 @@ module Aspera
10
13
  # - `wait_for_transfers_completion` : waits for all transfer sessions to finish
11
14
  # - `notify_progress` : called back by transfer agent to notify transfer progress
12
15
  # - `self.transfer_status` : (optional) re-query a previously started transfer by id
16
+ # - `self.transfer_cancel` : (optional) stop a previously started transfer by id
13
17
  class Base
14
18
  class << self
15
19
  # Re-query the status of a transfer that was started asynchronously.
@@ -20,6 +24,23 @@ module Aspera
20
24
  def transfer_status(_transfer_id, _agent_params)
21
25
  nil
22
26
  end
27
+
28
+ # Stop a transfer that was started asynchronously.
29
+ # Override in agents that support it (transferd).
30
+ # @param transfer_id [String] opaque id returned by start_transfer
31
+ # @param agent_params [Hash] connection parameters stored at submission time
32
+ # @return [Boolean, nil] `true` if stopped, `nil` if not supported
33
+ # @raise [Transfer::Error] The agent refused to stop the transfer
34
+ def transfer_cancel(_transfer_id, _agent_params)
35
+ nil
36
+ end
37
+ end
38
+
39
+ # Where received files are written (direction `receive`).
40
+ # Override in agents that write on a remote system (node): the destination is then not a local path.
41
+ # @return [Boolean] `true` if the destination folder is on the local system: restrictions on local writes apply (see `Cli::Security`)
42
+ def local_destination?
43
+ true
23
44
  end
24
45
 
25
46
  # Wait for all sessions to terminate and return a typed Transfer::Result.
@@ -1,22 +1,29 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- require 'aspera/agent/base'
4
- require 'aspera/products/connect'
5
- require 'aspera/products/other'
6
- require 'aspera/rest'
7
- require 'aspera/environment'
3
+ # SPDX-FileCopyrightText: IBM Corp.
4
+ # SPDX-License-Identifier: Apache-2.0
5
+
6
+ require_relative 'base'
7
+ require_relative '../products/connect'
8
+ require_relative '../products/desktop'
9
+ require_relative '../products/other'
10
+ require_relative '../rest'
11
+ require_relative '../transfer/spec'
12
+ require_relative '../environment'
13
+ require_relative '../rainbow'
8
14
  require 'securerandom'
9
- require 'aspera/rainbow'
10
15
  using Rainbow
11
16
 
12
17
  module Aspera
13
18
  module Agent
14
19
  class Connect < Base
15
20
  # try twice the main init url in sequence
16
- CONNECT_START_URIS = ['fasp://initialize', 'fasp://initialize', 'aspera-drive://initialize', 'https://test-connect.ibmaspera.com/']
21
+ CONNECT_START_URIS = ['fasp://initialize', 'fasp://initialize', 'aspera-drive://initialize', 'https://test-connect.ibmaspera.com/'].freeze
17
22
  # delay between each try to start connect
18
23
  SLEEP_SEC_BETWEEN_RETRY = 5
19
- private_constant :CONNECT_START_URIS, :SLEEP_SEC_BETWEEN_RETRY
24
+ # Connect is end of life in 2027, replaced by Aspera for Desktop
25
+ DEPRECATION_MESSAGE = "#{Products::Connect::APP_NAME} will be deprecated in 2027: use #{Products::Desktop::APP_NAME} instead (--transfer=desktop)".freeze
26
+ private_constant :CONNECT_START_URIS, :SLEEP_SEC_BETWEEN_RETRY, :DEPRECATION_MESSAGE
20
27
 
21
28
  class << self
22
29
  # Re-query a previously started transfer via the Connect REST API.
@@ -64,6 +71,7 @@ module Aspera
64
71
 
65
72
  def initialize(**base_options)
66
73
  super
74
+ Log.log.warn { DEPRECATION_MESSAGE.red }
67
75
  @transfer_id = nil
68
76
  @connect_settings = {
69
77
  'app_id' => SecureRandom.uuid
@@ -139,10 +147,6 @@ module Aspera
139
147
  Log.dump(:tr_info, tr_info, level: :trace1)
140
148
  if tr_info['transfer_info'].is_a?(Hash)
141
149
  transfer = tr_info['transfer_info']
142
- if transfer.nil?
143
- Log.log.warn('no session in Connect')
144
- break
145
- end
146
150
  # TODO: get session id
147
151
  case transfer['status']
148
152
  when 'initiating', 'queued'
@@ -1,11 +1,14 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- require 'aspera/agent/base'
4
- require 'aspera/rest'
5
- require 'aspera/environment'
6
- require 'aspera/json_rpc/client'
7
- require 'aspera/products/desktop'
8
- require 'aspera/transfer/spec'
3
+ # SPDX-FileCopyrightText: IBM Corp.
4
+ # SPDX-License-Identifier: Apache-2.0
5
+
6
+ require_relative 'base'
7
+ require_relative '../rest'
8
+ require_relative '../environment'
9
+ require_relative '../json_rpc/client'
10
+ require_relative '../products/desktop'
11
+ require_relative '../transfer/spec'
9
12
  require 'securerandom'
10
13
 
11
14
  module Aspera
@@ -13,7 +16,7 @@ module Aspera
13
16
  # Client: Aspera for Desktop
14
17
  class Desktop < Base
15
18
  # try twice the main init url in sequence
16
- START_URIS = ['aspera://', 'aspera://', 'aspera://']
19
+ START_URIS = ['aspera://', 'aspera://', 'aspera://'].freeze
17
20
  # delay between each try to start the app
18
21
  SLEEP_SEC_BETWEEN_RETRY = 5
19
22
  private_constant :START_URIS, :SLEEP_SEC_BETWEEN_RETRY
@@ -1,22 +1,25 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- require 'aspera/agent/base'
4
- require 'aspera/ascp/installation'
5
- require 'aspera/ascp/management'
6
- require 'aspera/exec_spec'
7
- require 'aspera/temp_file_manager'
8
- require 'aspera/transfer/parameters'
9
- require 'aspera/transfer/error'
10
- require 'aspera/transfer/spec'
11
- require 'aspera/transfer/resumer'
12
- require 'aspera/log'
13
- require 'aspera/assert'
3
+ # SPDX-FileCopyrightText: IBM Corp.
4
+ # SPDX-License-Identifier: Apache-2.0
5
+
6
+ require_relative 'base'
7
+ require_relative '../ascp/installation'
8
+ require_relative '../ascp/management'
9
+ require_relative '../exec_spec'
10
+ require_relative '../temp_file_manager'
11
+ require_relative '../transfer/parameters'
12
+ require_relative '../transfer/error'
13
+ require_relative '../transfer/spec'
14
+ require_relative '../transfer/resumer'
15
+ require_relative '../log'
16
+ require_relative '../assert'
17
+ require_relative '../rainbow'
14
18
  require 'socket'
15
19
  require 'securerandom'
16
20
  require 'shellwords'
17
21
  require 'English'
18
22
  require 'time'
19
- require 'aspera/rainbow'
20
23
  using Rainbow
21
24
 
22
25
  module Aspera
@@ -118,7 +121,7 @@ module Aspera
118
121
  # Start `ascp` transfer(s) (non blocking), single or multi-session
119
122
  # Session information added to @sessions
120
123
  # @param transfer_spec [Hash] Aspera transfer specification
121
- # @param token_regenerator [Object] Object with method refreshed_transfer_token
124
+ # @param token_regenerator [Proc, nil] Returns a renewed value for the bearer token of the transfer
122
125
  def start_transfer(transfer_spec, token_regenerator: nil)
123
126
  # clone transfer spec because we modify it (first level keys)
124
127
  transfer_spec = transfer_spec.clone
@@ -379,11 +382,11 @@ module Aspera
379
382
  Log.log.trace1 { 'Graceful shutdown, DONE message received' }
380
383
  when 'ERROR'
381
384
  if /bearer token/i.match?(last_event['Description']) &&
382
- session[:token_regenerator].respond_to?(:refreshed_transfer_token)
385
+ !session[:token_regenerator].nil?
383
386
  # regenerate token here, expired, or error on it
384
387
  # Note: in multi-session, each session will have a different one.
385
388
  Log.log.warn('Regenerating token for transfer')
386
- env['ASPERA_SCP_TOKEN'] = session[:token_regenerator].refreshed_transfer_token
389
+ env['ASPERA_SCP_TOKEN'] = session[:token_regenerator].call
387
390
  end
388
391
  raise Transfer::Error.new(last_event['Description'], code: last_event['Code'].to_i)
389
392
  else
@@ -400,9 +403,9 @@ module Aspera
400
403
  session.delete(:io)
401
404
  # if command was successfully started, check its status
402
405
  unless command_pid.nil?
403
- Process.kill(:INT, command_pid) if @monitor && !Environment.instance.os.eql?(Environment::OS_WINDOWS)
406
+ ::Process.kill(:INT, command_pid) if @monitor && !Environment.instance.os.eql?(Environment::OS_WINDOWS)
404
407
  # collect process exit status or wait for termination
405
- _, status = Process.wait2(command_pid)
408
+ _, status = ::Process.wait2(command_pid)
406
409
  if capture_stderr
407
410
  # process stderr of ascp
408
411
  stderr_flag = false
@@ -463,12 +466,10 @@ module Aspera
463
466
  total_size = session[:last_size] + session[:last_skipped]
464
467
  notify_progress(:session_size, session_id: progress_id, info: total_size) if !session[:size_sent] && !total_size.zero?
465
468
  notify_progress(:session_end, session_id: progress_id)
466
- # cspell:disable
467
469
  when 'SESSION'
468
470
  when 'ARGSTOP'
469
471
  when 'FILEERROR'
470
472
  Log.log.error { "#{event['Type']} #{event['Description']}" }
471
- # cspell:enable
472
473
  else
473
474
  Log.log.debug { "Unknown event type for progress: #{event['Type']}" }
474
475
  end
@@ -1,8 +1,11 @@
1
1
  # frozen_string_literal: true
2
2
 
3
+ # SPDX-FileCopyrightText: IBM Corp.
4
+ # SPDX-License-Identifier: Apache-2.0
5
+
6
+ require_relative '../log'
7
+ require_relative '../environment'
3
8
  require 'singleton'
4
- require 'aspera/log'
5
- require 'aspera/environment'
6
9
  module Aspera
7
10
  module Agent
8
11
  # Factory for Agents
@@ -20,7 +23,7 @@ module Aspera
20
23
  Aspera::Agent.const_get(agent.to_s.capitalize).new(**options)
21
24
  end
22
25
 
23
- IGNORED_ITEMS = %i[factory base]
26
+ IGNORED_ITEMS = %i[factory base].freeze
24
27
  # Available agents: :long : Capitalized name string, :short : single character symbol
25
28
  ALL =
26
29
  Dir.children(File.dirname(File.expand_path(__FILE__)))
@@ -1,10 +1,12 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- require 'aspera/agent/base'
4
- require 'aspera/transfer/spec'
5
- require 'aspera/api/httpgw'
6
- require 'aspera/log'
7
- require 'aspera/assert'
3
+ # SPDX-FileCopyrightText: IBM Corp.
4
+ # SPDX-License-Identifier: Apache-2.0
5
+
6
+ require_relative 'base'
7
+ require_relative '../api/httpgw'
8
+ require_relative '../log'
9
+ require_relative '../assert'
8
10
  require 'securerandom'
9
11
 
10
12
  module Aspera
@@ -1,12 +1,14 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # cspell:ignore precalc
4
- require 'aspera/agent/base'
5
- require 'aspera/transfer/spec'
6
- require 'aspera/api/node'
7
- require 'aspera/log'
8
- require 'aspera/assert'
9
- require 'aspera/oauth/client/factory'
3
+ # SPDX-FileCopyrightText: IBM Corp.
4
+ # SPDX-License-Identifier: Apache-2.0
5
+
6
+ require_relative 'base'
7
+ require_relative '../transfer/spec'
8
+ require_relative '../api/node'
9
+ require_relative '../log'
10
+ require_relative '../assert'
11
+ require_relative '../oauth/client/factory'
10
12
 
11
13
  module Aspera
12
14
  module Agent
@@ -79,6 +81,12 @@ module Aspera
79
81
  @transfer_id = nil
80
82
  end
81
83
 
84
+ # Received files are written on the node, not on the local system
85
+ # @return [Boolean] `false`
86
+ def local_destination?
87
+ false
88
+ end
89
+
82
90
  # generic method
83
91
  # :reek:UnusedParameters token_regenerator
84
92
  def start_transfer(transfer_spec, token_regenerator: nil)
@@ -1,65 +1,186 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- require 'aspera/environment'
4
- require 'aspera/agent/base'
5
- require 'aspera/products/transferd'
6
- require 'aspera/temp_file_manager'
7
- require 'aspera/transfer/spec'
3
+ # SPDX-FileCopyrightText: IBM Corp.
4
+ # SPDX-License-Identifier: Apache-2.0
5
+
6
+ require_relative '../environment'
7
+ require_relative 'base'
8
+ require_relative '../products/transferd'
9
+ require_relative '../temp_file_manager'
10
+ require_relative '../transfer/error'
11
+ require_relative '../transfer/spec'
12
+ require_relative '../../transferd_services_pb'
8
13
  require 'json'
14
+ require 'time'
9
15
  require 'uri'
10
- require 'transferd_services_pb'
11
16
 
12
17
  module Aspera
13
18
  module Agent
14
19
  class Transferd < Base
20
+ # Sends the API key of the daemon (`authentication` of its configuration) in the metadata `api_key` of each call
21
+ class ApiKeyInterceptor < GRPC::ClientInterceptor
22
+ # @param api_key [String] API key
23
+ def initialize(api_key)
24
+ super()
25
+ @api_key = api_key
26
+ end
27
+
28
+ %i[request_response client_streamer server_streamer bidi_streamer].each do |rpc_type|
29
+ define_method(rpc_type) do |metadata: nil, **_rest, &block|
30
+ metadata['api_key'] = @api_key
31
+ block.call
32
+ end
33
+ end
34
+ end
35
+
15
36
  # https://github.com/grpc/grpc/blob/master/doc/naming.md
16
37
  # https://grpc.io/docs/guides/custom-name-resolution/
17
38
  LOCAL_SOCKET_ADDR = '127.0.0.1'
18
39
  PORT_SEP = ':'
19
40
  # port zero means select a random available high port
20
- AUTO_LOCAL_TCP_PORT = "#{PORT_SEP}0"
41
+ AUTO_LOCAL_TCP_PORT = "#{PORT_SEP}0".freeze
42
+ # Default timeout in seconds of the calls of `transfer_status` and `transfer_cancel` (`agent_params['timeout']`)
43
+ CALL_TIMEOUT_SEC = 10
44
+ # Status of the daemon → status of an asynchronous transfer (as other agents): other statuses are `running`
45
+ ASYNC_STATUS = {
46
+ COMPLETED: 'completed',
47
+ FAILED: 'failed',
48
+ CANCELED: 'cancelled',
49
+ UNKNOWN_STATUS: 'unknown'
50
+ }.freeze
51
+ # Statuses of the daemon after which a transfer does not change
52
+ FINAL_STATUSES = %i[COMPLETED FAILED CANCELED].freeze
53
+ # Time in the daemon is in microseconds, but some versions give milliseconds: values below this are milliseconds
54
+ MIN_USEC_EPOCH = 10**14
21
55
 
22
- private_constant :LOCAL_SOCKET_ADDR, :PORT_SEP, :AUTO_LOCAL_TCP_PORT
56
+ private_constant :LOCAL_SOCKET_ADDR, :PORT_SEP, :AUTO_LOCAL_TCP_PORT, :ASYNC_STATUS, :MIN_USEC_EPOCH
23
57
 
24
58
  class << self
25
- # Re-query a previously started transfer from a running transferd daemon.
26
- # agent_params must contain 'url' (the daemon endpoint, e.g. "127.0.0.1:12345").
27
- # @return [Hash] normalized status hash
59
+ # Client of a daemon
60
+ # @param url [String] Endpoint of the daemon, e.g. `127.0.0.1:55002`
61
+ # @param api_key [String, nil] API key, if the daemon has `authentication` enabled
62
+ # @param ca_file [String, nil] File with the certificate authority of the daemon (PEM), if the daemon has `tls` enabled
63
+ # @return [Transferd::Api::TransferService::Stub] gRPC client
64
+ def create_client(url, api_key: nil, ca_file: nil)
65
+ credentials = ca_file.nil? ? :this_channel_is_insecure : GRPC::Core::ChannelCredentials.new(File.read(ca_file))
66
+ return ::Transferd::Api::TransferService::Stub.new(url, credentials) if api_key.nil?
67
+ ::Transferd::Api::TransferService::Stub.new(url, credentials, interceptors: [ApiKeyInterceptor.new(api_key)])
68
+ end
69
+
70
+ # @param agent_params [Hash] `url`: endpoint of the daemon; optional `api_key`, `ca_file`
71
+ # @return [Transferd::Api::TransferService::Stub] Client of the daemon
72
+ def client(agent_params)
73
+ Aspera.assert(agent_params['url'].is_a?(String) && !agent_params['url'].empty?) { 'agent_params: missing url' }
74
+ create_client(agent_params['url'], api_key: agent_params['api_key'], ca_file: agent_params['ca_file'])
75
+ end
76
+
77
+ # Re-query a previously started transfer from a running transferd daemon (unary call `QueryTransfer`).
78
+ # The daemon keeps a transfer for some time after its end (`workers.transfer_max_age` of its configuration): then it is `unknown`.
79
+ # @param transfer_id [String] Identifier of transfer, given by the daemon (`transfer_id`)
80
+ # @param agent_params [Hash] `url`: endpoint of the daemon, e.g. `127.0.0.1:55002`; optional `timeout`: seconds, `api_key`, `ca_file`
81
+ # @return [Hash] Normalized status: `status` (`running`, `completed`, `failed`, `cancelled`, or `unknown` if the daemon cannot tell),
82
+ # `bytes_transferred`, and when known: `state` (status of the daemon), `bytes_written` (by the receiver, with the bytes of a resumed transfer),
83
+ # `files_completed`, `rate_kbps` (average), `target_rate_kbps`,
84
+ # `elapsed_sec`, `started_at`, `ended_at`, `error_code`, `error`
28
85
  def transfer_status(transfer_id, agent_params)
29
- client = ::Transferd::Api::TransferService::Stub.new(agent_params['url'], :this_channel_is_insecure)
30
- result = {'bytes_transferred' => 0}
31
- client.monitor_transfers(::Transferd::Api::RegistrationRequest.new(transferId: [transfer_id])) do |response|
32
- result = case response.status
33
- when :COMPLETED
34
- {
35
- 'status' => 'completed', 'ended_at' => Time.now.utc.iso8601,
36
- 'bytes_transferred' => response.transferInfo.bytesTransferred
37
- }
38
- when :FAILED, :CANCELED
39
- {
40
- 'status' => response.status == :FAILED ? 'failed' : 'cancelled',
41
- 'ended_at' => Time.now.utc.iso8601, 'bytes_transferred' => 0,
42
- 'error' => JSON.parse(response.message.to_s)['Description']
43
- }
44
- else
45
- {'status' => 'running', 'bytes_transferred' => response.transferInfo.bytesTransferred}
46
- end
47
- break
86
+ response = client(agent_params).query_transfer(::Transferd::Api::TransferInfoRequest.new(transferId: transfer_id), deadline: deadline(agent_params))
87
+ # An unknown transfer is not an exception: status is not set, and error has code 404
88
+ error = response.error&.description.to_s
89
+ return {'status' => 'unknown', 'bytes_transferred' => 0, 'error' => error} if response.status.eql?(:UNKNOWN_STATUS) && !error.empty?
90
+ normalize_status(response)
91
+ rescue GRPC::BadStatus => e
92
+ # Daemon not reachable, or timeout: the transfer may still run
93
+ {'status' => 'unknown', 'bytes_transferred' => 0, 'error' => "#{e.class.name.split('::').last}: #{e.details}"}
94
+ end
95
+
96
+ # Information on a running daemon (unary call `GetInfo`)
97
+ # @param agent_params [Hash] `url`: endpoint of the daemon; optional `timeout`: seconds, `api_key`, `ca_file`
98
+ # @return [Hash] Version of the API (`apiVersion`) and information on the instance (`info`)
99
+ # @raise [Transfer::Error] The daemon is not reachable, or gave an error
100
+ def info(agent_params)
101
+ response = client(agent_params).get_info(::Transferd::Api::InstanceInfoRequest.new, deadline: deadline(agent_params))
102
+ error = response.error&.description.to_s
103
+ Aspera.assert(error.empty?, type: Transfer::Error) { error }
104
+ JSON.parse(response.to_h.except(:error).to_json)
105
+ rescue GRPC::BadStatus => e
106
+ raise Transfer::Error, "#{e.class.name.split('::').last}: #{e.details}"
107
+ end
108
+
109
+ # Stop a transfer (call `StopTransfer`)
110
+ # @param transfer_id [String] Identifier of transfer, given by the daemon
111
+ # @param agent_params [Hash] `url`: endpoint of the daemon; optional `timeout`: seconds, `api_key`, `ca_file`
112
+ # @return [Boolean] `true`: stopped
113
+ # @raise [Transfer::Error] The daemon did not stop it: unknown or terminated transfer
114
+ def transfer_cancel(transfer_id, agent_params)
115
+ response = client(agent_params).stop_transfer(::Transferd::Api::StopTransferRequest.new(transferId: [transfer_id]), deadline: deadline(agent_params))
116
+ result = response.stopResult.find { |item| item.transferId.eql?(transfer_id) }
117
+ Aspera.assert(!result.nil?, type: Transfer::Error) { "transfer id=#{transfer_id}: no result of stop" }
118
+ Aspera.assert(result.stopped, type: Transfer::Error) { result.error&.description || "transfer id=#{transfer_id}: not stopped" }
119
+ true
120
+ end
121
+
122
+ # @param response [Transferd::Api::QueryTransferResponse, Transferd::Api::TransferResponse] Response of the daemon
123
+ # @return [Hash] Normalized status, see `transfer_status`
124
+ def normalize_status(response)
125
+ info = response.transferInfo
126
+ result = {
127
+ 'status' => ASYNC_STATUS.fetch(response.status, 'running'),
128
+ 'state' => response.status.to_s.downcase,
129
+ 'bytes_transferred' => info&.bytesTransferred.to_i
130
+ }
131
+ return result if info.nil?
132
+ result.merge!(
133
+ 'bytes_written' => info.bytesWritten,
134
+ 'files_completed' => info.filesCompleted,
135
+ 'rate_kbps' => info.averageRateKbps,
136
+ 'target_rate_kbps' => info.targetRateKbps,
137
+ 'elapsed_sec' => info.elapsedUsec / 1_000_000.0,
138
+ 'started_at' => epoch_time(info.startTimeUsec),
139
+ 'ended_at' => epoch_time(info.endTimeUsec)
140
+ )
141
+ if FINAL_STATUSES.include?(response.status)
142
+ result['ended_at'] ||= Time.now.utc.iso8601
143
+ else
144
+ result.delete('ended_at')
48
145
  end
49
- result
50
- rescue StandardError => e
51
- {'status' => 'running', 'bytes_transferred' => 0, 'error' => e.message}
146
+ error = info.errorDescription.to_s.strip
147
+ error = response.error&.description.to_s if error.empty?
148
+ unless error.empty?
149
+ result['error_code'] = info.errorCode
150
+ result['error'] = error
151
+ end
152
+ result.compact
153
+ end
154
+
155
+ private
156
+
157
+ # @param agent_params [Hash] Optional `timeout`: seconds
158
+ # @return [Time] Deadline of a call
159
+ def deadline(agent_params)
160
+ Time.now + (agent_params['timeout'] || CALL_TIMEOUT_SEC).to_f
161
+ end
162
+
163
+ # @param value [Integer] Time since epoch, in microseconds or milliseconds, 0 if not known
164
+ # @return [String, nil] Time in ISO 8601, `nil` if not known
165
+ def epoch_time(value)
166
+ return if value.nil? || value <= 0
167
+ seconds = value >= MIN_USEC_EPOCH ? value / 1_000_000.0 : value / 1000.0
168
+ Time.at(seconds).utc.iso8601
52
169
  end
53
170
  end
54
171
 
55
172
  # @param url [String] URL of the transfer manager daemon
56
173
  # @param start [Boolean] If `false`, expect that an external daemon is already running
57
174
  # @param stop [Boolean] If `false`, do not shutdown daemon on exit
175
+ # @param api_key [String, nil] API key of an external daemon with `authentication` enabled
176
+ # @param ca_file [String, nil] Certificate authority (PEM file) of an external daemon with `tls` enabled
58
177
  # @param base [Hash] Base class options
59
178
  def initialize(
60
- url: AUTO_LOCAL_TCP_PORT,
61
- start: true,
62
- stop: true,
179
+ url: AUTO_LOCAL_TCP_PORT,
180
+ start: true,
181
+ stop: true,
182
+ api_key: nil,
183
+ ca_file: nil,
63
184
  **base
64
185
  )
65
186
  super(**base)
@@ -76,14 +197,15 @@ module Aspera
76
197
  begin
77
198
  # no address: local bind
78
199
  daemon_endpoint = "#{LOCAL_SOCKET_ADDR}#{daemon_endpoint}" if daemon_endpoint.match?(/^#{PORT_SEP}[0-9]+$/o)
79
- # Create stub (without credentials)
80
- @transfer_client = ::Transferd::Api::TransferService::Stub.new(daemon_endpoint, :this_channel_is_insecure)
200
+ # Create stub: no credentials for a daemon started here, API key and TLS only for an external daemon
201
+ @transfer_client = self.class.create_client(daemon_endpoint, api_key: api_key, ca_file: ca_file)
81
202
  # Initiate actual connection
82
203
  get_info_response = @transfer_client.get_info(::Transferd::Api::InstanceInfoRequest.new)
83
204
  @daemon_endpoint = daemon_endpoint
84
205
  Log.log.debug { "Daemon info: #{get_info_response}" }
85
206
  Log.log.warn('Attached to existing daemon') unless @daemon_pid || !start || !@stop
86
- at_exit { shutdown }
207
+ # `shutdown` is registered with `at_exit` only when the daemon is started here:
208
+ # a long-running process (e.g. Orchestrator) that attaches to an external daemon for each transfer would accumulate them
87
209
  rescue GRPC::Unavailable => e
88
210
  # if transferd is external: do not start it, or other error
89
211
  raise if !start || !e.message.include?('failed to connect')
@@ -122,14 +244,14 @@ module Aspera
122
244
  # wait for process to initialize, max 2 seconds
123
245
  Timeout.timeout(2.0) do
124
246
  # this returns if process dies (within 2 seconds)
125
- _, status = Process.wait2(@daemon_pid)
247
+ _, status = ::Process.wait2(@daemon_pid)
126
248
  raise "Transfer daemon exited with status #{status.exitstatus}. Check files: #{log_stdout} and #{log_stderr}"
127
249
  end
128
250
  rescue Timeout::Error
129
251
  nil
130
252
  end
131
253
  Log.log.debug { "Daemon started with pid #{@daemon_pid}" }
132
- Process.detach(@daemon_pid) unless @stop
254
+ ::Process.detach(@daemon_pid) unless @stop
133
255
  at_exit { shutdown }
134
256
  # update port for next connection attempt (if auto high port was requested)
135
257
  daemon_endpoint = "#{LOCAL_SOCKET_ADDR}#{PORT_SEP}#{Products::Transferd.daemon_port_from_log(log_stdout)}" if is_local_auto_port
@@ -140,6 +262,8 @@ module Aspera
140
262
 
141
263
  # Actual endpoint the daemon is listening on (resolved after connect, e.g. when port 0 was used)
142
264
  attr_reader :daemon_endpoint
265
+ # Identifier of the last transfer started, given by the daemon: for `transfer_status` and `transfer_cancel`
266
+ attr_reader :transfer_id
143
267
  # gRPC client of the daemon
144
268
  attr_reader :transfer_client
145
269
 
@@ -206,8 +330,8 @@ module Aspera
206
330
  def stop_daemon
207
331
  if !@daemon_pid.nil?
208
332
  Log.log.debug("Stopping daemon #{@daemon_pid}")
209
- Process.kill(:KILL, @daemon_pid)
210
- _, status = Process.wait2(@daemon_pid)
333
+ ::Process.kill(:KILL, @daemon_pid)
334
+ _, status = ::Process.wait2(@daemon_pid)
211
335
  Log.log.debug("daemon stopped #{status}")
212
336
  @daemon_pid = nil
213
337
  end
@@ -1,6 +1,9 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- require 'aspera/api/aoc'
3
+ # SPDX-FileCopyrightText: IBM Corp.
4
+ # SPDX-License-Identifier: Apache-2.0
5
+
6
+ require_relative 'aoc'
4
7
  module Aspera
5
8
  module Api
6
9
  # Aspera License Entitlement Engine API client