1.2.1 pip

A universal installation method (that works on Windows, Mac OS X, Linux, and always provides the latest version) is to use pip:

# Make sure we have an up-to-date version of pip and setuptools:
$ pip install --upgrade pip setuptools

$ pip install --upgrade tsaotun

(If pip installation fails for some reason, you can try easy_install tsaotun as a fallback.)

1.2.2 Docker hub

Pull from dockerhub, or build it yourself:

$ docker build -t tsaotun .

Verify that now we have installed the latest version, for example:

$ tsaotun version
Client:
    Version:         0.8.1
    Python version:  2.7.13
    OS/Arch:         Darwin/x86_64

Server:
    Version:         1.13.0-rc7
    API version:     1.25 (minimum version 1.12)
    Go version:      go1.7.3
    Git commit:      48a9e53
    Built:           5 days ago
    OS/Arch:         linux/amd64
    Kernel version:  4.9.3-moby
    Experimental:    True

1.4.1 Best practices (Sample addon to remove “ALL” containers at once, no matter it’s dead or alive)

__init__.py: To specify how to override the original command

"""Configuration file for this addon"""

from .Container import rm

__override__ = {'Container.rm': 'Rm'}
__argparse__ = [
    {
        'namespace': "Container",
        'position': "Child",
        'subcommand': "rm",
        'actions': [
            "add_argument('--clear',            \
                            action='store_true', \
                            dest='clear',        \
                            help='Remove all dead and alive containers. \
                                    You still need to give a whatever container ID.')",
        ],
    },
]

Container/rm.py

"""This module contains `docker container rm` class"""

from docker.errors import APIError
from tsaotun.lib.Docker.Container.command import Command
from tsaotun.cli import Tsaotun


class Rm(Command):
    """This class implements `docker container rm` command"""

    name = "container rm"
    require = []

    def __init__(self):
        Command.__init__(self)
        self.settings[self.name] = None

    def eval_command(self, args):
        try:
            containers = args["containers"]
            clear = args["clear"]
            del args["containers"]
            del args["clear"]
            Ids = []
            if clear:
                cli = Tsaotun()
                cli.send('ps -a --format {{Id}}')
                ress = cli.recv()
                if ress:
                    ress = ress.split('\n')
                    ress = [res[0:4] for res in ress]
                    for Id in ress:
                        Ids.append(Id)
                        args['container'] = Id
                        self.client.remove_container(**args)
            else:
                for Id in containers:
                    Ids.append(Id)
                    args['container'] = Id
                    self.client.remove_container(**args)
            self.settings[self.name] = '\n'.join(Ids)

        except APIError as e:
            raise e

    def final(self):
        return self.settings[self.name]