feat: add sensors collector

Author: nordicnode

CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- **Sensors collector** — added a new built-in `sensors` category for temperature and hardware sensor monitoring
+  - Collects temperatures directly from `/sys/class/hwmon/hwmon*/temp*_input` with optional `*_label`, `*_max`, and `*_crit` metadata
+  - Collects ACPI and platform thermal zone temperatures from `/sys/class/thermal/thermal_zone*/temp`
+  - Collects NVMe and storage device temperatures from `/sys/class/block/*/device/hwmon/*/temp*_input`
+  - Falls back to `sensors -j` when direct sysfs reads are unavailable or insufficient
+  - Collects GPU temperature and fan data from `nvidia-smi` when available
+  - Summarizes key thermal data as `CPU`, `GPU`, `NVMe`, and fan RPM values in scan output
+- **Expanded collector test coverage** — added dedicated tests for the new sensors collector
+  - Covers direct sysfs hwmon, thermal zone, and block-device sensor collection
+  - Covers `lm-sensors` JSON fallback behavior when sysfs data is unavailable
+
 ---
 
 ## [0.2.5] - 2026-03-10
@@ -233,7 +246,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 | Version | Date | Highlights |
 |---------|------|------------|
-| Unreleased | — | — |
+| Unreleased | — | Sensors collector and expanded collector tests |
 | 0.2.5 | 2026-03-10 | Security collector and documentation updates |
 | 0.2.4 | 2026-03-10 | Test suite expansion |
 | 0.2.3 | 2026-03-10 | Test suite bug fixes |

README.md

@@ -1,6 +1,6 @@
 # OptiSys
 
-**OptiSys** is a system profiler and diagnostics tool for Linux. It collects detailed information about hardware, kernel, drivers, services, packages, logs, and security posture, and presents it in a structured terminal output. Results can be exported to JSON or YAML for use with external tools or AI-assisted analysis.
+**OptiSys** is a system profiler and diagnostics tool for Linux. It collects detailed information about hardware, kernel, drivers, services, packages, logs, security posture, and thermal sensor data, and presents it in a structured terminal output. Results can be exported to JSON or YAML for use with external tools or AI-assisted analysis.
 
 ![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)
 ![License](https://img.shields.io/badge/License-MIT-green.svg)
@@ -11,6 +11,7 @@
 ## Features
 
 - **Hardware profiling** — CPU, GPU, memory, disks, and network interfaces
+- **Temperature and sensor monitoring** — CPU, GPU, NVMe, thermal zones, fans, and voltage readings with sysfs-first collection
 - **Kernel information** — OS release, kernel version, and system parameters
 - **Driver analysis** — loaded kernel modules and driver status
 - **Service monitoring** — systemd unit health and status
@@ -64,7 +65,7 @@ optisys scan
 ### Scan specific categories
 
 ```bash
-optisys scan -c hardware -c kernel
+optisys scan -c hardware -c sensors -c kernel
 ```
 
 ### Export results
@@ -142,6 +143,7 @@ This prints recent scan IDs, timestamps, hostnames, tool versions, durations, an
 | Category | Description |
 |----------|-------------|
 | `hardware` | CPU, GPU, memory, disks, and network interfaces |
+| `sensors` | CPU, GPU, NVMe, thermal zone, fan, and voltage sensor telemetry |
 | `kernel` | OS release, kernel version, and system parameters |
 | `drivers` | Loaded kernel modules and driver status |
 | `services` | Systemd unit health and status |
@@ -245,6 +247,7 @@ See [PLUGINS.md](optisys/PLUGINS.md) for the full developer guide, `BaseCollecto
 │ Status │ Category     │   Duration │ Key Info                                     │
 ├────────┼──────────────┼────────────┼──────────────────────────────────────────────┤
 │   ✓    │ hardware     │       49ms │ Intel Core i5-9400 · 15.5GB RAM · 1 GPU      │
+│   ✓    │ sensors      │       12ms │ CPU: 52°C · GPU: 61°C · NVMe: 38°C · fans: 1200rpm │
 │   ✓    │ kernel       │        4ms │ Pop!_OS 24.04 LTS · kernel 6.18.7 · up 2.4h  │
 │   ✓    │ drivers      │     5662ms │ 171 modules · GPU: nvidia · DKMS: 8          │
 │   ✓    │ services     │      564ms │ 163 units · active: 68 · failed: 1           │
@@ -270,6 +273,7 @@ Scan completed in 6595ms  Cached to /home/user/.cache/optisys/latest.json  Recor
 | Category | Commands |
 |----------|----------|
 | Hardware | `lscpu`, `lsblk`, `ip`, `nvidia-smi` |
+| Sensors | `sensors`, `nvidia-smi` *(direct sysfs reads are preferred and work without `lm-sensors`)* |
 | Kernel | `uname`, `sysctl` |
 | Drivers | `lspci`, `lsmod` |
 | Services | `systemctl` |

optisys/__init__.py

@@ -1,3 +1,3 @@
 """OptiSys — System profiler and diagnostics tool."""
 
-__version__ = "0.2.5"
+__version__ = "0.2.6"

optisys/collectors/__init__.py

@@ -12,6 +12,7 @@
 from optisys.collectors.logs import LogsCollector
 from optisys.collectors.packages import PackagesCollector
 from optisys.collectors.security import SecurityCollector
+from optisys.collectors.sensors import SensorsCollector
 from optisys.collectors.services import ServicesCollector
 
 # ---------------------------------------------------------------------------
@@ -26,6 +27,7 @@
     PackagesCollector(),
     LogsCollector(),
     SecurityCollector(),
+    SensorsCollector(),
 ]
 
 _BUILTIN_KEYS: frozenset[str] = frozenset(c.key for c in _BUILTIN_COLLECTORS)
@@ -83,6 +85,7 @@
     "PackagesCollector",
     "LogsCollector",
     "SecurityCollector",
+    "SensorsCollector",
     # Plugin system helpers
     "get_registry",
 ]