sysvis 1.1.0__tar.gz

sysvis-1.1.0/PKG-INFO

@@ -0,0 +1,241 @@
+Metadata-Version: 2.4
+Name: sysvis
+Version: 1.1.0
+Summary: Arrow-key terminal system monitor with actionable insights
+Home-page: https://github.com/Krishna4311/sysvis
+Author: Krishna4311
+Author-email: Krishna4311 <mtarunp@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Krishna4311/sysvis
+Project-URL: Repository, https://github.com/Krishna4311/sysvis
+Project-URL: Bug Tracker, https://github.com/Krishna4311/sysvis/issues
+Keywords: system,monitor,psutil,terminal,performance,insights
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: rich>=13.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: py-cpuinfo>=9.0.0
+Provides-Extra: gpu
+Requires-Dist: gputil>=1.4.0; extra == "gpu"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# SYSVIS
+
+> Arrow-key interactive terminal system monitor with real-time insights.
+
+```
+  SYSVIS  System Monitor    OS  Windows 11    HOST  Vasu-Krishna    ⏱  00h 48m
+
+   ❯  1. CPU            Cores, frequency, per-core usage, load average
+      2. Memory         RAM & swap usage with pressure insights
+      3. Disk           Partitions, free space, I/O throughput
+      4. Network        Speed, interfaces, IP addresses, WiFi SSID
+      5. Processes      Top CPU & memory consumers
+      6. GPU            Utilisation, VRAM, temperature
+      7. System Info    OS, kernel, uptime, installed applications
+      8. Live Monitor   All key metrics updating in real time
+      9. Health Report  A-F score per category with recommendations
+
+  ↑ ↓ arrow keys to move,  Enter to open,  q to quit
+```
+
+---
+
+## Install
+
+```bash
+pip install sysvis
+
+# Optional: NVIDIA GPU support
+pip install sysvis[gpu]
+```
+
+## Run
+
+```bash
+# Arrow-key menu (default)
+sysvis
+
+# Or as a module
+python -m sysvis
+```
+
+## Navigate
+
+| Key | Action |
+|---|---|
+| `↑` `↓` | Move selection |
+| `Enter` | Open view |
+| `q` / `Esc` | Go back / quit |
+
+---
+
+## Use as a library
+
+```python
+# Launch the interactive menu
+import sysvis
+sysvis.run()
+```
+
+```python
+# Collect data silently in your own script
+from sysvis import SystemCollector
+import time
+
+c = SystemCollector(interval=1.0)
+time.sleep(1.5)  # wait for first sample
+
+data = c.data
+print(f"CPU:  {data['cpu'].percent_total:.1f}%")
+print(f"RAM:  {data['memory'].ram_percent:.1f}%")
+print(f"Host: {data['network'].hostname}")
+
+c.stop()
+```
+
+```python
+# Open a specific view directly
+from sysvis import SystemCollector
+from sysvis.views import cpu, memory, health
+import time
+
+c = SystemCollector()
+time.sleep(1.5)
+
+cpu(c)       # live CPU view — blocks until q
+memory(c)    # live memory view
+health(c)    # health report
+c.stop()
+```
+
+```python
+# Use dataclasses with type hints
+from sysvis import SystemCollector, CPUMetrics, MemoryMetrics
+import time
+
+c = SystemCollector()
+time.sleep(1.5)
+
+cpu: CPUMetrics    = c.data["cpu"]
+mem: MemoryMetrics = c.data["memory"]
+
+print(cpu.cpu_name)
+print(cpu.logical_cores)
+print(mem.ram_total)
+c.stop()
+```
+
+---
+
+## Available views
+
+| Function | Description |
+|---|---|
+| `cpu(collector)` | Live CPU — cores, frequency, per-core bars, sparkline |
+| `memory(collector)` | Live RAM + swap bars and insights |
+| `disk(collector)` | Partition table, I/O speed |
+| `network(collector)` | Speeds, IPs, interfaces, sparklines |
+| `processes(collector)` | Top processes by CPU |
+| `gpu(collector)` | GPU util, VRAM, temperature (requires gputil) |
+| `sysinfo(collector)` | OS info + installed apps list |
+| `live(collector)` | Compact overview of all metrics |
+| `health(collector)` | A–F score per category + recommendations |
+
+---
+
+## Data collected
+
+```python
+data = collector.data
+
+data["cpu"].percent_total       # overall CPU %
+data["cpu"].percent_per_core    # list of per-core %
+data["cpu"].cpu_name            # CPU model name
+data["cpu"].logical_cores       # number of logical cores
+data["cpu"].freq_current        # current frequency MHz
+
+data["memory"].ram_percent      # RAM usage %
+data["memory"].ram_free         # free RAM in bytes
+data["memory"].ram_total        # total RAM in bytes
+data["memory"].swap_percent     # swap usage %
+
+data["disk"].partitions         # list of dicts (mountpoint, used, free, total, percent)
+data["disk"].read_speed         # bytes/sec
+data["disk"].write_speed        # bytes/sec
+
+data["network"].upload_speed    # bytes/sec
+data["network"].download_speed  # bytes/sec
+data["network"].local_ip        # local IP address
+data["network"].hostname        # machine hostname
+data["network"].wifi_ssid       # connected WiFi name
+data["network"].ethernet_ip     # ethernet IP
+data["network"].wifi_ip         # WiFi IP
+data["network"].interfaces      # list of all interfaces
+
+data["gpu"].available           # True if GPU detected
+data["gpu"].gpus                # list of GPU dicts (load, mem, temp)
+
+data["processes"].top_processes # list of top processes by CPU
+data["processes"].total_processes
+data["processes"].running
+data["processes"].sleeping
+
+data["system"].os_name          # e.g. Windows
+data["system"].os_release       # e.g. 11
+data["system"].hostname
+data["system"].uptime_seconds
+data["system"].installed_apps   # list of installed apps
+data["system"].installed_apps_count
+```
+
+---
+
+## Project structure
+
+```
+sysvis_lib/
+├── sysvis/
+│   ├── __init__.py          ← public API: SystemCollector, run()
+│   ├── __main__.py          ← python -m sysvis
+│   ├── collectors/
+│   │   ├── __init__.py
+│   │   └── system.py        ← threaded non-blocking psutil collectors
+│   └── views/
+│       ├── __init__.py      ← exports all 9 view functions
+│       ├── _helpers.py      ← bar, spark, hb, getch, clear …
+│       ├── menu.py          ← arrow-key interactive menu
+│       ├── cpu.py
+│       ├── memory.py
+│       ├── disk.py
+│       ├── network.py
+│       ├── processes.py
+│       ├── gpu.py
+│       ├── sysinfo.py
+│       ├── live.py
+│       └── health.py
+├── pyproject.toml
+├── setup.py
+└── README.md
+```
+
+---
+
+## Requirements
+
+- Python 3.8+
+- `rich >= 13`
+- `psutil >= 5.9`
+- `py-cpuinfo >= 9` — better CPU name detection
+- `gputil` *(optional)* — NVIDIA GPU panel
+
+---
+
+## License
+
+MIT

sysvis-1.1.0/README.md

@@ -0,0 +1,215 @@
+# SYSVIS
+
+> Arrow-key interactive terminal system monitor with real-time insights.
+
+```
+  SYSVIS  System Monitor    OS  Windows 11    HOST  Vasu-Krishna    ⏱  00h 48m
+
+   ❯  1. CPU            Cores, frequency, per-core usage, load average
+      2. Memory         RAM & swap usage with pressure insights
+      3. Disk           Partitions, free space, I/O throughput
+      4. Network        Speed, interfaces, IP addresses, WiFi SSID
+      5. Processes      Top CPU & memory consumers
+      6. GPU            Utilisation, VRAM, temperature
+      7. System Info    OS, kernel, uptime, installed applications
+      8. Live Monitor   All key metrics updating in real time
+      9. Health Report  A-F score per category with recommendations
+
+  ↑ ↓ arrow keys to move,  Enter to open,  q to quit
+```
+
+---
+
+## Install
+
+```bash
+pip install sysvis
+
+# Optional: NVIDIA GPU support
+pip install sysvis[gpu]
+```
+
+## Run
+
+```bash
+# Arrow-key menu (default)
+sysvis
+
+# Or as a module
+python -m sysvis
+```
+
+## Navigate
+
+| Key | Action |
+|---|---|
+| `↑` `↓` | Move selection |
+| `Enter` | Open view |
+| `q` / `Esc` | Go back / quit |
+
+---
+
+## Use as a library
+
+```python
+# Launch the interactive menu
+import sysvis
+sysvis.run()
+```
+
+```python
+# Collect data silently in your own script
+from sysvis import SystemCollector
+import time
+
+c = SystemCollector(interval=1.0)
+time.sleep(1.5)  # wait for first sample
+
+data = c.data
+print(f"CPU:  {data['cpu'].percent_total:.1f}%")
+print(f"RAM:  {data['memory'].ram_percent:.1f}%")
+print(f"Host: {data['network'].hostname}")
+
+c.stop()
+```
+
+```python
+# Open a specific view directly
+from sysvis import SystemCollector
+from sysvis.views import cpu, memory, health
+import time
+
+c = SystemCollector()
+time.sleep(1.5)
+
+cpu(c)       # live CPU view — blocks until q
+memory(c)    # live memory view
+health(c)    # health report
+c.stop()
+```
+
+```python
+# Use dataclasses with type hints
+from sysvis import SystemCollector, CPUMetrics, MemoryMetrics
+import time
+
+c = SystemCollector()
+time.sleep(1.5)
+
+cpu: CPUMetrics    = c.data["cpu"]
+mem: MemoryMetrics = c.data["memory"]
+
+print(cpu.cpu_name)
+print(cpu.logical_cores)
+print(mem.ram_total)
+c.stop()
+```
+
+---
+
+## Available views
+
+| Function | Description |
+|---|---|
+| `cpu(collector)` | Live CPU — cores, frequency, per-core bars, sparkline |
+| `memory(collector)` | Live RAM + swap bars and insights |
+| `disk(collector)` | Partition table, I/O speed |
+| `network(collector)` | Speeds, IPs, interfaces, sparklines |
+| `processes(collector)` | Top processes by CPU |
+| `gpu(collector)` | GPU util, VRAM, temperature (requires gputil) |
+| `sysinfo(collector)` | OS info + installed apps list |
+| `live(collector)` | Compact overview of all metrics |
+| `health(collector)` | A–F score per category + recommendations |
+
+---
+
+## Data collected
+
+```python
+data = collector.data
+
+data["cpu"].percent_total       # overall CPU %
+data["cpu"].percent_per_core    # list of per-core %
+data["cpu"].cpu_name            # CPU model name
+data["cpu"].logical_cores       # number of logical cores
+data["cpu"].freq_current        # current frequency MHz
+
+data["memory"].ram_percent      # RAM usage %
+data["memory"].ram_free         # free RAM in bytes
+data["memory"].ram_total        # total RAM in bytes
+data["memory"].swap_percent     # swap usage %
+
+data["disk"].partitions         # list of dicts (mountpoint, used, free, total, percent)
+data["disk"].read_speed         # bytes/sec
+data["disk"].write_speed        # bytes/sec
+
+data["network"].upload_speed    # bytes/sec
+data["network"].download_speed  # bytes/sec
+data["network"].local_ip        # local IP address
+data["network"].hostname        # machine hostname
+data["network"].wifi_ssid       # connected WiFi name
+data["network"].ethernet_ip     # ethernet IP
+data["network"].wifi_ip         # WiFi IP
+data["network"].interfaces      # list of all interfaces
+
+data["gpu"].available           # True if GPU detected
+data["gpu"].gpus                # list of GPU dicts (load, mem, temp)
+
+data["processes"].top_processes # list of top processes by CPU
+data["processes"].total_processes
+data["processes"].running
+data["processes"].sleeping
+
+data["system"].os_name          # e.g. Windows
+data["system"].os_release       # e.g. 11
+data["system"].hostname
+data["system"].uptime_seconds
+data["system"].installed_apps   # list of installed apps
+data["system"].installed_apps_count
+```
+
+---
+
+## Project structure
+
+```
+sysvis_lib/
+├── sysvis/
+│   ├── __init__.py          ← public API: SystemCollector, run()
+│   ├── __main__.py          ← python -m sysvis
+│   ├── collectors/
+│   │   ├── __init__.py
+│   │   └── system.py        ← threaded non-blocking psutil collectors
+│   └── views/
+│       ├── __init__.py      ← exports all 9 view functions
+│       ├── _helpers.py      ← bar, spark, hb, getch, clear …
+│       ├── menu.py          ← arrow-key interactive menu
+│       ├── cpu.py
+│       ├── memory.py
+│       ├── disk.py
+│       ├── network.py
+│       ├── processes.py
+│       ├── gpu.py
+│       ├── sysinfo.py
+│       ├── live.py
+│       └── health.py
+├── pyproject.toml
+├── setup.py
+└── README.md
+```
+
+---
+
+## Requirements
+
+- Python 3.8+
+- `rich >= 13`
+- `psutil >= 5.9`
+- `py-cpuinfo >= 9` — better CPU name detection
+- `gputil` *(optional)* — NVIDIA GPU panel
+
+---
+
+## License
+
+MIT

sysvis-1.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires      = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name            = "sysvis"
+version         = "1.1.0"
+description     = "Arrow-key terminal system monitor with actionable insights"
+readme          = "README.md"
+license         = { text = "MIT" }
+requires-python = ">=3.8"
+keywords        = ["system", "monitor", "psutil", "terminal", "performance", "insights"]
+authors         = [
+    { name = "Krishna4311", email = "mtarunp@gmail.com" }
+]
+
+dependencies = [
+    "rich>=13.0.0",
+    "psutil>=5.9.0",
+    "py-cpuinfo>=9.0.0",
+]
+
+[project.optional-dependencies]
+gpu = ["gputil>=1.4.0"]
+dev = ["pytest>=7.0", "pytest-cov"]
+
+[project.urls]
+Homepage      = "https://github.com/Krishna4311/sysvis"
+Repository    = "https://github.com/Krishna4311/sysvis"
+"Bug Tracker" = "https://github.com/Krishna4311/sysvis/issues"
+
+[project.scripts]
+sysvis = "sysvis.__main__:main"
+
+[tool.setuptools.packages.find]
+where   = ["."]
+include = ["sysvis*"]

sysvis-1.1.0/setup.cfg

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

sysvis-1.1.0/setup.py

@@ -0,0 +1,29 @@
+"""setup.py — compatibility shim for older pip / conda editable installs."""
+from setuptools import setup, find_packages
+
+setup(
+    name="sysvis",
+    version="1.1.0",
+    description="Arrow-key terminal system monitor with actionable insights",
+    author="Krishna4311",
+    author_email="mtarunp@gmail.com",
+    url="https://github.com/Krishna4311/sysvis",
+    license="MIT",
+    packages=find_packages(),
+    install_requires=[
+        "rich>=13.0.0",
+        "psutil>=5.9.0",
+        "py-cpuinfo>=9.0.0",
+    ],
+    extras_require={"gpu": ["gputil>=1.4.0"]},
+    entry_points={"console_scripts": ["sysvis=sysvis.__main__:main"]},
+    python_requires=">=3.8",
+    keywords=["system", "monitor", "psutil", "terminal", "performance", "insights"],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Environment :: Console",
+        "Topic :: System :: Monitoring",
+    ],
+)

sysvis-1.1.0/sysvis/__init__.py

@@ -0,0 +1,48 @@
+"""
+sysvis — Arrow-key terminal system monitor with actionable insights.
+
+Quick start
+-----------
+    import sysvis
+    sysvis.run()                    # launches arrow-key menu
+
+    # Use the collector directly:
+    from sysvis import SystemCollector
+    import time
+    c = SystemCollector()
+    time.sleep(1.5)
+    print(c.data["cpu"].percent_total)
+    c.stop()
+"""
+
+from .collectors.system import (
+    SystemCollector,
+    CPUMetrics,
+    MemoryMetrics,
+    DiskMetrics,
+    NetworkMetrics,
+    GPUMetrics,
+    ProcessMetrics,
+    SystemInfo,
+)
+
+__version__ = "1.1.0"
+__author__  = "sysvis contributors"
+
+__all__ = [
+    "SystemCollector",
+    "CPUMetrics",
+    "MemoryMetrics",
+    "DiskMetrics",
+    "NetworkMetrics",
+    "GPUMetrics",
+    "ProcessMetrics",
+    "SystemInfo",
+    "run",
+]
+
+
+def run():
+    """Launch the arrow-key interactive menu."""
+    from .views.menu import run as _run
+    _run()

sysvis-1.1.0/sysvis/__main__.py

@@ -0,0 +1,12 @@
+"""
+sysvis/__main__.py
+Allows:  python -m sysvis
+"""
+
+def main():
+    import sysvis
+    sysvis.run()
+
+
+if __name__ == "__main__":
+    main()

sysvis-1.1.0/sysvis/collectors/__init__.py

@@ -0,0 +1,3 @@
+"""sysvis.collectors — background metric collection."""
+from .system import SystemCollector
+__all__ = ["SystemCollector"]