pangu-rca 0.1.0__tar.gz

pangu_rca-0.1.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: pangu-rca
+Version: 0.1.0
+Summary: Pangu RCA CLI - AI-powered log analysis tool
+Home-page: https://www.pangulab.com
+Author: Pangulab Team
+Author-email: Pangulab Team <r00txxyyzz@gmail.com>
+License: MIT
+Project-URL: Homepage, https://www.pangulab.com
+Project-URL: Source, https://github.com/halokid/TronRabbit
+Keywords: log analysis,AI,root cause analysis,debugging,devtools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: System :: Logging
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# Pangu RCA CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/pangu-rca)](https://pypi.org/project/pangu-rca/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/pangu-rca)](https://pypi.org/project/pangu-rca/)
+[![License](https://img.shields.io/pypi/l/pangu-rca)](https://github.com/halokid/TronRabbit/blob/main/LICENSE)
+
+**AI-powered log analysis tool for developers.** Analyze error logs directly from your terminal.
+
+## Installation
+
+```bash
+pip install pangu-rca
+```
+
+## Quick Start
+
+```bash
+# Analyze a log file
+pangu-rca analyze error.log
+
+# Analyze with English output
+pangu-rca analyze error.log --lang en
+
+# Pipe log content directly
+cat error.log | pangu-rca analyze --stdin
+
+# Get JSON output (for scripting)
+pangu-rca analyze error.log --output json
+
+# Check service health
+pangu-rca health
+```
+
+## Examples
+
+### Analyze a Java error log
+
+```bash
+$ pangu-rca analyze java_error.log
+```
+
+```
+============================================================
+🔍 Pangu RCA Agent - 分析结果
+============================================================
+
+📋 问题类型: 数据库连接超时
+🎯 置信度: 95.0%
+
+📝 详细原因:
+   数据库连接池配置过小，导致在高并发场景下连接被耗尽...
+
+🔑 关键证据:
+   1. java.sql.SQLException: Connection timeout
+   2. Caused by: java.sql.SQLTimeoutException: Timeout waiting for connection
+
+💡 修复建议:
+   增加数据库连接池的最大连接数，建议从 10 调整为 50...
+```
+
+### Pipe from another command
+
+```bash
+# Analyze Docker container logs
+docker logs my-container 2>&1 | pangu-rca analyze --stdin
+
+# Analyze system logs
+journalctl -u my-service --no-pager | pangu-rca analyze --stdin --lang en
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--lang` | Output language: `zh` or `en` | `zh` |
+| `--output` | Output format: `text` or `json` | `text` |
+| `--api-url` | Custom API endpoint | `https://www.pangulab.com/api/analyze` |
+
+## Commands
+
+- `pangu-rca analyze <file>` — Analyze a log file
+- `pangu-rca analyze --stdin` — Read logs from stdin
+- `pangu-rca health` — Check API service status
+- `pangu-rca --version` — Show version
+- `pangu-rca --help` — Show help
+
+## About
+
+Pangu RCA Agent is an AI-powered log analysis tool that helps developers quickly identify root causes of errors from application logs. It supports Java, Python, Go, Rust, JavaScript, and many other programming languages.
+
+**Web version**: https://www.pangulab.com
+
+## License
+
+MIT

pangu_rca-0.1.0/README.md

@@ -0,0 +1,95 @@
+# Pangu RCA CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/pangu-rca)](https://pypi.org/project/pangu-rca/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/pangu-rca)](https://pypi.org/project/pangu-rca/)
+[![License](https://img.shields.io/pypi/l/pangu-rca)](https://github.com/halokid/TronRabbit/blob/main/LICENSE)
+
+**AI-powered log analysis tool for developers.** Analyze error logs directly from your terminal.
+
+## Installation
+
+```bash
+pip install pangu-rca
+```
+
+## Quick Start
+
+```bash
+# Analyze a log file
+pangu-rca analyze error.log
+
+# Analyze with English output
+pangu-rca analyze error.log --lang en
+
+# Pipe log content directly
+cat error.log | pangu-rca analyze --stdin
+
+# Get JSON output (for scripting)
+pangu-rca analyze error.log --output json
+
+# Check service health
+pangu-rca health
+```
+
+## Examples
+
+### Analyze a Java error log
+
+```bash
+$ pangu-rca analyze java_error.log
+```
+
+```
+============================================================
+🔍 Pangu RCA Agent - 分析结果
+============================================================
+
+📋 问题类型: 数据库连接超时
+🎯 置信度: 95.0%
+
+📝 详细原因:
+   数据库连接池配置过小，导致在高并发场景下连接被耗尽...
+
+🔑 关键证据:
+   1. java.sql.SQLException: Connection timeout
+   2. Caused by: java.sql.SQLTimeoutException: Timeout waiting for connection
+
+💡 修复建议:
+   增加数据库连接池的最大连接数，建议从 10 调整为 50...
+```
+
+### Pipe from another command
+
+```bash
+# Analyze Docker container logs
+docker logs my-container 2>&1 | pangu-rca analyze --stdin
+
+# Analyze system logs
+journalctl -u my-service --no-pager | pangu-rca analyze --stdin --lang en
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--lang` | Output language: `zh` or `en` | `zh` |
+| `--output` | Output format: `text` or `json` | `text` |
+| `--api-url` | Custom API endpoint | `https://www.pangulab.com/api/analyze` |
+
+## Commands
+
+- `pangu-rca analyze <file>` — Analyze a log file
+- `pangu-rca analyze --stdin` — Read logs from stdin
+- `pangu-rca health` — Check API service status
+- `pangu-rca --version` — Show version
+- `pangu-rca --help` — Show help
+
+## About
+
+Pangu RCA Agent is an AI-powered log analysis tool that helps developers quickly identify root causes of errors from application logs. It supports Java, Python, Go, Rust, JavaScript, and many other programming languages.
+
+**Web version**: https://www.pangulab.com
+
+## License
+
+MIT

pangu_rca-0.1.0/pangu_rca/__init__.py

@@ -0,0 +1,5 @@
+"""
+Pangu RCA CLI - AI-powered log analysis tool
+"""
+
+__version__ = "0.1.0"

pangu_rca-0.1.0/pangu_rca/cli.py

@@ -0,0 +1,262 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Pangu RCA CLI - AI-powered log analysis tool
+
+Usage:
+    pangu-rca analyze <log-file> [--api-url=<url>] [--lang=<lang>] [--output=<format>]
+    pangu-rca analyze --stdin [--api-url=<url>] [--lang=<lang>] [--output=<format>]
+    pangu-rca --version
+    pangu-rca --help
+
+Examples:
+    pangu-rca analyze error.log
+    pangu-rca analyze error.log --lang en
+    pangu-rca analyze error.log --output json
+    cat error.log | pangu-rca analyze --stdin
+"""
+
+import argparse
+import json
+import sys
+import os
+import requests
+from . import __version__
+
+
+DEFAULT_API_URL = "https://www.pangulab.com/api/analyze"
+
+
+def read_file(file_path):
+    """Read log content from a file."""
+    try:
+        with open(file_path, 'r', encoding='utf-8', errors='ignore') as f:
+            return f.read()
+    except FileNotFoundError:
+        print(f"❌ Error: File not found: {file_path}", file=sys.stderr)
+        sys.exit(1)
+    except Exception as e:
+        print(f"❌ Error reading file: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+def read_stdin():
+    """Read log content from stdin."""
+    try:
+        return sys.stdin.read()
+    except Exception as e:
+        print(f"❌ Error reading stdin: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+def call_api(log_content, api_url, language):
+    """Call the Pangu RCA API for log analysis."""
+    try:
+        response = requests.post(
+            api_url,
+            headers={"Content-Type": "application/json"},
+            json={
+                "log_content": log_content,
+                "language": language
+            },
+            timeout=60
+        )
+
+        if response.status_code == 200:
+            return response.json()
+        else:
+            error_detail = "Unknown error"
+            try:
+                error_detail = response.json().get("detail", response.text)
+            except Exception:
+                error_detail = response.text
+            print(f"❌ API Error ({response.status_code}): {error_detail}", file=sys.stderr)
+            sys.exit(1)
+
+    except requests.exceptions.ConnectionError:
+        print(f"❌ Error: Cannot connect to {api_url}", file=sys.stderr)
+        print("   Make sure the service is running and the URL is correct.", file=sys.stderr)
+        sys.exit(1)
+    except requests.exceptions.Timeout:
+        print("❌ Error: API request timed out (60s)", file=sys.stderr)
+        sys.exit(1)
+    except Exception as e:
+        print(f"❌ Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+def format_text_output(result, language):
+    """Format analysis result as human-readable text."""
+    confidence_pct = result.get("confidence", 0) * 100
+
+    if language == "zh":
+        output = []
+        output.append("=" * 60)
+        output.append("🔍 Pangu RCA Agent - 分析结果")
+        output.append("=" * 60)
+        output.append(f"\n📋 问题类型: {result.get('root_cause_type', 'N/A')}")
+        output.append(f"🎯 置信度: {confidence_pct:.1f}%")
+        output.append(f"\n📝 详细原因:")
+        output.append(f"   {result.get('root_cause_detail', 'N/A')}")
+        output.append(f"\n🔑 关键证据:")
+        for i, evidence in enumerate(result.get("key_evidence", []), 1):
+            output.append(f"   {i}. {evidence}")
+        output.append(f"\n💡 修复建议:")
+        output.append(f"   {result.get('suggestion', 'N/A')}")
+        output.append("\n" + "=" * 60)
+        return "\n".join(output)
+    else:
+        output = []
+        output.append("=" * 60)
+        output.append("🔍 Pangu RCA Agent - Analysis Result")
+        output.append("=" * 60)
+        output.append(f"\n📋 Problem Type: {result.get('root_cause_type', 'N/A')}")
+        output.append(f"🎯 Confidence: {confidence_pct:.1f}%")
+        output.append(f"\n📝 Detailed Reason:")
+        output.append(f"   {result.get('root_cause_detail', 'N/A')}")
+        output.append(f"\n🔑 Key Evidence:")
+        for i, evidence in enumerate(result.get("key_evidence", []), 1):
+            output.append(f"   {i}. {evidence}")
+        output.append(f"\n💡 Fix Suggestions:")
+        output.append(f"   {result.get('suggestion', 'N/A')}")
+        output.append("\n" + "=" * 60)
+        return "\n".join(output)
+
+
+def format_output(result, output_format, language):
+    """Format the analysis result in the specified format."""
+    if output_format == "json":
+        return json.dumps(result, indent=2, ensure_ascii=False)
+    elif output_format == "text":
+        return format_text_output(result, language)
+    else:
+        return format_text_output(result, language)
+
+
+def analyze_command(args):
+    """Handle the 'analyze' subcommand."""
+    # Read log content
+    if args.stdin:
+        log_content = read_stdin()
+        source = "stdin"
+    else:
+        log_content = read_file(args.log_file)
+        source = args.log_file
+
+    if not log_content.strip():
+        print("❌ Error: Log content is empty", file=sys.stderr)
+        sys.exit(1)
+
+    # Show progress
+    line_count = len(log_content.split('\n'))
+    lang_name = "中文" if args.lang == "zh" else "English"
+    print(f"📄 Reading logs from: {source}", file=sys.stderr)
+    print(f"📊 Log lines: {line_count}", file=sys.stderr)
+    print(f"🌐 Language: {lang_name}", file=sys.stderr)
+    print(f"⏳ Analyzing...", file=sys.stderr)
+
+    # Call API
+    result = call_api(log_content, args.api_url, args.lang)
+
+    # Output result
+    output = format_output(result, args.output, args.lang)
+    print(output)
+
+
+def health_command(args):
+    """Check if the API is healthy."""
+    health_url = args.api_url.replace("/api/analyze", "/api/health")
+    try:
+        response = requests.get(health_url, timeout=10)
+        if response.status_code == 200:
+            data = response.json()
+            print(f"✅ Service is healthy")
+            print(f"   Status: {data.get('status', 'unknown')}")
+            print(f"   Service: {data.get('service', 'unknown')}")
+        else:
+            print(f"❌ Service returned status {response.status_code}")
+    except Exception as e:
+        print(f"❌ Cannot connect to service: {e}")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Pangu RCA CLI - AI-powered log analysis tool",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  pangu-rca analyze error.log
+  pangu-rca analyze error.log --lang en
+  pangu-rca analyze error.log --output json
+  cat error.log | pangu-rca analyze --stdin
+  pangu-rca health
+
+Visit https://www.pangulab.com for more information.
+        """
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"Pangu RCA CLI v{__version__}"
+    )
+
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+
+    # Analyze command
+    analyze_parser = subparsers.add_parser("analyze", help="Analyze log file")
+    analyze_parser.add_argument(
+        "log_file",
+        nargs="?",
+        help="Path to the log file to analyze"
+    )
+    analyze_parser.add_argument(
+        "--stdin",
+        action="store_true",
+        help="Read log content from stdin (pipe)"
+    )
+    analyze_parser.add_argument(
+        "--api-url",
+        default=DEFAULT_API_URL,
+        help=f"API endpoint URL (default: {DEFAULT_API_URL})"
+    )
+    analyze_parser.add_argument(
+        "--lang",
+        choices=["zh", "en"],
+        default="zh",
+        help="Output language: zh (Chinese) or en (English) (default: zh)"
+    )
+    analyze_parser.add_argument(
+        "--output",
+        choices=["text", "json"],
+        default="text",
+        help="Output format: text or json (default: text)"
+    )
+
+    # Health command
+    health_parser = subparsers.add_parser("health", help="Check API health status")
+    health_parser.add_argument(
+        "--api-url",
+        default=DEFAULT_API_URL,
+        help=f"API endpoint URL (default: {DEFAULT_API_URL})"
+    )
+
+    args = parser.parse_args()
+
+    if args.command == "analyze":
+        if not args.stdin and not args.log_file:
+            print("❌ Error: Please provide a log file or use --stdin", file=sys.stderr)
+            print("   Usage: pangu-rca analyze <log-file>", file=sys.stderr)
+            print("   Or:    cat <log-file> | pangu-rca analyze --stdin", file=sys.stderr)
+            sys.exit(1)
+        if args.stdin and args.log_file:
+            print("❌ Error: Cannot use both --stdin and a log file", file=sys.stderr)
+            sys.exit(1)
+        analyze_command(args)
+    elif args.command == "health":
+        health_command(args)
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

pangu_rca-0.1.0/pangu_rca.egg-info/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: pangu-rca
+Version: 0.1.0
+Summary: Pangu RCA CLI - AI-powered log analysis tool
+Home-page: https://www.pangulab.com
+Author: Pangulab Team
+Author-email: Pangulab Team <r00txxyyzz@gmail.com>
+License: MIT
+Project-URL: Homepage, https://www.pangulab.com
+Project-URL: Source, https://github.com/halokid/TronRabbit
+Keywords: log analysis,AI,root cause analysis,debugging,devtools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: System :: Logging
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# Pangu RCA CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/pangu-rca)](https://pypi.org/project/pangu-rca/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/pangu-rca)](https://pypi.org/project/pangu-rca/)
+[![License](https://img.shields.io/pypi/l/pangu-rca)](https://github.com/halokid/TronRabbit/blob/main/LICENSE)
+
+**AI-powered log analysis tool for developers.** Analyze error logs directly from your terminal.
+
+## Installation
+
+```bash
+pip install pangu-rca
+```
+
+## Quick Start
+
+```bash
+# Analyze a log file
+pangu-rca analyze error.log
+
+# Analyze with English output
+pangu-rca analyze error.log --lang en
+
+# Pipe log content directly
+cat error.log | pangu-rca analyze --stdin
+
+# Get JSON output (for scripting)
+pangu-rca analyze error.log --output json
+
+# Check service health
+pangu-rca health
+```
+
+## Examples
+
+### Analyze a Java error log
+
+```bash
+$ pangu-rca analyze java_error.log
+```
+
+```
+============================================================
+🔍 Pangu RCA Agent - 分析结果
+============================================================
+
+📋 问题类型: 数据库连接超时
+🎯 置信度: 95.0%
+
+📝 详细原因:
+   数据库连接池配置过小，导致在高并发场景下连接被耗尽...
+
+🔑 关键证据:
+   1. java.sql.SQLException: Connection timeout
+   2. Caused by: java.sql.SQLTimeoutException: Timeout waiting for connection
+
+💡 修复建议:
+   增加数据库连接池的最大连接数，建议从 10 调整为 50...
+```
+
+### Pipe from another command
+
+```bash
+# Analyze Docker container logs
+docker logs my-container 2>&1 | pangu-rca analyze --stdin
+
+# Analyze system logs
+journalctl -u my-service --no-pager | pangu-rca analyze --stdin --lang en
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--lang` | Output language: `zh` or `en` | `zh` |
+| `--output` | Output format: `text` or `json` | `text` |
+| `--api-url` | Custom API endpoint | `https://www.pangulab.com/api/analyze` |
+
+## Commands
+
+- `pangu-rca analyze <file>` — Analyze a log file
+- `pangu-rca analyze --stdin` — Read logs from stdin
+- `pangu-rca health` — Check API service status
+- `pangu-rca --version` — Show version
+- `pangu-rca --help` — Show help
+
+## About
+
+Pangu RCA Agent is an AI-powered log analysis tool that helps developers quickly identify root causes of errors from application logs. It supports Java, Python, Go, Rust, JavaScript, and many other programming languages.
+
+**Web version**: https://www.pangulab.com
+
+## License
+
+MIT

pangu_rca-0.1.0/pangu_rca.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+setup.py
+pangu_rca/__init__.py
+pangu_rca/cli.py
+pangu_rca.egg-info/PKG-INFO
+pangu_rca.egg-info/SOURCES.txt
+pangu_rca.egg-info/dependency_links.txt
+pangu_rca.egg-info/entry_points.txt
+pangu_rca.egg-info/requires.txt
+pangu_rca.egg-info/top_level.txt

pangu_rca-0.1.0/pangu_rca.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pangu_rca-0.1.0/pangu_rca.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pangu-rca = pangu_rca.cli:main

pangu_rca-0.1.0/pangu_rca.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

pangu_rca-0.1.0/pangu_rca.egg-info/top_level.txt

@@ -0,0 +1 @@
+pangu_rca

pangu_rca-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pangu-rca"
+version = "0.1.0"
+description = "Pangu RCA CLI - AI-powered log analysis tool"
+readme = "README.md"
+requires-python = ">=3.7"
+license = {text = "MIT"}
+keywords = ["log analysis", "AI", "root cause analysis", "debugging", "devtools"]
+authors = [
+    {name = "Pangulab Team", email = "r00txxyyzz@gmail.com"},
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Debuggers",
+    "Topic :: System :: Logging",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.urls]
+Homepage = "https://www.pangulab.com"
+Source = "https://github.com/halokid/TronRabbit"
+
+[project.scripts]
+pangu-rca = "pangu_rca.cli:main"

pangu_rca-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pangu_rca-0.1.0/setup.py

@@ -0,0 +1,37 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="pangu-rca",
+    version="0.1.0",
+    description="Pangu RCA CLI - AI-powered log analysis tool",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    author="Pangulab Team",
+    author_email="r00txxyyzz@gmail.com",
+    url="https://www.pangulab.com",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.25.0",
+    ],
+    entry_points={
+        "console_scripts": [
+            "pangu-rca=pangu_rca.cli:main",
+        ],
+    },
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "Topic :: Software Development :: Debuggers",
+        "Topic :: System :: Logging",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+    python_requires=">=3.7",
+    keywords="log analysis, AI, root cause analysis, debugging, devtools",
+)