import re

_command_name_pattern = re.compile("^[a-z0-9-]{3,}$")

class _Command(object):
    """This class is used internally by the @command decorator
    to store command information on a method.
    """

    def __init__(self, method_name, name, kwargs, arguments):
        if not isinstance(method_name, str):
            raise TypeError(
                "Parameter 'method_name' is invalid. "
                "Expected a str instead of {got_type}.".format(
                    got_type=type(method_name).__name__))
        if not isinstance(name, str):
            raise TypeError(
                "Parameter 'name' is invalid. "
                "Expected a str instead of {got_type}.".format(
                    got_type=type(name).__name__))
        if not isinstance(kwargs, dict):
            raise TypeError(
                "Parameter 'kwargs' is invalid. "
                "Expected a dict instead of {got_type}.".format(
                    got_type=type(kwargs).__name__))
        if not isinstance(arguments, list):
            raise TypeError(
                "Parameter 'arguments' is invalid. "
                "Expected a list instead of {got_type}.".format(
                    got_type=type(arguments).__name__))
        if not _command_name_pattern.match(name):
            raise ValueError(
                "Invalid command name '{name}'. "
                "Wrong format.".format(
                    name=name))

        self.method_name = method_name
        self.name = name
        self.kwargs = kwargs
        self.arguments = arguments

    def __call__(self, target, *args, **kwargs):
        method = getattr(target, self.method_name, None)
        if not method:
            raise AttributeError(
                "Can't call command '{name}'. "
                "Method {method_name} does not exist on {cls}.".format(
                    name=self.name,
                    method_name=self.method_name,
                    cls=type(target).__name__))
        if not callable(method):
            raise TypeError(
                "Can't call command '{name}'. "
                "Attribute {method_name} on {cls} is not a method.".format(
                    name=self.name,
                    method_name=self.method_name,
                    cls=type(target).__name__))
        return method(*args, **kwargs)


def argument(*args, **kwargs):
    """Convenience function to properly format arguments to pass to the
    command decorator.
    """
    return (list(args), kwargs)


def command(*args, **kwargs):
    """Add this decorator to a method to expose it to the commands function.
    """

    def decorator(func):
        # validate func parameter
        if not func or not callable(func):
            raise TypeError(
                "Decorator @{command} should be added to a method "
                "instead of {type}.".format(
                    command=command.__name__,
                    type=type(func).__name__)
            )

        # convert arguments tuple to list
        arguments = list(args)

        # set default name
        name = kwargs.get('name')
        if not name:
            command_name = func.__name__.lower().replace('_', '-')
        else:
            command_name = name

        # set default description
        kwargs.setdefault('description', func.__doc__)

        # store the command on the function
        func.__command__ = _Command(
            func.__name__, command_name, kwargs, arguments)

        return func

    return decorator


def getcommand(cls, name):
    """Get a command by name, given the class and the command name.
    """

    # validate parameters
    if not isinstance(cls, type):
        raise TypeError(
            "Parameter 'cls' should be a class "
            "instead of {}.".format(
                type(cls).__name__))
    if not isinstance(name, str):
        raise TypeError(
            "Parameter 'name' should be a str "
            "instead of {}.".format(
                type(name).__name__))

    # derive method name
    method_name = name.lower().replace('-', '_')

    # find the command (also look in base classes)
    for base in [cls] + list(cls.__bases__):
        try:
            return getattr(getattr(base, method_name), '__command__')
        except AttributeError:
            pass
    return None


def _getcommands(cls, *names):
    """Returns all the methods that have the @command decorator.
    """

    member_names = dir(cls)
    # klass = cls if instance(cls, type) else cls.__class__
    # for base in klass.__bases__:
    #   member_names += dir(base)
    # member_names = set(member_names)

    for name in member_names:
        try:
            cmd = getcommand(cls, name)
            if cmd and (not names or cmd.name in names):
                yield cmd
        except (ValueError, AttributeError):
            continue


def getcommands(cls, *names):
    return list(_getcommands(cls, *names))

import re

_command_name_pattern = re.compile("^[a-z0-9-]{3,}$")

class _Command(object):
    """This class is used internally by the @command decorator
    to store command information on a method.
    """

    def __init__(self, method_name, name, kwargs, arguments):
        if not isinstance(method_name, str):
            raise TypeError(
                "Parameter 'method_name' is invalid. "
                "Expected a str instead of {got_type}.".format(
                    got_type=type(method_name).__name__))
        if not isinstance(name, str):
            raise TypeError(
                "Parameter 'name' is invalid. "
                "Expected a str instead of {got_type}.".format(
                    got_type=type(name).__name__))
        if not isinstance(kwargs, dict):
            raise TypeError(
                "Parameter 'kwargs' is invalid. "
                "Expected a dict instead of {got_type}.".format(
                    got_type=type(kwargs).__name__))
        if not isinstance(arguments, list):
            raise TypeError(
                "Parameter 'arguments' is invalid. "
                "Expected a list instead of {got_type}.".format(
                    got_type=type(arguments).__name__))
        if not _command_name_pattern.match(name):
            raise ValueError(
                "Invalid command name '{name}'. "
                "Wrong format.".format(
                    name=name))

        self.method_name = method_name
        self.name = name
        self.kwargs = kwargs
        self.arguments = arguments

    def __call__(self, target, *args, **kwargs):
        method = getattr(target, self.method_name, None)
        if not method:
            raise AttributeError(
                "Can't call command '{name}'. "
                "Method {method_name} does not exist on {cls}.".format(
                    name=self.name,
                    method_name=self.method_name,
                    cls=type(target).__name__))
        if not callable(method):
            raise TypeError(
                "Can't call command '{name}'. "
                "Attribute {method_name} on {cls} is not a method.".format(
                    name=self.name,
                    method_name=self.method_name,
                    cls=type(target).__name__))
        return method(*args, **kwargs)


def argument(*args, **kwargs):
    """Convenience function to properly format arguments to pass to the
    command decorator.
    """
    return (list(args), kwargs)


def command(*args, **kwargs):
    """Add this decorator to a method to expose it to the commands function.
    """

    def decorator(func):
        # validate func parameter
        if not func or not callable(func):
            raise TypeError(
                "Decorator @{command} should be added to a method "
                "instead of {type}.".format(
                    command=command.__name__,
                    type=type(func).__name__)
            )

        # convert arguments tuple to list
        arguments = list(args)

        # set default name
        name = kwargs.get('name')
        if not name:
            command_name = func.__name__.lower().replace('_', '-')
        else:
            command_name = name

        # set default description
        kwargs.setdefault('description', func.__doc__)

        # store the command on the function
        func.__command__ = _Command(
            func.__name__, command_name, kwargs, arguments)

        return func

    return decorator


def getcommand(cls, name):
    """Get a command by name, given the class and the command name.
    """

    # validate parameters
    if not isinstance(cls, type):
        raise TypeError(
            "Parameter 'cls' should be a class "
            "instead of {}.".format(
                type(cls).__name__))
    if not isinstance(name, str):
        raise TypeError(
            "Parameter 'name' should be a str "
            "instead of {}.".format(
                type(name).__name__))

    # derive method name
    method_name = name.lower().replace('-', '_')

    # find the command (also look in base classes)
    for base in [cls] + list(cls.__bases__):
        try:
            return getattr(getattr(base, method_name), '__command__')
        except AttributeError:
            pass
    return None


def _getcommands(cls, *names):
    """Returns all the methods that have the @command decorator.
    """

    member_names = dir(cls)
    # klass = cls if instance(cls, type) else cls.__class__
    # for base in klass.__bases__:
    #   member_names += dir(base)
    # member_names = set(member_names)

    for name in member_names:
        try:
            cmd = getcommand(cls, name)
            if cmd and (not names or cmd.name in names):
                yield cmd
        except (ValueError, AttributeError):
            continue


def getcommands(cls, *names):
    return list(_getcommands(cls, *names))

This class is used internally by the @command decorator
     to store command information on a method. Convenience function to properly format arguments to pass to the
     command decorator. Add this decorator to a method to expose it to the commands function. # validate func parameter # convert arguments tuple to list # set default name # set default description # store the command on the function Get a command by name, given the class and the command name. # validate parameters # derive method name # find the command (also look in base classes) Returns all the methods that have the @command decorator. # klass = cls if instance(cls, type) else cls.__class__ # for base in klass.__bases__: #   member_names += dir(base) # member_names = set(member_names)