aspera-cli 4.22.0 → 4.23.0

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 (43) hide show
  1. checksums.yaml +4 -4
  2. checksums.yaml.gz.sig +0 -0
  3. data/CHANGELOG.md +374 -364
  4. data/README.md +255 -155
  5. data/lib/aspera/agent/direct.rb +1 -1
  6. data/lib/aspera/api/aoc.rb +9 -12
  7. data/lib/aspera/api/httpgw.rb +8 -4
  8. data/lib/aspera/ascmd.rb +14 -6
  9. data/lib/aspera/ascp/installation.rb +6 -3
  10. data/lib/aspera/assert.rb +3 -3
  11. data/lib/aspera/cli/hints.rb +9 -1
  12. data/lib/aspera/cli/main.rb +1 -1
  13. data/lib/aspera/cli/manager.rb +1 -1
  14. data/lib/aspera/cli/plugin.rb +1 -1
  15. data/lib/aspera/cli/plugins/aoc.rb +33 -23
  16. data/lib/aspera/cli/plugins/config.rb +20 -15
  17. data/lib/aspera/cli/plugins/node.rb +96 -92
  18. data/lib/aspera/cli/plugins/server.rb +1 -0
  19. data/lib/aspera/cli/transfer_agent.rb +7 -11
  20. data/lib/aspera/cli/version.rb +1 -1
  21. data/lib/aspera/data_repository.rb +1 -0
  22. data/lib/aspera/environment.rb +1 -0
  23. data/lib/aspera/log.rb +1 -0
  24. data/lib/aspera/oauth/base.rb +2 -0
  25. data/lib/aspera/oauth/factory.rb +1 -0
  26. data/lib/aspera/preview/file_types.rb +40 -33
  27. data/lib/aspera/preview/generator.rb +1 -1
  28. data/lib/aspera/products/connect.rb +1 -0
  29. data/lib/aspera/rest.rb +18 -7
  30. data/lib/aspera/rest_error_analyzer.rb +1 -0
  31. data/lib/aspera/ssh.rb +1 -1
  32. data/lib/aspera/temp_file_manager.rb +1 -0
  33. data/lib/aspera/timer_limiter.rb +7 -5
  34. data/lib/aspera/transfer/async_conf.schema.yaml +716 -0
  35. data/lib/aspera/transfer/sync.rb +14 -4
  36. data/lib/aspera/transfer/sync_instance.schema.yaml +7 -0
  37. data/lib/aspera/transfer/sync_session.schema.yaml +7 -0
  38. data.tar.gz.sig +0 -0
  39. metadata +3 -5
  40. metadata.gz.sig +0 -0
  41. data/examples/dascli +0 -30
  42. data/examples/get_proto_file.rb +0 -8
  43. data/examples/proxy.pac +0 -60
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  # Changes (Release notes)
2
2
 
3
- * 4.22.0
3
+ * 4.23.0 2025-08-11
4
+ * New Features:
5
+ * `aoc`: #201: Added `package_folder` option to place each received package in its own subfolder named after a package attribute. Default is `@none:` which means no subfolder will be created.
6
+ * `config`: Added `transferd` version 1.1.6.
7
+ * Issues Fixed:
8
+ * `server`: #209: missing home folder for transfer user shall not cause an error.
9
+ * `direct`: #205: `kill` blocks `cmd` on Windows.
10
+ * Breaking Changes:
11
+ * `config`: In `ascp info`: `openssldir` → `ascp_openssl_dir`, `openssl_version` → `ascp_openssl_version`, `sdk_ascp_version` → `ascp_version`
12
+
13
+ * 4.22.0 2025-06-23
4
14
 
5
15
  * New Features:
6
16
  * `faspex5`: Support paging for Faspex5 browsing.
@@ -18,7 +28,7 @@
18
28
  * HTTP: More retry parameters.
19
29
  * `node`: renamed command `http_node_download` to `cat`, and it directly displays the content of the file in the terminal unless option `--output` is specified.
20
30
 
21
- * 4.21.2
31
+ * 4.21.2 2025-04-11
22
32
 
23
33
  * New Features:
24
34
  * **container**: Updated Ruby to 3.4.2
@@ -26,13 +36,13 @@
26
36
  * **global**: #185 `@val:` shall stop processing extended values
27
37
  * **global**: #186 Removed dependency on OpenSSL 3.3 gem to avoid MSYS2 dep on Windows.
28
38
  * `echo`: Display of list (Array) was showing only first element of it.
29
- * `transferd`: support for version 1.1.5+
39
+ * `transferd`: Support for version 1.1.5+
30
40
  * Breaking Changes:
31
41
  * `preview`: Updated Image Magick to v7+
32
42
  * `aoc`: `admin subscription` split into `admin subscription account` and `admin subscription usage`
33
43
  * **agent**: `alpha` renamed to `desktop`
34
44
 
35
- * 4.21.1
45
+ * 4.21.1 2025-03-15
36
46
 
37
47
  * New Features:
38
48
  * `config`: New command: `transferd` to list and install specific version of `asperatransferd` and `ascp`
@@ -45,10 +55,10 @@
45
55
  * `config`: Soft links in transfer SDK archive are correctly extracted
46
56
  * `aoc`: #184 token cache shall be different per AoC org.
47
57
  * `aoc`: Fix `packages delete` not working.
48
- * `direct` agent: #174 Race condition fix with `ascp`: timeout waiting mgt port connect (select not readable)
58
+ * `direct` agent: #174 Race condition fix with `ascp`: timeout waiting management port connect (select not readable)
49
59
  * `preview`: #177 fix bug that prevents preview generation to work.
50
60
  * Breaking Changes:
51
- * `transferd`: Use of Aspera Transfer Daemon requires minimum version 1.1.4. agent `trsdk` renamed `transferd`.
61
+ * `transferd`: Use of Aspera Transfer Daemon requires minimum version 1.1.4. Agent `trsdk` renamed `transferd`.
52
62
  * `ascp`: Default SDK version is now 1.1.4. Removes support for ascp4.
53
63
  * `node`: Removed deprecated command prefix `exec:`, use `@ruby:` instead.
54
64
  * **global**: Now uses OpenSSL 3.
@@ -56,73 +66,73 @@
56
66
  * **global**: Options `transpose_single` and `multi_table` replaced with single option `multi_single` and values: `no`, `yes`, `single`.
57
67
  * **global**: Column name for single object is now `field` instead of `key`.
58
68
 
59
- * 4.20.0
69
+ * 4.20.0 2025-01-21
60
70
 
61
- ATTENTION: [Faspex version 4 is now end of support](https://www.ibm.com/support/pages/lifecycle/search?q=faspex): the `faspex` plugin will be deprecated. Servers shall be upgraded to Faspex 5, and users use plugin `faspex5`.
71
+ ATTENTION: [Faspex version 4 is now end of support](https://www.ibm.com/support/pages/lifecycle/search?q=faspex): The `faspex` plugin will be deprecated. Servers shall be upgraded to Faspex 5, and users use plugin `faspex5`.
62
72
 
63
73
  * New Features:
64
74
  * `aoc`: Improved usability for creation of Admin shared folders.
65
75
  * `node`: New option `node_cache` (bool) for gen4 operations.
66
76
  * `node`: Option `root_id` now always works for node gen4, as well as `%id:` for file selection in addition to path.
67
77
  * `node`: `transfer list` now uses the `iteration_token` to retrieve all values. Option `once_only` is now supported.
68
- * **global**: option `http_options` now include retry options.
78
+ * **global**: Option `http_options` now include retry options.
69
79
  * Issues Fixed:
70
80
  * `aoc`: Fixed `find` command not working. (undefined variable)
71
- * `aoc`: #165 AoC mkdir now follows the last link of containing folder
81
+ * `aoc`: #165 AoC `mkdir` now follows the last link of containing folder
72
82
  * Breaking Changes:
73
83
  * Internal: Basic REST calls now return data directly. (no more `data` key). For advanced calls, use `call`.
74
84
  * Internal: Transfer SDK download is now a 2-step procedure: First get the YAML file from GitHub with URLs for the various platforms and versions, and then download the archive from the official IBM repository.
75
- **global**: option `format=multi` is replaced with option `multi_table=yes`
76
- * `faspex5`: removed deprecated option `value` replaced with positional parameter.
85
+ **global**: Option `format=multi` is replaced with option `multi_table=yes`
86
+ * `faspex5`: Removed deprecated option `value` replaced with positional parameter.
77
87
 
78
- * 4.19.0
88
+ * 4.19.0 2024-10-02
79
89
 
80
90
  * New Features:
81
- * `server`: add support for `async` (Aspera Sync) from Transfer SDK
91
+ * `server`: Add support for `async` (Aspera Sync) from Transfer SDK
82
92
  * **global**: #156 support sending folders with `httpgw`
83
- * **global**: new value for option `format`: `multi`
93
+ * **global**: New value for option `format`: `multi`
84
94
  * Issues Fixed:
85
95
  * `aoc`: #157 fix problem with `files browse` on a link
86
- * `sync`: better documentation and handling of options.
96
+ * `sync`: Better documentation and handling of options.
87
97
  * Breaking Changes:
88
98
  * **global**: Default value for direct agent option `transfer_info.multi_incr_udp` is `true` on Windows, and now `false` on other platforms.
89
99
  * **global**: Token based transfers now use the RSA key only. Direct agent option `transfer_info.client_ssh_key` allows changing this behavior.
90
100
 
91
- * 4.18.1
101
+ * 4.18.1 2024-08-21
92
102
 
93
103
  * New Features:
94
- * none
104
+ * None
95
105
  * Issues Fixed:
96
106
  * **global**: #146 (@junkimu) Fix problem on Windows WRT terminal detection
97
- * **global**: node gen4 (aoc) browsing through link now follows the link correctly
107
+ * **global**: Node gen4 (`aoc`) browsing through link now follows the link correctly
98
108
  * `shares`: #147 Fix problem for `shares files mkdir`
99
109
  * Breaking Changes:
100
110
  * **global**: Removed option `id`, deprecated since 4.14.0
101
111
 
102
- * 4.18.0
112
+ * 4.18.0 2024-07-10
103
113
 
104
114
  * New Features:
105
- * `faspex5`: added command `admin configuration` for global parameters.
106
- * `faspex5`: added command `admin clean_deleted`.
107
- * `faspex5`: added resource `distribution_list`.
115
+ * `faspex5`: Added command `admin configuration` for global parameters.
116
+ * `faspex5`: Added command `admin clean_deleted`.
117
+ * `faspex5`: Added resource `distribution_list`.
108
118
  * `node`: "gen3" browse now returns all elements using pages, and supports option `query` with parameter `recursive`, `max`, `self`.
109
- * `httpgw`: new plugin, detect the GW.
110
- * `faspio`: new plugin, configure bridges.
111
- * `config`: `ascp info` also shows the version of the openssl library used by `ascp`.
112
- * `node`: new action: `transport` to display transfer address and ports
113
- * **global**: added option `http_proxy`, as an alias to env var `http_proxy`.
119
+ * `httpgw`: New plugin, detect the GW.
120
+ * `faspio`: New plugin, configure bridges.
121
+ * `config`: `ascp info` also shows the version of the OpenSSL library used by `ascp`.
122
+ * `node`: New action: `transport` to display transfer address and ports
123
+ * **global**: Added option `http_proxy`, as an alias to env var `http_proxy`.
114
124
  * **global**: Possibility to filter fields when using formats like `json` or `yaml`.
115
125
  * Issues Fixed:
116
- * `faspex5`: fixed support for percent selector for metadata profiles.
126
+ * `faspex5`: Fixed support for percent selector for metadata profiles.
117
127
  * Breaking Changes:
118
128
  * `aoc` : `admin resource` is deprecated, use just `admin`.
119
129
  * `faspex5` : `admin resource` is deprecated, use just `admin`.
120
- * **global**: option `value` is deprecated and replaced with option `query` when used in generic commands: `delete` and `list`, as well as node ak browse, node stream and watch folder list. (#142)
121
- * **global**: option `warnings` (and short `w`) is removed. To get ruby warnings invoke with `ruby -w .../ascli ...`. See `Makefile` in `test`
122
- * **global**: option `table_style` now expects a Hash, not String.
130
+ * **global**: Option `value` is deprecated and replaced with option `query` when used in generic commands: `delete` and `list`, as well as node access_key browse, node stream and watch folder list. (#142)
131
+ * **global**: Option `warnings` (and short `w`) is removed. To get ruby warnings invoke with `ruby -w .../ascli ...`. See `Makefile` in `test`
132
+ * **global**: Option `table_style` now expects a Hash, not String.
123
133
  * **bss**: Removed unused plugin.
124
134
 
125
- * 4.17.0
135
+ * 4.17.0 2024-07-13
126
136
 
127
137
  * New Features:
128
138
  * `faspex5`: Automatic detection of HTTPGW.
@@ -156,259 +166,259 @@
156
166
  * 4.16.0 2024-02-15
157
167
 
158
168
  * New Features:
159
- * **global**: option `output` to redirect result to a file instead of `stdout`
160
- * **global**: new option `silent_insecure`
161
- * `config`: keys added to `config ascp info`
162
- * `config`: added command `pubkey` to extract public key from private key
163
- * `config`: new command `vault info`
164
- * `faspex5`: added `shared_folders` management
165
- * `faspex5`: if package has content protection, ask passphrase interactively, unless `content_protection=null` in `ts`
166
- * `faspex`: added `INIT` for `once_only`
167
- * `aoc`: added `INIT` for `once_only`
168
- * `aoc`: more list commands honor option `query`
169
+ * **global**: Option `output` to redirect result to a file instead of `stdout`
170
+ * **global**: New option `silent_insecure`
171
+ * `config`: Keys added to `config ascp info`
172
+ * `config`: Added command `pubkey` to extract public key from private key
173
+ * `config`: New command `vault info`
174
+ * `faspex5`: Added `shared_folders` management
175
+ * `faspex5`: If package has content protection, ask passphrase interactively, unless `content_protection=null` in `ts`
176
+ * `faspex`: Added `INIT` for `once_only`
177
+ * `aoc`: Added `INIT` for `once_only`
178
+ * `aoc`: More list commands honor option `query`
169
179
  * Issues Fixed:
170
- * `config`: wizard was failing due to `require` of optional gem.
171
- * `aoc`: use paging to list entities, instead of just one page(e.g. retrieve all packages)
180
+ * `config`: Wizard was failing due to `require` of optional gem.
181
+ * `aoc`: Use paging to list entities, instead of just one page(e.g. retrieve all packages)
172
182
  * `faspex5`: When receiving ALL packages, only get those with status `completed`.
173
- * `direct` agent: better support for WSS
183
+ * `direct` agent: Better support for WSS
174
184
  * Breaking Changes:
175
- * `shares`: option `type` for users and groups is replaced with mandatory positional argument with same value.
176
- * `aoc`, `faspex`: package `recv` command changed to `receive`, for consistency with faspex5 (`recv` is now an alias command)
185
+ * `shares`: Option `type` for users and groups is replaced with mandatory positional argument with same value.
186
+ * `aoc`, `faspex`: Package `recv` command changed to `receive`, for consistency with faspex5 (`recv` is now an alias command)
177
187
 
178
188
  * 4.15.0 2023-11-18
179
189
 
180
- * General: removed many redundant options, more consistency between plugins, see below in "break".
190
+ * General: Removed many redundant options, more consistency between plugins, see below in "break".
181
191
  * New Features:
182
- * **global**: added resolution hints for well known issues.
183
- * **global**: extended value expression `@extend:` finds and replace extended values in a string (e.g. for JSON)
184
- * **global**: option `fields` now supports `RegExp`
185
- * **global**: option `home` to set the main folder for configuration and cache
186
- * **global**: option `ignore_certificate` to specify specific URLs instead of global option `insecure`
187
- * **global**: option `cert_stores` to specify alternate certificate stores
188
- * **global**: uniform progress bar for any type of transfer.
189
- * **global**: add extended value types: `re` and `yaml`
190
- * **global**: option `pid_file` to write tool's PID during execution, deleted on exit
191
- * `config`: command `remote_certificate` to retrieve a remote certificate
192
- * `config`: added logger level `trace1` and `trace2`
192
+ * **global**: Added resolution hints for well known issues.
193
+ * **global**: Extended value expression `@extend:` finds and replace extended values in a string (e.g. for JSON)
194
+ * **global**: Option `fields` now supports `RegExp`
195
+ * **global**: Option `home` to set the main folder for configuration and cache
196
+ * **global**: Option `ignore_certificate` to specify specific URLs instead of global option `insecure`
197
+ * **global**: Option `cert_stores` to specify alternate certificate stores
198
+ * **global**: Uniform progress bar for any type of transfer.
199
+ * **global**: Add extended value types: `re` and `yaml`
200
+ * **global**: Option `pid_file` to write tool's PID during execution, deleted on exit
201
+ * `config`: Command `remote_certificate` to retrieve a remote certificate
202
+ * `config`: Added logger level `trace1` and `trace2`
193
203
  * `config`: `wizard` can detect multiple applications at the same address or URL.
194
- * `aoc`: wizard accepts public links
195
- * `aoc`: support private links, and possibility to list shared folder with workspace `@json:null`
196
- * `orchestrator`: error analysis for workflow start
197
- * `httpgw`: now supports pseudo file for testing: e.g. `faux:///testfile?1k`
198
- * `node`: added command `transfer sessions` to list all sessions of all transfers
199
- * `node`: generate bearer token from private key and user information
200
- * `node`: access node API with bearer token as credentials
201
- * **global**: agent `direct` allows ignoring certificate for WSS using HTTP options
202
- * `preview`: command `show` generates a preview and displays it in terminal
204
+ * `aoc`: Wizard accepts public links
205
+ * `aoc`: Support private links, and possibility to list shared folder with workspace `@json:null`
206
+ * `orchestrator`: Error analysis for workflow start
207
+ * `httpgw`: Now supports pseudo file for testing: e.g. `faux:///testfile?1k`
208
+ * `node`: Added command `transfer sessions` to list all sessions of all transfers
209
+ * `node`: Generate bearer token from private key and user information
210
+ * `node`: Access node API with bearer token as credentials
211
+ * **global**: Agent `direct` allows ignoring certificate for WSS using HTTP options
212
+ * `preview`: Command `show` generates a preview and displays it in terminal
203
213
  * Issues Fixed:
204
214
  * Ruby warning: `net/protocol.rb:68: warning: already initialized constant Net::ProtocRetryError` solved by removing dependency on `net-smtp` from gem spec (already in base ruby).
205
215
  * Breaking Changes:
206
- * **global**: commands `detect` and `wizard` takes now a mandatory argument: address or url instead of option `url`.
207
- * **global**: renamed option `pkeypath` to `key_path`
208
- * **global**: renamed option `notif_to` to `notify_to` and `notif_template` to `notify_template`
209
- * **global**: removed extended value handler `incps`, as it is never used (use `extend` instead).
210
- * **global**: option `fields`: `+prop` is replaced with: `DEF,prop` and `-field` is replaced with: `DEF,-field`, and whole list is evaluated.
211
- * **global**: replaced option `progress` with option `progressbar` (bool)
212
- * **global**: removed option `rest_debug` and `-r`, replaced with `--log-level=trace2`
213
- * **global**: the default file name for private key when using wizard is change from `aspera_aoc_key` to `my_private_key.pem`
214
- * `faspex5`: removed option and `auth` type `link`: simply provide the public link as `url`
215
- * `faspex`: remote source selection now uses percent selector instead of parameter `id` or `name`
216
- * `faspex`: option `source_name` is now `remote_source`
217
- * `aoc`: selection by name uses percent selector instead of option or parameter `name`
218
- * `aoc`: removed option `link`: use `url` instead
219
- * `aoc`: in command `short_link`, place type before command, e.g. `short_link private create /blah`
220
- * `aoc`: replaced option `operation` with mandatory positional parameter for command `files transfer`
221
- * `aoc`: replaced option `from_folder` with mandatory positional parameter for command `files transfer`
222
- * `orchestrator`: workflow start takes arguments as optional positional extended value instead of option `param`
216
+ * **global**: Commands `detect` and `wizard` takes now a mandatory argument: address or URL instead of option `url`.
217
+ * **global**: Renamed option `pkeypath` to `key_path`
218
+ * **global**: Renamed option `notif_to` to `notify_to` and `notif_template` to `notify_template`
219
+ * **global**: Removed extended value handler `incps`, as it is never used (use `extend` instead).
220
+ * **global**: Option `fields`: `+prop` is replaced with: `DEF,prop` and `-field` is replaced with: `DEF,-field`, and whole list is evaluated.
221
+ * **global**: Replaced option `progress` with option `progressbar` (bool)
222
+ * **global**: Removed option `rest_debug` and `-r`, replaced with `--log-level=trace2`
223
+ * **global**: The default file name for private key when using wizard is change from `aspera_aoc_key` to `my_private_key.pem`
224
+ * `faspex5`: Removed option and `auth` type `link`: simply provide the public link as `url`
225
+ * `faspex`: Remote source selection now uses percent selector instead of parameter `id` or `name`
226
+ * `faspex`: Option `source_name` is now `remote_source`
227
+ * `aoc`: Selection by name uses percent selector instead of option or parameter `name`
228
+ * `aoc`: Removed option `link`: use `url` instead
229
+ * `aoc`: In command `short_link`, place type before command, e.g. `short_link private create /blah`
230
+ * `aoc`: Replaced option `operation` with mandatory positional parameter for command `files transfer`
231
+ * `aoc`: Replaced option `from_folder` with mandatory positional parameter for command `files transfer`
232
+ * `orchestrator`: Workflow start takes arguments as optional positional extended value instead of option `param`
223
233
  * `node`: `find` command now takes an optional `@ruby:` extended value instead of option `query` with prefix: `exec:`
224
- * `sync`: plugin `sync` is removed: actions are available through `server` and `node` plugins.
225
- * `sync`: replaced option `sync_session` with optional positional parameter.
226
- * `preview`: command `scan`, `events` and `trevents` replaced option `query` with optional positional parameter for filter (like `find`).
227
- * **global**: agent `trsdk` parameters `host` and `port` in option `transfer_info` are replaced with parameter `url`, like `grpc://host:port`
234
+ * `sync`: Plugin `sync` is removed: actions are available through `server` and `node` plugins.
235
+ * `sync`: Replaced option `sync_session` with optional positional parameter.
236
+ * `preview`: Command `scan`, `events` and `trevents` replaced option `query` with optional positional parameter for filter (like `find`).
237
+ * **global**: Agent `trsdk` parameters `host` and `port` in option `transfer_info` are replaced with parameter `url`, like `grpc://host:port`
228
238
 
229
239
  * 4.14.0 2023-09-22
230
240
 
231
241
  * New Features:
232
- * `server`: option `passphrase` for simpler command line (#114)
233
- * percent selector for entities identifier
234
- * `faspex5`: shared inbox and workgroup membership management
235
- * `faspex5`: invite external user to shared inbox
236
- * `faspex5`: package list and receive from workgroup and shared inbox
242
+ * `server`: Option `passphrase` for simpler command line (#114)
243
+ * Percent selector for entities identifier
244
+ * `faspex5`: Shared inbox and workgroup membership management
245
+ * `faspex5`: Invite external user to shared inbox
246
+ * `faspex5`: Package list and receive from workgroup and shared inbox
237
247
  * `config`: Command `ascp info` shows default transfer spec.
238
- * **global**: agent `httpgw` synchronous and asynchronous upload modes
239
- * `node`: command `bandwidth_average` to get average bandwidth of node, per periods
248
+ * **global**: Agent `httpgw` synchronous and asynchronous upload modes
249
+ * `node`: Command `bandwidth_average` to get average bandwidth of node, per periods
240
250
  * Issues Fixed:
241
- * option `ts`: deep add and remove of keys. (#117)
242
- * `faspex5`: user lookup for `packages send` shall be exact match (#120)
243
- * **global**: agent `direct` if transfer spec contains "paths" and elements with "destination", but first element has only "source", then destinations were ignored. Now "destination" all or none is enforced.
251
+ * Option `ts`: Deep add and remove of keys. (#117)
252
+ * `faspex5`: User lookup for `packages send` shall be exact match (#120)
253
+ * **global**: Agent `direct` if transfer spec contains "paths" and elements with "destination", but first element has only "source", then destinations were ignored. Now "destination" all or none is enforced.
244
254
  * Breaking Changes:
245
- * using `aoc files` or node gen4 operations (`browse`, `delete`) on a link will follow the link only if path ends with /
246
- * `shares`: command `repository` is changed to `files` for consistency with aoc and upcoming faspex5, but is still available as alias
247
- * `aoc`: better handling of shared links
248
- * **global**: option `value` is deprecated. Use positional parameter for creation data and option `query` for list/delete operations.
249
- * `config`: remove deprecated command: `export_to_cli`
250
- * `config`: removed all legacy preset command, newer command `preset` shall be used now.
251
- * `config`: SDK is now installed in $HOME/.aspera/sdk instead of $HOME/.aspera/ascli/sdk
252
- * `aoc`, `node`: Simplification: gen4 operations: show modify permission thumbnail are now directly under node gen 4 command. Command `file` is suppressed. Option `path` is suppressed. The default expected argument is a path. To provide a file id, use selector syntax: %id:_file_id_
253
- * `node`: option `token_type` is removed, as starting with HSTS 4.3 basic token is only allowed with access keys, so use gen4 operations: `acc do self`
255
+ * Using `aoc files` or node gen4 operations (`browse`, `delete`) on a link will follow the link only if path ends with /
256
+ * `shares`: Command `repository` is changed to `files` for consistency with aoc and upcoming faspex5, but is still available as alias
257
+ * `aoc`: Better handling of shared links
258
+ * **global**: Option `value` is deprecated. Use positional parameter for creation data and option `query` for list/delete operations.
259
+ * `config`: Remove deprecated command: `export_to_cli`
260
+ * `config`: Removed all legacy preset command, newer command `preset` shall be used now.
261
+ * `config`: SDK is now installed in `$HOME/.aspera/sdk` instead of `$HOME/.aspera/ascli/sdk`
262
+ * `aoc`, `node`: Simplification: gen4 operations: show modify permission thumbnail are now directly under node gen 4 command. Command `file` is suppressed. Option `path` is suppressed. The default expected argument is a path. To provide a file ID, use selector syntax: `%id:_file_id_`
263
+ * `node`: Option `token_type` is removed, as starting with HSTS 4.3 basic token is only allowed with access keys, so use gen4 operations: `acc do self`
254
264
 
255
265
  * 4.13.0 2023-06-29
256
266
 
257
267
  * New Features:
258
- * `preview`: option `reencode_ffmpeg` allows overriding all re-encoding options
259
- * `faspex5`: package delete (#107)
260
- * `faspex5`: package recv for inboxes and regular users (#108)
261
- * `faspex5`: smtp management
262
- * `faspex5`: use public link for authorization of package download, using option `link`
263
- * `faspex5`: list content of package, and allow partial download of package
264
- * `faspex5`: list packages support multiple pages and items limitations (`max` and `pmax`)
265
- * `aoc`: files operations with workspace-less user (#109)
268
+ * `preview`: Option `reencode_ffmpeg` allows overriding all re-encoding options
269
+ * `faspex5`: `package delete` (#107)
270
+ * `faspex5`: `package recv` for inboxes and regular users (#108)
271
+ * `faspex5`: SMTP management
272
+ * `faspex5`: Use public link for authorization of package download, using option `link`
273
+ * `faspex5`: List content of package, and allow partial download of package
274
+ * `faspex5`: List packages support multiple pages and items limitations (`max` and `pmax`)
275
+ * `aoc`: Files operations with workspace-less user (#109)
266
276
  * `node`: `async` with gen3 token (#110)
267
- * `node`: display of preview of file in terminal for access keys
277
+ * `node`: Display of preview of file in terminal for access keys
268
278
  * Issues Fixed:
269
- * `cos`: do not use refresh token when not supported
279
+ * `cos`: Do not use refresh token when not supported
270
280
  * **container**: SDK installed in other folder than `ascli` (#106)
271
281
  * Breaking Changes:
272
- * option `transfer_info` is now cumulative, setting several times merge values
273
- * change(deprecation): Removed support of Ruby 2.4 and 2.5 : too old, no security update since a long time. If you need older ruby version use older gem version.
282
+ * Option `transfer_info` is now cumulative, setting several times merge values
283
+ * Change(deprecation): Removed support of Ruby 2.4 and 2.5 : Too old, no security update since a long time. If you need older ruby version use older gem version.
274
284
 
275
285
  * 4.12.0 2023-03-20
276
286
 
277
287
  * New Features:
278
- * **container**: build image from official gem version, possibility to deploy beta as well
288
+ * **container**: Build image from official gem version, possibility to deploy beta as well
279
289
  * **global**: `delete` operation supports option `value` for deletion parameters
280
- * `aoc`: command `aoc packages recv` accepts option `query` to specify a shared inbox
290
+ * `aoc`: Command `aoc packages recv` accepts option `query` to specify a shared inbox
281
291
  * `faspex`: (v4) user delete accepts option `value` with value `{"destroy":true}` to delete users permanently
282
292
  * `faspex`: (v4) gateway to Faspex 5 for package send
283
- * `faspex5`: possibility to change email templates
284
- * `faspex5`: shared folder list and browse
285
- * `faspex5`: emulate Faspex 4 post-processing, plugin: `faspex5` command: `postprocessing`
286
- * `faspex5`: send package from remote source
287
- * `shares`: option `type` for command `shares admin user`
288
- * `shares`: full support for shares admin operations
293
+ * `faspex5`: Possibility to change email templates
294
+ * `faspex5`: Shared folder list and browse
295
+ * `faspex5`: Emulate Faspex 4 post-processing, plugin: `faspex5` command: `postprocessing`
296
+ * `faspex5`: Send package from remote source
297
+ * `shares`: Option `type` for command `shares admin user`
298
+ * `shares`: Full support for shares admin operations
289
299
  * Breaking Changes:
290
- * `shares`: command `shares admin user saml_import` replaced with `shares admin user import --type=saml`
291
- * `shares`: command `shares admin user ldap_import` replaced with `shares admin user add --type=ldap`
292
- * `shares`: command `app_authorizations` now has sub commands `show` and `modify`
293
- * `shares`: similar changes for `shares admin share user show`
294
- * option `ascp_opts` is removed, and replaced with `transfer_info` parameter `ascp_args`
300
+ * `shares`: Command `shares admin user saml_import` replaced with `shares admin user import --type=saml`
301
+ * `shares`: Command `shares admin user ldap_import` replaced with `shares admin user add --type=ldap`
302
+ * `shares`: Command `app_authorizations` now has sub commands `show` and `modify`
303
+ * `shares`: Similar changes for `shares admin share user show`
304
+ * Option `ascp_opts` is removed, and replaced with `transfer_info` parameter `ascp_args`
295
305
 
296
306
  * 4.11.0 2023-01-26
297
307
 
298
308
  * New Features:
299
- * **global**: `vault`: secret finder, migration from config file
300
- * **global**: allow removal of transfer spec parameter by setting value to `null`
301
- * **global**: option `ascp_opts` allows providing native `ascp` options on command line
302
- * `node`, `server`: command `sync` added to `node` (gen4) and `server` plugins, also available in `aoc`
309
+ * **global**: `vault`: Secret finder, migration from config file
310
+ * **global**: Allow removal of transfer spec parameter by setting value to `null`
311
+ * **global**: Option `ascp_opts` allows providing native `ascp` options on command line
312
+ * `node`, `server`: Command `sync` added to `node` (gen4) and `server` plugins, also available in `aoc`
303
313
  * Issues Fixed:
304
- * **global**: security: no shell interpolation
305
- * **global**: agent `node`: when WSS is used: no localhost (certificate)
314
+ * **global**: Security: no shell interpolation
315
+ * **global**: Agent `node`: when WSS is used: no localhost (certificate)
306
316
  * `aoc`: #99 `file download` for single shared folder
307
- * `faspex5`: change of API in Faspex 5 for send package (paths is mandatory for any type of transfer now)
317
+ * `faspex5`: Change of API in Faspex 5 for send package (paths is mandatory for any type of transfer now)
308
318
  * **global**: OAuth web authentication was broken, fixed now
309
319
  * Breaking Changes:
310
- * **container**: image has entry point
320
+ * **container**: Image has entry point
311
321
  * `aoc`: `admin res node` commands `v3` and `v4` replaced with `do` and command `v3` moved inside `do`
312
- * renamed options for `sync`
313
- * node gen4 operations are moved from aoc plugin to node plugin but made available where gen4 is used
314
- * if wss is enabled on server, use wss
315
- * lots of cleanup and refactoring
322
+ * Renamed options for `sync`
323
+ * Node gen4 operations are moved from aoc plugin to node plugin but made available where gen4 is used
324
+ * If wss is enabled on server, use wss
325
+ * Lots of cleanup and refactoring
316
326
 
317
327
  * 4.10.0 2022-12-02
318
328
 
319
329
  * New Features:
320
- * httpgw transfer agent: support api v2, support transfer through http proxy, including proxy password
321
- * `faspex5`: get bearer token
330
+ * `httpgw`: Transfer agent support API v2, support transfer through HTTP proxy, including proxy password
331
+ * `faspex5`: Get bearer token
322
332
  * Issues Fixed:
323
- * **container**: container version
333
+ * **container**: Container version
324
334
  * Breaking Changes:
325
- * `config`: option `secrets` is renamed to `vault`
335
+ * `config`: Option `secrets` is renamed to `vault`
326
336
 
327
337
  * 4.9.0 2022-09-15
328
338
 
329
339
  * New Features:
330
- * `shares`: import of SAML users and LDAP users
340
+ * `shares`: Import of SAML users and LDAP users
331
341
  * M1 apple silicon support SDK install (uses x86 ascp)
332
- * support bulk operation more globally (create/delete), not all ops , though
333
- * added missing transfer spec parameters, e.g. `src_base`, `password`
334
- * improved documentation on faspex and aoc package send
342
+ * Support bulk operation more globally (create/delete), not all ops , though
343
+ * Added missing transfer spec parameters, e.g. `src_base`, `password`
344
+ * Improved documentation on faspex and aoc package send
335
345
  * Issues Fixed:
336
346
  * `node do` command fixed
337
- * improved secret hiding from logs
347
+ * Improved secret hiding from logs
338
348
  * Breaking Changes:
339
- * removed rarely commands `nodeadmin`, `configuration`, `userdata`, `ctl` from plugin `server`
349
+ * Removed rarely commands `nodeadmin`, `configuration`, `userdata`, `ctl` from plugin `server`
340
350
  as well as option `cmd_prefix`
341
351
  * `ascli` runs as user `cliuser` instead of `root` in container
342
- * default access right for config folder is now user only, including private keys
352
+ * Default access right for config folder is now user only, including private keys
343
353
 
344
354
  * 4.8.0 2022-06-16
345
355
 
346
356
  * New Features:
347
357
  * #76 add resource `group_membership` in `aoc`
348
- * add resource `metadata_profile` in `faspex5`
349
- * add command `user profile` in `faspex5`
350
- * add config wizard for `faspex5`
358
+ * Add resource `metadata_profile` in `faspex5`
359
+ * Add command `user profile` in `faspex5`
360
+ * Add config wizard for `faspex5`
351
361
  * #75 gem is signed
352
362
  * Breaking Changes:
353
- * removed dependency on gem `grpc` which is used only for the `trsdk` transfer agent. Users can install the gem manually if needed.
354
- * hash vault keys are string instead of symbol
355
- * cleanup with rubocop, all strings are immutable now by default, list constants are frozen
356
- * removed Hash.dig implementation because it is by default in Ruby >= 2.3
357
- * default is now to hide secrets on command output. Set option `show_secrets` to reveal secrets.
358
- * option `insecure` displays a warning
363
+ * Removed dependency on gem `grpc` which is used only for the `trsdk` transfer agent. Users can install the gem manually if needed.
364
+ * Hash vault keys are string instead of symbol
365
+ * Cleanup with rubocop, all strings are immutable now by default, list constants are frozen
366
+ * Removed Hash.dig implementation because it is by default in Ruby >= 2.3
367
+ * Default is now to hide secrets on command output. Set option `show_secrets` to reveal secrets.
368
+ * Option `insecure` displays a warning
359
369
 
360
370
  * 4.7.0 2022-03-23
361
371
 
362
372
  * New Features:
363
- * option to specify font used to generate image of text file in `preview`
373
+ * Option to specify font used to generate image of text file in `preview`
364
374
  * #66 improvement for content protection (support standard transfer spec options for direct agent)
365
- * option `fpac` is now applicable to all ruby based HTTP connections, i.e. API calls
366
- * option `show_secrets` to reveal secrets in command output
367
- * added and updated commands for Faspex 5
368
- * option `cache_tokens`
375
+ * Option `fpac` is now applicable to all ruby based HTTP connections, i.e. API calls
376
+ * Option `show_secrets` to reveal secrets in command output
377
+ * Added and updated commands for Faspex 5
378
+ * Option `cache_tokens`
369
379
  * Faspex4 dropbox packages can now be received by id
370
380
  * Issues Fixed:
371
381
  * After AoC version update, wizard did not detect AoC properly
372
382
  * Breaking Changes:
373
- * command `conf gem path` replaces `conf gem_path`
374
- * option `fpac` expects a value instead of URL
375
- * option `cipher` in transfer spec must have hyphen
376
- * renamed option `log_passwords` to `log_secrets`
377
- * removed plugin `shares2` as products is now EOL
383
+ * Command `conf gem path` replaces `conf gem_path`
384
+ * Option `fpac` expects a value instead of URL
385
+ * Option `cipher` in transfer spec must have hyphen
386
+ * Renamed option `log_passwords` to `log_secrets`
387
+ * Removed plugin `shares2` as products is now EOL
378
388
 
379
389
  * 4.6.0 2022-02-04
380
390
 
381
391
  * New Features:
382
- * command `conf plugin create`
383
- * global option `plugin_folder`
384
- * global option `transpose_single`
385
- * simplified metadata passing for shared inbox package creation in AoC
392
+ * Command `conf plugin create`
393
+ * Global option `plugin_folder`
394
+ * Global option `transpose_single`
395
+ * Simplified metadata passing for shared inbox package creation in AoC
386
396
  * Issues Fixed:
387
397
  * #60 ascli executable was not installed by default in 4.5.0
388
- * add password hiding case in logs
398
+ * Add password hiding case in logs
389
399
  * Breaking Changes:
390
- * command `aoc packages shared_inboxes list` replaces `aoc user shared_inboxes`
391
- * command `aoc user profile` replaces `aoc user info`
392
- * command `aoc user workspaces list` replaces `aoc user workspaces`
393
- * command `aoc user workspaces current` replaces `aoc workspace`
394
- * command `conf plugin list` replaces `conf plugins`
395
- * command `conf connect` simplified
400
+ * Command `aoc packages shared_inboxes list` replaces `aoc user shared_inboxes`
401
+ * Command `aoc user profile` replaces `aoc user info`
402
+ * Command `aoc user workspaces list` replaces `aoc user workspaces`
403
+ * Command `aoc user workspaces current` replaces `aoc workspace`
404
+ * Command `conf plugin list` replaces `conf plugins`
405
+ * Command `conf connect` simplified
396
406
 
397
407
  * 4.5.0 2021-12-27
398
408
 
399
409
  * New Features:
400
- * support transfer agent: [Transfer SDK](README.md#agt_trsdk)
401
- * support [http socket options](README.md#http_options)
402
- * logs hide passwords and secrets, option `log_passwords` to enable logging secrets
410
+ * Support transfer agent: [Transfer SDK](README.md#agt_trsdk)
411
+ * Support [http socket options](README.md#http_options)
412
+ * Logs hide passwords and secrets, option `log_passwords` to enable logging secrets
403
413
  * `config vault` supports encrypted passwords, also macos keychain
404
414
  * `config preset` command for consistency with id
405
- * identifier can be provided using either option `id` or directly after the command, e.g. `delete 123` is the same as `delete --id=123`
415
+ * Identifier can be provided using either option `id` or directly after the command, e.g. `delete 123` is the same as `delete --id=123`
406
416
  * Issues Fixed:
407
- * various smaller fixes and renaming of some internal classes (transfer agents and few other)
417
+ * Various smaller fixes and renaming of some internal classes (transfer agents and few other)
408
418
  * Breaking Changes:
409
- * when using wss, use [ruby's CA certs](README.md#certificates)
410
- * unexpected parameter makes exit code not zero
411
- * options `id` and `name` cannot be specified at the same time anymore, use [positional identifier or name selection](README.md#res_select)
419
+ * When using wss, use [ruby's CA certs](README.md#certificates)
420
+ * Unexpected parameter makes exit code not zero
421
+ * Options `id` and `name` cannot be specified at the same time anymore, use [positional identifier or name selection](README.md#res_select)
412
422
  * `aoc admin res node` does not take workspace main node as default node if no `id` specified.
413
423
  * : `orchestrator workflow status` requires id, and supports special id `ALL`
414
424
 
@@ -421,82 +431,82 @@
421
431
  * `node` plugin accepts bearer token and access key as credential
422
432
  * `node` option `token_type` allows using basic token in addition to aspera type.
423
433
  * Breaking Changes:
424
- * `server`: option `username` not mandatory anymore: xfer user is by default. If transfer spec token is provided, password or keys are optional, and bypass keys are used by default.
425
- * resource `apps_new` of `aoc` replaced with `application` (more clear)
434
+ * `server`: Option `username` not mandatory anymore: `xfer` user is by default. If transfer spec token is provided, password or keys are optional, and bypass keys are used by default.
435
+ * Resource `apps_new` of `aoc` replaced with `application` (more clear)
426
436
 
427
437
  * 4.3.0 2021-10-19
428
438
 
429
439
  * New Features:
430
- * parameter `multi_incr_udp` for option `transfer_info`: control if UDP port is incremented when multi-session is used on [`direct`](README.md#agt_direct) transfer agent.
431
- * command `aoc files node_info` to get node information for a given folder in the Files application of AoC. Allows cross-org or cross-workspace transfers.
440
+ * Parameter `multi_incr_udp` for option `transfer_info`: control if UDP port is incremented when multi-session is used on [`direct`](README.md#agt_direct) transfer agent.
441
+ * Command `aoc files node_info` to get node information for a given folder in the Files application of AoC. Allows cross-org or cross-workspace transfers.
432
442
 
433
443
  * 4.2.2 2021-09-23
434
444
 
435
445
  * New Features:
436
446
  * `faspex package list` retrieves the whole list, not just first page
437
- * support web based auth to aoc and faspex 5 using HTTPS, new dependency on gem `webrick`
438
- * the error "Remote host is not who we expected" displays a special remediation message
447
+ * Support web based auth to aoc and faspex 5 using HTTPS, new dependency on gem `webrick`
448
+ * The error "Remote host is not who we expected" displays a special remediation message
439
449
  * `conf ascp spec` displays supported transfer spec
440
- * options `notif_to` and `notif_template` to send email notifications on transfer (and other events)
450
+ * Options `notif_to` and `notif_template` to send email notifications on transfer (and other events)
441
451
  * Issues Fixed:
442
- * space character in `faspe:` url are percent encoded if needed
443
- * `preview scan`: if file_id is unknown, ignore and continue scan
452
+ * Space character in `faspe:` url are percent encoded if needed
453
+ * `preview scan`: If file_id is unknown, ignore and continue scan
444
454
  * Breaking Changes:
445
- * for commands that potentially execute several transfers (`package recv --id=ALL`), if one transfer fails then ascli exits with code 1 (instead of zero=success)
446
- * option `notify` or `aoc` replaced with `notif_to` and `notif_template`
455
+ * For commands that potentially execute several transfers (`package recv --id=ALL`), if one transfer fails then ascli exits with code 1 (instead of zero=success)
456
+ * Option `notify` or `aoc` replaced with `notif_to` and `notif_template`
447
457
 
448
458
  * 4.2.1 2021-09-01
449
459
 
450
460
  * New Features:
451
- * command `faspex package recv` supports link of type: `faspe:`
452
- * command `faspex package recv` supports option `recipient` to specify dropbox with leading `*`
461
+ * Command `faspex package recv` supports link of type: `faspe:`
462
+ * Command `faspex package recv` supports option `recipient` to specify dropbox with leading `*`
453
463
 
454
464
  * 4.2.0 2021-08-24
455
465
 
456
466
  * New Features:
457
- * command `aoc remind` to receive organization membership by email
458
- * in `preview` option `value` to filter out on file name
467
+ * Command `aoc remind` to receive organization membership by email
468
+ * In `preview` option `value` to filter out on file name
459
469
  * `initdemo` to initialize for demo server
460
470
  * [`direct`](README.md#agt_direct) transfer agent options: `spawn_timeout_sec` and `spawn_delay_sec`
461
471
  * Issues Fixed:
462
- * on Windows `conf ascp use` expects ascp.exe
472
+ * On Windows `conf ascp use` expects ascp.exe
463
473
  * (break) multi_session_threshold is Integer, not String
464
474
  * `conf ascp install` renames sdk folder if it already exists (leftover shared lib may make fail)
465
- * removed replace_illegal_chars from default aspera.conf causing "Error creating illegal char conversion table"
475
+ * Removed `replace_illegal_chars` from default `aspera.conf` causing "Error creating illegal char conversion table"
466
476
  * Breaking Changes:
467
477
  * `aoc apiinfo` is removed, use `aoc servers` to provide the list of cloud systems
468
- * parameters for resume in `transfer-info` for [`direct`](README.md#agt_direct) are now in sub-key `"resume"`
478
+ * Parameters for resume in `transfer-info` for [`direct`](README.md#agt_direct) are now in sub-key `"resume"`
469
479
 
470
480
  * 4.1.0 2021-06-23
471
481
 
472
482
  * New Features:
473
- * update documentation with regard to offline and docker installation
474
- * renamed command `nagios_check` to `health`
475
- * agent `http_gw` now supports upload
476
- * added option `sdk_url` to install SDK from local file for offline install
477
- * check new gem version periodically
478
- * the --fields= option, support -_field_name_ to remove a field from default fields
483
+ * Update documentation with regard to offline and docker installation
484
+ * Renamed command `nagios_check` to `health`
485
+ * Agent `http_gw` now supports upload
486
+ * Added option `sdk_url` to install SDK from local file for offline install
487
+ * Check new gem version periodically
488
+ * The --fields= option, support -_field_name_ to remove a field from default fields
479
489
  * Oauth tokens are discarded automatically after 30 minutes (useful for COS delegated refresh tokens)
480
490
  * `mimemagic` is now optional, needs manual install for `preview`, compatible with version 0.4.x
481
491
  * AoC a password can be provided for a public link
482
492
  * `conf doc` take an optional parameter to go to a section
483
- * initial support for Faspex 5 Beta 1
493
+ * Initial support for Faspex 5 Beta 1
484
494
  * Issues Fixed:
485
- * remove keys from transfer spec and command line when not needed
486
- * default to create_dir:true so that sending single file to a folder does not rename file if folder does not exist
495
+ * Remove keys from transfer spec and command line when not needed
496
+ * Default to `create_dir`:`true` so that sending single file to a folder does not rename file if folder does not exist
487
497
 
488
498
  * 4.0.0 2021-02-03
489
499
 
490
500
  * New Features:
491
- * now available as open source (github) with general cleanup
492
- * added possibility to install SDK: `config ascp install`
501
+ * Now available as open source (GitHub) with general cleanup
502
+ * Added possibility to install SDK: `config ascp install`
493
503
  * Breaking Changes:
494
- * changed default tool name from `mlia` to `ascli`
495
- * changed `aspera` command to `aoc`
496
- * changed gem name from `asperalm` to `aspera-cli`
497
- * changed module name from `Asperalm` to `Aspera`
498
- * removed command `folder` in `preview`, merged to `scan`
499
- * persistency files go to sub folder instead of main folder
504
+ * Changed default tool name from `mlia` to `ascli`
505
+ * Changed `aspera` command to `aoc`
506
+ * Changed gem name from `asperalm` to `aspera-cli`
507
+ * Changed module name from `Asperalm` to `Aspera`
508
+ * Removed command `folder` in `preview`, merged to `scan`
509
+ * Persistency files go to sub folder instead of main folder
500
510
 
501
511
  * 0.11.8
502
512
 
@@ -504,300 +514,300 @@
504
514
 
505
515
  * 0.11.7
506
516
 
507
- * rework on rest call error handling
508
- * use option `display` with value `data` to remove out of extraneous information
509
- * fixed option `lock_port` not working
510
- * generate special icon if preview failed
511
- * possibility to choose transfer progress bar type with option `progress`
517
+ * Rework on rest call error handling
518
+ * Use option `display` with value `data` to remove out of extraneous information
519
+ * Fixed option `lock_port` not working
520
+ * Generate special icon if preview failed
521
+ * Possibility to choose transfer progress bar type with option `progress`
512
522
  * AoC package creation now output package id
513
523
 
514
524
  * 0.11.6
515
525
 
516
- * `orchestrator`: added more choice in auth type
517
- * `preview`: cleanup in generator (removed and renamed parameters)
518
- * `preview`: better documentation
519
- * `preview`: animated thumbnails for video (option: `video_png_conv=animated`)
520
- * `preview`: new event trigger: `trevents` (`events` seems broken)
521
- * `preview`: unique tmp folder to avoid clash of multiple instances
522
- * repo: added template for secrets used for testing
526
+ * `orchestrator`: Added more choice in auth type
527
+ * `preview`: Cleanup in generator (removed and renamed parameters)
528
+ * `preview`: Better documentation
529
+ * `preview`: Animated thumbnails for video (option: `video_png_conv=animated`)
530
+ * `preview`: New event trigger: `trevents` (`events` seems broken)
531
+ * `preview`: Unique tmp folder to avoid clash of multiple instances
532
+ * Repo: Added template for secrets used for testing
523
533
 
524
534
  * 0.11.5
525
535
 
526
- * added option `default_ports` for AoC (see manual)
527
- * allow bulk delete in `aspera files` with option `bulk=yes`
528
- * fix getting connect versions
529
- * added section for Aix
530
- * support all ciphers for [`direct`](README.md#agt_direct) agent (including gcm, etc..)
531
- * added transfer spec param `apply_local_docroot` for [`direct`](README.md#agt_direct)
536
+ * Added option `default_ports` for AoC (see manual)
537
+ * Allow bulk delete in `aspera files` with option `bulk=yes`
538
+ * Fix getting connect versions
539
+ * Added section for Aix
540
+ * Support all ciphers for [`direct`](README.md#agt_direct) agent (including gcm, etc..)
541
+ * Added transfer spec param `apply_local_docroot` for [`direct`](README.md#agt_direct)
532
542
 
533
543
  * 0.11.4
534
544
 
535
- * possibility to give shared inbox name when sending a package (else use id and type)
545
+ * Possibility to give shared inbox name when sending a package (else use id and type)
536
546
 
537
547
  * 0.11.3
538
548
 
539
- * minor fixes on multi-session: avoid exception on progress bar
549
+ * Minor fixes on multi-session: Avoid exception on progress bar
540
550
 
541
551
  * 0.11.2
542
552
 
543
- * fixes on multi-session: progress bat and transfer spec param for "direct"
553
+ * Fixes on multi-session: Progress bat and transfer spec param for "direct"
544
554
 
545
555
  * 0.11.1
546
556
 
547
- * enhanced short_link creation commands (see examples)
557
+ * Enhanced short_link creation commands (see examples)
548
558
 
549
559
  * 0.11
550
560
 
551
- * add transfer spec option (agent `direct` only) to provide file list directly to ascp: `EX_file_list`.
561
+ * Add transfer spec option (agent `direct` only) to provide file list directly to ascp: `EX_file_list`.
552
562
 
553
563
  * 0.10.18
554
564
 
555
- * new option in. `server` : `ssh_options`
565
+ * New option in. `server` : `ssh_options`
556
566
 
557
567
  * 0.10.17
558
568
 
559
- * fixed problem on `server` for option `ssh_keys`, now accepts both single value and list.
560
- * new modifier: `@list:<separator>val1<separator>...`
569
+ * Fixed problem on `server` for option `ssh_keys`, now accepts both single value and list.
570
+ * New modifier: `@list:<separator>val1<separator>...`
561
571
 
562
572
  * 0.10.16
563
573
 
564
- * added list of shared inboxes in workspace (or global), use `--query=@json:'{}'`
574
+ * Added list of shared inboxes in workspace (or global), use `--query=@json:'{}'`
565
575
 
566
576
  * 0.10.15
567
577
 
568
- * in case of command line error, display the error cause first, and non-parsed argument second
578
+ * In case of command line error, display the error cause first, and non-parsed argument second
569
579
  * AoC : Activity / Analytics
570
580
 
571
581
  * 0.10.14
572
582
 
573
- * added missing bss plugin
583
+ * Added missing bss plugin
574
584
 
575
585
  * 0.10.13
576
586
 
577
- * added Faspex5 (use option `value` to give API arguments)
587
+ * Added Faspex5 (use option `value` to give API arguments)
578
588
 
579
589
  * 0.10.12
580
590
 
581
- * added support for AoC node registration keys
582
- * replaced option : `local_resume` with `transfer_info` for agent [`direct`](README.md#agt_direct)
591
+ * Added support for AoC node registration keys
592
+ * Replaced option : `local_resume` with `transfer_info` for agent [`direct`](README.md#agt_direct)
583
593
  * Transfer agent is no more a Singleton instance, but only one is used in CLI
584
- * `@incps` : new extended value modifier
585
- * ATS: no more provides access keys secrets: now user must provide it
586
- * begin work on "aoc" transfer agent
594
+ * `@incps` : New extended value modifier
595
+ * ATS: No more provides access keys secrets: now user must provide it
596
+ * Begin work on "aoc" transfer agent
587
597
 
588
598
  * 0.10.11
589
599
 
590
- * minor refactor and fixes
600
+ * Minor refactor and fixes
591
601
 
592
602
  * 0.10.10
593
603
 
594
- * fix on documentation
604
+ * Fix on documentation
595
605
 
596
606
  * 0.10.9.1
597
607
 
598
- * add total number of items for AoC resource list
599
- * better gem version dependency (and fixes to support Ruby 2.0.0)
600
- * removed aoc search_nodes
608
+ * Add total number of items for AoC resource list
609
+ * Better gem version dependency (and fixes to support Ruby 2.0.0)
610
+ * Removed aoc search_nodes
601
611
 
602
612
  * 0.10.8
603
613
 
604
- * removed option: `fasp_proxy`, use pseudo transfer spec parameter: `EX_fasp_proxy_url`
605
- * removed option: `http_proxy`, use pseudo transfer spec parameter: `EX_http_proxy_url`
606
- * several other changes..
614
+ * Removed option: `fasp_proxy`, use pseudo transfer spec parameter: `EX_fasp_proxy_url`
615
+ * Removed option: `http_proxy`, use pseudo transfer spec parameter: `EX_http_proxy_url`
616
+ * Several other changes..
607
617
 
608
618
  * 0.10.7
609
619
 
610
- * fix: ascli fails when username cannot be computed on Linux.
620
+ * Fix: `ascli` fails when username cannot be computed on Linux.
611
621
 
612
622
  * 0.10.6
613
623
 
614
- * FaspManager: transfer spec `authentication` no more needed for local transfer to use Aspera public keys. public keys will be used if there is a token and no key or password is provided.
615
- * gem version requirements made more open
624
+ * FaspManager: Transfer spec `authentication` no more needed for local transfer to use Aspera public keys. public keys will be used if there is a token and no key or password is provided.
625
+ * Gem version requirements made more open
616
626
 
617
627
  * 0.10.5
618
628
 
619
- * fix faspex package receive command not working
629
+ * Fix faspex package receive command not working
620
630
 
621
631
  * 0.10.4
622
632
 
623
- * new options for AoC : `secrets`
633
+ * New options for AoC : `secrets`
624
634
  * `ACLI-533` temp file list folder to use file lists is set by default, and used by `asession`
625
635
 
626
636
  * 0.10.3
627
637
 
628
- * included user name in oauth bearer token cache for AoC when JWT is used.
638
+ * Included user name in oauth bearer token cache for AoC when JWT is used.
629
639
 
630
640
  * 0.10.2
631
641
 
632
- * updated `search_nodes` to be more generic, so it can search not only on access key, but also other queries.
633
- * added doc for "cargo" like actions
634
- * added doc for multi-session
642
+ * Updated `search_nodes` to be more generic, so it can search not only on access key, but also other queries.
643
+ * Added doc for "cargo" like actions
644
+ * Added doc for multi-session
635
645
 
636
646
  * 0.10.1
637
647
 
638
648
  * AoC and node v4 "browse" works now on non-folder items: file, link
639
- * initial support for AoC automation (do not use yet)
649
+ * Initial support for AoC automation (do not use yet)
640
650
 
641
651
  * 0.10
642
652
 
643
- * support for transfer using IBM Cloud Object Storage
644
- * improved `find` action using arbitrary expressions
653
+ * Support for transfer using IBM Cloud Object Storage
654
+ * Improved `find` action using arbitrary expressions
645
655
 
646
656
  * 0.9.36
647
657
 
648
- * added option to specify file pair lists
658
+ * Added option to specify file pair lists
649
659
 
650
660
  * 0.9.35
651
661
 
652
- * updated plugin `preview` , changed parameter names, added documentation
653
- * fix in `ats` plugin : instance id needed in request header
662
+ * `preview`: Changed parameter names, added documentation
663
+ * `ats`: Fix: instance ID needed in request header
654
664
 
655
665
  * 0.9.34
656
666
 
657
- * parser "@preset" can be used again in option "transfer_info"
658
- * some documentation re-organizing
667
+ * Parser "@preset" can be used again in option "transfer_info"
668
+ * Some documentation re-organizing
659
669
 
660
670
  * 0.9.33
661
671
 
662
- * new command to display basic token of node
663
- * new command to display bearer token of node in AoC
664
- * the --fields= option, support +_field_name_ to add a field to default fields
665
- * many small changes
672
+ * New command to display basic token of node
673
+ * New command to display bearer token of node in AoC
674
+ * The --fields= option, support +_field_name_ to add a field to default fields
675
+ * Many small changes
666
676
 
667
677
  * 0.9.32
668
678
 
669
- * all Faspex public links are now supported
670
- * removed faspex operation `recv_publink`
671
- * replaced with option `link` (consistent with AoC)
679
+ * All Faspex public links are now supported
680
+ * Removed faspex operation `recv_publink`
681
+ * Replaced with option `link` (consistent with AoC)
672
682
 
673
683
  * 0.9.31
674
684
 
675
- * added more support for public link: receive and send package, to user or dropbox and files view.
676
- * delete expired file lists
677
- * changed text table gem from text-table to terminal-table because it supports multiline values
685
+ * Added more support for public link: receive and send package, to user or dropbox and files view.
686
+ * Delete expired file lists
687
+ * Changed text table gem from text-table to terminal-table because it supports multiline values
678
688
 
679
689
  * 0.9.27
680
690
 
681
- * basic email support with SMTP
682
- * basic proxy auto config support
691
+ * Basic email support with SMTP
692
+ * Basic proxy auto config support
683
693
 
684
694
  * 0.9.26
685
695
 
686
- * table display with --fields=ALL now includes all column names from all lines, not only first one
687
- * unprocessed argument shows error even if there is an error beforehand
696
+ * Table display with --fields=ALL now includes all column names from all lines, not only first one
697
+ * Unprocessed argument shows error even if there is an error beforehand
688
698
 
689
699
  * 0.9.25
690
700
 
691
- * the option `value` of command `find`, to filter on name, is not optional
701
+ * The option `value` of command `find`, to filter on name, is not optional
692
702
  * `find` now also reports all types (file, folder, link)
693
703
  * `find` now is able to report all fields (type, size, etc...)
694
704
 
695
705
  * 0.9.24
696
706
 
697
- * fix bug where AoC node to node transfer did not work
698
- * fix bug on error if ED25519 private key is defined in .ssh
707
+ * Fix bug where AoC node to node transfer did not work
708
+ * Fix bug on error if ED25519 private key is defined in .ssh
699
709
 
700
710
  * 0.9.23
701
711
 
702
- * defined REST error handlers, more error conditions detected
703
- * commands to select specific ascp location
712
+ * Defined REST error handlers, more error conditions detected
713
+ * Commands to select specific ascp location
704
714
 
705
715
  * 0.9.21
706
716
 
707
- * supports simplified wizard using global client
708
- * only ascp binary is required, other SDK (keys) files are now generated
717
+ * Supports simplified wizard using global client
718
+ * Only ascp binary is required, other SDK (keys) files are now generated
709
719
 
710
720
  * 0.9.20
711
721
 
712
- * improved wizard (prepare for AoC global client id)
713
- * preview generator: added option : --skip-format=&lt;png,mp4&gt;
714
- * removed outdated pictures from this doc
722
+ * Improved wizard (prepare for AoC global client id)
723
+ * Preview generator: Added option : --skip-format=&lt;png,mp4&gt;
724
+ * Removed outdated pictures from this doc
715
725
 
716
726
  * 0.9.19
717
727
 
718
- * added command aspera bearer --scope=xx
728
+ * Added command aspera bearer --scope=xx
719
729
 
720
730
  * 0.9.18
721
731
 
722
- * enhanced aspera admin events to support query
732
+ * Enhanced aspera admin events to support query
723
733
 
724
734
  * 0.9.16
725
735
 
726
736
  * AoC transfers are now reported in activity app
727
- * new interface for Rest class authentication (keep backward compatibility)
737
+ * New interface for Rest class authentication (keep backward compatibility)
728
738
 
729
739
  * 0.9.15
730
740
 
731
- * new feature: "find" command in aspera files
732
- * sample code for transfer API
741
+ * New feature: "find" command in aspera files
742
+ * Sample code for transfer API
733
743
 
734
744
  * 0.9.12
735
745
 
736
- * add nagios commands
737
- * support of ATS for IBM Cloud, removed old version based on aspera id
746
+ * Add nagios commands
747
+ * Support of ATS for IBM Cloud, removed old version based on aspera id
738
748
 
739
749
  * 0.9.11
740
750
 
741
- * change(break): @stdin is now @stdin:
742
- * support of ATS for IBM Cloud, removed old version based on aspera id
751
+ * Change(break): @stdin is now @stdin:
752
+ * Support of ATS for IBM Cloud, removed old version based on aspera id
743
753
 
744
754
  * 0.9.10
745
755
 
746
- * change(break): parameter transfer-node becomes more generic: transfer-info
747
- * Display SaaS storage usage with command: aspera admin res node --id=nn info
748
- * cleaner way of specifying source file list for transfers
749
- * change(break): replaced download_mode option with http_download action
756
+ * Change(break): Parameter transfer-node becomes more generic: `transfer-info`
757
+ * Display SaaS storage usage with command: `aspera admin res node --id=nn info`
758
+ * Cleaner way of specifying source file list for transfers
759
+ * Change(break): Replaced download_mode option with http_download action
750
760
 
751
761
  * 0.9.9
752
762
 
753
- * change(break): "aspera package send" parameter deprecated, use the --value option instead with "recipients" value. See example.
763
+ * Change(break): "aspera package send" parameter deprecated, use the --value option instead with "recipients" value. See example.
754
764
  * Now supports "cargo" for Aspera on Cloud (automatic package download)
755
765
 
756
766
  * 0.9.8
757
767
 
758
- * Faspex: use option once_only set to yes to enable cargo like function. id=NEW deprecated.
759
- * AoC: share to share transfer with command "transfer"
768
+ * Faspex: Use option once_only set to yes to enable cargo like function. id=NEW deprecated.
769
+ * AoC: Share to share transfer with command "transfer"
760
770
 
761
771
  * 0.9.7
762
772
 
763
- * homogeneous transfer spec for `node` and [`direct`](README.md#agt_direct) transfer agents
764
- * preview persistency goes to unique file by default
765
- * catch mxf extension in preview as video
766
- * Faspex: possibility to download all packages by specifying id=ALL
767
- * Faspex: to come: cargo-like function to download only new packages with id=NEW
773
+ * Homogeneous transfer spec for `node` and [`direct`](README.md#agt_direct) transfer agents
774
+ * Preview persistency goes to unique file by default
775
+ * Catch mxf extension in preview as video
776
+ * Faspex: Possibility to download all packages by specifying id=ALL
777
+ * Faspex: To come: Cargo-like function to download only new packages with id=NEW
768
778
 
769
779
  * 0.9.6
770
780
 
771
- * change(break): `@param:`is now `@preset:` and is generic
772
- * AoC: added command to display current workspace information
781
+ * Change(break): `@param:`is now `@preset:` and is generic
782
+ * AoC: Added command to display current workspace information
773
783
 
774
784
  * 0.9.5
775
785
 
776
- * new parameter: new_user_option used to choose between public_link and invite of external users.
777
- * fixed bug in wizard, and wizard uses now product detection
786
+ * New parameter: `new_user_option` used to choose between public_link and invite of external users.
787
+ * Fixed bug in wizard, and wizard uses now product detection
778
788
 
779
789
  * 0.9.4
780
790
 
781
- * change(break): onCloud file list follow --source convention as well (plus specific case for download when first path is source folder, and other are source file names).
791
+ * Change(break): `oncloud file list` follow --source convention as well (plus specific case for download when first path is source folder, and other are source file names).
782
792
  * AoC Package send supports external users
783
- * new command to export AoC config to Aspera CLI config
793
+ * New command to export AoC config to Aspera CLI config
784
794
 
785
795
  * 0.9.3
786
796
 
787
797
  * REST error message show host and code
788
- * option for quiet display
789
- * modified transfer interface and allow token re-generation on error
790
- * async add admin command
791
- * async add db parameters
792
- * change(break): new option "sources" to specify files to transfer
798
+ * Option for quiet display
799
+ * Modified transfer interface and allow token re-generation on error
800
+ * `async` add `admin` command
801
+ * `async` add db parameters
802
+ * Change(break): New option "sources" to specify files to transfer
793
803
 
794
804
  * 0.9.2
795
805
 
796
- * change(break): changed AoC package creation to match API, see AoC section
806
+ * Change(break): Changed AoC package creation to match API, see AoC section
797
807
 
798
808
  * 0.9.1
799
809
 
800
- * change(break): changed faspex package creation to match API, see Faspex section
810
+ * Change(break): Changed faspex package creation to match API, see Faspex section
801
811
 
802
812
  * 0.9
803
813
 
@@ -806,31 +816,31 @@
806
816
 
807
817
  * 0.7.6
808
818
 
809
- * add "sync" plugin
819
+ * Add `sync` plugin
810
820
 
811
821
  * 0.7
812
822
 
813
- * change(break): AoC package recv take option if for package instead of argument.
814
- * change(break): Rest class and Oauth class changed init parameters
815
- * AoC: receive package from public link
816
- * select by col value on output
817
- * added rename (AoC, node)
823
+ * Change(break): AoC `package recv` take option if for package instead of argument.
824
+ * Change(break): Rest class and Oauth class changed init parameters
825
+ * AoC: Receive package from public link
826
+ * Select by col value on output
827
+ * Added rename (AoC, node)
818
828
 
819
829
  * 0.6.19
820
830
 
821
- * change(break): ats server list provisioned &rarr; ats cluster list
822
- * change(break): ats server list clouds &rarr; ats cluster clouds
823
- * change(break): ats server list instance --cloud=x --region=y &rarr; ats cluster show --cloud=x --region=y
824
- * change(break): ats server id xxx &rarr; ats cluster show --id=xxx
825
- * change(break): ats subscriptions &rarr; ats credential subscriptions
826
- * change(break): ats api_key repository list &rarr; ats credential cache list
827
- * change(break): ats api_key list &rarr; ats credential list
828
- * change(break): ats access_key id xxx &rarr; ats access_key --id=xxx
831
+ * Change(break): `ats server list provisioned` &rarr; `ats cluster list`
832
+ * Change(break): `ats server list clouds` &rarr; `ats cluster clouds`
833
+ * Change(break): `ats server list instance --cloud=x --region=y` &rarr; `ats cluster show --cloud=x --region=y`
834
+ * Change(break): `ats server id xxx` &rarr; `ats cluster show --id=xxx`
835
+ * Change(break): `ats subscriptions` &rarr; `ats credential subscriptions`
836
+ * Change(break): `ats api_key repository list` &rarr; `ats credential cache list`
837
+ * Change(break): `ats api_key list` &rarr; `ats credential list`
838
+ * Change(break): `ats access_key id xxx` &rarr; `ats access_key --id=xxx`
829
839
 
830
840
  * 0.6.18
831
841
 
832
- * some commands take now --id option instead of id command.
842
+ * Some commands take now `--id` option instead of `id` command.
833
843
 
834
844
  * 0.6.15
835
845
 
836
- * change(break): "files" application renamed to "aspera" (for "Aspera on Cloud"). "repository" renamed to "files". Default is automatically reset, e.g. in config files and change key "files" to "aspera" in preset "default".
846
+ * Change(break): `files` application renamed to `aspera` (for "Aspera on Cloud"). `repository` renamed to `files`. Default is automatically reset, e.g. in config files and change key `files` to `aspera` in preset `default`.