network · Command reference

qzx testWebSpeed

What it does

Measures internet download speed (Mbps) and HTTP ping latency (ms)

Canonical command: testWebSpeed

Accepted aliases: None

Case-sensitive: no

Included in the published package

Available in PyPI 0.2.2.0.2. This page documents the 0.2.2.0.2 alpha development checkout.

Safety and effects

Read-only under the current classification

No documented dry-run parameter

No native program invocation in the current classification

May use the network

No inherent elevation requirement

This safety classification was reviewed against implementation digest sha256:9b94913643caf38f368241c2518a68f1da1d00bd4a4f3ec1625cd3930f48c5fe on 2026-07-24.

Exact syntax

qzx testWebSpeed [max_seconds] --json

Parameters

NameTypeRequiredDefaultDescription
max_secondsstrNo"3"Maximum duration of the download test in seconds (defaults to 3)

Input examples

qzx testWebSpeed

Measure connection latency and download throughput

qzx testWebSpeed 5

Run the speed test for up to 5 seconds

For the complete structured payload, add --json: qzx testWebSpeed [max_seconds] --json

Representative output example

This illustrative JSON is derived from the current implementation-backed result contract. It shows what the command can return without claiming a recorded execution; values vary with inputs, host, permissions, and optional tools.

Example command: qzx testWebSpeed --json

{
    "success": true,
    "message": "Measures internet download speed (Mbps) and HTTP ping latency (ms). In this illustrative example, the command completed successfully.",
    "download_speed_mbps": 42.7,
    "download_speed_mbs": 42.7,
    "latency_ms": {
        "average": null,
        "min": null,
        "max": null
    },
    "test_details": {
        "bytes_downloaded": "Example value",
        "duration_seconds": 42.7,
        "capped": true
    }
}
View the JSON result contract
{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": [
        "success",
        "message"
    ],
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "download_speed_mbps": [],
        "download_speed_mbs": [],
        "error": [],
        "latency_ms": {
            "type": "object",
            "properties": {
                "average": {
                    "type": "null"
                },
                "min": {
                    "type": "null"
                },
                "max": {
                    "type": "null"
                }
            },
            "additionalProperties": true
        },
        "test_details": {
            "type": "object",
            "properties": {
                "bytes_downloaded": [],
                "duration_seconds": [],
                "capped": {
                    "type": "boolean"
                }
            },
            "additionalProperties": true
        }
    },
    "additionalProperties": true
}

Errors and limits

The public contract requires success=false and a descriptive message on failure. This catalog does not yet declare a command-specific error taxonomy; inspect the result and do not invent error codes.

QZX is alpha software. Optional dependencies, permissions, and host capabilities can change the result.

Evidence workflow: requires an authorized endpoint or reviewed fixture.

Evidence and provenance

Tests
No command-specific test file with the same module name was found; this does not prove that all coverage is absent.
Documentation channel
Development documentation 0.2.2.0.2 · main · sha256:319b16857a87636ebc3b89734cc040a737bb56194464fca33ce73bdae2043096
Availability
0.2.2.0.2 or earlier

Keep exploring

These commands also belong to the network category. Compare them to choose the operation that best fits your task.

Explore all QZX commands