deprecated decorator

Author: kossak

paperspace/cli/common.py

@@ -1,7 +1,7 @@
+import functools
 import getpass
 
 import click
-from click import group
 from click_didyoumean import DYMMixin
 from click_help_colors import HelpColorsGroup
 
@@ -32,10 +32,10 @@ def group(self, *args, **kwargs):
             aliases.append(kwargs.pop('alias'))
 
         def decorator(f):
-            cmd = group(*_args, **kwargs)(f)
+            cmd = click.group(*_args, **kwargs)(f)
             self.add_command(cmd)
             for alias in set(aliases):
-                alias_cmd = group(alias, **kwargs)(f)
+                alias_cmd = click.group(alias, **kwargs)(f)
                 self.add_command(alias_cmd)
                 alias_cmd.commands = cmd.commands
             return cmd
@@ -51,3 +51,20 @@ def callback_fun(ctx, param, value):
         return value
 
     return callback_fun
+
+
+def deprecated(f, version="1.0.0"):
+    deprecated_invoke_notice = """DeprecatedWarning: \nWARNING: This command will not be included in version %s .
+For more information, please see:
+
+https://docs.paperspace.com
+If you depend on functionality not listed there, please file an issue.""" % version
+
+    def new_invoke(self, ctx):
+        click.echo(click.style(deprecated_invoke_notice, fg='red'), err=True)
+        super(type(self), self).invoke(ctx)
+
+    def decorator():
+        f.invoke = functools.partial(new_invoke, f)
+
+    return decorator()

paperspace/cli/run.py

@@ -3,13 +3,14 @@
 from paperspace import client, config
 from paperspace.cli import common
 from paperspace.cli.cli import cli
-from paperspace.cli.common import del_if_value_is_none
+from paperspace.cli.common import del_if_value_is_none, deprecated
 from paperspace.cli.jobs import common_jobs_create_options
 from paperspace.commands.run import RunCommand
 from paperspace.constants import RunMode
 
 
-@cli.command("new-run")
+@deprecated
+@cli.command("run", help="Run script or command on remote cluster")
 @click.option("-c", "--python-command", "mode", flag_value=RunMode.RUN_MODE_PYTHON_COMMAND)
 @click.option("-m", "--module", "mode", flag_value=RunMode.RUN_MODE_PYTHON_MODULE)
 @click.option("-s", "--shell", "mode", flag_value=RunMode.RUN_MODE_SHELL_COMMAND)

tests/functional/test_run.py

@@ -9,7 +9,7 @@
 
 
 class TestRunCommand(object):
-    command_name = 'new-run'
+    command_name = 'run'
     common_commands = ["--name", "test", "--projectId", "projectId", "--apiKey", "some_key"]
     url = "https://api.paperspace.io/jobs/createJob/"
     headers = default_headers.copy()