Synnefo » ./kamaki

#!/usr/bin/env python

# Copyright 2011-2012 GRNET S.A. All rights reserved.

#

# Redistribution and use in source and binary forms, with or

# without modification, are permitted provided that the following

# conditions are met:

#

#   1. Redistributions of source code must retain the above

#      copyright notice, this list of conditions and the following

#      disclaimer.

#

#   2. Redistributions in binary form must reproduce the above

#      copyright notice, this list of conditions and the following

#      disclaimer in the documentation and/or other materials

#      provided with the distribution.

#

# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS

# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR

# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF

# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED

# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN

# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

# POSSIBILITY OF SUCH DAMAGE.

#

# The views and conclusions contained in the software and

# documentation are those of the authors and should not be

# interpreted as representing official policies, either expressed

# or implied, of GRNET S.A.

"""

To add a command create a new class and add a 'command' decorator. The class

must have a 'main' method which will contain the code to be executed.

Optionally a command can implement an 'update_parser' class method in order

to add command line arguments, or modify the OptionParser in any way.

The name of the class is important and it will determine the name and grouping

of the command. This behavior can be overriden with the 'group' and 'name'

decorator arguments:

    @command(api='compute')

    class server_list(object):

        # This command will be named 'list' under group 'server'

        ...

    @command(api='compute', name='ls')

    class server_list(object):

        # This command will be named 'ls' under group 'server'

        ...

The docstring of a command class will be used as the command description in

help messages, unless overriden with the 'description' decorator argument.

The syntax of a command will be generated dynamically based on the signature

of the 'main' method, unless overriden with the 'syntax' decorator argument:

    def main(self, server_id, network=None):

        # This syntax of this command will be: '<server id> [network]'

        ...

The order of commands is important, it will be preserved in the help output.

"""

from __future__ import print_function

import inspect

import logging

import sys

from argparse import ArgumentParser

from base64 import b64encode

from os.path import abspath, basename, exists

from sys import exit, stdout, stderr

try:

    from collections import OrderedDict

except ImportError:

    from ordereddict import OrderedDict

from colors import magenta, red, yellow

from progress.bar import IncrementalBar

from requests.exceptions import ConnectionError

from . import clients

from .config import Config

from .utils import print_addresses, print_dict, print_items, format_size, dict_from_args

_commands = OrderedDict()

GROUPS = {

    'config': "Configuration commands",

    'server': "Compute API server commands",

    'flavor': "Compute API flavor commands",

    'image': "Compute or Glance API image commands",

    'network': "Compute API network commands (Cyclades extension)",

    'store': "Storage API commands",

    'astakos': "Astakos API commands"}

class ProgressBar(IncrementalBar):

    suffix = '%(percent)d%% - %(eta)ds'

def command(api=None, group=None, name=None, syntax=None):

    """Class decorator that registers a class as a CLI command."""

    def decorator(cls):

        grp, sep, cmd = cls.__name__.partition('_')

        if not sep:

            grp, cmd = None, cls.__name__

        cls.api = api

        cls.group = group or grp

        cls.name = name or cmd

        short_description, sep, long_description = cls.__doc__.partition('\n')

        cls.description = short_description

        cls.long_description = long_description or short_description

        cls.syntax = syntax

        if cls.syntax is None:

            # Generate a syntax string based on main's arguments

            spec = inspect.getargspec(cls.main.im_func)

            args = spec.args[1:]

            n = len(args) - len(spec.defaults or ())

            required = ' '.join('<%s>' % x.replace('_', ' ') for x in args[:n])

            optional = ' '.join('[%s]' % x.replace('_', ' ') for x in args[n:])

            cls.syntax = ' '.join(x for x in [required, optional] if x)

            if spec.varargs:

                cls.syntax += ' <%s ...>' % spec.varargs

        if cls.group not in _commands:

            _commands[cls.group] = OrderedDict()

        _commands[cls.group][cls.name] = cls

        return cls

    return decorator

@command(api='config')

class config_list(object):

    """List configuration options"""

    def update_parser(self, parser):

        parser.add_argument('-a', dest='all', action='store_true',

                          default=False, help='include default values')

    def main(self):

        include_defaults = self.args.all

        for section in sorted(self.config.sections()):

            items = self.config.items(section, include_defaults)

            for key, val in sorted(items):

                print('%s.%s = %s' % (section, key, val))

@command(api='config')

class config_get(object):

    """Show a configuration option"""

    def main(self, option):

        section, sep, key = option.rpartition('.')

        section = section or 'global'

        value = self.config.get(section, key)

        if value is not None:

            print(value)

@command(api='config')

class config_set(object):

    """Set a configuration option"""

    def main(self, option, value):

        section, sep, key = option.rpartition('.')

        section = section or 'global'

        self.config.set(section, key, value)

        self.config.write()

@command(api='config')

class config_delete(object):

    """Delete a configuration option (and use the default value)"""

    def main(self, option):

        section, sep, key = option.rpartition('.')

        section = section or 'global'

        self.config.remove_option(section, key)

        self.config.write()

@command(api='compute')

class server_list(object):

    """List servers"""

    def update_parser(self, parser):

        parser.add_argument('-l', dest='detail', action='store_true',

                default=False, help='show detailed output')

    def main(self):

        servers = self.client.list_servers(self.args.detail)

        print_items(servers)

@command(api='compute')

class server_info(object):

    """Get server details"""

    def main(self, server_id):

        server = self.client.get_server_details(int(server_id))

        print_dict(server)

@command(api='compute')

class server_create(object):

    """Create a server"""

    def update_parser(self, parser):

        parser.add_argument('--personality', dest='personalities',

                          action='append', default=[],

                          metavar='PATH[,SERVER PATH[,OWNER[,GROUP,[MODE]]]]',

                          help='add a personality file')

    def main(self, name, flavor_id, image_id):

        personalities = []

        for personality in self.args.personalities:

            p = personality.split(',')

            p.extend([None] * (5 - len(p)))     # Fill missing fields with None

            path = p[0]

            if not path:

                print("Invalid personality argument '%s'" % p)

                return 1

            if not exists(path):

                print("File %s does not exist" % path)

                return 1

            with open(path) as f:

                contents = b64encode(f.read())

            d = {'path': p[1] or abspath(path), 'contents': contents}

            if p[2]:

                d['owner'] = p[2]

            if p[3]:

                d['group'] = p[3]

            if p[4]:

                d['mode'] = int(p[4])

            personalities.append(d)

        reply = self.client.create_server(name, int(flavor_id), image_id,

                personalities)

        print_dict(reply)

@command(api='compute')

class server_rename(object):

    """Update a server's name"""

    def main(self, server_id, new_name):

        self.client.update_server_name(int(server_id), new_name)

@command(api='compute')

class server_delete(object):

    """Delete a server"""

    def main(self, server_id):

        self.client.delete_server(int(server_id))

@command(api='compute')

class server_reboot(object):

    """Reboot a server"""

    def update_parser(self, parser):

        parser.add_argument('-f', dest='hard', action='store_true',

                default=False, help='perform a hard reboot')

    def main(self, server_id):

        self.client.reboot_server(int(server_id), self.args.hard)

@command(api='cyclades')

class server_start(object):

    """Start a server"""

    def main(self, server_id):

        self.client.start_server(int(server_id))

@command(api='cyclades')

class server_shutdown(object):

    """Shutdown a server"""

    def main(self, server_id):

        self.client.shutdown_server(int(server_id))

@command(api='cyclades')

class server_console(object):

    """Get a VNC console"""

    def main(self, server_id):

        reply = self.client.get_server_console(int(server_id))

        print_dict(reply)

@command(api='cyclades')

class server_firewall(object):

    """Set the server's firewall profile"""

    def main(self, server_id, profile):

        self.client.set_firewall_profile(int(server_id), profile)

@command(api='cyclades')

class server_addr(object):

    """List a server's addresses"""

    def main(self, server_id, network=None):

        reply = self.client.list_server_addresses(int(server_id), network)

        margin = max(len(x['name']) for x in reply)

        print_addresses(reply, margin)

@command(api='compute')

class server_meta(object):

    """Get a server's metadata"""

    def main(self, server_id, key=None):

        reply = self.client.get_server_metadata(int(server_id), key)

        print_dict(reply)

@command(api='compute')

class server_addmeta(object):

    """Add server metadata"""

    def main(self, server_id, key, val):

        reply = self.client.create_server_metadata(int(server_id), key, val)

        print_dict(reply)

@command(api='compute')

class server_setmeta(object):

    """Update server's metadata"""

    def main(self, server_id, key, val):

        metadata = {key: val}

        reply = self.client.update_server_metadata(int(server_id), **metadata)

        print_dict(reply)

@command(api='compute')

class server_delmeta(object):

    """Delete server metadata"""

    def main(self, server_id, key):

        self.client.delete_server_metadata(int(server_id), key)

@command(api='cyclades')

class server_stats(object):

    """Get server statistics"""

    def main(self, server_id):

        reply = self.client.get_server_stats(int(server_id))

        print_dict(reply, exclude=('serverRef',))

@command(api='compute')

class flavor_list(object):

    """List flavors"""

    def update_parser(self, parser):

        parser.add_argument('-l', dest='detail', action='store_true',

                default=False, help='show detailed output')

    def main(self):

        flavors = self.client.list_flavors(self.args.detail)

        print_items(flavors)

@command(api='compute')

class flavor_info(object):

    """Get flavor details"""

    def main(self, flavor_id):

        flavor = self.client.get_flavor_details(int(flavor_id))

        print_dict(flavor)

@command(api='compute')

class image_list(object):

    """List images"""

    def update_parser(self, parser):

        parser.add_argument('-l', dest='detail', action='store_true',

                default=False, help='show detailed output')

    def main(self):

        images = self.client.list_images(self.args.detail)

        print_items(images)

@command(api='compute')

class image_info(object):

    """Get image details"""

    def main(self, image_id):

        image = self.client.get_image_details(image_id)

        print_dict(image)

@command(api='compute')

class image_delete(object):

    """Delete image"""

    def main(self, image_id):

        self.client.delete_image(image_id)

@command(api='compute')

class image_properties(object):

    """Get image properties"""

    def main(self, image_id, key=None):

        reply = self.client.get_image_metadata(image_id, key)

        print_dict(reply)

@command(api='compute')

class image_addproperty(object):

    """Add an image property"""

    def main(self, image_id, key, val):

        reply = self.client.create_image_metadata(image_id, key, val)

        print_dict(reply)

@command(api='compute')

class image_setproperty(object):

    """Update an image property"""

    def main(self, image_id, key, val):

        metadata = {key: val}

        reply = self.client.update_image_metadata(image_id, **metadata)

        print_dict(reply)

@command(api='compute')

class image_delproperty(object):

    """Delete an image property"""

    def main(self, image_id, key):

        self.client.delete_image_metadata(image_id, key)

@command(api='cyclades')

class network_list(object):

    """List networks"""

    def update_parser(self, parser):

        parser.add_argument('-l', dest='detail', action='store_true',

                default=False, help='show detailed output')

    def main(self):

        networks = self.client.list_networks(self.args.detail)

        print_items(networks)

@command(api='cyclades')

class network_create(object):

    """Create a network"""

    def main(self, name):

        reply = self.client.create_network(name)

        print_dict(reply)

@command(api='cyclades')

class network_info(object):

    """Get network details"""

    def main(self, network_id):

        network = self.client.get_network_details(network_id)

        print_dict(network)

@command(api='cyclades')

class network_rename(object):

    """Update network name"""

    def main(self, network_id, new_name):

        self.client.update_network_name(network_id, new_name)

@command(api='cyclades')

class network_delete(object):

    """Delete a network"""

    def main(self, network_id):

        self.client.delete_network(network_id)

@command(api='cyclades')

class network_connect(object):

    """Connect a server to a network"""

    def main(self, server_id, network_id):

        self.client.connect_server(server_id, network_id)

@command(api='cyclades')

class network_disconnect(object):

    """Disconnect a server from a network"""

    def main(self, server_id, network_id):

        self.client.disconnect_server(server_id, network_id)

@command(api='image')

class image_public(object):

    """List public images"""

    def update_parser(self, parser):

        parser.add_argument('-l', dest='detail', action='store_true',

                default=False, help='show detailed output')

        parser.add_argument('--container-format', dest='container_format',

                metavar='FORMAT', help='filter by container format')

        parser.add_argument('--disk-format', dest='disk_format',

                metavar='FORMAT', help='filter by disk format')

        parser.add_argument('--name', dest='name', metavar='NAME',

                help='filter by name')

        parser.add_argument('--size-min', dest='size_min', metavar='BYTES',

                help='filter by minimum size')

        parser.add_argument('--size-max', dest='size_max', metavar='BYTES',

                help='filter by maximum size')

        parser.add_argument('--status', dest='status', metavar='STATUS',

                help='filter by status')

        parser.add_argument('--order', dest='order', metavar='FIELD',

                help='order by FIELD (use a - prefix to reverse order)')

    def main(self):

        filters = {}

        for filter in ('container_format', 'disk_format', 'name', 'size_min',

                       'size_max', 'status'):

            val = getattr(self.args, filter, None)

            if val is not None:

                filters[filter] = val

        order = self.args.order or ''

        images = self.client.list_public(self.args.detail, filters=filters,

                                         order=order)

        print_items(images, title=('name',))

@command(api='image')

class image_meta(object):

    """Get image metadata"""

    def main(self, image_id):

        image = self.client.get_meta(image_id)

        print_dict(image)

@command(api='image')

class image_register(object):

    """Register an image"""

    def update_parser(self, parser):

        parser.add_argument('--checksum', dest='checksum', metavar='CHECKSUM',

                help='set image checksum')

        parser.add_argument('--container-format', dest='container_format',

                metavar='FORMAT', help='set container format')

        parser.add_argument('--disk-format', dest='disk_format',

                metavar='FORMAT', help='set disk format')

        parser.add_argument('--id', dest='id',

                metavar='ID', help='set image ID')

        parser.add_argument('--owner', dest='owner',

                metavar='USER', help='set image owner (admin only)')

        parser.add_argument('--property', dest='properties', action='append',

                metavar='KEY=VAL',

                help='add a property (can be used multiple times)')

        parser.add_argument('--public', dest='is_public', action='store_true',

                help='mark image as public')

        parser.add_argument('--size', dest='size', metavar='SIZE',

                help='set image size')

    def main(self, name, location):

        if not location.startswith('pithos://'):

            account = self.config.get('storage', 'account')

            container = self.config.get('storage', 'container')

            location = 'pithos://%s/%s/%s' % (account, container, location)

        params = {}

        for key in ('checksum', 'container_format', 'disk_format', 'id',

                    'owner', 'size'):

            val = getattr(self.args, key)

            if val is not None:

                params[key] = val

        if self.args.is_public:

            params['is_public'] = 'true'

        properties = {}

        for property in self.args.properties or []:

            key, sep, val = property.partition('=')

            if not sep:

                print("Invalid property '%s'" % property)

                return 1

            properties[key.strip()] = val.strip()

        self.client.register(name, location, params, properties)

@command(api='image')

class image_members(object):

    """Get image members"""

    def main(self, image_id):

        members = self.client.list_members(image_id)

        for member in members:

            print(member['member_id'])

@command(api='image')

class image_shared(object):

    """List shared images"""

    def main(self, member):

        images = self.client.list_shared(member)

        for image in images:

            print(image['image_id'])

@command(api='image')

class image_addmember(object):

    """Add a member to an image"""

    def main(self, image_id, member):

        self.client.add_member(image_id, member)

@command(api='image')

class image_delmember(object):

    """Remove a member from an image"""

    def main(self, image_id, member):

        self.client.remove_member(image_id, member)

@command(api='image')

class image_setmembers(object):

    """Set the members of an image"""

    def main(self, image_id, *member):

        self.client.set_members(image_id, member)

class _store_account_command(object):

    """Base class for account level storage commands"""

    def update_parser(self, parser):

        parser.add_argument('--account', dest='account', metavar='NAME',

                          help="Specify an account to use")

    def progress(self, message):

        """Return a generator function to be used for progress tracking"""

        MESSAGE_LENGTH = 25

        def progress_gen(n):

            msg = message.ljust(MESSAGE_LENGTH)

            for i in ProgressBar(msg).iter(range(n)):

                yield

            yield

        return progress_gen

    def main(self):

        if self.args.account is not None:

            self.client.account = self.args.account

class _store_container_command(_store_account_command):

    """Base class for container level storage commands"""

    def update_parser(self, parser):

        super(_store_container_command, self).update_parser(parser)

        parser.add_argument('--container', dest='container', metavar='NAME',

                          help="Specify a container to use")

    def main(self):

        super(_store_container_command, self).main()

        if self.args.container is not None:

            self.client.container = self.args.container

@command(api='storage')

class store_info(_store_account_command):

    """Get information for account [, container [or object]]"""

    def main(self, container=None, object=None):

        super(store_info, self).main()

        if container is None:

            reply = self.client.get_account_info()

        elif object is None:

            reply = self.client.get_container_info(container)

        else:

            self.client.container = container

            reply = self.client.get_object_info(object)

        print_dict(reply)

@command(api='storage')

class store_meta(_store_account_command):

    """Get custom meta-content for account [, container [or object]]"""

    def main(self, container = None, object = None):

        super(store_meta, self).main()

        if container is None:

            reply = self.client.get_account_meta()

        elif object is None:

            reply = self.client.get_container_object_meta(container)

            print_dict(reply)

            reply = self.client.get_container_meta(container)

        else:

            self.client.container = container

            reply = self.client.get_object_meta(object)

        print_dict(reply)

@command(api='storage')

class store_setmeta(_store_account_command):

    """Set a new metadatum for account [, container [or object]]"""

    def main(self, metakey, metavalue, container=None, object=None):

        super(store_setmeta, self).main()

        if container is None:

            self.client.set_account_meta({metakey:metavalue})

        else:

            self.client.container = container

            if object is None:

                self.client.set_container_meta({metakey:metavalue})

            else:

                self.client.set_object_meta(object, {metakey:metavalue})

@command(api='storage')

class store_policy(_store_account_command):

    """Get  policy for account [, container [or object]]"""

    def main(self, container = None):

        super(store_policy, self).main()

        if container is None:

            reply = self.client.get_account_policy()

        else:

            reply = self.client.get_container_policy(container)

        print_dict(reply)

@command(api='storage')

class store_create(_store_account_command):

    """Create a container [or a directory object]"""

    def main(self, container, directory_object=None):

        super(store_create, self).main()

        if directory_object is None:

            self.client.create_container(container)

        else:

            self.client.container = container

            self.client.create_directory(directory_object)

@command(api='storage')

class store_list(_store_container_command):

    """List containers [, object trees [or objects in a directory]]"""

    def print_objects(self, object_list):

        for obj in object_list:

            size = format_size(obj['bytes']) if 0 < obj['bytes'] else 'D'

            print('%6s %s' % (size, obj['name']))

    def print_containers(self, container_list):

        for container in container_list:

            size = format_size(container['bytes'])

            print('%s (%s, %s objects)' % (container['name'], size, container['count']))

    def main(self, container=None, object=None):

        super(store_list, self).main()

        if container is None:

            reply = self.client.list_containers()

            self.print_containers(reply)

        else:

            self.client.container = container

            reply = self.client.list_objects() if object is None \

                else self.client.list_objects_in_path(path_prefix=object)

            self.print_objects(reply)

@command(api='storage')

class store_upload(_store_container_command):

    """Upload a file"""

    def main(self, container, path, remote_path=None):

        super(store_upload, self).main()

        self.client.container = container

        if remote_path is None:

            remote_path = basename(path)

        with open(path) as f:

            hash_cb = self.progress('Calculating block hashes')

            upload_cb = self.progress('Uploading blocks')

            self.client.create_object(remote_path, f, hash_cb=hash_cb,

                                      upload_cb=upload_cb)

@command(api='storage')

class store_download(_store_container_command):

    """Download a file"""

    def main(self, container,remote_path, local_path='-'):

        super(store_download, self).main()

        self.client.container = container

        f, size = self.client.get_object(remote_path)

        out = open(local_path, 'w') if local_path != '-' else stdout

        blocksize = 4 * 1024 ** 2

        nblocks = 1 + (size - 1) // blocksize

        cb = self.progress('Downloading blocks') if local_path != '-' else None

        if cb:

            gen = cb(nblocks)

            gen.next()

        data = f.read(blocksize)

        while data:

            out.write(data)

            data = f.read(blocksize)

            if cb:

                gen.next()

@command(api='storage')

class store_delete(_store_container_command):

    """Delete a container [or an object]"""

    def main(self, container, object=None):

        super(store_delete, self).main()

        if object is None:

            self.client.delete_container(container)

        else:

            self.client.container = container

            self.client.delete_object(object)

@command(api='storage')

class store_purge(_store_account_command):

    """Purge a container"""

    def main(self, container):

        super(store_purge, self).main()

        self.client.purge_container(container)

@command(api='astakos')

class astakos_authenticate(object):

    """Authenticate a user"""

    def main(self):

        reply = self.client.authenticate()

        print_dict(reply)

def print_groups():

    print('\nGroups:')

    for group in _commands:

        description = GROUPS.get(group, '')

        print(' ', group.ljust(12), description)

def print_commands(group):

    description = GROUPS.get(group, '')

    if description:

        print('\n' + description)

    print('\nCommands:')

    for name, cls in _commands[group].items():

        print(' ', name.ljust(14), cls.description)

def add_handler(name, level, prefix=''):

    h = logging.StreamHandler()

    fmt = logging.Formatter(prefix + '%(message)s')

    h.setFormatter(fmt)

    logger = logging.getLogger(name)

    logger.addHandler(h)

    logger.setLevel(level)

def main():

    exe = basename(sys.argv[0])

    parser = ArgumentParser(add_help=False)

    parser.prog = '%s <group> <command>' % exe

    parser.add_argument('-h', '--help', dest='help', action='store_true',

                      default=False,

                      help="Show this help message and exit")

    parser.add_argument('--config', dest='config', metavar='PATH',

                      help="Specify the path to the configuration file")

    parser.add_argument('-d', '--debug', dest='debug', action='store_true',

                      default=False,

                      help="Include debug output")

    parser.add_argument('-i', '--include', dest='include', action='store_true',

                      default=False,

                      help="Include protocol headers in the output")

    parser.add_argument('-s', '--silent', dest='silent', action='store_true',

                      default=False,

                      help="Silent mode, don't output anything")

    parser.add_argument('-v', '--verbose', dest='verbose', action='store_true',

                      default=False,

                      help="Make the operation more talkative")

    parser.add_argument('-V', '--version', dest='version', action='store_true',

                      default=False,

                      help="Show version number and quit")

    parser.add_argument('-o', dest='options', action='append',

                      default=[], metavar="KEY=VAL",

                      help="Override a config values")

    args, argv = parser.parse_known_args()

    if args.version:

        import kamaki

        print("kamaki %s" % kamaki.__version__)

        exit(0)

    config = Config(args.config) if args.config else Config()

    for option in args.options:

        keypath, sep, val = option.partition('=')

        if not sep:

            print("Invalid option '%s'" % option)

            exit(1)

        section, sep, key = keypath.partition('.')

        if not sep:

            print("Invalid option '%s'" % option)

            exit(1)

        config.override(section.strip(), key.strip(), val.strip())

    apis = set(['config'])

    for api in ('compute', 'image', 'storage', 'astakos'):

        if config.getboolean(api, 'enable'):

            apis.add(api)

    if config.getboolean('compute', 'cyclades_extensions'):

        apis.add('cyclades')

    if config.getboolean('storage', 'pithos_extensions'):

        apis.add('pithos')

    # Remove commands that belong to APIs that are not included

    for group, group_commands in _commands.items():

        for name, cls in group_commands.items():

            if cls.api not in apis:

                del group_commands[name]

        if not group_commands:

            del _commands[group]

    group = argv.pop(0) if argv else None

    if not group:

        parser.print_help()

        print_groups()

        exit(0)

    if group not in _commands:

        parser.print_help()

        print_groups()

        exit(1)

    parser.prog = '%s %s <command>' % (exe, group)

    command = argv.pop(0) if argv else None

    if not command:

        parser.print_help()

        print_commands(group)

        exit(0)

    if command not in _commands[group]:

        parser.print_help()

        print_commands(group)

        exit(1)

    cmd = _commands[group][command]()

    parser.prog = '%s %s %s' % (exe, group, command)

    if cmd.syntax:

        parser.prog += '  %s' % cmd.syntax

    parser.description = cmd.description

    parser.epilog = ''

    if hasattr(cmd, 'update_parser'):

        cmd.update_parser(parser)

    args, argv = parser.parse_known_args()

    if args.help:

        parser.print_help()

        exit(0)

    if args.silent:

        add_handler('', logging.CRITICAL)

    elif args.debug:

        add_handler('requests', logging.INFO, prefix='* ')

        add_handler('clients.send', logging.DEBUG, prefix='> ')

        add_handler('clients.recv', logging.DEBUG, prefix='< ')

    elif args.verbose:

        add_handler('requests', logging.INFO, prefix='* ')

        add_handler('clients.send', logging.INFO, prefix='> ')

        add_handler('clients.recv', logging.INFO, prefix='< ')

    elif args.include:

        add_handler('clients.recv', logging.INFO)

    else:

        add_handler('', logging.WARNING)

    api = cmd.api

    if api in ('compute', 'cyclades'):