Synnefo » ./kamaki

Currently:

  kamaki astakos -h
    feedback: Send feedback to astakos server
    quotas: Get user (or service) quotas
    commission: Manage commissions (special privileges required)
        services: Astakos operations filtered by services
        endpoints: Get endpoints service endpoints
        resources: List user resources
    user:
        info: Authenticate a user
        uuid: Get uuid(s) from username(s)
        name: Get username(s) from uuid(s)
    services: Astakos operations filtered by services
        username: Get service username(s) from uuid(s)
        Get service uuid(s) from username(s)
        List available services
        Get user (or service) quotas
    endpoints: Get endpoints service endpoints
    resources: List user resources

  kamaki projects -h
    <project commands> ...

While projects namespace is OK, the astakos namespace is confusing for most users. Ideally, command namespaces should be semantically content and self-describing, so that users would rarely need to user help and documantion.

The prevalent idea is to rename "astakos" to "user".
There is a "user" namespace in kamaki that manages cached user information. This could be moved to "user session".

This is the proposed status of the astakos-related commands at 0.11:

  kamaki user -h
    info: Authenticate a user and get info
    uuid2name: Get uuid(s) from username(s)
    name2uuid: Get username(s) from uuid(s)
    quotas: Get user (or service) quotas
    session: Manage kamaki session user setting
        list: list all cached authenticated users
        add: authenticate and a new user (by token) and add to cache
        pick: Set session user from the list of cached authenticated users
        whoami: Show current session user

  kamaki admin -h
    commission: Manage commissions (special privileges required)
        services: Astakos operations filtered by services
        endpoints: Get service endpoints
        resources: List user resources
    service: Astakos operations filtered by services
        uuid2name: Get service username(s) from uuid(s)
        name2uuid: Get service uuid(s) from username(s)
        list: List available services
        quotas: Get user (or service) quotas
    endpoints: Get endpoints service endpoints
    resources: List user resources
    feedback: Send feedback to astakos server

  kamaki projects -h
    <project commands> ...