aspera-cli 4.18.0 → 4.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71adcb69e4f2f4bb9db31713c2a5b7f251ddb052418d3a11e6061e55bf4979ce
-  data.tar.gz: af9cc1ab42b8b6f89d2e561becdb07e05e6ca0d6c2275e0834848ab3f2496eb6
+  metadata.gz: 89df3ebc2bf7a146a16e59154a73efcfc2e11f7767aba28725f9443de04772b7
+  data.tar.gz: 33469a2bc4991b106ab3002927e823f280c016fc070a2bdcbb3edb286506041d
 SHA512:
-  metadata.gz: b48fab716de4e3d3c3a4175c8a5a4139f02d0ff29f2a8e9c1e57b12f1fe6e0bbb1aed85eeb04a894087da6b360675695e0017a97be1ee210b1ff9b3b70beeeff
-  data.tar.gz: e31d43642a703b5b2a9b3f65ce712ed848b174b7dc122e7be760ef51849d292accc104f90acc02e4bc9c6eaae579246f6a68239b204ebb514a6d6783d0a82cb1
+  metadata.gz: d57c69a340b866cfe5c3003c94ecb3ebc8c61aba7011ee4b8683da60d9615dd060fb94ac153e16eb98bd11f7dfa1deb117b1ca2ecd5bfe5d46e5a390ec290a01
+  data.tar.gz: fa364474177bc6d2f648474b1eed12b45733e84a5d4896d3075225ed1212aed27f64725ba38a400a3f9c5da2e7e2acf46d6a41164e5d92c1e2ce3a94498c5401

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changes (Release notes)
 
+* 4.19.0
+  * New Features:
+    * `server`: add support for `async` (Aspera Sync) from Transfer SDK
+    * **global**: #156 support sending folders with httpgw
+    * **global**: new value for option `format`: `multi`
+  * Issues Fixed:
+    * `aoc`: #157 fix problem with `files browse` on a link
+    * `sync`: better documentation and handling of options.
+  * Breaking Changes:
+    * **global**: Default value for direct agent option `transfer_info.multi_incr_udp` is `true` on Windows, and now `false` on other platforms.
+    * **global**: Token based transfers now use the RSA key only. Direct agent option `transfer_info.client_ssh_key` allows changing this behavior.
+  
+* 4.18.1
+
+  * New Features:
+    * none
+  * Issues Fixed:
+    * **global**: #146 (@junkimu) Fix problem on Windows WRT terminal detection
+    * **global**: node gen4 (aoc) browsing through link now follows the link correctly
+    * `shares`: #147 Fix problem for `shares files mkdir`
+  * Breaking Changes:
+    * **global**: Removed option `id`, deprecated since 4.14.0
+
 * 4.18.0
   
   * New Features:

data/CONTRIBUTING.md

@@ -228,7 +228,7 @@ Then procedure is as follows:
 
 ## Docker image build
 
-The Dockerfile template allows customizing the optional copy of gem file , versus install from rubygems,org as well as customizing the retrieval of the SDK.
+The `Dockerfile.tmpl.erb` template allows customization of the optional copying of the `aspera-cli.gem` file, as opposed to installing from rubygems.org. It also supports customizing the retrieval of the SDK.
 
 ### Default image build
 
@@ -278,19 +278,11 @@ make docker_push_beta
 
 ## Single executable build
 
-It is possible to build `ascli` as a single native executable using `rubyc` (gem `ruby-packer`).
+Initially, `rubyc` (gem [`ruby-packer`](https://github.com/pmq20/ruby-packer) and [here](https://github.com/you54f/ruby-packer)) was used to build a single executable.
 
-```bash
-make single
-```
-
-This is based on tool `rubyc` (gem `ruby-packer`): either place the executable in folder `tmp`, or the architecture-specific version will be automatically downloaded.
+https://www.tebako.org/
 
-> **Note:** Perl `Findbin` is needed, install on Linux with:
-
-```bash
-sudo dnf install -y perl perl-FindBin perl-IPC-Cmd
-```
+A modern version of this is now used: [`tebako`](https://github.com/tamatebako/tebako) for which a container is provided.
 
 ## Long Term Implementation and delivery improvements
 
@@ -299,3 +291,4 @@ sudo dnf install -y perl perl-FindBin perl-IPC-Cmd
   - <https://github.com/oauth-xx/oauth2>
 - use gem Thor <http://whatisthor.com/> (or other standard Ruby CLI manager)
 - Package a single-file executable for various architectures with <https://github.com/pmq20/ruby-packer> (`rubyc`)
+- look at <https://github.com/phusion/traveling-ruby>

data/README.md

@@ -10,7 +10,7 @@
 
 ## Introduction
 
-Version : 4.18.0
+Version : 4.19.0
 
 Laurent/2016-2024
 
@@ -92,7 +92,7 @@ Once the gem is installed, `ascli` shall be accessible:
 
 ```console
 $ ascli --version
-4.18.0
+4.19.0
 ```
 
 ### First use
@@ -300,52 +300,6 @@ Download the Ruby installer executable from <https://rubyinstaller.org/downloads
 rubyinstaller-devkit-3.2.2-1-x64.exe /silent /currentuser /noicons /dir=C:\aspera-cli
 ```
 
-Installation without network:
-
-It is essentially the same procedure, but instead of retrieving files from internet, copy the files from a machine with internet access, and then install from those archives:
-
-- Download the `exe` Ruby installer from <https://rubyinstaller.org/downloads/>
-
-  ```bash
-  v=$(curl -s https://rubyinstaller.org/downloads/|sed -nEe 's|.*(https://.*/releases/download/.*exe).*|\1|p'|head -n 1)
-  curl -o ${v##*/} $v
-  ```
-
-- Create an archive with necessary gems: <https://help.rubygems.org/kb/rubygems/installing-gems-with-no-network>
-
-  ```bat
-  gem install aspera-cli -N -i my_gems
-  ```
-
-  Zip the files `*.gem` from folder `repo/my_gems`
-
-- Download the SDK from: <https://ibm.biz/aspera_sdk>
-
-Create a Zip with all those files, and transfer to the target system.
-
-Then, on the target system:
-
-- Unzip the archive
-- Execute the installer:
-
-```bat
-rubyinstaller-devkit-3.2.2-1-x64.exe /silent /currentuser /noicons /dir=C:\aspera-cli
-```
-
-- Install the gems:
-
-```bat
-gem install --force --local *.gem
-```
-
-- Install the SDK
-
-```bash
-ascli config ascp install --sdk-url=file:///sdk.zip
-```
-
-> **Note:** An example of installation script is provided: [docs/install.bat](docs/install.bat)
-
 #### macOS: `brew`
 
 **macOS** come with Ruby.
@@ -410,6 +364,26 @@ One can remove all installed gems, for example to start fresh:
 gem uninstall -axI $(ls $(gem env gemdir)/gems/|sed -e 's/-[^-]*$//'|sort -u)
 ```
 
+#### Linux as simple user
+
+If you don't have root access, you can install Ruby in your home directory using `rbenv` see [rbenv-installer](https://github.com/rbenv/rbenv-installer#rbenv-installer):
+
+```bash
+curl -fsSL https://github.com/rbenv/rbenv-installer/raw/HEAD/bin/rbenv-installer | bash
+```
+
+Then open a new terminal, or "source" the shell initialization script:
+
+```bash
+source ~/.bashrc
+```
+
+Then install Ruby:
+
+```bash
+rbenv install 3.2.2
+```
+
 #### Other Unixes (AIX)
 
 Ruby is sometimes made available as an installable package through third party providers.
@@ -544,7 +518,7 @@ ascli config ascp install
 If a local SDK installation is preferred instead of fetching from internet: one can specify the location of the SDK file:
 
 ```bash
-curl -Lso sdk.zip https://ibm.biz/aspera_sdk
+curl -Lso sdk.zip https://ibm.biz/aspera_transfer_sdk
 ```
 
 ```bash
@@ -574,6 +548,18 @@ Refer to section: [Transfer Agents](#transfer-clients-agents)
 
 > **Note:** No pre-packaged version is provided yet.
 
+#### Gem files and dependencies
+
+The sample script: [examples/build_package.sh](examples/build_package.sh) can be used to download all necessary gems and dependencies in a tar gz.
+
+```console
+$ ./build_package.sh aspera-cli 4.18.0
+
+Archive: aspera-cli-4.18.0-gems.tgz
+```
+
+#### Unix-like
+
 A method to build one is provided here:
 
 The procedure:
@@ -595,7 +581,7 @@ ascli --show-config --fields=sdk_url
 - Download the SDK archive from that URL
 
 ```bash
-curl -Lso sdk.zip https://ibm.biz/aspera_sdk
+curl -Lso sdk.zip https://ibm.biz/aspera_transfer_sdk
 ```
 
 - Transfer those 2 files to the target system
@@ -618,12 +604,48 @@ ascli config ascp install --sdk-url=file:///sdk.zip
 source ~/.rvm/scripts/rvm
 ```
 
-> **Note:** Alternatively, to download all necessary gems in folder `my_gems`, execute:
+#### Windows
+
+Installation without network:
+
+It is essentially the same procedure as installation for Windows with internet, but instead of retrieving files from internet, copy the files from a machine with internet access, and then install from those archives:
+
+- Download the `exe` Ruby installer from <https://rubyinstaller.org/downloads/>
+
+  ```bash
+  v=$(curl -s https://rubyinstaller.org/downloads/|sed -nEe 's|.*(https://.*/releases/download/.*exe).*|\1|p'|head -n 1)
+  curl -o ${v##*/} $v
+  ```
+
+- Create an archive with necessary gems like in previous section
+
+- Download the SDK from: <https://ibm.biz/aspera_transfer_sdk>
+
+- Create a Zip with all those files, and transfer to the target system.
+
+Then, on the target system:
+
+- Unzip the archive
+- Execute the installer:
+
+```bat
+rubyinstaller-devkit-3.2.2-1-x64.exe /silent /currentuser /noicons /dir=C:\aspera-cli
+```
+
+- Install the gems: Extract the gem archive, and then:
+
+```bat
+gem install --force --local *.gem
+```
+
+- Install the SDK
 
 ```bash
-gem install aspera-cli -N -i my_gems
+ascli config ascp install --sdk-url=file:///sdk.zip
 ```
 
+> **Note:** An example of installation script is provided: [docs/install.bat](docs/install.bat)
+
 ### Container
 
 The container image is: [`docker.io/martinlaurent/ascli`](https://hub.docker.com/r/docker.io/martinlaurent/ascli).
@@ -684,7 +706,7 @@ ascli -v
 ```
 
 ```text
-4.18.0
+4.19.0
 ```
 
 In order to keep persistency of configuration on the host, you should specify your user's configuration folder as a volume for the container.
@@ -1475,6 +1497,7 @@ If transposition of single object is not desired, use option: `transpose_single`
 The style of output can be set using the `format` option, supporting:
 
 - `table` : Text table (default)
+- `multi` : List of elements are displayed as a list of tables
 - `text` : Value as String
 - `ruby` : Ruby code
 - `json` : JSON code
@@ -1902,7 +1925,8 @@ ascp use /usr/bin/ascp
 check_update
 coffee
 coffee --ui=text
-coffee --ui=text --query=@json:'{"text":"true"}'
+coffee --ui=text --image=@json:'{"text":true,"double":false}'
+coffee --ui=text --image=@json:'{"text":true}'
 detect https://faspex4.example.com/path
 detect https://faspex5.example.com/path
 detect https://node.example.com/path
@@ -1937,8 +1961,8 @@ genkey my_key 4096
 image https://eudemo.asperademo.com/wallpaper.jpg
 initdemo
 open
-plugin create my_command
-plugin list
+plugins create my_command
+plugins list
 preset delete conf_name
 preset initialize conf_name @json:'{"p1":"v1","p2":"v2"}'
 preset list
@@ -2723,19 +2747,21 @@ Refer to section [FASP](#fasp-configuration).
 
 The `transfer_info` option accepts the following optional parameters to control multi-session, Web Socket Session, Resume policy and add any argument to `ascp`:
 
-| Name                   | Type  | Description |
-|------------------------|-------|-------------|
-| `wss`                  | Bool  | Web Socket Session<br/>Enable use of web socket session in case it is available<br/>Default: true |
-| `ascp_args`            | Array | Array of strings with native `ascp` arguments.<br/>Default: [] |
-| `spawn_timeout_sec`    | Float | Multi session<br/>Verification time that `ascp` is running<br/>Default: 3 |
-| `spawn_delay_sec`      | Float | Multi session<br/>Delay between startup of sessions<br/>Default: 2 |
-| `multi_incr_udp`       | Bool  | Multi Session<br/>Increment UDP port on multi-session<br/>If true, each session will have a different UDP port starting at `fasp_port` (or default 33001)<br/>Else, each session will use `fasp_port` (or `ascp` default)<br/>Default: true |
-| `trusted_certs`        | Array | List of repositories for trusted certificates. |
-| `resume`               | Hash  | Resume parameters. See below |
-| `resume.iter_max`      | int   | Max number of retry on error<br/>Default: 7 |
-| `resume.sleep_initial` | int   | First Sleep before retry<br/>Default: 2 |
-| `resume.sleep_factor`  | int   | Multiplier of sleep period between attempts<br/>Default: 2 |
-| `resume.sleep_max`     | int   | Default: 60 |
+| Name                   | Type    | Description |
+|------------------------|---------|-------------|
+| `wss`                  | Bool    | Web Socket Session<br/>Enable use of web socket session in case it is available<br/>Default: true |
+| `quiet`                | Bool    | If `true`, then `ascp` progress bar is not shown.<br/>Default: `false` |
+| `trusted_certs`        | Array   | List of repositories for trusted certificates. |
+| `client_ssh_key`       | String  | SSH Keys to use for token-based transfers. One of: `dsa_rsa`, `rsa`, `per_client`. Default: `rsa` |
+| `ascp_args`            | Array   | Array of strings with native `ascp` arguments.<br/>Default: `[]` |
+| `spawn_timeout_sec`    | Float   | Multi session<br/>Verification time that `ascp` is running<br/>Default: `3` |
+| `spawn_delay_sec`      | Float   | Multi session<br/>Delay between startup of sessions<br/>Default: `2` |
+| `multi_incr_udp`       | Bool    | Multi Session<br/>Increment UDP port on multi-session<br/>If `true`, each session will have a different UDP port starting at `fasp_port` (or default 33001)<br/>Else, each session will use `fasp_port` (or `ascp` default)<br/>Default: `true` on Windows, else `false` |
+| `resume`               | Hash    | Resume parameters. See below |
+| `resume.iter_max`      | Integer | Max number of retry on error<br/>Default: `7` |
+| `resume.sleep_initial` | Integer | First Sleep before retry<br/>Default: `2` |
+| `resume.sleep_factor`  | Integer | Multiplier of sleep period between attempts<br/>Default: `2` |
+| `resume.sleep_max`     | Integer | Default: `60` |
 
 In case of transfer interruption, the agent will **resume** a transfer up to `iter_max` time.
 Sleep between iterations is given by the following formula where `iter_index` is the current iteration index, starting at 0:
@@ -2745,7 +2771,7 @@ max( sleep_max , sleep_initial * sleep_factor ^ iter_index )
 ```
 
 By default, Ruby's root CA store is used to validate any HTTPS endpoint used by `ascp` (e.g. WSS).
-In order to use a custom certificate store, use the `trusted_certs` option.
+In order to use a custom certificate store, use the `trusted_certs` option of direct agent's option `transfer_info`.
 To use `ascp`'s default, use option: `--transfer-info=@json:'{"trusted_certs":null}'`.
 
 Some transfer errors are considered **retry-able** (e.g. timeout) and some other not (e.g. wrong password).
@@ -3032,7 +3058,7 @@ Columns:
 | fasp_port | int | Y | Y | Y | Y | Y | Specifies fasp (UDP) port.<br/>(-O {int}) |
 | fasp_url | string | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Only used in Faspex.<br/>(&lt;ignored&gt;) |
 | file_checksum | string | Y | Y | &nbsp; | &nbsp; | &nbsp; | Enable checksum reporting for transferred files by specifying the hash to use.<br/>Allowed values: sha-512, sha-384, sha-256, sha1, md5, none<br/>(&lt;ignored&gt;) |
-| http_fallback | bool<br/>string | Y | Y | Y | Y | Y | When true(1), attempts to perform an HTTP transfer if a FASP transfer cannot be performed.<br/>(-y (conversion){bool}|{string}) |
+| http_fallback | bool<br/>string | Y | Y | Y | Y | Y | When true(1), attempts to perform an HTTP transfer if a FASP transfer cannot be performed.<br/>(-y (conversion){bool}\|{string}) |
 | http_fallback_port | int | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Specifies http port when no cipher is used<br/>(-t {int}) |
 | https_fallback_port | int | Y | Y | Y | Y | Y | Specifies https port when cipher is used<br/>(-t {int}) |
 | keepalive | bool | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | The session is running in persistent session mode.<br/>(--keepalive) |
@@ -3539,7 +3565,7 @@ ascli server upload "faux:///mydir?file=testfile&count=1m&size=0&inc=2&seq=seque
 ```text
 ascli -h
 NAME
-        ascli -- a command line tool for Aspera Applications (v4.18.0)
+        ascli -- a command line tool for Aspera Applications (v4.19.0)
 
 SYNOPSIS
         ascli COMMANDS [OPTIONS] [ARGS]
@@ -3570,7 +3596,8 @@ ARGS
 OPTIONS: global
         --interactive=ENUM           Use interactive input of missing params: [no], yes
         --ask-options=ENUM           Ask even optional options: [no], yes
-        --format=ENUM                Output format: text, nagios, ruby, json, jsonpp, yaml, [table], csv, image
+        --struct-parser=ENUM         Default parser when expected value is a struct: json, ruby
+        --format=ENUM                Output format: text, nagios, ruby, json, jsonpp, yaml, [table], multi, csv, image
         --output=VALUE               Destination for results (String)
         --display=ENUM               Output only some information: [info], data, error
         --fields=VALUE               Comma separated list of: fields, or ALL, or DEF (String, Array, Regexp, Proc)
@@ -3594,7 +3621,7 @@ OPTIONS: global
         --pid-file=VALUE             Write process identifier to file, delete on exit (String)
 
 COMMAND: config
-SUBCOMMANDS: ascp check_update coffee detect documentation echo email_test file flush_tokens folder gem genkey image initdemo open plugins preset proxy_check pubkey remote_certificate smtp_settings throw vault wizard
+SUBCOMMANDS: ascp check_update coffee detect documentation echo email_test file flush_tokens folder gem genkey image initdemo open platform plugins preset proxy_check pubkey remote_certificate smtp_settings throw vault wizard
 OPTIONS:
         --home=VALUE                 Home folder for tool (String)
         --config-file=VALUE          Path to YAML file with preset configuration
@@ -3604,7 +3631,6 @@ OPTIONS:
         --query=VALUE                Additional filter for for some commands (list/delete) (Hash)
         --value=VALUE                Value for create, update, list filter (Hash) (deprecated: (4.14) Use positional value for create/modify or option: query for list/delete)
         --property=VALUE             Name of property to set (modify operation)
-        --id=VALUE                   Resource identifier (deprecated: (4.14) Use positional identifier after verb (modify,delete,show))
         --bulk=ENUM                  Bulk operation (only some): [no], yes
         --bfail=ENUM                 Bulk operation error handling: no, [yes]
     -N, --no-default                 Do not load default configuration for plugin
@@ -5019,6 +5045,9 @@ files browse /
 files browse / --url=my_private_link
 files browse / --url=my_public_link_folder_no_pass
 files browse / --url=my_public_link_folder_pass --password=my_public_link_password
+files browse my_remote_file
+files browse my_remote_folder
+files browse my_remote_folder/
 files delete /testsrc
 files download --transfer=alpha testdst/test_file.bin
 files download --transfer=connect testdst/test_file.bin
@@ -5036,8 +5065,11 @@ files show /
 files show testdst/test_file.bin
 files sync admin status --sync-info=@json:'{"name":"my_aoc_sync2","reset":true,"direction":"pull","local":{"path":"/data/local_sync"},"remote":{"path":"/testdst"}}'
 files sync admin status --sync-info=@json:'{"sessions":[{"name":"my_aoc_sync1","direction":"pull","local_dir":"/data/local_sync","remote_dir":"/testdst","reset":true}]}'
+files sync start --sync-info=@json:'{"name":"my_aoc_sync1","reset":true,"direction":"pull","local":{"path":"/data/local_sync"},"remote":{"path":"/testdst"}}'
 files sync start --sync-info=@json:'{"name":"my_aoc_sync2","reset":true,"direction":"pull","local":{"path":"/data/local_sync"},"remote":{"path":"/testdst"}}'
 files sync start --sync-info=@json:'{"sessions":[{"name":"my_aoc_sync1","direction":"pull","local_dir":"/data/local_sync","remote_dir":"/testdst","reset":true}]}'
+files sync start pull /testdst /data/local_sync --sync-info=@json:'{"reset":true,"quiet":false}'
+files sync start pull /testdst /data/local_sync --sync-info=@json:'{"sessions":[{"reset":true}]}'
 files thumbnail my_test_folder/video_file.mpg
 files thumbnail my_test_folder/video_file.mpg --query=@json:'{"text":true,"double":true}'
 files transfer push /testsrc --to-folder=/testdst test_file.bin
@@ -5389,7 +5421,7 @@ Example:
 - `ascli node browse /` : list files with **gen3/node user** API
 - `ascli node access_key do self browse /` : list files with **gen4/access key** API
 
-## Browse
+#### Browse
 
 Native API parameters can be placed in option `query`.
 
@@ -5805,8 +5837,8 @@ ssync summary %name:my_node_sync
 stream list
 sync admin status --sync-info=@json:'{"name":"my_node_sync2","reset":true,"direction":"pull","local":{"path":"/data/local_sync"},"remote":{"path":"/aspera-test-dir-tiny"}}'
 sync admin status --sync-info=@json:'{"sessions":[{"name":"my_node_sync1","direction":"pull","local_dir":"/data/local_sync","remote_dir":"/aspera-test-dir-tiny","reset":true}]}'
+sync start --sync-info=@json:'{"name":"my_node_sync1","reset":true,"quiet":false,"direction":"pull","local":{"path":"/data/local_sync"},"remote":{"path":"/aspera-test-dir-tiny"}}'
 sync start --sync-info=@json:'{"name":"my_node_sync2","reset":true,"direction":"pull","local":{"path":"/data/local_sync"},"remote":{"path":"/aspera-test-dir-tiny"}}'
-sync start --sync-info=@json:'{"sessions":[{"name":"my_node_sync1","direction":"pull","local_dir":"/data/local_sync","remote_dir":"/aspera-test-dir-tiny","reset":true}]}'
 transfer list --query=@json:'{"active_only":true}'
 transfer sessions
 transport
@@ -6337,6 +6369,14 @@ Then, the postprocessing script executed will be `script1.sh`.
 
 Environment variables at set to the values provided by the web hook which are the same as Faspex 4 postprocessing.
 
+### Faspex 5: Missing commands
+
+If a command is missing, then it is still possible to execute command by calling directly the API on the command line using `curl`:
+
+```bash
+curl -H "Authorization: $(ascli ascli bearer)" https://faspex5.example.com/aspera/faspex/api/v5/api_endpoint_here
+```
+
 ## Plugin: `faspex`: IBM Aspera Faspex v4
 
 > **Note:** For full details on Faspex API, refer to: [Reference on Developer Site](https://developer.ibm.com/apis/catalog/?search=faspex)
@@ -6573,9 +6613,11 @@ admin user ldap add the_name
 admin user local list
 admin user saml import @json:'{"id":"the_id","name_id":"the_name"}'
 files browse /
+files delete my_share1/new_folder
 files delete my_share1/test_file.bin
 files download --to-folder=. my_share1/test_file.bin
 files download --to-folder=. my_share1/test_file.bin --transfer=httpgw --transfer-info=@json:'{"url":"https://tst.example.com/path@"}'
+files mkdir my_share1/new_folder
 files upload --to-folder=https://shares.share1 'faux:///testfile?1m' --transfer=httpgw --transfer-info=@json:'{"url":"my_example.com/path@","synchronous":true,"api_version":"v1","upload_chunk_size":100000}'
 files upload --to-folder=my_share1 test_file.bin
 files upload --to-folder=my_share1 test_file.bin --transfer=httpgw --transfer-info=@json:'{"url":"https://tst.example.com/path@"}'
@@ -6749,6 +6791,8 @@ health
 > **Note:** Add `ascli faspio` in front of the commands:
 
 ```bash
+bridges create @json:'{"name":"test1","local":{"protocol":"tcp","tls_enabled":false,"port":"3000","bind_address":"127.0.0.1"},"forward":{"protocol":"fasp","tls_enabled":false,"port":"3994","bind_address":"127.0.0.1","host":["10.0.0.1"]}}'
+bridges delete --bulk=yes @json:@stdin:
 bridges list
 health
 ```
@@ -7087,28 +7131,52 @@ An interface for the `async` utility is provided in the following plugins:
 - `aoc files sync` (uses node)
 - `shares files sync` (uses node)
 
-The main advantage over the `async` command line when using `server` is the possibility to use a configuration file, using standard options of `ascli`.
+One advantage over the `async` command line is the possibility to use a configuration file, using standard options of `ascli`.
+Moreover `ascli` supports sync with application requiring token-based authorization.
 
-In this case, some of the `sync` parameters are filled by the related plugin using transfer spec parameters (e.g. including token).
+Some of the `sync` parameters are filled by the related plugin using transfer spec parameters (e.g. including token).
 
-> **Note:** All `sync` commands require an `async` enabled license and availability of the `async` executable (and `asyncadmin`).
+> **Note:** All `sync` commands require an `async` enabled license and availability of the `async` executable (and `asyncadmin`). The Transfer SDK 1.3 includes this.
 
-Two JSON syntax are supported for option `sync_info`.
+`sync` supports 0 or 3 arguments:
 
-### `async` JSON: API format
+- direction
+- local folder
+- remote folder
+
+Additional options can be provided with option `sync_info`, for which two syntax are possible, as follows.
+
+### `async` API and conf format
 
 It is the same payload as specified on the option `--conf` of `async` or in node API `/asyncs`.
 This is the preferred syntax and allows a single session definition.
-But there is no progress output nor error messages.
+
+> **Note:** No progress, nor error messages is provided on terminal.
 
 Documentation on Async node API can be found on [IBM Developer Portal](https://developer.ibm.com/apis/catalog?search=%22aspera%20sync%20api%22).
 
-### `async` JSON: Options mapping
+If 3 arguments are provided they are mapped to:
+
+- `direction`
+- `local.path`
+- `remote.path`
+
+### `async` options mapping
 
 `ascli` defines a JSON equivalent to regular `async`options.
 It is based on a JSON representation of `async` command line options.
 It allows definition of multiple sync sessions in a single command, although usually only one sync session is defined.
 
+This is the mode selection if there is either keys `sessions` or `instance` in option `sync_info`.
+
+> **Note:** Progress and error messages are provided on terminal like regular command line invocation of `async`.
+
+If 3 arguments are provided, they are applied to the first (and only) session and mapped to:
+
+- `direction`
+- `local_dir`
+- `remote_dir`
+
 ## Hot folder
 
 ### Requirements

data/examples/build_exec

@@ -0,0 +1,85 @@
+#!/bin/bash
+
+set -e
+
+if test $# -ne 2; then
+    echo "Usage: $0 <CLI_TARGET_EXECUTABLE> <CLI_ENTRY_SCRIPT>" 1>&2
+    exit 1
+fi
+
+CLI_TARGET_EXECUTABLE=$1
+CLI_ENTRY_SCRIPT=$(realpath $2)
+CLI_EXEC_NAME=$(basename $CLI_TARGET_EXECUTABLE)
+CLI_ROOT=$(dirname $(dirname $CLI_ENTRY_SCRIPT))
+
+echo "Project folder: $CLI_ROOT"
+echo "Executable:     $CLI_TARGET_EXECUTABLE"
+echo "Exec Name:      $CLI_EXEC_NAME"
+echo "Entry:          $CLI_ENTRY_SCRIPT"
+
+# tebako press --root=$(TB_WORK_DIR) --entry-point=ascli --output=$(TB_WORK_DIR)/$(CLI_TARGET_EXECUTABLE) --Ruby=3.2.4
+
+if true;then
+    tebako_command=tebako
+    tebako_args="--root=$CLI_ROOT --entry-point=ascli --output=$CLI_TARGET_EXECUTABLE --Ruby=3.3.3"
+    case $(uname -s) in
+        Darwin)
+            brew update
+            brew install gnu-sed bash pkg-config bison flex binutils libffi gdbm zlib \
+                ncurses double-conversion boost jemalloc  glog libevent libsodium lz4 xz \
+                libyaml openssl@3
+            # brew install m4
+            # boost fmt
+            #export PATH=$(dirname $(brew ls m4|grep '/m4$'|head -n 1)):$PATH
+            #export PATH=$(dirname $(brew ls binutils|grep '/ar$'|head -n 1)):$PATH
+            #tebako_bin=$CLI_ROOT/tmp/tbkbin
+            tebako_root=$CLI_ROOT/../tebako-tmp
+            #export PATH=$tebako_bin:$PATH
+            mkdir -p $tebako_root
+            #mkdir -p $tebako_bin
+            # need ar from apple
+            #rm -f $tebako_bin/ar
+            #ln -s /usr/bin/ar $tebako_bin
+            export PATH=$(echo $PATH|tr : \\n|grep -v /binutils/|tr \\n :)
+            #tebako setup --Ruby=3.3.4 --prefix=$tebako_root
+            tebako press --Ruby=3.3.4 --prefix=$tebako_root --root=$CLI_ROOT/examples/tebako --entry-point=ascli --output=$CLI_TARGET_EXECUTABLE
+            #tebako press --Ruby=3.3.4 --prefix=$tebako_root --root=$CLI_ROOT --entry-point=$CLI_ENTRY_SCRIPT --output=$CLI_TARGET_EXECUTABLE
+            exit 0
+            ;;
+        Linux)
+            work_dir=/mnt/w
+            tebako press --root=$work_dir --entry-point=ascli --output=$work_dir/ascli.exe --Ruby=3.3.3 
+            tebako_prefix="podman run -it --rm -v $PWD:$work_dir ghcr.io/tamatebako/tebako-ubuntu-20.04:0.8.6"
+            tebako_opts=--patchelf
+            ;;
+        *)
+            echo "This OS is not supported." >&2
+            exit 1
+            ;;
+    esac
+    command $tebako_command $tebako_args
+else
+    # https://github.com/you54f/ruby-packer
+    # https://github.com/YOU54F/ruby-packer/releases
+    set -e
+    FOLDER="$(dirname $0)/../tmp"
+    RUBYC="$FOLDER/rubyc"
+    if test ! -e "$RUBYC"; then
+        mkdir -p "$FOLDER"
+        case $(uname -sm|tr ' ' -) in
+            Darwin-arm64)
+                curl -L https://github.com/YOU54F/ruby-packer/releases/download/rel-20230812/rubyc-Darwin-arm64.tar.gz | tar -xz -C "$FOLDER"
+                mv "$FOLDER/rubyc-Darwin-arm64" "$RUBYC"
+                ;;
+            Linux-x86_64)
+                curl -L https://github.com/YOU54F/ruby-packer/releases/download/rel-20230812/rubyc-Linux-x86_64.tar.gz | tar -xz -C "$FOLDER"
+                mv "$FOLDER/rubyc-Linux-x86_64" "$RUBYC"
+                ;;
+            *)
+                echo "This architecture is not supported." >&2
+                exit 1
+                ;;
+        esac
+    fi
+    exec "$RUBYC" -o "$CLI_TARGET_EXECUTABLE" "$CLI_ENTRY_SCRIPT"
+fi

data/examples/build_package.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# Usage: ./build_package.sh <gem_name> <gem_version>
+# Example: ./build_package.sh aspera-cli 4.18.0
+set -e
+if [ "$#" -ne 2 ]; then
+    echo "Usage: $0 <gem_name> <gem_version>"
+    exit 1
+fi
+gem_name=$1
+gem_version=$2
+# on macOS, GNU tar is gtar
+GNU_TAR=tar
+if [ "$(uname)" == "Darwin" ]; then
+    GNU_TAR=gtar
+fi
+# temp folder to install gems
+tmp_dir_install=.tmp_install
+# clean, if there were left overs
+rm -fr $tmp_dir_install
+# retrieve list of necessary gems
+echo "Getting gems $gem_name $gem_version"
+# install gems in a temporary folder
+gem install $gem_name:$gem_version --no-document --install-dir $tmp_dir_install
+archive=$gem_name-$gem_version-gems.tgz
+# .gem files are located in cache folder
+$GNU_TAR -zcf $archive --directory=$tmp_dir_install/cache/. .
+rm -fr $tmp_dir_install
+echo "Archive: $archive"