agent-starter-pack 0.3.3__py3-none-any.whl → 0.21.0__py3-none-any.whl

agent_starter_pack/cli/utils/logging.py

@@ -0,0 +1,103 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+from collections.abc import Callable
+from functools import wraps
+from typing import Any, TypeVar, cast
+
+from rich.console import Console
+
+console = Console()
+
+F = TypeVar("F", bound=Callable[..., Any])
+
+
+def display_welcome_banner(
+    agent: str | None = None, enhance_mode: bool = False, agent_garden: bool = False
+) -> None:
+    """Display the Agent Starter Pack welcome banner.
+
+    Args:
+        agent: Optional agent specification to customize the welcome message
+        enhance_mode: Whether this is for enhancement mode
+        agent_garden: Whether this deployment is from Agent Garden
+    """
+    if enhance_mode:
+        console.print(
+            "\n=== Google Cloud Agent Starter Pack 🚀===",
+            style="bold blue",
+        )
+        console.print(
+            "Enhancing your existing project with production-ready agent capabilities!\n",
+            style="green",
+        )
+    elif agent_garden:
+        console.print(
+            "\n=== Welcome to Agent Garden! 🌱 ===",
+            style="bold blue",
+        )
+        console.print(
+            "Powered by [link=https://goo.gle/agent-starter-pack]Google Cloud - Agent Starter Pack [/link]\n",
+        )
+        console.print(
+            "This tool will help you deploy production-ready AI agents from Agent Garden to Google Cloud!\n"
+        )
+    elif agent and agent.startswith("adk@"):
+        console.print(
+            "\n=== Welcome to [link=https://github.com/google/adk-samples]google/adk-samples[/link]! ✨ ===",
+            style="bold blue",
+        )
+        console.print(
+            "Powered by [link=https://goo.gle/agent-starter-pack]Google Cloud - Agent Starter Pack [/link]\n",
+        )
+        console.print(
+            "This tool will help you create an end-to-end production-ready AI agent in Google Cloud!\n"
+        )
+    else:
+        console.print(
+            "\n=== Google Cloud Agent Starter Pack 🚀===",
+            style="bold blue",
+        )
+        console.print("Welcome to the Agent Starter Pack!")
+        console.print(
+            "This tool will help you create an end-to-end production-ready AI agent in Google Cloud!\n"
+        )
+
+
+def handle_cli_error(f: F) -> F:
+    """Decorator to handle CLI errors gracefully.
+
+    Wraps CLI command functions to catch any exceptions and display them nicely
+    to the user before exiting with a non-zero status code.
+
+    Args:
+        f: The CLI command function to wrap
+
+    Returns:
+        The wrapped function that handles errors
+    """
+
+    @wraps(f)
+    def wrapper(*args: Any, **kwargs: Any) -> Any:
+        try:
+            return f(*args, **kwargs)
+        except KeyboardInterrupt:
+            console.print("\nOperation cancelled by user", style="yellow")
+            sys.exit(130)  # Standard exit code for Ctrl+C
+        except Exception as e:
+            console.print(f"Error: {e!s}", style="bold red")
+            sys.exit(1)
+
+    return cast(F, wrapper)