Metadata-Version: 2.4
Name: netstrength
Version: 1.0.0
Summary: Beautiful network quality analyzer with real-world usage estimates
Author: chibokocl
License-Expression: MIT
Project-URL: Homepage, https://github.com/chibokocl/netstrength
Project-URL: Repository, https://github.com/chibokocl/netstrength
Project-URL: Issues, https://github.com/chibokocl/netstrength/issues
Keywords: network,ping,latency,monitoring,cli,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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 :: Networking :: Monitoring
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# netstrength

Beautiful network quality analyzer with real-world usage estimates.

```
╔══════════════════════════════════════════════════════════════╗
║           netstrength - Network Quality Analyzer            ║
╚══════════════════════════════════════════════════════════════╝
```

## Features

- **Zero dependencies** - Pure Python, works out of the box
- **Beautiful terminal output** - Colors, progress bars, clear formatting
- **Real-world estimates** - Tells you if you can stream 4K, game competitively, etc.
- **Cross-platform** - Works on macOS, Linux, and Windows
- **Simple grades** - A through F rating system anyone can understand

## Installation

### Via pip (recommended)
```bash
pip install netstrength
```

### Via Homebrew (macOS/Linux)
```bash
brew tap chibokocl/tools
brew install netstrength
```

### From source
```bash
git clone https://github.com/chibokocl/netstrength
cd netstrength
pip install .
```

## Usage

```bash
# Quick test with defaults
netstrength

# Test specific hosts
netstrength -t google.com -t cloudflare.com

# Quick 5-ping test
netstrength --quick

# More pings for accuracy
netstrength -n 30

# Run continuously
netstrength --continuous

# High-latency network? Increase timeout
netstrength --timeout 10
```

## Sample Output

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  RESULTS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  🌍 Quad9 DNS (9.9.9.9)
     [A] Excellent
     ████░░░░░░░░░░░░░░░░   45.2 ms avg
     Latency: 32/45/78 ms (min/avg/max)
     Jitter:   8.3 ms   Loss:  0.0% (10/10)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  WHAT CAN YOU DO?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✓ 4K Streaming            Smooth playback
  ✓ Video Calls             HD quality
  ✓ Competitive Gaming      Pro-level
  ✓ 120Hz Gaming            Smooth
  ✓ Web Browsing            Snappy
  ✓ Downloads               Full speed

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  OVERALL GRADE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ★★★★★  Grade A - Excellent
  Avg latency: 45ms | Jitter: 8ms | Loss: 0.0%

  ► Best target: Quad9 DNS (45ms avg)
```

## Options

| Option | Description |
|--------|-------------|
| `-t, --target HOST` | Target host(s) to test |
| `-n, --count N` | Number of pings (default: 10) |
| `-i, --interval SEC` | Seconds between pings (default: 1.0) |
| `--timeout SEC` | Ping timeout (default: 5) |
| `--quick` | Quick 5-ping test |
| `--continuous` | Run until Ctrl+C |
| `--no-color` | Disable colors |
| `-v, --version` | Show version |

## License

MIT
