Initial commit

skills/python-uv-scripts/assets/templates/api-client.py

@@ -0,0 +1,72 @@
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.11"
+# dependencies = [
+#   "httpx>=0.27.0",
+#   "rich>=13.0.0",
+# ]
+# ///
+"""
+API client template using httpx.
+
+Demonstrates HTTP requests, error handling, and structured output.
+Includes environment variable usage for API credentials.
+
+Usage:
+    export API_URL="https://api.example.com"
+    export API_TOKEN="your-token"
+    python api-client.py
+"""
+
+import httpx
+import os
+import sys
+from rich import print
+from rich.console import Console
+
+console = Console()
+
+
+def get_env_var(name: str) -> str:
+    """Get required environment variable or exit with error."""
+    value = os.getenv(name)
+    if not value:
+        console.print(f"[red]Error: {name} environment variable not set[/red]")
+        sys.exit(1)
+    return value
+
+
+def fetch_data(api_url: str, token: str):
+    """Fetch data from API with error handling."""
+    headers = {"Authorization": f"Bearer {token}"}
+
+    try:
+        with httpx.Client() as client:
+            response = client.get(api_url, headers=headers, timeout=10.0)
+            response.raise_for_status()
+            return response.json()
+
+    except httpx.HTTPStatusError as e:
+        console.print(f"[red]HTTP error {e.response.status_code}[/red]")
+        console.print(f"Response: {e.response.text}")
+        sys.exit(1)
+    except httpx.RequestError as e:
+        console.print(f"[red]Request failed: {e}[/red]")
+        sys.exit(1)
+
+
+def main():
+    """Main entry point."""
+    api_url = get_env_var("API_URL")
+    api_token = get_env_var("API_TOKEN")
+
+    console.print(f"[cyan]Fetching data from {api_url}...[/cyan]")
+
+    data = fetch_data(api_url, api_token)
+
+    # Process and display data
+    print(data)
+
+
+if __name__ == "__main__":
+    main()