Enrich clients docs for astakos endpoints, scripts

Refs: #4135

Merge branch 'feature-test-command-tree' into develop

Complete ConfigArgument testing

Refs: #4058

Fully test argument.Argument

Refs: #4058

Initialize unittests for argument.Argument

Refs: #4058

Also, make argument package a directory

Improve error message when image meta file exists

Fully test CommandTree

Refs: #4058

Accepte tilda as a character for a cloud name

Refs: #4126

Accepte tilda as a character for a cloud name

Refs: #4126

Setup test example commands for CommandTree

Refs: #4058

Implement all unittests for command_tree.Command

Refs: #4058

Spot and remove unused Command methods

Setup unittest for CLI and apply to commant_tree

Refs: #4058

Only a __init__ and name methods are tested for now

Merge branch 'feature-expose-astakosclient-full' into develop

Expose commission issue commands

Refs: #4115

Expose commission commands (astakos)

Refs: #4115

New commands: astakos_commission_*:
    pending, info, action, accept, reject, resolve

Also implement the CommaSeparatedListArgument structure

Expose more astakosclients methods (1to1)

Refs: #4115

New commands: astakores_resources/feedback/endpoints

Also, wrap astakosclient expositions with an error handling decorator

Update Changelog optional cmd spec bug fix

Refs: #4114

Exclude unset optional cmd groups

Refs: #4114

E.g. the cyclades spec package contains the non-optional group "server" and
the optional group "floatingip". Now kamaki can load only the "server"
group, except if the user requests the loading of "floatingip" group too.

Update inline documentation for get->whoami rename

Rename user_get-->user_whoami

Fix user_list docs

Add name and uuid of session user to shell greet

Refs: 3632

Merge branch 'feature-multiple-tokens' into develop

Allow multiple tokens per cloud configuration

Refs: #3632

Merge branch 'feature-user-commands' into develop

Update Changelog

Adjust funcional tests

Cache by uuid instead of token in astakos client

Refs: #3660

Merge branch 'feature-user-commands' into develop

Implement user_get/set for session user

Refs: #3632

user_info --> user_get
Each kamaki session has a session user
The user defined in the config file through cloud....token
During the session, kamaki users may authenticate more users by tokens
and switch between them with user_set command
When authenticating a user, kamaki asks if you need to store this users
token as the session token

Implement user_info  to show current user info

Refs: #3632

Implement a user_list to list cached shell users

Refs: #3632

Fix typo == --> --

Parse publicURL to fix astakos init, pretty quotas

Refs: #3632

Fix logger in snf-astakos commands

Fix broken unittests concerning floating ips

Merge branch 'feature-expand-wait-functionality' into develop

Add --wait 2 network_create/delete + upd Changelog

Refs: 3867

Make wait mechanism usble by more cyclades methods

Refs: #3867

Add a --wait option to various server commands

Refs: #3867

Commands affected: server_create/start/shutdown/reboot

Also, the wait functionality is now encapsulated in a _server_wait class
The server_wait command is just an implementation of this class.

Update the copyright dates everywhere

Merge branch 'feature-history-run' into develop

Restore history-run functionality

Fix spelling mistake (ident-->indent)

Simplify listings

    Modify print_list/dict/items methods of kamaki.cli.utils to be simpler
    and print output in a simpler form

    key: value
    key:
        key: value
        key:
            key: value
            ...
        key:
            list-item

            list-item
        key-for-list-of-dicts:
            key: value
            key: value

            key: value
            ...

Expose floatingip command group to CLI

Merge branch 'feature-floating-ips' into develop

Update changelog

Expose impemented floating IP methods

New commands:

floatingip list/create/delete/info/pools
server ip attach/detach

Also, renamed the assoc/disassoc floating ip clients methods to
attach/detach_floating_ip

Merge branch 'develop' into feature-floating-ips

Adjust unit/functional tests

Refs: #3964

Update Changelog

Merge branch 'feature-adjust-docs' into develop

Remove links from simple listing

Add network examples

Add examples for virtual machine handling

Add image registration examples

Add file sharing examples

Add upload and download examples

Complete the listing section

Merge branch 'feature-connection-retry' into develop

Add a Connection Retry to Client + ResponseManager

Usage:
cl.XxxClient(...)
cl.CONNECTION_RETRY_LIMIT = 5
cl.<methods>

Remove forgoten debug message

Fix write recovery bug in kamaki.cli.config

write failed to recover config memory repr. after writing in disk

Refs: #4030

Merge branch 'feature-check-cloud-name' into develop

Create InvalidCloudNameError, raise it when needed

Refs: #4030

Make cloud prefix a global settings

Refs: #4030

Rename: scenarios-->examples, add first content

- configuration section, with clouds
- Simple listing
- Pithos advanced listing

Add a new section "Scenarios" in documentation

Merge branch 'develop' into feature-adjust-docs

Add seperator in item listing (unnamed)

Adjust list_sever_nics to recent server changes

Merge branch 'feature-adjust-docs' into develop

Fix deprecated terms in documentation

Merge branch 'develop' into feature-adjust-docs

Fix typo when getting metadata without key

Merge branch 'develop' into feature-adjust-docs

Recover old token in case of authentication error

Prepare special local paths (like .) for pithos

Merge branch 'feature-floating-ips' into develop

Conflicts:
Changelog

Merge branch 'feature-expose-astakosclient' into develop

Conflicts:
kamaki/cli/commands/snf-astakos.py

Merge branch 'feature-adjust-functional-tests' into develop

Fix all minor typos and modifications in tests

Merge branch 'develop' into feature-adjust-functional-tests

Merge branch 'feature-cloud-renamings' into develop

Merge branch 'feature-adjust-docs' into develop

Do not suggest ansicolors if colors == off

Refs: #3978

Fix typos in error messages and helps

Refs: #3979

Fix log level for expected command failures

Updagrade error message for multiple clouds

Refs: #3979

Use the default_cloud global option

Refs: #3934 #3979

Merge branch 'develop' into feature-cloud-renamings

Fix typo in method docs

Adjust livetests to cloud renamings

Merge branch 'develop' into feature-adjust-docs

Merge branch 'feature-cloud-renamings' into develop

Change term "remote" to "cloud" when proper

Refs: #3934

Merge branch 'feature-adjust-docs' into develop

Adjust docs to cover multiple clouds functionality

This commit server as a backup mostly, since the adjustments are not yet
applied to docs/commands and all docs/developers kamaki guides.