Metadata-Version: 2.4
Name: zspeedtest
Version: 0.2.1
Summary: zspeedtest
Keywords: zspeedtest
Author: Sergey
Author-email: Sergey <kava.develop@protonmail.com>
License-Expression: MIT
Classifier: Typing :: Typed
Classifier: Framework :: Pytest
Classifier: Framework :: AsyncIO
Classifier: Natural Language :: English
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.10, <3.15
Project-URL: Homepage, https://theseriff.github.io/zspeedtest/
Project-URL: Repository, https://github.com/theseriff/zspeedtest
Project-URL: Documentation, https://theseriff.github.io/zspeedtest/
Project-URL: Changelog, https://github.com/theseriff/zspeedtest/blob/main/docs/CHANGELOG.md
Project-URL: Issues, https://github.com/theseriff/zspeedtest/issues
Description-Content-Type: text/markdown

<div align="center">

<h1>zspeedtest</h1>
<p><strong>Simple CLI internet speed tester. Downloads a file and measures throughput.</strong></p>

[![Supported Python versions](https://img.shields.io/pypi/pyversions/zspeedtest.svg)](https://pypi.org/project/zspeedtest)
[![PyPI version](https://badge.fury.io/py/zspeedtest.svg)](https://pypi.python.org/pypi/zspeedtest)
[![Tests](https://github.com/theseriff/zspeedtest/actions/workflows/pr_tests.yaml/badge.svg)](https://github.com/theseriff/zspeedtest/actions/workflows/pr_tests.yaml)
[![Coverage](https://coverage-badge.samuelcolvin.workers.dev/theseriff/zspeedtest.svg)](https://coverage-badge.samuelcolvin.workers.dev/redirect/theseriff/zspeedtest)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

</div>

## Install from PyPI

```bash
uv add zspeedtest  # or pip install zspeedtest
uv run zspeedtest
```

## Usage

```
uv run zspeedtest [URL] [--requests N] [--timeout N]
```

- `URL` — large file to download (default: 10MB test file from ThinkBroadband)
- `--requests`/`-n` — number of test requests (default: 10)
- `--timeout`/`-t` — per-request timeout in seconds (default: 30)

### Examples

```bash
uv run zspeedtest
uv run zspeedtest http://example.com/file.bin --requests 5
uv run zspeedtest http://example.com/file.bin -n 3 -t 15
```

Output:

```bash
uv run zspeedtest -n 1

URL: http://ipv4.download.thinkbroadband.com/10MB.zip
Requests: 1
----------------------------------------------------
  #        Size      Time         Speed
----------------------------------------------------

  1     10.0 MB    29.95s        0.33 MB/s
====================================================
Successful requests : 1 / 1
Total downloaded    : 10.0 MB
Average time        : 29.95 s
Average speed       : 0.33 MB/s
Min / Max           : 0.33 / 0.33 MB/s
```
