GitLab

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 everything to kamaki.clients

Remove multiple hierarchies of connection classes (== abandon support for
    alternative connection methods, e.g. for requests from pypi)

New connection classes are
- RequestManager
- ResponseManager
Semantics:
    RequestManager constructor commits a request without performing it
      but it performs all sanity checks for url, path, method and params
    RequestManager.perform will perform the commited request, if called
    ResponseManager constructor needs a RequestManager instance
    ResponseManager.(various properties)
        request is pooled from a ContextManagerPool (objpool) when needed.
        Results are cached and used as long as the ResponseManager instance
        is alive

Remove KamakiConnection/ResponseErrors, use ClientError wrapers for everything

Remove the connection livetest

TODO: Adjust unittests

Naming convention:

Actual functionality:

In package kamaki.clients.pkg there is class C containing a method M
Test it in a package kamaki.clients.pkg.test, with a class C + a method test_M
Command line run:
    python ${kamaki}/kamaki/clients/pkg/test.py C M
or
    python ${kamaki}/kamaki/clients/test.py C M

In package kamaki.clients there is a module mod containing a method M
Test it in a package kamaki.clients.mod, with a class Mod + a method test_M
Command line run:
    python ${kamaki}/kamaki/clients/mod/test.py Mod M
or
    python ${kamaki}/kamaki/clients/test.py Mod M

Tests are packaged as kamaki.clients.test
As an example, the astakos authenticate method test has been implemented

Update documentation to reflect these changes

list method returns a list of all cached user informations, one for each token

Everything has been tested and fixed except the following flaw:
when testing the whole image package, the same image file is uploaded and
destroyed again and again.

Prototype implementation on kamaki.clients.astakos client
In prototype status, does not function yet
Old unittests in _tests.py, for reference

Most astakos services need admin auth to test

Two modes: astakos service and astakos admin
They both have a userinfo command

astakos imports an anused (and soon deprecated) module

Seperate Client to Client and HTTPConnection
The later is put in a separate package kamaki.client.connection
It manages headers, params, method, url and data of a connection
but the actuall http connection is not implemented at this
abstract level
There is an HTTPRequest class extention of HTTPConnection in the
same package. It implements connection using requests package
so basicaly it replicates the connection procedure that was used
in kamaki so far.
Minor modifications were nessacary at every client lib package

Setup is now aware of gevent and commands package

Add "astakos authenticate" command

* New configuration mechanism
* Refactored CLI
* Added clint dependency

* New configuration mechanism
* Refactored CLI
* Added clint dependency

Groundwork to support different APIs (synnefo and
plankton).

New configuration mechanism (kamaki config)