summaryrefslogtreecommitdiff
path: root/cliff/command.py
blob: 94c8e8e6608f99f87b2bc8993357adb0684ea84f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

import abc
import argparse
import inspect


class Command(object):
    """Base class for command plugins.
    """
    __metaclass__ = abc.ABCMeta

    def __init__(self, app, app_args):
        self.app = app
        self.app_args = app_args
        return

    def get_description(self):
        """Return the command description.
        """
        return inspect.getdoc(self.__class__) or ''

    def get_parser(self, prog_name):
        """Return an argparse.ArgumentParser.
        """
        parser = argparse.ArgumentParser(
            description=self.get_description(),
            prog=prog_name,
            )
        return parser

    @abc.abstractmethod
    def run(self, parsed_args):
        """Do something useful.
        """