[commands] Factor out common commands to make them reusable

Starting with the list command

beat/cmdline/commands.py

+#!/usr/bin/env python
+# vim: set fileencoding=utf-8 :
+
+###################################################################################
+#                                                                                 #
+# Copyright (c) 2019 Idiap Research Institute, http://www.idiap.ch/               #
+# Contact: beat.support@idiap.ch                                                  #
+#                                                                                 #
+# 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.                          #
+#                                                                                 #
+# 3. Neither the name of the copyright holder nor the names of its contributors   #
+# may be used to endorse or promote products derived from this software without   #
+# specific prior written permission.                                              #
+#                                                                                 #
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 THE COPYRIGHT HOLDER 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.            #
+#                                                                                 #
+###################################################################################
+
+import click
+import types
+
+from .decorators import raise_on_error
+
+from . import common
+
+
+def copy_func(f, name=None):
+    """
+    based on https://stackoverflow.com/a/30714299/5843716
+
+    return a function with same code, globals, defaults, closure, doc, and
+    name (or provide a new name)
+    """
+    fn = types.FunctionType(
+        f.__code__, f.__globals__, name or f.__name__, f.__defaults__, f.__closure__
+    )
+    # in case f was given attrs (note this dict is a shallow copy):
+    fn.__dict__.update(f.__dict__)
+    fn.__doc__ = f.__doc__
+
+    return fn
+
+
+@click.option(
+    "--remote", help="Only acts on the remote copy of the list.", is_flag=True
+)
+@click.pass_context
+@raise_on_error
+def list_impl(ctx, remote):
+    """Lists the assets of this type available on the platform.
+
+    To list all existing asset of a type on your local prefix:
+
+    $ beat <asset_type> list
+    """
+
+    if remote:
+        with common.make_webapi(ctx.meta["config"]) as webapi:
+            return common.display_remote_list(webapi, ctx.meta["asset_type"])
+    else:
+        return common.display_local_list(
+            ctx.meta["config"].path, ctx.meta["asset_type"]
+        )
+
+
+CMD_TABLE = {"list": list_impl}
+
+
+def command(name):
+    return copy_func(CMD_TABLE[name])