Metadata-Version: 2.4
Name: dargslan-bandwidth-monitor
Version: 1.0.0
Summary: Network bandwidth monitor — track interface statistics, throughput, and traffic in real-time from /proc/net/dev
Author-email: Dargslan <info@dargslan.com>
License: MIT
Project-URL: Homepage, https://dargslan.com
Project-URL: Documentation, https://dargslan.com/blog
Project-URL: Repository, https://github.com/Dargslan
Project-URL: Free Cheat Sheets, https://dargslan.com/cheat-sheets
Project-URL: Linux & DevOps Books, https://dargslan.com/books
Keywords: bandwidth,network,monitor,traffic,throughput,linux,sysadmin,devops
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Networking :: Monitoring
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# dargslan-bandwidth-monitor

**Network Bandwidth Monitor** — Track interface statistics, throughput, and traffic from /proc/net/dev. Real-time speed tests. Zero external dependencies.

[![PyPI version](https://img.shields.io/pypi/v/dargslan-bandwidth-monitor)](https://pypi.org/project/dargslan-bandwidth-monitor/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Installation

```bash
pip install dargslan-bandwidth-monitor
```

## CLI Usage

```bash
dargslan-bw report            # Full bandwidth report
dargslan-bw stats             # Interface statistics
dargslan-bw speed             # Real-time throughput test
dargslan-bw speed -d 5        # 5-second speed test
dargslan-bw total             # Total traffic counters
dargslan-bw errors            # Interface errors/drops
dargslan-bw json              # JSON output
```

## Python API

```python
from dargslan_bandwidth_monitor import BandwidthMonitor
bm = BandwidthMonitor()
stats = bm.get_stats()
throughput = bm.measure_throughput(duration=3)
bm.print_report()
```

## More from Dargslan

- [Dargslan.com](https://dargslan.com) — Linux & DevOps eBook Store
- [Free Cheat Sheets](https://dargslan.com/cheat-sheets)
- [Blog & Tutorials](https://dargslan.com/blog)

## License

MIT — see [LICENSE](LICENSE)
