aspera-cli 4.0.0.pre2 → 4.0.0.pre3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36a82a69216429313771832febaa8a3a84b02aa0c6f10c7ccdb5e637c768046e
-  data.tar.gz: 73c2b08c40ed75fbe99164cbdbaf236309d82bd25bf8dd5ce92081ed09faecda
+  metadata.gz: 22041be5b72d2a1907350832239b7e3b96890e6b50cc36ab199ecdddf6fe3e89
+  data.tar.gz: b30116b52e35ffd5020a400fa07a519da847de1c078c2e09b91349488c95947a
 SHA512:
-  metadata.gz: c04ef4969a3cac1435c85b7533b84756fbdf312ee692d79d249839d1cd0b7cd55a8f6f7436e01f8242414218321e81d350f8f1f446f7bb6c3de52f9771bb7612
-  data.tar.gz: e036d3c9ebc46356b99f7fd4a56e7586d992485628add560360d4fda9bd58bd655ba26a4bc1a45b4157597d62e8d250e7da7d44c808644c3cfbf54d3512234f6
+  metadata.gz: d7992b721a8dc47334ad5706aa645534822ef7b9608055c1ef0c5908085c20e45dd2dc4b7a4210481b40af9f554f389fe408c8807cc7d2eb40c3e7b212f0c4f9
+  data.tar.gz: 16ee1fdb8ddfecac75a0674f2f4be902decc76543b3577e81a12284d899d74b4cd1c38b68f6bda126aebd1f9cddf045af0c7ef98fe0aa0aee0a2634b9a249a84

data/README.md

@@ -1,7 +1,7 @@
 [comment1]: # (Do not edit this README.md, edit docs/README.erb.md, for details, read docs/README.md)
 # `ascli` : a Command Line for IBM Aspera products
 
-Version : 4.0.0.pre2
+Version : 4.0.0.pre3
 
 _Laurent/2016-2021_
 
@@ -36,7 +36,7 @@ Once the gem is installed, `ascli` shall be accessible:
 
 ```
 $ ascli --version
-4.0.0.pre2
+4.0.0.pre3
 ```
 
 ## First use
@@ -112,8 +112,9 @@ The following sections provide information on the installation.
 ## <a name="ruby"></a>Ruby
 
 A ruby interpreter is required to run the tool or to use the gem and tool.
-The Ruby version shall be > 2.4.
+The Ruby version shall be at least > 2.4.
 Any type of Ruby installation can be used.
+Ruby 3 is not yet tested.
 
 Refer to the following sections for a proposed method for specific operating systems.
 
@@ -138,13 +139,13 @@ Install Latest stable Ruby using [https://rubyinstaller.org/](https://rubyinstal
 
 Go to "Downloads".
 
-Select the version "without devkit", x64 corresponding to the one recommended "with devkit".
+Select the Ruby 2 version "without devkit", x64 corresponding to the one recommended "with devkit". Devkit is not needed.
 
-During installation, skip the installation of "MSys2".
+At the end of the installer uncheck the box to skip the installation of "MSys2".
 
 ### Linux
 
-Install Latest Ruby using "rvm" [https://rvm.io/](https://rvm.io/) .
+Install Latest Ruby 2 using "rvm" [https://rvm.io/](https://rvm.io/) .
 It installs by default in /usr/local/rvm , but you can install in another location:
 
 ```
@@ -507,14 +508,28 @@ It is also possible to provide a _Structured Value_ in a file using `@json:@file
 
 ## <a name="conffolder"></a>Configuration and Persistency Folder
 
-`ascli` configuration and other runtime files (token cache, file lists, persistency files)
-are stored in folder `$HOME/.aspera/ascli`. The folder can be displayed using :
+`ascli` configuration and other runtime files (token cache, file lists, persistency files, SDK) are stored in folder `[User's home folder]/.aspera/ascli`.
+
+Note: `[User's home folder]` is found using ruby's `Dir.home` (`rb_w32_home_dir`).
+It uses the `HOME` env var primarily, and on MS Windows it also looks at `%HOMEDRIVE%%HOMEPATH%` and `%USERPROFILE%`. `ascli` sets the env var `%HOME%` to the value of `%USERPROFILE%` if set and exists. So, on Windows `%USERPROFILE%` is used as it is more reliable than `%HOMEDRIVE%%HOMEPATH%`.
+
+The main folder can be displayed using :
 
 ```
 $ ascli config folder
 /Users/kenji/.aspera/ascli
 ```
 
+It can be overriden using the envinonment variable `ASCLI_HOME`.
+
+Example (Windows):
+
+```
+$ set ASCLI_HOME=C:\Users\Kenji\.aspera\ascli
+$ ascli config folder
+C:\Users\Kenji\.aspera\ascli
+```
+
 ## <a name="configfile"></a>Configuration file
 
 On the first execution of `ascli`, an empty configuration file is created in the configuration folder.
@@ -751,6 +766,8 @@ EOF
 
 The gem is equipped with traces. By default logging level is "warn". To increase debug level, use parameter `log_level`, so either command line `--log-level=xx` or env var `ASCLI_LOG_LEVEL`.
 
+It is also possible to activate traces before initialisation using env var `AS_LOG_LEVEL`.
+
 ## Learning Aspera Product APIs (REST)
 
 This CLI uses REST APIs.
@@ -1424,7 +1441,7 @@ ascli sync start --parameters=@json:'{"sessions":[{"name":"test","reset":true,"r
 ```
 $ ascli -h
 NAME
-	ascli -- a command line tool for Aspera Applications (v4.0.0.pre2)
+	ascli -- a command line tool for Aspera Applications (v4.0.0.pre3)
 
 SYNOPSIS
 	ascli COMMANDS [OPTIONS] [ARGS]
@@ -1448,27 +1465,27 @@ ARGS
 	Some commands require mandatory arguments, e.g. a path.
 
 OPTIONS: global
-        --interactive=ENUM           use interactive input of missing params: yes, no
-        --ask-options=ENUM           ask even optional options: yes, no
+        --interactive=ENUM           use interactive input of missing params: yes, no
+        --ask-options=ENUM           ask even optional options: yes, no
         --format=ENUM                output format: table, ruby, json, jsonpp, yaml, csv, nagios
         --display=ENUM               output only some information: info, data, error
         --fields=VALUE               comma separated list of fields, or ALL, or DEF
         --select=VALUE               select only some items in lists, extended value: hash (column, value)
         --table-style=VALUE          table display style
-        --flat-hash=ENUM             display hash values as additional keys: yes, no
+        --flat-hash=ENUM             display hash values as additional keys: yes, no
     -h, --help                       Show this message.
         --bash-comp                  generate bash completion for command
         --show-config                Display parameters used for the provided action.
     -r, --rest-debug                 more debug for HTTP calls
     -v, --version                    display version
     -w, --warnings                   check for language warnings
-        --ui=ENUM                    method to start browser: text, graphical
-        --log-level=ENUM             Log level: info, warn, error, fatal, unknown, debug
-        --logger=ENUM                log method: stderr, stdout, syslog
+        --ui=ENUM                    method to start browser: text, graphical
+        --log-level=ENUM             Log level: debug, info, error, warn, fatal, unknown
+        --logger=ENUM                log method: stderr, stdout, syslog
         --lock-port=VALUE            prevent dual execution of a command, e.g. in cron
         --query=VALUE                additional filter for API calls (extended value) (some commands)
-        --insecure=ENUM              do not validate HTTPS certificate: yes, no
-        --once-only=ENUM             process only new items (some commands): yes, no
+        --insecure=ENUM              do not validate HTTPS certificate: yes, no
+        --once-only=ENUM             process only new items (some commands): yes, no
 
 COMMAND: config
 SUBCOMMANDS: gem_path genkey plugins flush_tokens list overview open echo id documentation wizard export_to_cli detect coffee ascp email_test smtp_settings proxy_check folder file
@@ -1476,10 +1493,10 @@ OPTIONS:
         --value=VALUE                extended value for create, update, list filter
         --property=VALUE             name of property to set
         --id=VALUE                   resource identifier (modify,delete,show)
-        --config-file=VALUE          read parameters from file in YAML format, current=/Users/dwosk/.aspera/ascli/config.yaml
-        --override=ENUM              override existing value: yes, no
+        --config-file=VALUE          read parameters from file in YAML format, current=/Users/FooBar/.aspera/ascli/config.yaml
+        --override=ENUM              override existing value: yes, no
     -N, --no-default                 do not load default configuration for plugin
-        --use-generic-client=ENUM    wizard: AoC: use global or org specific jwt client id: yes, no
+        --use-generic-client=ENUM    wizard: AoC: use global or org specific jwt client id: yes, no
         --pkeypath=VALUE             path to private key for JWT (wizard)
         --ascp-path=VALUE            path to ascp
         --use-product=VALUE          use ascp from specified product
@@ -1489,7 +1506,7 @@ OPTIONS:
         --default=VALUE              set as default configuration for specified plugin
         --secret=VALUE               access key secret for node
         --secrets=VALUE              access key secret for node
-        --test-mode=ENUM             skip user validation in wizard mode: yes, no
+        --test-mode=ENUM             skip user validation in wizard mode: yes, no
         --ts=VALUE                   override transfer spec values (Hash, use @json: prefix), current={}
         --local-resume=VALUE         set resume policy (Hash, use @json: prefix), current=
         --to-folder=VALUE            destination folder for downloaded files
@@ -1528,7 +1545,7 @@ OPTIONS:
         --password=VALUE             user's password
         --params=VALUE               parameters hash table, use @json:{"param":"value"}
         --result=VALUE               specify result value as: 'work step:parameter'
-        --synchronous=ENUM           work step:parameter expected as result: yes, no
+        --synchronous=ENUM           work step:parameter expected as result: yes, no
         --ret-style=ENUM             how return type is requested in api: header, arg, ext
         --auth-style=ENUM            authentication type: arg_pass, head_basic, apikey
 
@@ -1611,7 +1628,7 @@ OPTIONS:
         --username=VALUE             username to log in
         --password=VALUE             user's password
         --skip-format=ENUM           skip this preview format (multiple possible): png, mp4
-        --folder-reset-cache=ENUM    force detection of generated preview by refresh cache: no, header, read
+        --folder-reset-cache=ENUM    force detection of generated preview by refresh cache: no, header, read
         --skip-types=VALUE           skip types in comma separated list
         --previews-folder=VALUE      preview folder in storage root
         --temp-folder=VALUE          path to temp folder
@@ -1619,14 +1636,14 @@ OPTIONS:
         --case=VALUE                 basename of output for for test
         --scan-path=VALUE            subpath in folder id to start scan in (default=/)
         --scan-id=VALUE              forder id in storage to start scan in, default is access key main folder id
-        --overwrite=ENUM             when to overwrite result file: always, never, mtime
-        --file-access=ENUM           how to read and write files in repository: local, remote
+        --overwrite=ENUM             when to overwrite result file: always, never, mtime
+        --file-access=ENUM           how to read and write files in repository: local, remote
         --max-size=VALUE             maximum size (in bytes) of preview file
         --thumb-vid-scale=VALUE      png: video: size (ffmpeg scale argument)
         --thumb-vid-fraction=VALUE   png: video: position of snapshot
         --thumb-img-size=VALUE       png: non-video: height (and width)
-        --video-conversion=ENUM      mp4: method for preview generation: reencode, blend, clips
-        --video-png-conv=ENUM        mp4: method for thumbnail generation: fixed, animated
+        --video-conversion=ENUM      mp4: method for preview generation: reencode, blend, clips
+        --video-png-conv=ENUM        mp4: method for thumbnail generation: fixed, animated
         --video-start-sec=VALUE      mp4: start offset (seconds) of video preview
         --video-scale=VALUE          mp4: video scale (ffmpeg)
         --blend-keyframes=VALUE      mp4: blend: # key frames
@@ -1642,10 +1659,62 @@ SUBCOMMANDS: start admin
 OPTIONS:
         --parameters=VALUE           extended value for session set definition
         --session-name=VALUE         name of session to use for admin commands, by default first one
-ERROR: Other: uninitialized constant Aspera::Cli::Plugins::Aoc
-Did you mean?  Aspera::AoC
-ERROR: Argument: unprocessed options: ["-Cnone"]
-Use '--log-level=debug' to get more details.
+
+
+COMMAND: aoc
+SUBCOMMANDS: apiinfo bearer_token organization tier_restrictions user workspace packages files gateway admin automation servers
+OPTIONS:
+        --url=VALUE                  URL of application, e.g. https://org.asperafiles.com
+        --username=VALUE             username to log in
+        --password=VALUE             user's password
+
+COMMAND: ats
+SUBCOMMANDS: cluster access_key api_key aws_trust_policy
+OPTIONS:
+        --ibm-api-key=VALUE          IBM API key, see https://cloud.ibm.com/iam/apikeys
+        --instance=VALUE             ATS instance in ibm cloud
+        --ats-key=VALUE              ATS key identifier (ats_xxx)
+        --ats-secret=VALUE           ATS key secret
+        --params=VALUE               Parameters access key creation (@json:)
+        --cloud=VALUE                Cloud provider
+        --region=VALUE               Cloud region
+        --auth=ENUM                  type of Oauth authentication: body_userpass, header_userpass, web, jwt, url_token, ibm_apikey
+        --operation=ENUM             client operation for transfers: push, pull
+        --client-id=VALUE            API client identifier in application
+        --client-secret=VALUE        API client passcode
+        --redirect-uri=VALUE         API client redirect URI
+        --private-key=VALUE          RSA private key PEM value for JWT (prefix file path with @val:@file:)
+        --workspace=VALUE            name of workspace
+        --eid=VALUE                  identifier
+        --name=VALUE                 resource name
+        --link=VALUE                 public link to shared resource
+        --new-user-option=VALUE      new user creation option
+        --from-folder=VALUE          share to share source folder
+        --scope=VALUE                scope for AoC API calls
+        --notify=VALUE               notify users that file was received
+        --bulk=ENUM                  bulk operation: yes, no
+        --default-ports=ENUM         use standard FASP ports or get from node api: yes, no
+
+
+COMMAND: server
+SUBCOMMANDS: nagios nodeadmin userdata configurator ctl download upload browse delete rename ls rm mv du info mkdir cp df md5sum
+OPTIONS:
+        --url=VALUE                  URL of application, e.g. https://org.asperafiles.com
+        --username=VALUE             username to log in
+        --password=VALUE             user's password
+        --ssh-keys=VALUE             ssh key path list (Array or single)
+        --ssh-options=VALUE          ssh options (Hash)
+        --cmd-prefix=VALUE           prefix to add for as cmd execution, e.g. sudo or /opt/aspera/bin 
+
+
+COMMAND: console
+SUBCOMMANDS: transfer nagios_check
+OPTIONS:
+        --url=VALUE                  URL of application, e.g. https://org.asperafiles.com
+        --username=VALUE             username to log in
+        --password=VALUE             user's password
+        --filter-from=DATE           only after date
+        --filter-to=DATE             only before date
 
 
 ```
@@ -2188,17 +2257,26 @@ $ ascli aoc admin res node --id=8669 v4 perm 82 show
 Send a package:
 
 ```
-$ ascli aoc packages send --value=@json:'{"name":"my title","note":"my note","recipients":["laurent.martin.aspera@fr.ibm.com","other@example.com"]}' --sources=@args my_file.dat
+$ ascli aoc packages send --value=[package extended value] [other parameters such as file list and transfer parameters]
 ```
 
 Notes:
 
-* the `value` parameter can contain any supported package creation parameter. Refer to the API, or display an existing package.
-* to list recipients use fields: "recipients" and/or "bcc_recipients". ascli will resolve the list of email addresses to expected user ids. If a recipient is not already registered and the workspace allows external users, then the package is sent to an external user, and
+* the `value` parameter can contain any supported package creation parameter. Refer to the AoC package creation API, or display an existing package to find attributes.
+* to provide the list of recipients, use fields: "recipients" and/or "bcc_recipients". ascli will resolve the list of email addresses to expected user ids.
+* a recipîent can be a shared inbox, in this case just use the name of the shared inbox as recipient.
+* If a recipient is not already registered and the workspace allows external users, then the package is sent to an external user, and
   * if the option `new_user_option` is `@json:{"package_contact":true}` (default), then a public link is sent and the external user does not need to create an account.
   * if the option `new_user_option` is `@json:{}`, then external users are invited to join the workspace
 
-## <a name="aoccargo"></a>Receive only new packages
+Examples:
+
+```
+$ ascli aoc packages send --value=@json:'{"name":"my title","note":"my note","recipients":["laurent.martin.aspera@fr.ibm.com","other@example.com"]}' --sources=@args my_file.dat
+$ ascli aoc packages send --value=@json:'{"name":"my file in shared inbox","recipients":["The Shared Inbox"]}' my_file.dat --ts=@json:'{"target_rate_kbps":100000}'
+```
+
+## <a name="aoccargo"></a>Receive new packages only
 
 It is possible to automatically download new packages, like using Aspera Cargo:
 

data/bin/ascli

@@ -2,6 +2,8 @@
 require 'rubygems'
 $LOAD_PATH.unshift(File.dirname(__FILE__)+"/../lib")
 require 'aspera/cli/main'
+require 'aspera/environment'
 Encoding.default_internal = Encoding::UTF_8
 Encoding.default_external = Encoding::UTF_8
+Aspera::Environment.fix_home
 Aspera::Cli::Main.new(ARGV).process_command_line

data/docs/Makefile

@@ -56,7 +56,8 @@ $(INCL_COMMANDS): $(DIR_TMP).exists $(TEST_MAKEFILE)
 # generated help of tools depends on all sources, so regenerate always
 .PHONY: $(INCL_USAGE)
 $(INCL_USAGE): $(DIR_TMP).exists
-	$(EXETESTB) -Cnone -h 2> $(INCL_USAGE) || true
+	-$(EXETESTB) -Cnone -h 2> $(INCL_USAGE)
+	sed -i -e 's/\/Users\/[^\/]*/\/Users\/FooBar/g' $(INCL_USAGE)
 .PHONY: $(INCL_ASESSION)
 $(INCL_ASESSION): $(DIR_TMP).exists
 	$(DIR_BIN)/asession -h 2> $(INCL_ASESSION) || true

data/docs/README.erb.md

@@ -128,8 +128,9 @@ The following sections provide information on the installation.
 ## <a name="ruby"></a>Ruby
 
 A ruby interpreter is required to run the tool or to use the gem and tool.
-The Ruby version shall be <%= gemspec.required_ruby_version %>.
+The Ruby version shall be at least <%= gemspec.required_ruby_version %>.
 Any type of Ruby installation can be used.
+Ruby 3 is not yet tested.
 
 Refer to the following sections for a proposed method for specific operating systems.
 
@@ -154,13 +155,13 @@ Install Latest stable Ruby using [https://rubyinstaller.org/](https://rubyinstal
 
 Go to "Downloads".
 
-Select the version "without devkit", x64 corresponding to the one recommended "with devkit".
+Select the Ruby 2 version "without devkit", x64 corresponding to the one recommended "with devkit". Devkit is not needed.
 
-During installation, skip the installation of "MSys2".
+At the end of the installer uncheck the box to skip the installation of "MSys2".
 
 ### Linux
 
-Install Latest Ruby using "rvm" [https://rvm.io/](https://rvm.io/) .
+Install Latest Ruby 2 using "rvm" [https://rvm.io/](https://rvm.io/) .
 It installs by default in /usr/local/rvm , but you can install in another location:
 
 ```
@@ -523,14 +524,28 @@ It is also possible to provide a _Structured Value_ in a file using `@json:@file
 
 ## <a name="conffolder"></a>Configuration and Persistency Folder
 
-<%=tool%> configuration and other runtime files (token cache, file lists, persistency files)
-are stored in folder `$HOME/.aspera/<%=cmd%>`. The folder can be displayed using :
+<%=tool%> configuration and other runtime files (token cache, file lists, persistency files, SDK) are stored in folder `[User's home folder]/.aspera/<%=cmd%>`.
+
+Note: `[User's home folder]` is found using ruby's `Dir.home` (`rb_w32_home_dir`).
+It uses the `HOME` env var primarily, and on MS Windows it also looks at `%HOMEDRIVE%%HOMEPATH%` and `%USERPROFILE%`. <%=tool%> sets the env var `%HOME%` to the value of `%USERPROFILE%` if set and exists. So, on Windows `%USERPROFILE%` is used as it is more reliable than `%HOMEDRIVE%%HOMEPATH%`.
+
+The main folder can be displayed using :
 
 ```
 $ <%=cmd%> config folder
 /Users/kenji/.aspera/<%=cmd%>
 ```
 
+It can be overriden using the envinonment variable `<%=evp%>HOME`.
+
+Example (Windows):
+
+```
+$ set <%=evp%>HOME=C:\Users\Kenji\.aspera\ascli
+$ <%=cmd%> config folder
+C:\Users\Kenji\.aspera\ascli
+```
+
 ## <a name="configfile"></a>Configuration file
 
 On the first execution of <%=tool%>, an empty configuration file is created in the configuration folder.
@@ -767,6 +782,8 @@ EOF
 
 The gem is equipped with traces. By default logging level is "warn". To increase debug level, use parameter `log_level`, so either command line `--log-level=xx` or env var `<%=evp%>LOG_LEVEL`.
 
+It is also possible to activate traces before initialisation using env var `AS_LOG_LEVEL`.
+
 ## Learning Aspera Product APIs (REST)
 
 This CLI uses REST APIs.
@@ -1703,17 +1720,26 @@ $ <%=cmd%> aoc admin res node --id=8669 v4 perm 82 show
 Send a package:
 
 ```
-$ <%=cmd%> aoc packages send --value=@json:'{"name":"my title","note":"my note","recipients":["laurent.martin.aspera@fr.ibm.com","other@example.com"]}' --sources=@args my_file.dat
+$ <%=cmd%> aoc packages send --value=[package extended value] [other parameters such as file list and transfer parameters]
 ```
 
 Notes:
 
-* the `value` parameter can contain any supported package creation parameter. Refer to the API, or display an existing package.
-* to list recipients use fields: "recipients" and/or "bcc_recipients". <%=cmd%> will resolve the list of email addresses to expected user ids. If a recipient is not already registered and the workspace allows external users, then the package is sent to an external user, and
+* the `value` parameter can contain any supported package creation parameter. Refer to the AoC package creation API, or display an existing package to find attributes.
+* to provide the list of recipients, use fields: "recipients" and/or "bcc_recipients". <%=cmd%> will resolve the list of email addresses to expected user ids.
+* a recipîent can be a shared inbox, in this case just use the name of the shared inbox as recipient.
+* If a recipient is not already registered and the workspace allows external users, then the package is sent to an external user, and
   * if the option `new_user_option` is `@json:{"package_contact":true}` (default), then a public link is sent and the external user does not need to create an account.
   * if the option `new_user_option` is `@json:{}`, then external users are invited to join the workspace
 
-## <a name="aoccargo"></a>Receive only new packages
+Examples:
+
+```
+$ <%=cmd%> aoc packages send --value=@json:'{"name":"my title","note":"my note","recipients":["laurent.martin.aspera@fr.ibm.com","other@example.com"]}' --sources=@args my_file.dat
+$ <%=cmd%> aoc packages send --value=@json:'{"name":"my file in shared inbox","recipients":["The Shared Inbox"]}' my_file.dat --ts=@json:'{"target_rate_kbps":100000}'
+```
+
+## <a name="aoccargo"></a>Receive new packages only
 
 It is possible to automatically download new packages, like using Aspera Cargo:
 

data/docs/test_env.conf

@@ -1,16 +1,16 @@
 ---
 config:
-  version: 4.0.0.pre1
+  version: 4.0.0
 default:
   config: cli_default
-  aoc: tst_aoc
+  aoc: tst_aoc1
   faspex: tst_faspex
   faspex5: tst_faspex5
   shares: tst_shares
   shares2: tst_shares2
   node: tst_node
   server: tst_server
-  orchestrator: orch_eudemo
+  orchestrator: tst_orch
   console: tst_console
   preview: tst_ak_preview
   ats: tst_ats
@@ -31,7 +31,7 @@ smtp_config:
   from_name: your value here
   username: your value here
   password: your value here
-tst_aoc:
+tst_aoc1:
   url: your value here
   username: your value here
   auth: your value here
@@ -79,7 +79,7 @@ tst_server:
 tst_server_bykey:
   url: your value here
   username: your value here
-orch_eudemo:
+tst_orch:
   url: your value here
   username: your value here
   password: your value here

data/lib/aspera/cli/main.rb

@@ -21,18 +21,9 @@ module Aspera
       # name of application, also foldername where config is stored
       PROGRAM_NAME = 'ascli'
       GEM_NAME = 'aspera-cli'
-      # Container module of current class : Aspera::Cli
-      CLI_MODULE=Module.nesting[1].to_s
-      # Path to Plugin classes: Aspera::Cli::Plugins
-      PLUGINS_MODULE=CLI_MODULE+'::Plugins'
       VERBOSE_LEVELS=[:normal,:minimal,:quiet]
 
-      private_constant :PROGRAM_NAME,:GEM_NAME,:CLI_MODULE,:PLUGINS_MODULE,:VERBOSE_LEVELS
-
-      # find the root folder of gem where this class is
-      def self.gem_root
-        File.expand_path(CLI_MODULE.to_s.gsub('::','/').gsub(%r([^/]+),'..'),File.dirname(__FILE__))
-      end
+      private_constant :PROGRAM_NAME,:GEM_NAME,:VERBOSE_LEVELS
 
       # =============================================================
       # Parameter handlers
@@ -140,7 +131,7 @@ module Aspera
         require @plugin_env[:config].plugins[plugin_name_sym][:require_stanza]
         # load default params only if no param already loaded before plugin instanciation
         env[:config].add_plugin_default_preset(plugin_name_sym)
-        command_plugin=Object::const_get(PLUGINS_MODULE+'::'+plugin_name_sym.to_s.capitalize).new(env)
+        command_plugin=Plugins::Config.plugin_new(plugin_name_sym,env)
         Log.log.debug("got #{command_plugin.class}")
         # TODO: check that ancestor is Plugin?
         return command_plugin