speedtest-cli-ng 0.1.1__tar.gz → 0.2.0__tar.gz

{speedtest_cli_ng-0.1.1/speedtest_cli_ng.egg-info → speedtest_cli_ng-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: speedtest-cli-ng
-Version: 0.1.1
+Version: 0.2.0
 Summary: Next generation CLI for testing internet bandwidth using speedtest.net
 Author-email: Michał Korczak <git@omikor.in>
 License-Expression: Apache-2.0
@@ -29,8 +29,8 @@ Dynamic: license-file
 [![PyPI version](https://img.shields.io/pypi/v/speedtest-cli-ng.svg)](https://github.com/Omikorin/speedtest-cli)
 [![PyPI license](https://img.shields.io/pypi/l/speedtest-cli-ng.svg)](https://github.com/Omikorin/speedtest-cli)
 [![PyPI pyversions](https://img.shields.io/pypi/pyversions/speedtest-cli-ng.svg)](https://github.com/Omikorin/speedtest-cli)
-<!-- [![GitHub  License](https://img.shields.io/github/license/Omikorin/speedtest-cli)](https://github.com/Omikorin/speedtest-cli/blob/main/LICENSE) -->
-<!-- TODO: SonarQube, GitHub Actions? -->
+[![CI](https://github.com/Omikorin/speedtest-cli/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Omikorin/speedtest-cli/actions/workflows/ci.yml)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=Omikorin_speedtest-cli&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=Omikorin_speedtest-cli)
 
 Next generation CLI for testing internet bandwidth using speedtest.net
 
@@ -75,15 +75,14 @@ speedtest-cli --help
 ```
 
 ```text
-usage: speedtest-cli [-h] [-l] [-s SERVER] [--no-download] [--no-upload] [-t THREADS | --single]
-                     [--share] [--bytes] [--csv | --json] [--csv-delimiter CSV_DELIMITER]
-                     [--csv-header] [--source SOURCE] [--timeout TIMEOUT] [--debug] [--version]
+usage: speedtest-cli [-h] [-l] [-s SERVER] [--no-download] [--no-upload]
+                     [-t THREADS | --single] [--share] [--bytes] [--json]
+                     [--debug] [--version]
 
 Next generation CLI for testing internet bandwidth using speedtest.net.
 
 options:
   -h, --help            show this help message and exit
-  --version             show program's version number and exit
 
 Core Options:
   -l, --list            Show available speedtest.net servers sorted by distance. (default: False)
@@ -99,17 +98,12 @@ Transfer Modifiers:
 
 Output Options:
   --share               Generate and provide a URL to the speedtest.net share results image. (default: False)
-  --bytes               Display values in bytes instead of bits. Does not affect image generation or JSON/CSV output. (default: ('bit', 1))
-  --csv                 Suppress verbose output, only show basic information in CSV format. Speeds listed in bit/s. (default: False)
+  --bytes               Display values in bytes instead of bits. Does not affect image generation or JSON output. (default: ('bit', 1))
   --json                Suppress verbose output, only show basic information in JSON format. Speeds listed in bit/s. (default: False)
-  --csv-delimiter CSV_DELIMITER
-                        Single character delimiter to use in CSV output. (default: ,)
-  --csv-header          Print CSV headers and exit. (default: False)
 
-Connection Options:
-  --source SOURCE       Bind a source IP address to use for connections. (default: None)
-  --timeout TIMEOUT     HTTP timeout in seconds. (default: 10.0)
+Miscellaneous Options:
   --debug               Show verbose debugging output. (default: False)
+  --version             show program's version number and exit
 ```
 
 ## Development
@@ -153,7 +147,6 @@ uv run build
 
 The output will be in the `dist/` directory.
 
-
 ## Acknowledgments
 
 This project is a heavily refactored and modernized fork of the original [speedtest-cli](https://github.com/sivel/speedtest-cli) created by Matt Martz. While the codebase has been completely rewritten to support modern Python standards, concurrent thread pools, and memory-safe streaming, it was built upon the foundational concepts of the original tool.

{speedtest_cli_ng-0.1.1 → speedtest_cli_ng-0.2.0}/README.md

@@ -3,8 +3,8 @@
 [![PyPI version](https://img.shields.io/pypi/v/speedtest-cli-ng.svg)](https://github.com/Omikorin/speedtest-cli)
 [![PyPI license](https://img.shields.io/pypi/l/speedtest-cli-ng.svg)](https://github.com/Omikorin/speedtest-cli)
 [![PyPI pyversions](https://img.shields.io/pypi/pyversions/speedtest-cli-ng.svg)](https://github.com/Omikorin/speedtest-cli)
-<!-- [![GitHub  License](https://img.shields.io/github/license/Omikorin/speedtest-cli)](https://github.com/Omikorin/speedtest-cli/blob/main/LICENSE) -->
-<!-- TODO: SonarQube, GitHub Actions? -->
+[![CI](https://github.com/Omikorin/speedtest-cli/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Omikorin/speedtest-cli/actions/workflows/ci.yml)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=Omikorin_speedtest-cli&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=Omikorin_speedtest-cli)
 
 Next generation CLI for testing internet bandwidth using speedtest.net
 
@@ -49,15 +49,14 @@ speedtest-cli --help
 ```
 
 ```text
-usage: speedtest-cli [-h] [-l] [-s SERVER] [--no-download] [--no-upload] [-t THREADS | --single]
-                     [--share] [--bytes] [--csv | --json] [--csv-delimiter CSV_DELIMITER]
-                     [--csv-header] [--source SOURCE] [--timeout TIMEOUT] [--debug] [--version]
+usage: speedtest-cli [-h] [-l] [-s SERVER] [--no-download] [--no-upload]
+                     [-t THREADS | --single] [--share] [--bytes] [--json]
+                     [--debug] [--version]
 
 Next generation CLI for testing internet bandwidth using speedtest.net.
 
 options:
   -h, --help            show this help message and exit
-  --version             show program's version number and exit
 
 Core Options:
   -l, --list            Show available speedtest.net servers sorted by distance. (default: False)
@@ -73,17 +72,12 @@ Transfer Modifiers:
 
 Output Options:
   --share               Generate and provide a URL to the speedtest.net share results image. (default: False)
-  --bytes               Display values in bytes instead of bits. Does not affect image generation or JSON/CSV output. (default: ('bit', 1))
-  --csv                 Suppress verbose output, only show basic information in CSV format. Speeds listed in bit/s. (default: False)
+  --bytes               Display values in bytes instead of bits. Does not affect image generation or JSON output. (default: ('bit', 1))
   --json                Suppress verbose output, only show basic information in JSON format. Speeds listed in bit/s. (default: False)
-  --csv-delimiter CSV_DELIMITER
-                        Single character delimiter to use in CSV output. (default: ,)
-  --csv-header          Print CSV headers and exit. (default: False)
 
-Connection Options:
-  --source SOURCE       Bind a source IP address to use for connections. (default: None)
-  --timeout TIMEOUT     HTTP timeout in seconds. (default: 10.0)
+Miscellaneous Options:
   --debug               Show verbose debugging output. (default: False)
+  --version             show program's version number and exit
 ```
 
 ## Development
@@ -127,7 +121,6 @@ uv run build
 
 The output will be in the `dist/` directory.
 
-
 ## Acknowledgments
 
 This project is a heavily refactored and modernized fork of the original [speedtest-cli](https://github.com/sivel/speedtest-cli) created by Matt Martz. While the codebase has been completely rewritten to support modern Python standards, concurrent thread pools, and memory-safe streaming, it was built upon the foundational concepts of the original tool.

{speedtest_cli_ng-0.1.1 → speedtest_cli_ng-0.2.0}/extras/man/speedtest-cli.1

@@ -62,12 +62,7 @@ Generate and provide a URL to the speedtest.net share results image.
 
 \fB\-\-bytes\fR
 .RS
-Display values in bytes instead of bits. Does not affect image generation or JSON/CSV output.
-.RE
-
-\fB\-\-csv\fR
-.RS
-Suppress verbose output, only show basic information in CSV format. Speeds listed in bit/s.
+Display values in bytes instead of bits. Does not affect image generation or JSON output.
 .RE
 
 \fB\-\-json\fR
@@ -75,27 +70,7 @@ Suppress verbose output, only show basic information in CSV format. Speeds liste
 Suppress verbose output, only show basic information in JSON format. Speeds listed in bit/s.
 .RE
 
-\fB\-\-csv\-delimiter CSV_DELIMITER\fR
-.RS
-Single character delimiter to use in CSV output. Default ","
-.RE
-
-\fB\-\-csv\-header\fR
-.RS
-Print CSV headers and exit.
-.RE
-
-.B Connection Options
-
-\fB\-\-source SOURCE\fR
-.RS
-Bind a source IP address to use for connections.
-.RE
-
-\fB\-\-timeout TIMEOUT\fR
-.RS
-HTTP timeout in seconds. Default 10.0
-.RE
+.B Miscellaneous Options
 
 \fB\-\-debug\fR
 .RS

{speedtest_cli_ng-0.1.1 → speedtest_cli_ng-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "speedtest-cli-ng"
-version = "0.1.1"
+version = "0.2.0"
 authors = [
     {name = "Michał Korczak", email = "git@omikor.in"}
     # TODO: I'm not sure whether I should put the old author because of possible spam for him unknowingly etc

{speedtest_cli_ng-0.1.1 → speedtest_cli_ng-0.2.0}/speedtest/__main__.py

@@ -27,7 +27,7 @@ def main() -> int:
 
         if code not in (ExitStatus.SUCCESS.value, ExitStatus.ERROR_CTRL_C.value):
             msg = str(e) or repr(e)
-            logger.error(f"ERROR: {msg}")
+            logger.error(msg)
 
         return int(code)
 

speedtest_cli_ng-0.2.0/speedtest/cli/commands.py

@@ -0,0 +1,26 @@
+"""
+Wraps the core Speedtest logic into CLI actions.
+"""
+
+from speedtest.models import Server
+from speedtest.utils.status import ExitStatus
+
+__all__ = ["handle_server_list"]
+
+
+def handle_server_list(servers: list[Server]) -> int:
+    """Handle the --list argument by printing nearby servers and exiting."""
+
+    try:
+        for server in servers:
+            line = (
+                f"[{server.id:>5}]\t{server.distance} km\t"
+                f"{server.name} ({server.country}) "
+                f"by {server.sponsor}"
+            )
+            print(line)
+    except BrokenPipeError:
+        # Prevents messy tracebacks if the user pipes output to `head` or `less`
+        pass
+
+    return ExitStatus.SUCCESS.value

speedtest_cli_ng-0.2.0/speedtest/cli/main.py

@@ -0,0 +1,103 @@
+"""
+The main entry point of the CLI shell.
+"""
+
+import dataclasses
+import signal
+import threading
+from typing import Any
+
+from speedtest.cli.commands import handle_server_list
+from speedtest.cli.output import format_json, format_text
+from speedtest.cli.parser import parse_args
+from speedtest.client import SpeedtestClient
+from speedtest.engine.config import get_config
+from speedtest.exceptions import SpeedtestCLIError
+from speedtest.models import RunContext, TestResult
+from speedtest.utils.logger import logger, setup_logging
+from speedtest.utils.status import ExitStatus
+
+__all__ = ["shell"]
+
+
+def _register_shutdown_handler() -> threading.Event:
+    """Register a SIGINT handler and return the associated shutdown event."""
+
+    shutdown_event = threading.Event()
+
+    def _handler(signum: int, frame: Any) -> None:
+        shutdown_event.set()
+        logger.warning("Stopping speedtest-cli...")
+        raise KeyboardInterrupt
+
+    signal.signal(signal.SIGINT, _handler)
+    return shutdown_event
+
+
+def shell() -> int:
+    """Run the full speedtest.net test orchestrator."""
+
+    raw_args = parse_args()
+    ctx = RunContext.from_args(raw_args)
+    results = TestResult()
+
+    setup_logging(debug=ctx.debug_mode, quiet=ctx.is_quiet)
+
+    ctx.shutdown_event = _register_shutdown_handler()
+    client = SpeedtestClient()
+
+    try:
+        logger.info("[INFO] Retrieving speedtest.net configuration...")
+        ctx.api_config = get_config()
+
+        logger.info(
+            f"ISP: {ctx.api_config.ip_address} ({ctx.api_config.isp_name}) "
+            f"[{ctx.api_config.location.latitude:.4f}, {ctx.api_config.location.longitude:.4f}]"
+        )
+
+        target_servers = client.get_target_servers(
+            config=ctx.api_config, target_id=ctx.target_server_id
+        )
+
+        if ctx.list_servers_only:
+            return handle_server_list(target_servers)
+
+        # Latency test
+        results.server, results.ping_ms = client.select_best_server(target_servers)
+
+        logger.info(
+            f"Test server: [{results.server.id}] {results.server.distance} km "
+            f"{results.server.name} ({results.server.country}) "
+            f"by {results.server.sponsor}"
+        )
+
+        logger.info(f"Latency: {results.ping_ms:.5f} ms")
+
+        # Transfer tests
+        if not ctx.no_download:
+            results.download_bytes, results.download_bps = client.download(
+                server=results.server, ctx=ctx
+            )
+
+        if not ctx.no_upload:
+            results.upload_bytes, results.upload_bps = client.upload(server=results.server, ctx=ctx)
+
+        if ctx.share:
+            logger.info("[INFO] Generating share link...")
+            results.share_url = client.generate_share_link(results)
+
+        logger.debug(f"Results:\n{dataclasses.asdict(results)!r}")
+
+        if ctx.json_output:
+            final_output = format_json(results, ctx.api_config)
+        else:
+            final_output = format_text(results, ctx.units)
+
+        print(final_output)
+
+        return ExitStatus.SUCCESS.value
+
+    except SpeedtestCLIError as e:
+        logger.error(f"Test failed: {e}")
+
+        return ExitStatus.ERROR.value

speedtest_cli_ng-0.2.0/speedtest/cli/output.py

@@ -0,0 +1,62 @@
+"""
+Handles formatting of test results into strings.
+"""
+
+import dataclasses
+import json
+import sys
+from datetime import UTC, datetime
+
+from speedtest.models import SpeedtestConfig, TestResult
+
+__all__ = ["format_json", "format_text"]
+
+
+def format_json(results: TestResult, client_config: SpeedtestConfig | None = None) -> str:
+    """Construct the machine-readable JSON representation as a string."""
+
+    json_data = {
+        "timestamp": datetime.now(UTC).isoformat(),
+        "ping": results.ping_ms,
+        "download": results.download_bps,
+        "upload": results.upload_bps,
+        "bytes_received": results.download_bytes,
+        "bytes_sent": results.upload_bytes,
+        "share": results.share_url,
+        "server": dataclasses.asdict(results.server) if results.server else None,
+    }
+
+    if client_config:
+        json_data["client"] = {
+            "ip": client_config.ip_address,
+            "isp": client_config.isp_name,
+            "isp_id": client_config.isp_id,
+            "location": dataclasses.asdict(client_config.location),
+        }
+
+    indent = 2 if sys.stdout.isatty() else None
+    return json.dumps(json_data, indent=indent)
+
+
+def format_text(results: TestResult, units: tuple[str, int]) -> str:
+    """Format the human-readable text representation as a string."""
+
+    unit_name, unit_divisor = units
+    lines = []
+
+    dl_speed = results.get_download_speed(unit_divisor)
+    dl_bytes = results.get_downloaded_megabytes()
+
+    if dl_speed is not None and dl_bytes is not None:
+        lines.append(f"Download: {dl_speed:.2f} M{unit_name}/s ({dl_bytes:.2f} MB)")
+
+    ul_speed = results.get_upload_speed(unit_divisor)
+    ul_bytes = results.get_uploaded_megabytes()
+
+    if ul_speed is not None and ul_bytes is not None:
+        lines.append(f"Upload: {ul_speed:.2f} M{unit_name}/s ({ul_bytes:.2f} MB)")
+
+    if results.share_url is not None:
+        lines.append(f"Share results: {results.share_url}")
+
+    return "\n".join(lines)

{speedtest_cli_ng-0.1.1 → speedtest_cli_ng-0.2.0}/speedtest/cli/parser.py

@@ -9,16 +9,6 @@ from speedtest import __version__
 __all__ = ["parse_args"]
 
 
-def _single_char_delimiter(value: str) -> str:
-    """Argparse type validator to ensure a delimiter is exactly one character."""
-
-    if len(value) != 1:
-        raise argparse.ArgumentTypeError(
-            f"CSV delimiter must be a single character, got: {value!r}"
-        )
-    return value
-
-
 def parse_args() -> argparse.Namespace:
     """Function to handle building and parsing of command line arguments."""
 
@@ -83,23 +73,15 @@ def parse_args() -> argparse.Namespace:
         "--bytes",
         dest="units",
         action="store_const",
-        const=("byte", 8),
-        default=("bit", 1),
+        const=("B", 8),
+        default=("b", 1),
         help=(
             "Display values in bytes instead of bits. "
-            "Does not affect image generation or JSON/CSV output."
+            "Does not affect image generation or JSON output."
         ),
     )
 
     format_group = output_group.add_mutually_exclusive_group()
-    format_group.add_argument(
-        "--csv",
-        action="store_true",
-        help=(
-            "Suppress verbose output, only show basic information "
-            "in CSV format. Speeds listed in bit/s."
-        ),
-    )
     format_group.add_argument(
         "--json",
         action="store_true",
@@ -109,22 +91,8 @@ def parse_args() -> argparse.Namespace:
         ),
     )
 
-    output_group.add_argument(
-        "--csv-delimiter",
-        default=",",
-        type=_single_char_delimiter,
-        help="Single character delimiter to use in CSV output.",
-    )
-    output_group.add_argument(
-        "--csv-header", action="store_true", help="Print CSV headers and exit."
-    )
-
-    conn_group = parser.add_argument_group("Connection Options")
-    conn_group.add_argument(
-        "--source", type=str, help="Bind a source IP address to use for connections."
-    )
-    conn_group.add_argument("--timeout", default=10.0, type=float, help="HTTP timeout in seconds.")
-    conn_group.add_argument("--debug", action="store_true", help="Show verbose debugging output.")
-    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    misc_group = parser.add_argument_group("Miscellaneous Options")
+    misc_group.add_argument("--debug", action="store_true", help="Show verbose debugging output.")
+    misc_group.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
 
     return parser.parse_args()

speedtest_cli_ng-0.2.0/speedtest/client.py

@@ -0,0 +1,117 @@
+import urllib.error
+import urllib.parse
+import urllib.request
+from hashlib import md5
+from operator import attrgetter
+
+from speedtest.engine.servers import get_best_server
+from speedtest.engine.transfer import run_download_test, run_upload_test
+from speedtest.exceptions import NoMatchedServer, SpeedtestCLIError
+from speedtest.models import Server, SpeedtestConfig, TestResult
+from speedtest.models.context import RunContext
+
+__all__ = ["SpeedtestClient"]
+
+
+class SpeedtestClient:
+    """Orchestrates high-level speedtest actions."""
+
+    def get_target_servers(
+        self, config: SpeedtestConfig, target_id: int | None = None, limit: int = 5
+    ) -> list[Server]:
+        """Sorts available servers by distance and filters by ID if requested."""
+
+        servers = sorted(config.servers, key=attrgetter("distance"))
+
+        if target_id is not None:
+            servers = [srv for srv in servers if srv.id == target_id]
+            if not servers:
+                raise NoMatchedServer(f"No server matched the ID: {target_id}")
+
+        return servers[:limit]
+
+    def select_best_server(self, servers: list[Server]) -> tuple[Server, float]:
+        """Pings a list of servers and returns the fastest one alongside its latency."""
+
+        if not servers:
+            raise SpeedtestCLIError("No servers provided to test against.")
+
+        best_server, latency = get_best_server(servers)
+
+        if not best_server:
+            raise SpeedtestCLIError("Failed to identify a valid best server.")
+
+        return best_server, latency
+
+    def download(self, server: Server, ctx: RunContext) -> tuple[int, float]:
+        """Executes the download test. Returns (bytes_received, download_speed)."""
+
+        if not server.url:
+            raise SpeedtestCLIError("The target server is missing a valid URL.")
+
+        return run_download_test(best_server_url=server.url, ctx=ctx)
+
+    def upload(self, server: Server, ctx: RunContext) -> tuple[int, float]:
+        """Executes the upload test. Returns (bytes_sent, upload_speed)."""
+
+        if not server.url:
+            raise SpeedtestCLIError("The target server is missing a valid URL.")
+
+        return run_upload_test(best_server_url=server.url, ctx=ctx)
+
+    def generate_share_link(self, results: TestResult) -> str:
+        """POST data to the speedtest.net API to obtain a share results link."""
+
+        if not results.is_complete or not results.server:
+            raise SpeedtestCLIError("Cannot generate share link: missing test results.")
+
+        # The legacy Ookla API expects speeds in kilobits per second (kbps)
+        download_kbps = round((results.download_bps or 0) / 1000.0)
+        upload_kbps = round((results.upload_bps or 0) / 1000.0)
+        ping = round(results.ping_ms or 0)
+
+        hash_str = f"{ping}-{upload_kbps}-{download_kbps}-297aae72"
+        hash_val = md5(hash_str.encode()).hexdigest()
+
+        api_parameters = {
+            "recommendedserverid": results.server.id,
+            "ping": ping,
+            "screenresolution": "",
+            "promo": "",
+            "download": download_kbps,
+            "screendpi": "",
+            "upload": upload_kbps,
+            "testmethod": "http",
+            "hash": hash_val,
+            "touchscreen": "none",
+            "startmode": "pingselect",
+            "accuracy": 1,
+            "bytesreceived": results.download_bytes or 0,
+            "bytessent": results.upload_bytes or 0,
+            "serverid": results.server.id,
+        }
+
+        api_data = urllib.parse.urlencode(api_parameters).encode()
+        headers = {"Referer": "https://c.speedtest.net/flash/speedtest.swf"}
+
+        req = urllib.request.Request(
+            "https://www.speedtest.net/api/api.php", data=api_data, headers=headers, method="POST"
+        )
+
+        try:
+            with urllib.request.urlopen(req) as response:
+                if response.status != 200:
+                    raise SpeedtestCLIError(f"Could not submit results. HTTP {response.status}")
+
+                body = response.read().decode(errors="ignore")
+
+        except urllib.error.URLError as e:
+            raise SpeedtestCLIError(f"Failed to connect to Share API: {e}") from e
+
+        qsargs = urllib.parse.parse_qs(body)
+        resultid = qsargs.get("resultid")
+
+        if not resultid or len(resultid) != 1:
+            raise SpeedtestCLIError("Could not parse result ID from API response.")
+
+        return f"https://www.speedtest.net/result/{resultid[0]}.png"

speedtest_cli_ng-0.2.0/speedtest/engine/config.py

@@ -0,0 +1,50 @@
+"""
+Retrieves and parses the core configuration JSON from speedtest.net.
+"""
+
+import json
+from json import JSONDecodeError
+from typing import Any
+from urllib.error import URLError
+from urllib.request import Request, urlopen
+
+from speedtest.engine.network import build_user_agent
+from speedtest.models import SpeedtestConfig
+
+CONFIG_URL = "https://www.speedtest.net/api/js/config-sdk"
+
+
+class ConfigFetchError(Exception):
+    """Raised when the configuration cannot be retrieved or parsed."""
+
+    pass
+
+
+def fetch_raw_config(url: str = CONFIG_URL) -> dict[str, Any]:
+    """
+    Fetches the JSON configuration from the Speedtest API.
+    """
+
+    user_agent = build_user_agent()
+
+    req = Request(url, headers={"User-Agent": user_agent, "Accept": "application/json"})
+
+    try:
+        with urlopen(req, timeout=10.0) as response:
+            if response.status != 200:
+                raise ConfigFetchError(f"HTTP {response.status}: Failed to fetch config.")
+
+            body = response.read().decode("utf-8")
+            return json.loads(body)
+
+    except (URLError, JSONDecodeError) as e:
+        raise ConfigFetchError(f"Failed to retrieve or parse config: {e}") from e
+
+
+def get_config() -> SpeedtestConfig:
+    """
+    Orchestrates fetching the raw data and building the strict dataclass models.
+    """
+
+    raw_data = fetch_raw_config()
+    return SpeedtestConfig.from_dict(raw_data)