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

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.

Update some of the documentation

this commit serves back-up purposes mostly

Reset Upgrade notes for the upcoming version 0.10

Merge branch 'feature-adjust-docs' into develop

Document the Upgrade notes for v0.9

Fix PEP8 warning

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

Adjust all livetests to use cached astakos client

Refs: #3964

Adjust cached astakos client unit tests

Refs: #3964

Create mising func. tests 4 cached astakos client

Refs: #3964

Adjust astakos functional tests to novel features

Refs: #3964

Make sure all url-params are url-encoded

Refs: #3956

Merge branch 'feature-endpoints' into develop

Adjust help messages to configuration changes

Refs:#3934

Merge branch 'feature-endpoints' into develop

Fix a PEP8 issue

Use os-specific path seperators in up/down-load -R

Refs: #3954

Adjust all command specs to multicloud/singleauth

Refs: #3934

Make sure user and history commands work fine

Refs: #3934

Adjust config cli commands to serve remotes

Refs: #3934

config set remote.smth.option value
  inserts option=value in remote smth
config get remote.smth
  lists the contents (key=val) of remote smth
config delete remote.smth.option
  deletes this specific option from the remote smth
config delete remote.smth
  completely erased the remote smth

Decide a cloud term, use it if no cloud.url

Refs: #3934

Implement remotes support in Config and cli init

Refs: #3934

In Config:

Simplify guess_version heuristics (check if the following exist:
    global.url/token, remote-defaults)
Trasnlate files 'remote "name"' to 3-level dict and back
Implement rescue_old_file to convert config files to v3.0

In kamaki.cli:

Implement method _check_config_version

Plan Config changes (rescue_old_file, translates)

Refs: #3934

rescue_old_file: mines info from old config file to use them in new file
translates:
  remote "smth" --> 'remote': {'smth': ...
  global.{url, token} --> remote.default.{url, token}
  <command>.cli --> global.command_cli
  some commands are maped to other names, e.g. pithos --> file
  <command>.url --> remote.defailt.<command>_url

Implement Config.guess_version for config files

Implement the Config.guess_version method

A. Hardcode the new kamaki config file

Refs: #3934

Breaks compatibility, implements a remotes-based config file

Backwards compatibility for configuraiton file

Compatible with kamaki config files v2

user.url, file.url, compute.url and image.url
are now valid and of higher priority to
astakos.url, pithos.url, cyclades.url, plankton.url
which are also valid

All these are ignored iff [global].auth_url is given

Merge branch 'feature-endpoints' into develop

Fix typos in default and expected values

Handle url proccessing even if url is unicode

Also, fix typos and default values for service configurations

Fix typo in astakos client: version_id-->versionId

Adjust cached auth info reading to recent changes

Merge branch 'feature-endpoints' into develop

Fix typos in user command flow

Update changelog to reflect recent changes

Merge branch 'feature-endpoints' into develop

Apply servce.url options to cross-sercice calls

Refs: #3874

Let cross-service initializations to use explicit service endpoint urls if
there is no single authentication url.
- In Image commands, there are calls that use astakos and pithos clients
- In pithos there are calls that use astakos client

Use explicitely set services urls if no auth_url

Refs: #3874

In current configuration, kamaki checks for auth_url. If that fails,
it raises an error. If it is not set, it prints a warning and attempts
to read the <service>.url option from the configuration file.

Service urls: astakos.url, pithos.url, cyclades.url, plankton.url

Update changelog

Implement --cloud arg to switch between clouds

Refs: #3913

Config file can (optionaly) contain:

[remotes]
 example = https://www.example.org/astakos/identity/v2.0/
 old_version = https://www.example.org/astakos/identity/v1.0/
 ...

Now, user can explicitely request for a remote cloud authentication URI:

kamaki --cloud=<remote>

Merge branch 'develop' into feature-endpoints

Fix pep8 warning

Get endpoint urls for all CLI operations

Refs: #3874

Use kamaki.clients.astakos.AstakosClient as a cached astakos client to get
user information and, most importantly, endpoints. Allow users to authenticate
multiple tokens on the same session. In every session there must be at most
one authentication per user/token.

Major change: top kamaki.cli.commands class now contains a base_auth field
with the cached authenticating client. All urls are drained from this field.

Create config file version 3

Refs: #3874

Minimum config file:
[global]
token = <user token>

Changes:

- Only one field "cli" for user command specs, to map command groups to CLIs:

[cli]
 user = astakos
 file = pithos
 server = cyclades
...

- Specify client services/apis and versions.
 General format:
 [client]
  type = <service>
  version = <api version>

 Example:
 [cyclades]
  type = compute
  version = v2.0

Merge commit '528550d929d5d30009016ae23b2a948d13fe8eb3' into develop

Conflicts:
Changelog
version

Enrich/rename astakos client calls with endpoints

Refs: #3874

Kamaki.clients.astakos.AstakosClient is now a high-level client lib that
offers access to token-authenticated astakos-aquired cached information.
Users who need an astakos client should use the snf-astakosclient instead.

Usage:

 astakos_cache = AstakosClient(<astakos/base/url/with/identity/api>)
 astakos_cache.authenticate(<token>)
 user_info = astakos_cache.user_info()
 compute_endpoints = astakos_cache.get_service_endpoints('compute', 'v2')

Major changes:

Modify ReST call from /im/authenticate to /tokens

New methods as AstakosClient instance cache accessors:
 get_services
 get_service_details
 get_service_endpoints

Method renaiming for existing AstakosClient instance cache accessors:
 info --> user_info
 user --> list_users

Merge branch 'feature-osv2-compatibility' into release-0.9

Merge branch 'release-0.9' into feature-osv2-compatibility

Impleent floating ip methods @compute/cyclades

Refs: #3862

New methods introduced and unit-tested:
 ComputeRestClient: floating_ip_pools_get, floating_ips_get/post/delete
 CycladesRestClient: floating_ip_pools_get, floating_ips_get/post/delete
 ComputeClient: get_floating_ip_pools, get_floating_ips,
    alloc/get_delete_floating_ip
 CycladesClient: get_floating_ip_pools, get_floating_ips,
    alloc/get_delete_floating_ip, dis/assoc_floating_ip_to_server

Implement floating_ip(s)post/get/delete rest calls

Refs: #3862

Merge branch 'develop' into feature-floating-ips

Initialize version 0.10

Implement floating_ip_pools_get @compute/cyclades

Refs: #3862

Remove undesired logging in non-verbose mode

Differenciate cli logger from astakosclient logger

Wip snf-astakos, try-import it by default

Initialize kamaki v0.9rc1

Merge branch 'feature-expose-astakosclient' into develop

Merge branch 'feature-osv2-compatibility' into develop

Update Changelog for latest astakosclient cli

Expose some basix astakosclient methods to cli

Methods exposed:

get_user_info as authenticate
get_uuid[s] as uuid
get_username[s] as username
get_quotas as quotas
services_get_uuid[s]/username[s]/quotas as service uuid/username/quotas

Update log about astakos authenticate adjustment

Adjust astakos authenticate to snf-0.14 url sheme