Metadata-Version: 2.4
Name: oractl
Version: 0.0.1
Summary: The ultimate zero-dependency system monitoring library for every platform
Author-email: jdn404 <jdn404@oracron.dev>
License: MIT
Project-URL: Homepage, https://github.com/jdn404/oractl
Project-URL: Repository, https://github.com/jdn404/oractl
Project-URL: Issues, https://github.com/jdn404/oractl
Keywords: system,monitoring,cpu,memory,disk,network,android,termux,psutil
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# oractl

**The zero-dependency system monitoring library that works everywhere.**

Built by [Oracron](https://github.com/jdn404) — designed to bury psutil.

---

## Install

```bash
pip install oractl
```

Zero dependencies. Pure Python. Works on Android, Termux, Windows, Linux, macOS, FreeBSD — everything.

---

## Why oractl over psutil?

| Feature | oractl | psutil |
|---|---|---|
| Zero dependencies | ✅ | ❌ |
| Android / Termux | ✅ | ❌ |
| Battery info | ✅ | ✅ |
| GPU info | ✅ | ❌ |
| Network speed live | ✅ | ❌ |
| Ping / latency | ✅ | ❌ |
| Public IP | ✅ | ❌ |
| ARP table | ✅ | ❌ |
| Routing table | ✅ | ❌ |
| DNS servers | ✅ | ❌ |
| CPU vulnerabilities | ✅ | ❌ |
| CPU governor | ✅ | ❌ |
| CPU flags | ✅ | ❌ |
| System fingerprint | ✅ | ❌ |
| Hardware ID | ✅ | ❌ |
| Container detection | ✅ | ❌ |
| Process tree | ✅ | ❌ |
| Top CPU/mem procs | ✅ | ❌ |
| Zombie processes | ✅ | ❌ |
| Inode usage | ✅ | ❌ |
| Entropy pool | ✅ | ❌ |
| Thermal zones | ✅ | partial |
| NUMA info | ✅ | ❌ |
| HugePages info | ✅ | ❌ |
| Uptime string | ✅ | ❌ |
| Timezone info | ✅ | ❌ |
| Last logins | ✅ | ❌ |
| Running services | ✅ | ❌ |
| Disk health/SMART | ✅ | ❌ |
| IO wait / steal / guest | ✅ | partial |
| CPU scaling | ✅ | ❌ |
| Memory maps | ✅ | partial |

---

## Usage

```python
import oractl

# CPU
print(oractl.cpu_percent())
print(oractl.cpu_count())
print(oractl.cpu_model())
print(oractl.cpu_freq())
print(oractl.cpu_temp())
print(oractl.cpu_flags())
print(oractl.cpu_governor())
print(oractl.cpu_vulnerability_info())
print(oractl.cpu_load_avg())

# Memory
mem = oractl.virtual_memory()
print(mem.total, mem.used, mem.percent)
print(oractl.memory_available())
print(oractl.cache_memory())
print(oractl.swap_memory())
print(oractl.hugepages_info())

# Disk
print(oractl.disk_usage("/"))
print(oractl.disk_partitions())
print(oractl.disk_io_counters())
print(oractl.inode_usage())
print(oractl.disk_health())

# Network
print(oractl.net_io_counters())
print(oractl.net_local_ip())
print(oractl.net_public_ip())
print(oractl.net_ping("8.8.8.8"))
print(oractl.net_dns_servers())
print(oractl.net_arp_table())
print(oractl.net_routing_table())
print(oractl.net_open_ports())
print(oractl.network_speed())

# Processes
print(oractl.pids())
print(oractl.process_count())
print(oractl.top_cpu_processes(5))
print(oractl.top_memory_processes(5))
print(oractl.zombie_processes())
print(oractl.process_tree())

p = oractl.Process(1)
print(p.name())
print(p.status())
print(p.memory())
print(p.cpu())
print(p.children())

# Battery (Android + Windows + macOS)
bat = oractl.battery()
print(bat.percent, bat.plugged, bat.time_left)

# GPU
gpus = oractl.gpu_info()
for gpu in gpus:
    print(gpu.name, gpu.usage, gpu.temperature)

# System / OS
print(oractl.platform_info())
print(oractl.os_name())
print(oractl.kernel_version())
print(oractl.uptime_str())
print(oractl.system_fingerprint())
print(oractl.machine_id())
print(oractl.is_android())
print(oractl.is_termux())
print(oractl.is_docker())
print(oractl.container_info())

# Users
print(oractl.current_user())
print(oractl.logged_in_users())
print(oractl.last_logins())

# Environment
print(oractl.env_vars())
print(oractl.path_list())
print(oractl.terminal_size())

# Misc
print(oractl.sys_entropy())
print(oractl.timezone_info())
print(oractl.system_time())
print(oractl.running_services())
```

---

## Platform Support

| Platform | Status |
|---|---|
| Linux | ✅ Full |
| Android / Termux | ✅ Full |
| Windows | ✅ Full |
| macOS | ✅ Full |
| FreeBSD | ✅ Full |
| OpenBSD | ✅ Full |
| Raspberry Pi | ✅ Full |
| ChromeOS (Linux) | ✅ Full |

---

## License

MIT — by [Oracron / jdn404](https://github.com/jdn404)
