guro 0.1.0__tar.gz

guro-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 DHANUSH KANDHAN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

guro-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include guro *

guro-0.1.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.2
+Name: guro
+Version: 0.1.0
+Summary: A Simple System Monitoring & Benchmarking Toolkit
+Home-page: https://github.com/dhanushk-offl/guro
+Author: Dhanush Kandhan
+Author-email: dhanushkandhan75@gmail.com
+Project-URL: Bug Reports, https://github.com/dhanushk-offl/guro/issues
+Project-URL: Source, https://github.com/dhanushk-offl/guro
+Project-URL: Documentation, https://github.com/dhanushk-offl/guro/wiki
+Keywords: system-monitoring,gpu-optimization,performance-tuning,hardware-monitoring,system-administration,nvidia-gpu,amd-gpu,intel-gpu,resource-monitoring,system-optimization
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: System :: Operating System
+Classifier: Topic :: System :: Hardware :: Hardware Drivers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Developers
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Natural Language :: English
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: rich>=10.0.0
+Requires-Dist: psutil>=5.8.0
+Requires-Dist: gputil>=1.4.0
+Requires-Dist: matplotlib>=3.5.0
+Requires-Dist: nvidia-ml-py>=11.515.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: plotly>=5.5.0
+Requires-Dist: termcolor>=2.0.0
+Requires-Dist: tabulate>=0.8.9
+Requires-Dist: py-cpuinfo>=8.0.0
+Requires-Dist: setproctitle>=1.2.2
+Requires-Dist: keyboard>=0.13.5
+Requires-Dist: pytest>=7.0.0
+Requires-Dist: pytest-mock>=3.10.0
+Requires-Dist: pytest-cov>=4.0.0
+Requires-Dist: pytest-timeout>=2.1.0
+Provides-Extra: nvidia
+Requires-Dist: py3nvml>=0.2.7; extra == "nvidia"
+Requires-Dist: nvidia-ml-py>=11.515.0; extra == "nvidia"
+Provides-Extra: amd
+Requires-Dist: pyamdgpuinfo>=2.1.0; extra == "amd"
+Provides-Extra: all
+Requires-Dist: py3nvml>=0.2.7; extra == "all"
+Requires-Dist: nvidia-ml-py>=11.515.0; extra == "all"
+Requires-Dist: pyamdgpuinfo>=2.1.0; extra == "all"
+Requires-Dist: matplotlib>=3.5.0; extra == "all"
+Requires-Dist: plotly>=5.5.0; extra == "all"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Requires-Dist: pytest-timeout>=2.1.0; extra == "test"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Guro - A Simple System Monitoring & Benchmarking Toolkit 🚀
+
+
+Welcome to **Guro**, the ultimate toolkit for **system monitoring** and **benchmarking**. It’s simple, fast, and designed for developers and enthusiasts who want to monitor system performance, run benchmarks, and visualize system heatmaps in an intuitive way.
+
+### Features:
+- 📊 **Real-time system monitoring** – Monitor CPU, memory, and disk usage in real-time.
+- 🔥 **Performance benchmarking** – Run benchmarks with mini and full-scale tests for your CPU and GPU.
+- 🌡️ **Hardware heatmap** – Visualize your system's temperature with a heatmap in real-time.
+- 💾 **Export data** – Export monitoring data to CSV for analysis.
+  
+### Installation
+
+```bash
+pip install guro
+```
+
+### Usage
+
+Run the following commands for monitoring, benchmarking, or heatmap analysis:
+
+#### 1. **Monitor System Resources**
+```bash
+guro monitor --interval 1.0 --duration 60
+```
+
+#### 2. **Run Benchmark Tests**
+```bash
+guro benchmark --type mini --cpu-only
+```
+
+#### 3. **Visualize System Heatmap**
+```bash
+guro heatmap --interval 1.0 --duration 30
+```
+
+#### 4. **List All Commands**
+```bash
+guro list
+```
+
+For more details, check out our [documentation](https://github.com/dhanushk-offl/guro/wiki).
+
+### Demo
+
+[Watch the demo video here](https://www.youtube.com/watch?v=xyz123)
+
+### License
+
+MIT License. See LICENSE for more details.

guro-0.1.0/README.md

@@ -0,0 +1,50 @@
+# Guro - A Simple System Monitoring & Benchmarking Toolkit 🚀
+
+
+Welcome to **Guro**, the ultimate toolkit for **system monitoring** and **benchmarking**. It’s simple, fast, and designed for developers and enthusiasts who want to monitor system performance, run benchmarks, and visualize system heatmaps in an intuitive way.
+
+### Features:
+- 📊 **Real-time system monitoring** – Monitor CPU, memory, and disk usage in real-time.
+- 🔥 **Performance benchmarking** – Run benchmarks with mini and full-scale tests for your CPU and GPU.
+- 🌡️ **Hardware heatmap** – Visualize your system's temperature with a heatmap in real-time.
+- 💾 **Export data** – Export monitoring data to CSV for analysis.
+  
+### Installation
+
+```bash
+pip install guro
+```
+
+### Usage
+
+Run the following commands for monitoring, benchmarking, or heatmap analysis:
+
+#### 1. **Monitor System Resources**
+```bash
+guro monitor --interval 1.0 --duration 60
+```
+
+#### 2. **Run Benchmark Tests**
+```bash
+guro benchmark --type mini --cpu-only
+```
+
+#### 3. **Visualize System Heatmap**
+```bash
+guro heatmap --interval 1.0 --duration 30
+```
+
+#### 4. **List All Commands**
+```bash
+guro list
+```
+
+For more details, check out our [documentation](https://github.com/dhanushk-offl/guro/wiki).
+
+### Demo
+
+[Watch the demo video here](https://www.youtube.com/watch?v=xyz123)
+
+### License
+
+MIT License. See LICENSE for more details.

guro-0.1.0/setup.cfg

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

guro-0.1.0/setup.py

@@ -0,0 +1,101 @@
+from setuptools import setup, find_packages
+import sys
+
+common_packages = [
+    'click>=8.0.0',
+    'rich>=10.0.0',
+    'psutil>=5.8.0',
+    'gputil>=1.4.0',
+    'matplotlib>=3.5.0',
+    'nvidia-ml-py>=11.515.0',
+    'pandas>=1.3.0',
+    'plotly>=5.5.0',
+    'termcolor>=2.0.0',
+    'tabulate>=0.8.9',
+    'py-cpuinfo>=8.0.0',
+    'setproctitle>=1.2.2',
+    'keyboard>=0.13.5',
+    'pytest>=7.0.0',
+    'pytest-mock>=3.10.0',
+    'pytest-cov>=4.0.0',
+    'pytest-timeout>=2.1.0',
+]
+
+if sys.platform.startswith('linux'):
+    common_packages.append('pyamdgpuinfo>=2.1.6')
+    common_packages.append('distro>=1.7.0')
+
+# Test requirements
+test_requires = [
+    'pytest>=7.0.0',
+    'pytest-mock>=3.10.0',
+    'pytest-cov>=4.0.0',
+    'pytest-timeout>=2.1.0',
+]
+
+setup(
+    name="guro",
+    version="0.1.0",
+    packages=find_packages(where="src"),
+    package_dir={"": "src"},
+    install_requires=common_packages,
+    entry_points={
+        'console_scripts': [
+            'guro=guro.cli.main:cli',
+        ],
+    },
+    author="Dhanush Kandhan",
+    author_email="dhanushkandhan75@gmail.com",
+    description="A Simple System Monitoring & Benchmarking Toolkit",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/dhanushk-offl/guro",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: POSIX :: Linux",
+        "Operating System :: Microsoft :: Windows",
+        "Operating System :: MacOS :: MacOS X",
+        "Topic :: System :: Hardware",
+        "Topic :: System :: Monitoring",
+        "Topic :: System :: Systems Administration",
+        "Topic :: System :: Operating System",
+        "Topic :: System :: Hardware :: Hardware Drivers",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "Intended Audience :: System Administrators",
+        "Intended Audience :: Developers",
+        "Development Status :: 4 - Beta",
+        "Environment :: Console",
+        "Natural Language :: English"
+    ],
+    python_requires=">=3.7",
+    keywords=[
+        "system-monitoring",
+        "gpu-optimization",
+        "performance-tuning",
+        "hardware-monitoring",
+        "system-administration",
+        "nvidia-gpu",
+        "amd-gpu",
+        "intel-gpu",
+        "resource-monitoring",
+        "system-optimization"
+    ],
+    project_urls={
+        "Bug Reports": "https://github.com/dhanushk-offl/guro/issues",
+        "Source": "https://github.com/dhanushk-offl/guro",
+        "Documentation": "https://github.com/dhanushk-offl/guro/wiki"
+    },
+    extras_require={
+        'nvidia': ['py3nvml>=0.2.7', 'nvidia-ml-py>=11.515.0'],
+        'amd': ['pyamdgpuinfo>=2.1.0'],
+        'all': [
+            'py3nvml>=0.2.7',
+            'nvidia-ml-py>=11.515.0',
+            'pyamdgpuinfo>=2.1.0',
+            'matplotlib>=3.5.0',
+            'plotly>=5.5.0'
+        ],
+        'test': test_requires
+    }
+)

guro-0.1.0/src/guro/__init__.py

@@ -0,0 +1,2 @@
+# guro/__init__.py
+__version__ = "1.0.0"

guro-0.1.0/src/guro/cli/__init__.py

@@ -0,0 +1,4 @@
+# guro/cli/__init__.py
+from .main import cli
+
+__all__ = ['cli']

guro-0.1.0/src/guro/cli/main.py

@@ -0,0 +1,161 @@
+import click
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.prompt import Prompt, Confirm
+from rich import print as rprint
+from typing import Optional
+from ..core.monitor import SystemMonitor
+from ..core.benchmark import SafeSystemBenchmark
+from ..core.heatmap import SystemHeatmap
+
+console = Console()
+
+def print_banner():
+    """Display the Guro banner"""
+    banner = """
+[bold cyan]
+   ██████╗ ██╗   ██╗██████╗  ██████╗ 
+  ██╔════╝ ██║   ██║██╔══██╗██╔═══██╗
+  ██║  ███╗██║   ██║██████╔╝██║   ██║
+  ██║   ██║██║   ██║██╔══██╗██║   ██║
+  ╚██████╔╝╚██████╔╝██║  ██║╚██████╔╝
+   ╚═════╝  ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ 
+[/bold cyan]
+[yellow]A Simple System Monitoring & Benchmarking Toolkit[/yellow]
+    """
+    console.print(banner)
+
+@click.group()
+@click.version_option(version='1.0.0')
+def cli():
+    """🚀 Guro - A Simple System Monitoring & Benchmarking Toolkit"""
+    print_banner()
+
+@cli.command()
+@click.option('--interval', '-i', default=1.0, help='Monitoring interval in seconds')
+@click.option('--duration', '-d', default=None, type=int, help='Monitoring duration in seconds')
+@click.option('--export', '-e', is_flag=True, help='Export monitoring data to CSV')
+def monitor(interval: float, duration: Optional[int], export: bool):
+    """📊 Monitor system resources and performance in real-time"""
+    try:
+        monitor = SystemMonitor()
+        if export:
+            click.echo("📝 Monitoring data will be exported to 'monitoring_data.csv'")
+        
+        with console.status("[bold green]Initializing system monitor..."):
+            monitor.run_performance_test(
+                interval=interval,
+                duration=duration,
+                export_data=export
+            )
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Monitoring stopped by user[/yellow]")
+    except Exception as e:
+        console.print(f"\n[red]Error during monitoring: {str(e)}[/red]")
+
+@cli.command()
+@click.option('--type', '-t', 'test_type',
+              type=click.Choice(['mini', 'god'], case_sensitive=False),
+              help='Type of benchmark test to run')
+@click.option('--gpu-only', is_flag=True, help='Run only GPU benchmark')
+@click.option('--cpu-only', is_flag=True, help='Run only CPU benchmark')
+def benchmark(test_type: str, gpu_only: bool, cpu_only: bool):
+    """🔥 Run system benchmarks"""
+    try:
+        benchmark = SafeSystemBenchmark()
+        
+        if not test_type:
+            test_type = Prompt.ask(
+                "Select benchmark type",
+                choices=["mini", "god"],
+                default="mini"
+            )
+
+        with console.status("[bold green]Preparing benchmark..."):
+            if test_type == "mini":
+                benchmark.mini_test(gpu_only=gpu_only, cpu_only=cpu_only)
+            else:
+                benchmark.god_test(gpu_only=gpu_only, cpu_only=cpu_only)
+
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Benchmark stopped by user[/yellow]")
+    except Exception as e:
+        console.print(Panel(
+            f"[red]Error during benchmark: {str(e)}[/red]",
+            title="⚠️ Benchmark Error",
+            border_style="red"
+        ))
+
+@cli.command()  # Added the cli decorator here
+@click.option('--interval', '-i', 
+              type=click.FloatRange(min=0.1, min_open=False),
+              default=1.0, 
+              help='Update interval in seconds (must be greater than 0.1)')
+@click.option('--duration', '-d', 
+              type=click.IntRange(min=1, min_open=False),
+              default=10, 
+              help='Duration to run in seconds (default: 10)')
+def heatmap(interval: float, duration: int):
+    """🌡️ Display unified system temperature heatmap"""
+    try:
+        heatmap = SystemHeatmap()
+        
+        with console.status("[bold green]Initializing system heatmap..."):
+            updates = heatmap.run(
+                interval=interval,
+                duration=duration
+            )
+            
+        console.print(f"\n[green]Heatmap completed after {updates} updates[/green]")
+            
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Heatmap visualization stopped by user[/yellow]")
+    except Exception as e:
+        console.print(f"[red]Error during heatmap visualization: {str(e)}[/red]")
+
+@cli.command(name='list')
+def list_features():
+    """📋 List all available features and commands"""
+    table = Table(title="Guro Commands and Features")
+    table.add_column("Command", style="cyan")
+    table.add_column("Description", style="green")
+    table.add_column("Options", style="yellow")
+
+    commands = {
+        "monitor": ("📊 Real-time system monitoring", "-i/--interval, -d/--duration, -e/--export"),
+        "benchmark": ("🔥 System benchmarking", "-t/--type [mini/god], --gpu-only, --cpu-only"),
+        "heatmap": ("🌡️ Hardware Heatmap Analysis", "-i/--interval, -d/--duration"),
+        "about": ("ℹ️  About Guro", "None"),
+        "list": ("📋 List all commands", "None")
+    }
+
+    for cmd, (desc, opts) in commands.items():
+        table.add_row(cmd, desc, opts)
+
+    console.print(table)
+
+@cli.command(name='about')
+def about():
+    """ℹ️  Display information about Guro"""
+    about_text = """[bold cyan]Guro - A Simple System Monitoring & Benchmarking Toolkit[/bold cyan]
+        
+[green]Version:[/green] 1.0.0
+[green]Author:[/green] Dhanush Kandhan
+[green]License:[/green] MIT
+        
+🛠️  A Simple powerful toolkit for system monitoring and benchmarking.
+
+[yellow]Key Features:[/yellow]
+• 📊 Real-time system monitoring
+• 💾 Memory management
+• 🔥 Performance benchmarking
+• 🌡️ Hardware Heatmap Analysis
+
+[blue]GitHub:[/blue] https://github.com/dhanushk-offl/guro
+[blue]Documentation:[/blue] https://github.com/dhanushk-offl/guro/wiki"""
+
+    console.print(Panel(about_text, title="About Guro", border_style="blue"))
+
+if __name__ == '__main__':
+    cli()

guro-0.1.0/src/guro/core/__init__.py

@@ -0,0 +1,3 @@
+# guro/core/__init__.py
+from .monitor import SystemMonitor
+__all__ = ['SystemMonitor']