zspeedtest 0.1.1__py3-none-any.whl

zspeedtest/__init__.py

@@ -0,0 +1,5 @@
+"""Core zspeedtest components for the zspeedtest library."""
+
+from importlib.metadata import version as get_version
+
+__version__ = get_version("zspeedtest")

zspeedtest/main.py

@@ -0,0 +1,149 @@
+"""Internet speed tester.
+
+Usage: zspeedtest <URL> [--requests N]
+"""
+
+import argparse
+import sys
+import textwrap
+import time
+from typing import NamedTuple
+from urllib.request import Request, urlopen
+
+KB = 1024
+MB = KB**2
+CHUNK_SIZE = KB * 64
+DEFAULT_URL = "http://ipv4.download.thinkbroadband.com/10MB.zip"
+
+
+class SpeedTestArgs(NamedTuple):
+    url: str
+    requests: int
+    timeout: int
+
+    @classmethod
+    def from_cli(cls) -> "SpeedTestArgs":
+        parser = argparse.ArgumentParser(
+            description="Internet speed tester",
+            formatter_class=argparse.ArgumentDefaultsHelpFormatter,
+        )
+        parser.add_argument(
+            "url",
+            nargs="?",
+            default=DEFAULT_URL,
+            help="URL of a large file to download",
+        )
+        parser.add_argument(
+            "--requests",
+            "-n",
+            type=int,
+            default=10,
+            metavar="N",
+            help="Number of requests",
+        )
+        parser.add_argument(
+            "--timeout",
+            "-t",
+            type=int,
+            default=30,
+            metavar="N",
+            help="Request timeout",
+        )
+        namespace = parser.parse_args()
+
+        if not namespace.url.startswith(("http:", "https:")):
+            msg = "URL must start with 'http:' or 'https:'"
+            raise ValueError(msg)
+
+        return cls(**namespace.__dict__)
+
+
+class RequestResult(NamedTuple):
+    duration_seconds: float
+    bytes_downloaded: int
+
+
+def download_url(req: Request, timeout: int) -> RequestResult:
+    start = time.perf_counter()
+    total_bytes: int = 0
+
+    # nosemgrep: python.lang.security.audit.dynamic-urllib-use-detected.dynamic-urllib-use-detected  # noqa: E501, ERA001
+    with urlopen(req, timeout=timeout) as response:  # nosec
+        while chunk := response.read(CHUNK_SIZE):
+            total_bytes += len(chunk)
+
+    duration = time.perf_counter() - start
+    return RequestResult(
+        duration_seconds=duration,
+        bytes_downloaded=total_bytes,
+    )
+
+
+def format_size(bytes_count: float) -> str:
+    for unit in ("B", "KB", "MB", "GB"):
+        if bytes_count < KB:
+            return f"{bytes_count:.1f} {unit}"
+        bytes_count /= KB
+    return f"{bytes_count:.1f} TB"
+
+
+def run() -> None:
+    args = SpeedTestArgs.from_cli()
+    start_info = textwrap.dedent(f"""\
+        URL: {args.url}
+        Requests: {args.requests}
+        {"-" * 52}
+        {"#":>3}  {"Size":>10}  {"Time":>8}  {"Speed":>12}
+        {"-" * 52}
+    """)
+    print(start_info)
+
+    results: list[RequestResult] = []
+
+    req = Request(args.url)
+    req.add_header("User-Agent", "zspeedtest/1.0")
+
+    for i in range(1, args.requests + 1):
+        try:
+            r = download_url(req, timeout=args.timeout)
+        except Exception as e:  # noqa: BLE001
+            print(f"{i:>3}  ERROR: {e}")
+            continue
+
+        results.append(r)
+
+        speed_mbps = (r.bytes_downloaded / r.duration_seconds) / MB
+        print(
+            f"{i:>3}  {format_size(r.bytes_downloaded):>10}"
+            f"  {r.duration_seconds:>7.2f}s  {speed_mbps:>10.2f} MB/s"
+        )
+
+    if not results:
+        print("\nNo requests completed successfully.")
+        sys.exit(1)
+
+    print("=" * 52)
+
+    total_bytes = sum(r.bytes_downloaded for r in results)
+    total_time = sum(r.duration_seconds for r in results)
+    avg_time = total_time / len(results)
+    avg_speed = (total_bytes / total_time) / MB
+    min_speed = min(
+        (r.bytes_downloaded / r.duration_seconds) / MB for r in results
+    )
+    max_speed = max(
+        (r.bytes_downloaded / r.duration_seconds) / MB for r in results
+    )
+
+    end_info = textwrap.dedent(f"""\
+        Successful requests : {len(results)} / {args.requests}
+        Total downloaded    : {format_size(total_bytes)}
+        Average time        : {avg_time:.2f} s
+        Average speed       : {avg_speed:.2f} MB/s
+        Min / Max           : {min_speed:.2f} / {max_speed:.2f} MB/s
+    """)
+    print(end_info)
+
+
+if __name__ == "__main__":
+    run()

zspeedtest-0.1.1.dist-info/METADATA

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: zspeedtest
+Version: 0.1.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>
+
+```bash
+uv add zspeedtest
+zspeedtest
+```
+
+## Usage
+
+```
+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
+zspeedtest
+zspeedtest http://example.com/file.bin --requests 5
+zspeedtest http://example.com/file.bin -n 3 -t 15
+```
+
+Output:
+
+```bash
+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
+```

zspeedtest-0.1.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+zspeedtest/__init__.py,sha256=g67SDd0H4atCLjpFUcESP0JlWXyOkYMmf5nLAavR5us,157
+zspeedtest/main.py,sha256=nKlFO_VFdM6iUlYo5-rHSiRGVCrGuI4zgou4cNp6yCI,4053
+zspeedtest-0.1.1.dist-info/WHEEL,sha256=s49dN1sxqzkgPplo4QuUaKomil-_cbDzeLK4-pZKD-A,81
+zspeedtest-0.1.1.dist-info/entry_points.txt,sha256=y1ChsvhdTkNwup6Cgwm0VRE5wCRZgzxdHySE6qXc9K0,52
+zspeedtest-0.1.1.dist-info/METADATA,sha256=OIKwxSHlUT8JRGZU-u9PNQCsM9692l2spWHkBrttYSQ,3090
+zspeedtest-0.1.1.dist-info/RECORD,,

zspeedtest-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.24
+Root-Is-Purelib: true
+Tag: py3-none-any

zspeedtest-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+zspeedtest = zspeedtest.main:run
+