Adds a decorator to generate watch command for the run operation.

Author: mrDzurb

ads/opctl/decorator/__init__.py

@@ -0,0 +1,5 @@
+#!/usr/bin/env python
+# -*- coding: utf-8; -*-
+
+# Copyright (c) 2023 Oracle and its affiliates.
+# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/

ads/opctl/decorator/common.py

@@ -0,0 +1,25 @@
+#!/usr/bin/env python
+# -*- coding: utf-8; -*-
+
+# Copyright (c) 2023 Oracle and/or its affiliates.
+# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
+
+from typing import Dict, Callable
+from functools import wraps
+
+RUN_ID_FIELD = "run_id"
+
+def print_watch_command(func: callable)->Callable:
+    """The decorator to help build the `opctl watch` command."""
+    @wraps(func)
+    def wrapper(*args, **kwargs)->Dict:
+        result = func(*args, **kwargs)
+        if result and isinstance(result, Dict) and RUN_ID_FIELD in result:
+            msg_header = (
+                f"{'*' * 40} To monitor the progress of a task, execute the following command {'*' * 40}"
+            )
+            print(msg_header)
+            print(f"ads opctl watch {result[RUN_ID_FIELD]}")
+            print("*" * len(msg_header))
+        return result
+    return wrapper