From ead18ff15f047808142007709ce6e62a7449c95e Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 08:50:20 -0600
Subject: [PATCH 01/24] Fix bugs, performance, and usability issues in Python
 code

Bugs:
- CLI: --file-level was ignored; file sink used the console level. Wire
  --file-level through configure/start and fix its help text.
- Configure logging in the stop command (and the now-enabled clean command).
- hive: pass check=True to schematool so metastore init failures surface.
- cluster_manager: raise InvalidConfiguration when computed worker memory is
  <= 0 instead of passing a negative value to Spark.
- Fix managed_cluster docstring (managed_start -> managed_cluster) and the
  _read_spark_defaults whitespace-only-line filter.

Performance:
- Start/stop Spark workers over ssh concurrently with a thread pool instead
  of serially, which previously serialized multi-node cluster startup.
- Cache the Slurm node-name lookup so a single configure/stop no longer shells
  out to squeue/scontrol multiple times.

Usability:
- Implement ClusterManager.clean() and enable the `sparkctl clean` command.
- Make the Spark Connect port configurable (connect_server_port), with a
  CLI default that falls back to the model default for older settings files.
- stop(): when the status file is missing, infer running processes from the
  configuration rather than assuming every server is up.
- default-config: warn when writing to a directory sparkctl cannot
  auto-discover.

Security:
- Pass the Postgres password to the setup scripts via the environment instead
  of the command line so it no longer appears in process listings.
- hive: extract the Hive tarball with filter="data".

Cleanup:
- Use click.Path(path_type=Path) instead of lambda callbacks for path options.
- Remove dead code in slurm_compute.get_node_names, the duplicate import in
  config.py, and honor the node_memory_overhead_gb argument consistently.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 src/sparkctl/cli/sparkctl.py             | 80 +++++++++++++++++-------
 src/sparkctl/cluster_manager.py          | 75 +++++++++++++++++-----
 src/sparkctl/config.py                   | 10 ++-
 src/sparkctl/fake_compute.py             |  2 +-
 src/sparkctl/hive.py                     | 12 +++-
 src/sparkctl/models.py                   |  4 ++
 src/sparkctl/native_compute.py           |  2 +-
 src/sparkctl/postgres/setup_metastore.sh |  3 +-
 src/sparkctl/postgres/start_container.sh |  3 +-
 src/sparkctl/slurm_compute.py            | 17 +++--
 src/sparkctl/spark_process_runner.py     | 54 ++++++++++++----
 tests/test_spark_process_runner.py       |  3 +-
 12 files changed, 199 insertions(+), 66 deletions(-)

diff --git a/src/sparkctl/cli/sparkctl.py b/src/sparkctl/cli/sparkctl.py
index cbb4917..6568c27 100644
--- a/src/sparkctl/cli/sparkctl.py
+++ b/src/sparkctl/cli/sparkctl.py
@@ -10,6 +10,7 @@
 from sparkctl.config import (
     DEFAULT_SETTINGS_FILENAME,
     RUNTIME,
+    SETTINGS_FILE_ENV_VAR,
     get_binaries,
     sparkctl_settings,
 )
@@ -39,7 +40,7 @@
     "--file-level",
     default=sparkctl_settings.app.file_level,
     show_default=True,
-    help="Console log level",
+    help="File log level",
 )
 @click.option(
     "-r",
@@ -66,15 +67,15 @@ def cli(ctx: click.Context, console_level: str, file_level: str, reraise_excepti
 
 
 @click.command(epilog=_default_config_epilog)
-@click.argument("spark_path", type=click.Path(exists=True), callback=lambda *x: Path(x[2]))
-@click.argument("java_path", type=click.Path(exists=True), callback=lambda *x: Path(x[2]))
+@click.argument("spark_path", type=click.Path(exists=True, path_type=Path))
+@click.argument("java_path", type=click.Path(exists=True, path_type=Path))
 @click.option(
     "-d",
     "--directory",
     default=Path.home(),
     show_default=True,
     help="Directory in which to create the sparkctl config file.",
-    callback=lambda *x: Path(x[2]),
+    type=click.Path(path_type=Path),
 )
 @click.option(
     "-e",
@@ -89,19 +90,19 @@ def cli(ctx: click.Context, console_level: str, file_level: str, reraise_excepti
     "-H",
     "--hadoop-path",
     help="Directory containing Hadoop binaries.",
-    callback=lambda *x: None if x[2] is None else Path(x[2]),
+    type=click.Path(path_type=Path),
 )
 @click.option(
     "-h",
     "--hive-tarball",
     help="File containing Hive binaries.",
-    callback=lambda *x: None if x[2] is None else Path(x[2]),
+    type=click.Path(path_type=Path),
 )
 @click.option(
     "-p",
     "--postgresql-jar-file",
     help="Path to PostgreSQL jar file.",
-    callback=lambda *x: None if x[2] is None else Path(x[2]),
+    type=click.Path(path_type=Path),
 )
 def default_config(
     spark_path: Path,
@@ -129,6 +130,16 @@ def default_config(
         toml.dump(data, f_out)
     print(f"Wrote sparkctl settings to {filename}")
 
+    # sparkctl only auto-discovers settings files in the home directory and the current working
+    # directory. A file written anywhere else must be pointed to explicitly, otherwise later
+    # commands silently fall back to defaults.
+    resolved = filename.resolve().parent
+    if resolved not in (Path.home().resolve(), Path.cwd().resolve()):
+        print(
+            f"\nNote: this location is not auto-discovered. Set {SETTINGS_FILE_ENV_VAR}={filename} "
+            "in your environment so sparkctl can find it."
+        )
+
 
 def _create_default_config(
     spark_path: Path, java_path: Path, directory: Path, compute_environment: ComputeEnvironment
@@ -157,8 +168,7 @@ def _create_default_config(
     default=Path(),
     show_default=True,
     help="Base directory for the cluster configuration",
-    type=click.Path(),
-    callback=lambda *x: Path(x[2]),
+    type=click.Path(path_type=Path),
 )
 @click.option(
     "-s",
@@ -166,7 +176,7 @@ def _create_default_config(
     default=Path("spark_scratch"),
     show_default=True,
     help=RuntimeDirectories.model_fields["spark_scratch"].description,
-    callback=lambda *x: Path(x[2]),
+    type=click.Path(path_type=Path),
 )
 @click.option(
     "-e",
@@ -217,7 +227,7 @@ def _create_default_config(
     "-t",
     "--spark-defaults-template-file",
     help=SparkRuntimeParams.model_fields["spark_defaults_template_file"].description,
-    callback=lambda *x: None if x[2] is None else Path(x[2]),
+    type=click.Path(path_type=Path),
 )
 @click.option(
     "--local-storage/--no-local-storage",
@@ -233,6 +243,18 @@ def _create_default_config(
     show_default=True,
     help=SparkRuntimeParams.model_fields["start_connect_server"].description,
 )
+@click.option(
+    "--connect-server-port",
+    # Fall back to the model default so the option still works for users whose settings file
+    # predates this field (a missing key would otherwise bind the default to None).
+    default=sparkctl_settings.runtime.get(
+        "connect_server_port",
+        SparkRuntimeParams.model_fields["connect_server_port"].default,
+    ),
+    show_default=True,
+    type=int,
+    help=SparkRuntimeParams.model_fields["connect_server_port"].description,
+)
 @click.option(
     "--history-server/--no-history-server",
     is_flag=True,
@@ -275,7 +297,7 @@ def _create_default_config(
     default=Path(),
     show_default=True,
     help=RuntimeDirectories.model_fields["metastore_dir"].description,
-    callback=lambda *x: Path(x[2]),
+    type=click.Path(path_type=Path),
 )
 @click.option(
     "-P",
@@ -319,6 +341,7 @@ def configure(
     spark_defaults_template_file: Path | None,
     local_storage: bool,
     connect_server: bool,
+    connect_server_port: int,
     history_server: bool,
     thrift_server: bool,
     spark_log_level: str | None,
@@ -333,7 +356,7 @@ def configure(
     setup_logging(
         filename="sparkctl.log",
         console_level=ctx.find_root().params["console_level"],
-        file_level=ctx.find_root().params["console_level"],
+        file_level=ctx.find_root().params["file_level"],
         mode="a",
     )
     if python_path is None and use_current_python:
@@ -355,6 +378,7 @@ def build_config() -> SparkConfig:
                 spark_defaults_template_file=spark_defaults_template_file,
                 use_local_storage=local_storage,
                 start_connect_server=connect_server,
+                connect_server_port=connect_server_port,
                 start_history_server=history_server,
                 start_thrift_server=thrift_server,
                 spark_log_level=spark_log_level,
@@ -408,8 +432,7 @@ def _configure(build_config: Callable[[], SparkConfig], start: bool) -> ClusterM
     default=Path(),
     show_default=True,
     help="Base directory for the cluster configuration",
-    type=click.Path(),
-    callback=lambda *x: Path(x[2]),
+    type=click.Path(path_type=Path),
 )
 @click.option(
     "-t",
@@ -423,7 +446,7 @@ def start(ctx: click.Context, wait: bool, directory: Path, timeout: float | None
     setup_logging(
         filename="sparkctl.log",
         console_level=ctx.find_root().params["console_level"],
-        file_level=ctx.find_root().params["console_level"],
+        file_level=ctx.find_root().params["file_level"],
         mode="a",
     )
     mgr = ClusterManager.load(directory)
@@ -461,19 +484,32 @@ def start(ctx: click.Context, wait: bool, directory: Path, timeout: float | None
     default=Path(),
     show_default=True,
     help="Base directory for the cluster configuration",
-    type=click.Path(),
-    callback=lambda *x: Path(x[2]),
+    type=click.Path(path_type=Path),
 )
-def stop(directory: Path) -> None:
+@click.pass_context
+def stop(ctx: click.Context, directory: Path) -> None:
     """Stop a Spark cluster."""
+    setup_logging(
+        filename="sparkctl.log",
+        console_level=ctx.find_root().params["console_level"],
+        file_level=ctx.find_root().params["file_level"],
+        mode="a",
+    )
     mgr = ClusterManager.load(directory)
     mgr.stop()
 
 
 @click.command()
-@click.argument("directory", callback=lambda *x: Path(x[2]))
-def clean(directory: Path) -> None:
+@click.argument("directory", type=click.Path(path_type=Path))
+@click.pass_context
+def clean(ctx: click.Context, directory: Path) -> None:
     """Delete all Spark runtime files in the directory."""
+    setup_logging(
+        filename="sparkctl.log",
+        console_level=ctx.find_root().params["console_level"],
+        file_level=ctx.find_root().params["file_level"],
+        mode="a",
+    )
     mgr = ClusterManager.load(directory)
     mgr.clean()
 
@@ -499,4 +535,4 @@ def handle_sparkctl_exception(ctx: click.Context, func, *args, **kwargs) -> Any:
 cli.add_command(configure)
 cli.add_command(start)
 cli.add_command(stop)
-# cli.add_command(clean)
+cli.add_command(clean)
diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index bc59ee8..4daa92f 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -1,7 +1,6 @@
 import fileinput
 import os
 import re
-import shlex
 import shutil
 import subprocess
 import sys
@@ -110,8 +109,32 @@ def load(cls, directory: Path | str | None = None) -> Self:
         return cls(config, status=status)
 
     def clean(self) -> None:
-        """Delete all Spark runtime files in the directory."""
-        logger.warning("clean is not implemented yet")
+        """Delete all Spark runtime files generated by sparkctl in the base directory."""
+        base = self._config.directories.base
+        directories = [
+            self._config.directories.get_spark_conf_dir(),
+            self._config.directories.spark_scratch.absolute(),
+            base / "stats-output",
+            base / "pg_data",
+            base / "pg_run",
+        ]
+        files = [
+            base / self.CONFIG_FILENAME,
+            base / self.STATUS_FILENAME,
+            base / "srun_workers.pid",
+            base / "srun_workers.log",
+        ]
+        for directory in directories:
+            if directory.exists():
+                shutil.rmtree(directory)
+                logger.info("Deleted directory {}", directory)
+        for file in files:
+            if file.exists():
+                file.unlink()
+                logger.info("Deleted file {}", file)
+        for pid_file in base.glob("rmon_*.pid"):
+            pid_file.unlink()
+            logger.info("Deleted file {}", pid_file)
 
     def configure(self) -> None:
         """Configure a Spark cluster based on the input parameters.
@@ -165,7 +188,8 @@ def get_spark_session(self) -> SparkSession:
         if not self._config.runtime.start_connect_server:
             msg = "The Spark config does not enable the Spark Connect Server."
             raise InvalidConfiguration(msg)
-        return SparkSession.builder.remote("sc://localhost:15002").getOrCreate()
+        port = self._config.runtime.connect_server_port
+        return SparkSession.builder.remote(f"sc://localhost:{port}").getOrCreate()
 
     def set_workers(self, workers: list[str]) -> None:
         """Set the workers for the cluster. Must be called after :meth:`configure` and before
@@ -252,7 +276,7 @@ def managed_cluster(self) -> Generator[SparkSession, None, None]:
         --------
         >>> from sparkctl import ClusterManager
         >>> mgr = ClusterManager.from_config_file("config.json")
-        >>> with mgr.managed_start() as spark:
+        >>> with mgr.managed_cluster() as spark:
             df = spark.createDataFrame([(1, 2), (3, 4)], ["a", "b"])
             df.show()
         """
@@ -323,18 +347,23 @@ def stop(self) -> None:
         if status_file.exists():
             tracker = StatusTracker.model_validate_json(status_file.read_text(encoding="utf-8"))
         else:
+            rt = self._config.runtime
             logger.warning(
-                "Status file {} does not exist, assume all processes are running.", status_file
+                "Status file {} does not exist; inferring running processes from the "
+                "configuration.",
+                status_file,
             )
+            # The master and workers are always started. Only stop the optional servers that the
+            # configuration actually enabled, so we don't emit spurious errors for servers that
+            # were never running.
             tracker = StatusTracker(
                 started_master=True,
                 started_workers=True,
-                started_thrift_server=True,
-                started_history_server=True,
-                started_connect_server=True,
+                started_connect_server=rt.start_connect_server,
+                started_history_server=self._is_history_server_enabled(),
+                started_thrift_server=rt.start_thrift_server,
+                started_postgres=rt.enable_postgres_hive_metastore,
             )
-            if self._config.runtime.enable_postgres_hive_metastore:
-                tracker.started_postgres = True
         url = make_spark_url(gethostname())
         runner = SparkProcessRunner(self._config, url)
         if tracker.started_master:
@@ -381,7 +410,17 @@ def _get_worker_memory_gb(self, driver_memory_gb: int) -> int:
             # Add a conservative cushion for memory.
             node_memory_overhead_gb += 2
 
-        return self._intf.get_worker_memory_gb() - node_memory_overhead_gb
+        total_memory_gb = self._intf.get_worker_memory_gb()
+        worker_memory_gb = total_memory_gb - node_memory_overhead_gb
+        if worker_memory_gb <= 0:
+            msg = (
+                f"The computed Spark worker memory is {worker_memory_gb} GB, which is invalid. "
+                f"The node memory overhead ({node_memory_overhead_gb} GB) is greater than or equal "
+                f"to the available node memory ({total_memory_gb} GB). Reduce "
+                "driver_memory_gb and/or node_memory_overhead_gb."
+            )
+            raise InvalidConfiguration(msg)
+        return worker_memory_gb
 
     @staticmethod
     def _is_single_node_cluster(workers: list[str]) -> bool:
@@ -555,7 +594,7 @@ def _read_spark_defaults(self) -> list[str]:
         lines: list[str] = []
         for line in filename.read_text(encoding="utf-8").splitlines():
             line_ = line.strip()
-            if line and not line_.startswith("#"):
+            if line_ and not line_.startswith("#"):
                 lines.append(line_)
 
         return lines
@@ -564,8 +603,14 @@ def _setup_postgres(self) -> None:
         script = self._config.compute.postgres.get_script_path("start_container")
         pg_data = self._config.directories.base / "pg_data"
         pg_run = self._config.directories.base / "pg_run"
-        cmd = f"bash {script} {pg_data} {pg_run} {self._config.runtime.postgres_password}"
-        subprocess.run(shlex.split(cmd), check=True)
+        password = self._config.runtime.postgres_password
+        if password is None:
+            msg = "postgres_password cannot be None"
+            raise InvalidConfiguration(msg)
+        # Pass the password through the environment rather than the command line so that it does
+        # not appear in process listings (ps) on the node.
+        env = {**os.environ, "SPARKCTL_PG_PASSWORD": password}
+        subprocess.run(["bash", str(script), str(pg_data), str(pg_run)], env=env, check=True)
         setup_postgres_metastore(self._config)
 
     def _stop_postgres(self) -> None:
diff --git a/src/sparkctl/config.py b/src/sparkctl/config.py
index 29a2893..8b86c2d 100644
--- a/src/sparkctl/config.py
+++ b/src/sparkctl/config.py
@@ -1,12 +1,17 @@
 import os
-from sparkctl.models import AppParams, ComputeParams
 from pathlib import Path
 
 from dynaconf import Dynaconf, Validator  # type: ignore
 from rich import print
 
 from sparkctl.exceptions import InvalidConfiguration
-from sparkctl.models import BinaryLocations, SparkRuntimeParams, SparkConfig
+from sparkctl.models import (
+    AppParams,
+    BinaryLocations,
+    ComputeParams,
+    SparkConfig,
+    SparkRuntimeParams,
+)
 
 DEFAULT_SETTINGS_FILENAME = ".sparkctl.toml"
 SETTINGS_FILE_ENV_VAR = "SPARKCTL_SETTINGS_FILE"
@@ -41,6 +46,7 @@ def _build_settings_files() -> list[Path]:
     "node_memory_overhead_gb": SparkRuntimeParams.model_fields["node_memory_overhead_gb"].default,
     "use_local_storage": SparkRuntimeParams.model_fields["use_local_storage"].default,
     "start_connect_server": SparkRuntimeParams.model_fields["start_connect_server"].default,
+    "connect_server_port": SparkRuntimeParams.model_fields["connect_server_port"].default,
     "start_history_server": SparkRuntimeParams.model_fields["start_history_server"].default,
     "start_thrift_server": SparkRuntimeParams.model_fields["start_thrift_server"].default,
     "spark_log_level": SparkRuntimeParams.model_fields["spark_log_level"].default,
diff --git a/src/sparkctl/fake_compute.py b/src/sparkctl/fake_compute.py
index 82068a7..9f06cda 100644
--- a/src/sparkctl/fake_compute.py
+++ b/src/sparkctl/fake_compute.py
@@ -15,7 +15,7 @@ class FakeCompute(ComputeInterface):
     def get_node_memory_overhead_gb(
         self, driver_memory_gb: int, node_memory_overhead_gb: int
     ) -> int:
-        return driver_memory_gb + self._config.runtime.node_memory_overhead_gb
+        return driver_memory_gb + node_memory_overhead_gb
 
     def get_num_workers(self) -> int:
         return 1
diff --git a/src/sparkctl/hive.py b/src/sparkctl/hive.py
index 183de5c..2d903c1 100644
--- a/src/sparkctl/hive.py
+++ b/src/sparkctl/hive.py
@@ -13,8 +13,12 @@ def setup_postgres_metastore(config: SparkConfig) -> None:
     pg_exists = bool(list(pg_data_dir.iterdir()))
     setup_script = config.compute.postgres.get_script_path("setup_metastore")
     assert config.runtime.postgres_password is not None
+    # Pass the password through the environment rather than the command line so that it does not
+    # appear in process listings (ps) on the node.
+    env = {**os.environ, "SPARKCTL_PG_PASSWORD": config.runtime.postgres_password}
     subprocess.run(
-        ["bash", str(setup_script), str(pg_exists).lower(), config.runtime.postgres_password],
+        ["bash", str(setup_script), str(pg_exists).lower()],
+        env=env,
         check=True,
     )
     if not pg_exists:
@@ -42,7 +46,7 @@ def init_hive(config: SparkConfig):
     if hive_home.exists():
         shutil.rmtree(hive_home)
     with tarfile.open(config.binaries.hive_tarball, "r:gz") as tar:
-        tar.extractall(path=config.directories.base)
+        tar.extractall(path=config.directories.base, filter="data")
     hive_conf = hive_home / "conf"
 
     shutil.copyfile(
@@ -62,7 +66,9 @@ def init_hive(config: SparkConfig):
             }
         )
         subprocess.run(
-            [f"{hive_home}/bin/schematool", "-dbType", "postgres", "-initSchema"], env=env
+            [f"{hive_home}/bin/schematool", "-dbType", "postgres", "-initSchema"],
+            env=env,
+            check=True,
         )
     finally:
         os.chdir(cwd)
diff --git a/src/sparkctl/models.py b/src/sparkctl/models.py
index 103f342..cec29c1 100644
--- a/src/sparkctl/models.py
+++ b/src/sparkctl/models.py
@@ -79,6 +79,10 @@ class SparkRuntimeParams(SparkctlBaseModel):
         default=False,
         description="Enable the Spark connect server.",
     )
+    connect_server_port: int = Field(
+        default=15002,
+        description="Port on which the Spark Connect server listens.",
+    )
     start_history_server: bool = Field(
         default=False,
         description="Enable the Spark history server.",
diff --git a/src/sparkctl/native_compute.py b/src/sparkctl/native_compute.py
index 2736c0c..87df11f 100644
--- a/src/sparkctl/native_compute.py
+++ b/src/sparkctl/native_compute.py
@@ -14,7 +14,7 @@ class NativeCompute(ComputeInterface):
     def get_node_memory_overhead_gb(
         self, driver_memory_gb: int, node_memory_overhead_gb: int
     ) -> int:
-        return driver_memory_gb + self._config.runtime.node_memory_overhead_gb
+        return driver_memory_gb + node_memory_overhead_gb
 
     def get_num_workers(self) -> int:
         return 1
diff --git a/src/sparkctl/postgres/setup_metastore.sh b/src/sparkctl/postgres/setup_metastore.sh
index 9e7bc00..dba23b9 100644
--- a/src/sparkctl/postgres/setup_metastore.sh
+++ b/src/sparkctl/postgres/setup_metastore.sh
@@ -1,6 +1,7 @@
 #!/bin/bash
 pg_exists=$1
-pg_password=$2
+# The password is passed through the environment so that it does not appear in process listings.
+pg_password=${SPARKCTL_PG_PASSWORD}
 module load apptainer
 
 if [ "${pg_exists}" != "true" ]; then
diff --git a/src/sparkctl/postgres/start_container.sh b/src/sparkctl/postgres/start_container.sh
index 8853e10..6c42aaf 100644
--- a/src/sparkctl/postgres/start_container.sh
+++ b/src/sparkctl/postgres/start_container.sh
@@ -1,7 +1,8 @@
 #!/bin/bash
 pg_data_dir=$1
 pg_run_dir=$2
-pg_password=$3
+# The password is passed through the environment so that it does not appear in process listings.
+pg_password=${SPARKCTL_PG_PASSWORD}
 
 # TODO: Make these configurable.
 lustre_bind_mounts=" -B /nopt:/nopt \
diff --git a/src/sparkctl/slurm_compute.py b/src/sparkctl/slurm_compute.py
index d80c1cd..ffda70d 100644
--- a/src/sparkctl/slurm_compute.py
+++ b/src/sparkctl/slurm_compute.py
@@ -3,21 +3,27 @@
 import subprocess
 from pathlib import Path
 from socket import gethostname
-from typing import Any
 
 from sparkctl.compute_interface import ComputeInterface
+from sparkctl.models import SparkConfig
 
 
 class SlurmCompute(ComputeInterface):
     """Provides interface to Slurm."""
 
+    def __init__(self, config: SparkConfig) -> None:
+        super().__init__(config)
+        # The node list does not change during a job, so cache it to avoid repeatedly shelling
+        # out to squeue/scontrol (get_node_names is called several times per configure/stop).
+        self._node_names: list[str] | None = None
+
     def get_node_memory_overhead_gb(
         self, driver_memory_gb: int, node_memory_overhead_gb: int
     ) -> int:
         if self.is_heterogeneous_slurm_job():
             return node_memory_overhead_gb
 
-        return driver_memory_gb + self._config.runtime.node_memory_overhead_gb
+        return driver_memory_gb + node_memory_overhead_gb
 
     def get_num_workers(self) -> int:
         master_node = gethostname()
@@ -31,7 +37,9 @@ def get_num_workers(self) -> int:
         return num_workers
 
     def get_node_names(self) -> list[str]:
-        return get_node_names(os.environ["SLURM_JOB_ID"])
+        if self._node_names is None:
+            self._node_names = get_node_names(os.environ["SLURM_JOB_ID"])
+        return self._node_names
 
     def get_worker_node_names(self) -> list[str]:
         node_names = self.get_node_names()
@@ -97,15 +105,12 @@ def run_checks(self) -> None:
 
 def get_node_names(job_id: str) -> list[str]:
     # The squeue command will produce multiple lines if the job is heterogeneous.
-    job_id = os.environ["SLURM_JOB_ID"]
-    output: dict[str, Any] = {}
     proc = subprocess.run(
         ["squeue", "-j", job_id, "--format", '"%5D %1000N"', "-h"], capture_output=True, check=True
     )
     host_lists = [x.strip().split()[1] for x in proc.stdout.decode("utf-8").splitlines() if x]
     final: list[str] = []
     for hosts in host_lists:
-        output.clear()
         proc = subprocess.run(
             ["scontrol", "show", "hostnames", hosts], capture_output=True, check=True
         )
diff --git a/src/sparkctl/spark_process_runner.py b/src/sparkctl/spark_process_runner.py
index 1fb6d2c..9d061e8 100644
--- a/src/sparkctl/spark_process_runner.py
+++ b/src/sparkctl/spark_process_runner.py
@@ -5,6 +5,7 @@
 import stat
 import subprocess
 import time
+from concurrent.futures import ThreadPoolExecutor, as_completed
 from pathlib import Path
 from typing import Any
 
@@ -34,7 +35,11 @@ def stop_master_process(self) -> int:
 
     def start_connect_server(self) -> None:
         """Start the Spark connect server."""
-        cmd = f"{self._start_connect_server_cmd()} --master {self._url}"
+        port = self._config.runtime.connect_server_port
+        cmd = (
+            f"{self._start_connect_server_cmd()} --master {self._url} "
+            f"--conf spark.connect.grpc.binding.port={port}"
+        )
         self._check_run_command(cmd)
 
     def stop_connect_server(self) -> int:
@@ -79,11 +84,15 @@ def start_worker_processes(
         start_script = self._sbin_cmd("start-worker.sh")
         tmp_script = self._make_start_worker_script(start_script, memory_gb)
         try:
-            for worker in workers:
-                cmd = ["ssh", worker, str(tmp_script)]
-                subprocess.run(cmd, check=True)
+            # Start the workers concurrently. ssh to each node is independent and otherwise
+            # serializes cluster startup across all worker nodes.
+            failures = self._run_ssh_commands(workers, str(tmp_script))
         finally:
             tmp_script.unlink()
+        if failures:
+            nodes = ", ".join(f"{worker} (rc={rc})" for worker, rc in failures.items())
+            msg = f"Failed to start Spark workers on the following node(s): {nodes}"
+            raise ExecutionError(msg)
 
     def stop_worker_process(self) -> int:
         """Stop the Spark workers."""
@@ -96,15 +105,34 @@ def stop_worker_processes(self, workers: list[str]) -> int:
             return self._stop_worker_processes_srun(workers)
 
         tmp_script = self._make_stop_worker_script(self._config.resource_monitor.enabled)
-        ret = 0
-        for worker in workers:
-            cmd = ["ssh", worker, str(tmp_script)]
-            proc = subprocess.run(cmd)
-            if proc.returncode != 0:
-                logger.error("Failed to stop worker on {}: {}", worker, proc.returncode)
-                ret = proc.returncode
-        tmp_script.unlink()
-        return ret
+        try:
+            # Stop the workers concurrently; ssh to each node is independent.
+            failures = self._run_ssh_commands(workers, str(tmp_script))
+        finally:
+            tmp_script.unlink()
+        for worker, rc in failures.items():
+            logger.error("Failed to stop worker on {}: {}", worker, rc)
+        return next(iter(failures.values()), 0)
+
+    @staticmethod
+    def _run_ssh_commands(workers: list[str], script: str) -> dict[str, int]:
+        """Run the script on each worker over ssh concurrently.
+
+        Returns a mapping of worker node name to non-zero return code for any node that failed.
+        """
+
+        def run_one(worker: str) -> int:
+            return subprocess.run(["ssh", worker, script]).returncode
+
+        failures: dict[str, int] = {}
+        with ThreadPoolExecutor(max_workers=max(1, len(workers))) as executor:
+            futures = {executor.submit(run_one, worker): worker for worker in workers}
+            for future in as_completed(futures):
+                worker = futures[future]
+                rc = future.result()
+                if rc != 0:
+                    failures[worker] = rc
+        return failures
 
     def _use_srun(self) -> bool:
         if self._config.compute.environment != ComputeEnvironment.SLURM:
diff --git a/tests/test_spark_process_runner.py b/tests/test_spark_process_runner.py
index 85184fd..3e5df61 100644
--- a/tests/test_spark_process_runner.py
+++ b/tests/test_spark_process_runner.py
@@ -122,9 +122,10 @@ def fake_run(cmd, **kwargs):
     runner = SparkProcessRunner(config, SPARK_URL)
     runner.start_worker_processes(["node1", "node2"], 80)
 
+    # The workers are started concurrently, so the command order is not deterministic.
     assert len(commands) == 2
     assert [cmd[0] for cmd in commands] == ["ssh", "ssh"]
-    assert [cmd[1] for cmd in commands] == ["node1", "node2"]
+    assert {cmd[1] for cmd in commands} == {"node1", "node2"}
 
 
 def test_start_worker_processes_slurm_use_srun_disabled_uses_ssh(tmp_path, monkeypatch):

From da7cd71ac73ad62958df5dc9327b0f43b5c41cc8 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 08:56:55 -0600
Subject: [PATCH 02/24] Switch tooling to prek/ty/uv

Replace mypy with ty and pre-commit with prek, and standardize on uv for
environment management and CI, matching the datasight conventions.

- pyproject: drop mypy/pre-commit dev deps; add prek, ty, and an explicit
  ruff pin. Replace [tool.mypy] with [tool.ty.src] (include src/tests,
  exclude vendored tests/data).
- .pre-commit-config.yaml: bump ruff-pre-commit and run ty via a local hook
  (uv run ty check) instead of mypy.
- CI: run lint (ruff check, ruff format --check) and ty through uv; install
  with uv sync --frozen. Convert the docs and PyPI publish workflows to uv.
- config.py: annotate the RUNTIME/APP settings dicts as dict[str, Any] so the
  **dict model construction type-checks under ty, and drop the now-unused
  dynaconf type: ignore.
- README: document the uv/ruff/ty/prek development workflow.
- Commit uv.lock so uv sync --frozen works in CI.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .github/workflows/ci.yml              |   74 +-
 .github/workflows/gh-pages.yml        |   15 +-
 .github/workflows/publish_to_pypi.yml |   14 +-
 .pre-commit-config.yaml               |   29 +-
 README.md                             |   26 +-
 pyproject.toml                        |   17 +-
 src/sparkctl/config.py                |    7 +-
 uv.lock                               | 1534 +++++++++++++++++++++++++
 8 files changed, 1629 insertions(+), 87 deletions(-)
 create mode 100644 uv.lock

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index a99fdf3..23727f7 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -11,52 +11,46 @@ env:
   DEFAULT_OS: ubuntu-latest
 
 jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+          enable-cache: false
+      - name: Install Python project
+        run: uv sync --extra dev --frozen
+      - name: Run Ruff lint
+        run: uv run ruff check .
+      - name: Check Ruff formatting
+        run: uv run ruff format --check .
+      - name: Run ty
+        run: uv run ty check
+
   pytest:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
         python-version: ["3.12", "3.13"]
         os: [ubuntu-latest]
-
-    steps:
-    - uses: actions/checkout@v4
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ matrix.python-version }}
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        python -m pip install ".[dev]"
-    - name: Run pytest with coverage
-      run: |
-        pytest -v -m "not integration" --cov --cov-report=xml
-    - name: codecov
-      uses: codecov/codecov-action@v4.2.0
-      if: ${{ matrix.os == env.DEFAULT_OS && matrix.python-version == env.DEFAULT_PYTHON  }}
-      with:
-        token: ${{ secrets.CODECOV_TOKEN }}
-        name: sparkctl-tests
-        fail_ci_if_error: false
-        verbose: true
-  mypy:
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v4
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: 3.12
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        python -m pip install ".[dev]"
-        mypy
-  ruff:
-    runs-on: ubuntu-latest
-    name: "ruff"
     steps:
       - uses: actions/checkout@v4
-      - uses: chartboost/ruff-action@v1
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: false
+      - name: Install Python project
+        run: uv sync --extra dev --frozen
+      - name: Run pytest with coverage
+        run: uv run pytest -v -m "not integration" --cov --cov-report=xml
+      - name: codecov
+        uses: codecov/codecov-action@v4.2.0
+        if: ${{ matrix.os == env.DEFAULT_OS && matrix.python-version == env.DEFAULT_PYTHON }}
         with:
-          src: "./src"
+          token: ${{ secrets.CODECOV_TOKEN }}
+          name: sparkctl-tests
+          fail_ci_if_error: false
+          verbose: true
diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml
index b4a5e10..b940b2b 100644
--- a/.github/workflows/gh-pages.yml
+++ b/.github/workflows/gh-pages.yml
@@ -9,19 +9,18 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: select python version
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: "3.12"
-      - name: install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          python -m pip install ".[dev]"
+          enable-cache: false
+      - name: Install Python project
+        run: uv sync --extra dev --frozen
       - name: build documentation
         run: |
           cd docs
-          make clean
-          make html
+          uv run make clean
+          uv run make html
       - name: deploy
         uses: peaceiris/actions-gh-pages@v3.6.1
         with:
diff --git a/.github/workflows/publish_to_pypi.yml b/.github/workflows/publish_to_pypi.yml
index c20fa5f..3b111a5 100644
--- a/.github/workflows/publish_to_pypi.yml
+++ b/.github/workflows/publish_to_pypi.yml
@@ -11,16 +11,12 @@ jobs:
         id-token: write
       steps:    
       - uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: "3.12"
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          python -m pip install build
-      - name: Build and publish
-        run: |
-          python -m build
+          enable-cache: false
+      - name: Build
+        run: uv build
       - name: Publish package distributions to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 025a30a..2b810ef 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,15 +1,16 @@
 repos:
-- repo: https://github.com/astral-sh/ruff-pre-commit
-  # Ruff version.
-  rev: v0.2.1
-  hooks:
-    # Run the linter.
-    - id: ruff
-      args: [ --fix ]
-    # Run the formatter.
-    - id: ruff-format
-- repo: https://github.com/pre-commit/mirrors-mypy
-  rev: v1.13.0
-  hooks:
-  - id: mypy
-    language: system
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.8
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: local
+    hooks:
+      - id: ty
+        name: ty (type check)
+        entry: uv run ty check
+        language: system
+        types: [python]
+        pass_filenames: false
diff --git a/README.md b/README.md
index 608d061..b187cc3 100644
--- a/README.md
+++ b/README.md
@@ -49,24 +49,40 @@ support.
 Contributions are welcome.
 
 ## Development
-Install the package with its development dependencies:
+This project uses [uv](https://docs.astral.sh/uv/) for environment management. Install the
+package with its development dependencies:
 ```console
-$ pip install -e ".[dev]"
+$ uv sync --extra dev
+```
+
+Lint, format, and type-check the code with [ruff](https://docs.astral.sh/ruff/) and
+[ty](https://github.com/astral-sh/ty):
+```console
+$ uv run ruff check .
+$ uv run ruff format --check .
+$ uv run ty check
+```
+
+These checks also run as Git hooks via [prek](https://github.com/j178/prek). Install the hooks
+once and then run them on demand:
+```console
+$ uv run prek install
+$ uv run prek run --all-files
 ```
 
 Run the unit tests. These are fast, require no special resources, and are what CI runs:
 ```console
-$ pytest -m "not integration"
+$ uv run pytest -m "not integration"
 ```
 
 The integration tests download a real Spark and Java distribution into `tests/data/` and start a
 real single-node Spark cluster, so they are slower and require network access and sufficient
 memory. They are excluded from CI; run them locally with:
 ```console
-$ pytest -m integration
+$ uv run pytest -m integration
 ```
 
-Run the complete suite (unit and integration tests) with `pytest`.
+Run the complete suite (unit and integration tests) with `uv run pytest`.
 
 ## License
 sparkctl is released under a BSD 3-Clause [license](https://github.com/NatLabRockies/sparkctl/blob/main/LICENSE).
diff --git a/pyproject.toml b/pyproject.toml
index 9b6195a..a7d2db5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -41,18 +41,19 @@ pyspark = [
 ]
 dev = [
     "furo",
-    "mypy >=1.13, < 2",
     "myst_parser",
-    "pre-commit",
+    "prek >= 0.2, < 1",
     "pytest",
     "pytest-cov",
     "requests",
+    "ruff >= 0.15, < 1",
     "sphinx",
     "sphinx-click",
     "sphinx-copybutton",
     "sphinxcontrib-mermaid",
     "autodoc_pydantic~=2.0",
     "sphinx-tabs~=3.4",
+    "ty >= 0.0.26",
     "types-requests",
     "types-toml",
 ]
@@ -71,15 +72,15 @@ where = ["src"]
 [tool.setuptools.package-data]
 "*" = ["*.sh", "*.conf", "*.properties", "*.template"]
 
-[tool.mypy]
-check_untyped_defs = true
+[tool.ty.src]
+include = [
+    "src",
+    "tests",
+]
+# Exclude vendored third-party code (Spark/Hadoop/Hive/JDK) downloaded by the integration tests.
 exclude = [
     "tests/data",
 ]
-files = [
-  "src",
-  "tests",
-]
 
 [tool.pytest.ini_options]
 pythonpath = "src"
diff --git a/src/sparkctl/config.py b/src/sparkctl/config.py
index 8b86c2d..0e25b60 100644
--- a/src/sparkctl/config.py
+++ b/src/sparkctl/config.py
@@ -1,7 +1,8 @@
 import os
 from pathlib import Path
+from typing import Any
 
-from dynaconf import Dynaconf, Validator  # type: ignore
+from dynaconf import Dynaconf, Validator
 from rich import print
 
 from sparkctl.exceptions import InvalidConfiguration
@@ -39,7 +40,7 @@ def _build_settings_files() -> list[Path]:
     return files
 
 
-RUNTIME = {
+RUNTIME: dict[str, Any] = {
     "executor_cores": SparkRuntimeParams.model_fields["executor_cores"].default,
     "executor_memory_gb": SparkRuntimeParams.model_fields["executor_memory_gb"].default,
     "driver_memory_gb": SparkRuntimeParams.model_fields["driver_memory_gb"].default,
@@ -63,7 +64,7 @@ def _build_settings_files() -> list[Path]:
     "postgres_password": None,
     "spark_defaults_template_file": None,
 }
-APP = {
+APP: dict[str, Any] = {
     "console_level": AppParams.model_fields["console_level"].default,
     "file_level": AppParams.model_fields["file_level"].default,
     "reraise_exceptions": AppParams.model_fields["reraise_exceptions"].default,
diff --git a/uv.lock b/uv.lock
new file mode 100644
index 0000000..b901090
--- /dev/null
+++ b/uv.lock
@@ -0,0 +1,1534 @@
+version = 1
+revision = 3
+requires-python = ">=3.11, <3.14"
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version < '3.12'",
+]
+
+[[package]]
+name = "accessible-pygments"
+version = "0.0.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/bc/c1/bbac6a50d02774f91572938964c582fff4270eee73ab822a4aeea4d8b11b/accessible_pygments-0.0.5.tar.gz", hash = "sha256:40918d3e6a2b619ad424cb91e556bd3bd8865443d9f22f1dcdf79e33c8046872", size = 1377899, upload-time = "2024-05-10T11:23:10.216Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8d/3f/95338030883d8c8b91223b4e21744b04d11b161a3ef117295d8241f50ab4/accessible_pygments-0.0.5-py3-none-any.whl", hash = "sha256:88ae3211e68a1d0b011504b2ffc1691feafce124b845bd072ab6f9f66f34d4b7", size = 1395903, upload-time = "2024-05-10T11:23:08.421Z" },
+]
+
+[[package]]
+name = "alabaster"
+version = "1.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a6/f8/d9c74d0daf3f742840fd818d69cfae176fa332022fd44e3469487d5a9420/alabaster-1.0.0.tar.gz", hash = "sha256:c00dca57bca26fa62a6d7d0a9fcce65f3e026e9bfe33e9c538fd3fbb2144fd9e", size = 24210, upload-time = "2024-07-26T18:15:03.762Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/b3/6b4067be973ae96ba0d615946e314c5ae35f9f993eca561b356540bb0c2b/alabaster-1.0.0-py3-none-any.whl", hash = "sha256:fc6786402dc3fcb2de3cabd5fe455a2db534b371124f1f21de8731783dec828b", size = 13929, upload-time = "2024-07-26T18:15:02.05Z" },
+]
+
+[[package]]
+name = "annotated-types"
+version = "0.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
+]
+
+[[package]]
+name = "autodoc-pydantic"
+version = "2.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pydantic" },
+    { name = "pydantic-settings" },
+    { name = "sphinx" },
+]
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7b/df/87120e2195f08d760bc5cf8a31cfa2381a6887517aa89453b23f1ae3354f/autodoc_pydantic-2.2.0-py3-none-any.whl", hash = "sha256:8c6a36fbf6ed2700ea9c6d21ea76ad541b621fbdf16b5a80ee04673548af4d95", size = 34001, upload-time = "2024-04-27T10:57:00.542Z" },
+]
+
+[[package]]
+name = "babel"
+version = "2.17.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7d/6b/d52e42361e1aa00709585ecc30b3f9684b3ab62530771402248b1b1d6240/babel-2.17.0.tar.gz", hash = "sha256:0c54cffb19f690cdcc52a3b50bcbf71e07a808d1c80d549f2459b9d2cf0afb9d", size = 9951852, upload-time = "2025-02-01T15:17:41.026Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/b8/3fe70c75fe32afc4bb507f75563d39bc5642255d1d94f1f23604725780bf/babel-2.17.0-py3-none-any.whl", hash = "sha256:4d0b53093fdfb4b21c92b5213dba5a1b23885afa8383709427046b21c366e5f2", size = 10182537, upload-time = "2025-02-01T15:17:37.39Z" },
+]
+
+[[package]]
+name = "beautifulsoup4"
+version = "4.14.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "soupsieve" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b0/1c6a16426d389813b48d95e26898aff79abbde42ad353958ad95cc8c9b21/beautifulsoup4-4.14.3.tar.gz", hash = "sha256:6292b1c5186d356bba669ef9f7f051757099565ad9ada5dd630bd9de5fa7fb86", size = 627737, upload-time = "2025-11-30T15:08:26.084Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1a/39/47f9197bdd44df24d67ac8893641e16f386c984a0619ef2ee4c51fbbc019/beautifulsoup4-4.14.3-py3-none-any.whl", hash = "sha256:0918bfe44902e6ad8d57732ba310582e98da931428d231a5ecb9e7c703a735bb", size = 107721, upload-time = "2025-11-30T15:08:24.087Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.1.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e0/2d/a891ca51311197f6ad14a7ef42e2399f36cf2f9bd44752b3dc4eab60fdc5/certifi-2026.1.4.tar.gz", hash = "sha256:ac726dd470482006e014ad384921ed6438c457018f4b3d204aea4281258b2120", size = 154268, upload-time = "2026-01-04T02:42:41.825Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e6/ad/3cc14f097111b4de0040c83a525973216457bbeeb63739ef1ed275c1c021/certifi-2026.1.4-py3-none-any.whl", hash = "sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c", size = 152900, upload-time = "2026-01-04T02:42:40.15Z" },
+]
+
+[[package]]
+name = "charset-normalizer"
+version = "3.4.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/13/69/33ddede1939fdd074bce5434295f38fae7136463422fe4fd3e0e89b98062/charset_normalizer-3.4.4.tar.gz", hash = "sha256:94537985111c35f28720e43603b8e7b43a6ecfb2ce1d3058bbe955b73404e21a", size = 129418, upload-time = "2025-10-14T04:42:32.879Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ed/27/c6491ff4954e58a10f69ad90aca8a1b6fe9c5d3c6f380907af3c37435b59/charset_normalizer-3.4.4-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:6e1fcf0720908f200cd21aa4e6750a48ff6ce4afe7ff5a79a90d5ed8a08296f8", size = 206988, upload-time = "2025-10-14T04:40:33.79Z" },
+    { url = "https://files.pythonhosted.org/packages/94/59/2e87300fe67ab820b5428580a53cad894272dbb97f38a7a814a2a1ac1011/charset_normalizer-3.4.4-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5f819d5fe9234f9f82d75bdfa9aef3a3d72c4d24a6e57aeaebba32a704553aa0", size = 147324, upload-time = "2025-10-14T04:40:34.961Z" },
+    { url = "https://files.pythonhosted.org/packages/07/fb/0cf61dc84b2b088391830f6274cb57c82e4da8bbc2efeac8c025edb88772/charset_normalizer-3.4.4-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:a59cb51917aa591b1c4e6a43c132f0cdc3c76dbad6155df4e28ee626cc77a0a3", size = 142742, upload-time = "2025-10-14T04:40:36.105Z" },
+    { url = "https://files.pythonhosted.org/packages/62/8b/171935adf2312cd745d290ed93cf16cf0dfe320863ab7cbeeae1dcd6535f/charset_normalizer-3.4.4-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:8ef3c867360f88ac904fd3f5e1f902f13307af9052646963ee08ff4f131adafc", size = 160863, upload-time = "2025-10-14T04:40:37.188Z" },
+    { url = "https://files.pythonhosted.org/packages/09/73/ad875b192bda14f2173bfc1bc9a55e009808484a4b256748d931b6948442/charset_normalizer-3.4.4-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d9e45d7faa48ee908174d8fe84854479ef838fc6a705c9315372eacbc2f02897", size = 157837, upload-time = "2025-10-14T04:40:38.435Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/fc/de9cce525b2c5b94b47c70a4b4fb19f871b24995c728e957ee68ab1671ea/charset_normalizer-3.4.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:840c25fb618a231545cbab0564a799f101b63b9901f2569faecd6b222ac72381", size = 151550, upload-time = "2025-10-14T04:40:40.053Z" },
+    { url = "https://files.pythonhosted.org/packages/55/c2/43edd615fdfba8c6f2dfbd459b25a6b3b551f24ea21981e23fb768503ce1/charset_normalizer-3.4.4-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ca5862d5b3928c4940729dacc329aa9102900382fea192fc5e52eb69d6093815", size = 149162, upload-time = "2025-10-14T04:40:41.163Z" },
+    { url = "https://files.pythonhosted.org/packages/03/86/bde4ad8b4d0e9429a4e82c1e8f5c659993a9a863ad62c7df05cf7b678d75/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d9c7f57c3d666a53421049053eaacdd14bbd0a528e2186fcb2e672effd053bb0", size = 150019, upload-time = "2025-10-14T04:40:42.276Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/86/a151eb2af293a7e7bac3a739b81072585ce36ccfb4493039f49f1d3cae8c/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:277e970e750505ed74c832b4bf75dac7476262ee2a013f5574dd49075879e161", size = 143310, upload-time = "2025-10-14T04:40:43.439Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/fe/43dae6144a7e07b87478fdfc4dbe9efd5defb0e7ec29f5f58a55aeef7bf7/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:31fd66405eaf47bb62e8cd575dc621c56c668f27d46a61d975a249930dd5e2a4", size = 162022, upload-time = "2025-10-14T04:40:44.547Z" },
+    { url = "https://files.pythonhosted.org/packages/80/e6/7aab83774f5d2bca81f42ac58d04caf44f0cc2b65fc6db2b3b2e8a05f3b3/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:0d3d8f15c07f86e9ff82319b3d9ef6f4bf907608f53fe9d92b28ea9ae3d1fd89", size = 149383, upload-time = "2025-10-14T04:40:46.018Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/e8/b289173b4edae05c0dde07f69f8db476a0b511eac556dfe0d6bda3c43384/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:9f7fcd74d410a36883701fafa2482a6af2ff5ba96b9a620e9e0721e28ead5569", size = 159098, upload-time = "2025-10-14T04:40:47.081Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/df/fe699727754cae3f8478493c7f45f777b17c3ef0600e28abfec8619eb49c/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ebf3e58c7ec8a8bed6d66a75d7fb37b55e5015b03ceae72a8e7c74495551e224", size = 152991, upload-time = "2025-10-14T04:40:48.246Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/86/584869fe4ddb6ffa3bd9f491b87a01568797fb9bd8933f557dba9771beaf/charset_normalizer-3.4.4-cp311-cp311-win32.whl", hash = "sha256:eecbc200c7fd5ddb9a7f16c7decb07b566c29fa2161a16cf67b8d068bd21690a", size = 99456, upload-time = "2025-10-14T04:40:49.376Z" },
+    { url = "https://files.pythonhosted.org/packages/65/f6/62fdd5feb60530f50f7e38b4f6a1d5203f4d16ff4f9f0952962c044e919a/charset_normalizer-3.4.4-cp311-cp311-win_amd64.whl", hash = "sha256:5ae497466c7901d54b639cf42d5b8c1b6a4fead55215500d2f486d34db48d016", size = 106978, upload-time = "2025-10-14T04:40:50.844Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/9d/0710916e6c82948b3be62d9d398cb4fcf4e97b56d6a6aeccd66c4b2f2bd5/charset_normalizer-3.4.4-cp311-cp311-win_arm64.whl", hash = "sha256:65e2befcd84bc6f37095f5961e68a6f077bf44946771354a28ad434c2cce0ae1", size = 99969, upload-time = "2025-10-14T04:40:52.272Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/85/1637cd4af66fa687396e757dec650f28025f2a2f5a5531a3208dc0ec43f2/charset_normalizer-3.4.4-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:0a98e6759f854bd25a58a73fa88833fba3b7c491169f86ce1180c948ab3fd394", size = 208425, upload-time = "2025-10-14T04:40:53.353Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/6a/04130023fef2a0d9c62d0bae2649b69f7b7d8d24ea5536feef50551029df/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b5b290ccc2a263e8d185130284f8501e3e36c5e02750fc6b6bdeb2e9e96f1e25", size = 148162, upload-time = "2025-10-14T04:40:54.558Z" },
+    { url = "https://files.pythonhosted.org/packages/78/29/62328d79aa60da22c9e0b9a66539feae06ca0f5a4171ac4f7dc285b83688/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74bb723680f9f7a6234dcf67aea57e708ec1fbdf5699fb91dfd6f511b0a320ef", size = 144558, upload-time = "2025-10-14T04:40:55.677Z" },
+    { url = "https://files.pythonhosted.org/packages/86/bb/b32194a4bf15b88403537c2e120b817c61cd4ecffa9b6876e941c3ee38fe/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f1e34719c6ed0b92f418c7c780480b26b5d9c50349e9a9af7d76bf757530350d", size = 161497, upload-time = "2025-10-14T04:40:57.217Z" },
+    { url = "https://files.pythonhosted.org/packages/19/89/a54c82b253d5b9b111dc74aca196ba5ccfcca8242d0fb64146d4d3183ff1/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2437418e20515acec67d86e12bf70056a33abdacb5cb1655042f6538d6b085a8", size = 159240, upload-time = "2025-10-14T04:40:58.358Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/10/d20b513afe03acc89ec33948320a5544d31f21b05368436d580dec4e234d/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:11d694519d7f29d6cd09f6ac70028dba10f92f6cdd059096db198c283794ac86", size = 153471, upload-time = "2025-10-14T04:40:59.468Z" },
+    { url = "https://files.pythonhosted.org/packages/61/fa/fbf177b55bdd727010f9c0a3c49eefa1d10f960e5f09d1d887bf93c2e698/charset_normalizer-3.4.4-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ac1c4a689edcc530fc9d9aa11f5774b9e2f33f9a0c6a57864e90908f5208d30a", size = 150864, upload-time = "2025-10-14T04:41:00.623Z" },
+    { url = "https://files.pythonhosted.org/packages/05/12/9fbc6a4d39c0198adeebbde20b619790e9236557ca59fc40e0e3cebe6f40/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:21d142cc6c0ec30d2efee5068ca36c128a30b0f2c53c1c07bd78cb6bc1d3be5f", size = 150647, upload-time = "2025-10-14T04:41:01.754Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/1f/6a9a593d52e3e8c5d2b167daf8c6b968808efb57ef4c210acb907c365bc4/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:5dbe56a36425d26d6cfb40ce79c314a2e4dd6211d51d6d2191c00bed34f354cc", size = 145110, upload-time = "2025-10-14T04:41:03.231Z" },
+    { url = "https://files.pythonhosted.org/packages/30/42/9a52c609e72471b0fc54386dc63c3781a387bb4fe61c20231a4ebcd58bdd/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:5bfbb1b9acf3334612667b61bd3002196fe2a1eb4dd74d247e0f2a4d50ec9bbf", size = 162839, upload-time = "2025-10-14T04:41:04.715Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/5b/c0682bbf9f11597073052628ddd38344a3d673fda35a36773f7d19344b23/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:d055ec1e26e441f6187acf818b73564e6e6282709e9bcb5b63f5b23068356a15", size = 150667, upload-time = "2025-10-14T04:41:05.827Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/24/a41afeab6f990cf2daf6cb8c67419b63b48cf518e4f56022230840c9bfb2/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:af2d8c67d8e573d6de5bc30cdb27e9b95e49115cd9baad5ddbd1a6207aaa82a9", size = 160535, upload-time = "2025-10-14T04:41:06.938Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/e5/6a4ce77ed243c4a50a1fecca6aaaab419628c818a49434be428fe24c9957/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:780236ac706e66881f3b7f2f32dfe90507a09e67d1d454c762cf642e6e1586e0", size = 154816, upload-time = "2025-10-14T04:41:08.101Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/ef/89297262b8092b312d29cdb2517cb1237e51db8ecef2e9af5edbe7b683b1/charset_normalizer-3.4.4-cp312-cp312-win32.whl", hash = "sha256:5833d2c39d8896e4e19b689ffc198f08ea58116bee26dea51e362ecc7cd3ed26", size = 99694, upload-time = "2025-10-14T04:41:09.23Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/2d/1e5ed9dd3b3803994c155cd9aacb60c82c331bad84daf75bcb9c91b3295e/charset_normalizer-3.4.4-cp312-cp312-win_amd64.whl", hash = "sha256:a79cfe37875f822425b89a82333404539ae63dbdddf97f84dcbc3d339aae9525", size = 107131, upload-time = "2025-10-14T04:41:10.467Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/d9/0ed4c7098a861482a7b6a95603edce4c0d9db2311af23da1fb2b75ec26fc/charset_normalizer-3.4.4-cp312-cp312-win_arm64.whl", hash = "sha256:376bec83a63b8021bb5c8ea75e21c4ccb86e7e45ca4eb81146091b56599b80c3", size = 100390, upload-time = "2025-10-14T04:41:11.915Z" },
+    { url = "https://files.pythonhosted.org/packages/97/45/4b3a1239bbacd321068ea6e7ac28875b03ab8bc0aa0966452db17cd36714/charset_normalizer-3.4.4-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:e1f185f86a6f3403aa2420e815904c67b2f9ebc443f045edd0de921108345794", size = 208091, upload-time = "2025-10-14T04:41:13.346Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/62/73a6d7450829655a35bb88a88fca7d736f9882a27eacdca2c6d505b57e2e/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b39f987ae8ccdf0d2642338faf2abb1862340facc796048b604ef14919e55ed", size = 147936, upload-time = "2025-10-14T04:41:14.461Z" },
+    { url = "https://files.pythonhosted.org/packages/89/c5/adb8c8b3d6625bef6d88b251bbb0d95f8205831b987631ab0c8bb5d937c2/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3162d5d8ce1bb98dd51af660f2121c55d0fa541b46dff7bb9b9f86ea1d87de72", size = 144180, upload-time = "2025-10-14T04:41:15.588Z" },
+    { url = "https://files.pythonhosted.org/packages/91/ed/9706e4070682d1cc219050b6048bfd293ccf67b3d4f5a4f39207453d4b99/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:81d5eb2a312700f4ecaa977a8235b634ce853200e828fbadf3a9c50bab278328", size = 161346, upload-time = "2025-10-14T04:41:16.738Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/0d/031f0d95e4972901a2f6f09ef055751805ff541511dc1252ba3ca1f80cf5/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5bd2293095d766545ec1a8f612559f6b40abc0eb18bb2f5d1171872d34036ede", size = 158874, upload-time = "2025-10-14T04:41:17.923Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/83/6ab5883f57c9c801ce5e5677242328aa45592be8a00644310a008d04f922/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a8a8b89589086a25749f471e6a900d3f662d1d3b6e2e59dcecf787b1cc3a1894", size = 153076, upload-time = "2025-10-14T04:41:19.106Z" },
+    { url = "https://files.pythonhosted.org/packages/75/1e/5ff781ddf5260e387d6419959ee89ef13878229732732ee73cdae01800f2/charset_normalizer-3.4.4-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc7637e2f80d8530ee4a78e878bce464f70087ce73cf7c1caf142416923b98f1", size = 150601, upload-time = "2025-10-14T04:41:20.245Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/57/71be810965493d3510a6ca79b90c19e48696fb1ff964da319334b12677f0/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f8bf04158c6b607d747e93949aa60618b61312fe647a6369f88ce2ff16043490", size = 150376, upload-time = "2025-10-14T04:41:21.398Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/d5/c3d057a78c181d007014feb7e9f2e65905a6c4ef182c0ddf0de2924edd65/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:554af85e960429cf30784dd47447d5125aaa3b99a6f0683589dbd27e2f45da44", size = 144825, upload-time = "2025-10-14T04:41:22.583Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/8c/d0406294828d4976f275ffbe66f00266c4b3136b7506941d87c00cab5272/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:74018750915ee7ad843a774364e13a3db91682f26142baddf775342c3f5b1133", size = 162583, upload-time = "2025-10-14T04:41:23.754Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/24/e2aa1f18c8f15c4c0e932d9287b8609dd30ad56dbe41d926bd846e22fb8d/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c0463276121fdee9c49b98908b3a89c39be45d86d1dbaa22957e38f6321d4ce3", size = 150366, upload-time = "2025-10-14T04:41:25.27Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/5b/1e6160c7739aad1e2df054300cc618b06bf784a7a164b0f238360721ab86/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:362d61fd13843997c1c446760ef36f240cf81d3ebf74ac62652aebaf7838561e", size = 160300, upload-time = "2025-10-14T04:41:26.725Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/10/f882167cd207fbdd743e55534d5d9620e095089d176d55cb22d5322f2afd/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9a26f18905b8dd5d685d6d07b0cdf98a79f3c7a918906af7cc143ea2e164c8bc", size = 154465, upload-time = "2025-10-14T04:41:28.322Z" },
+    { url = "https://files.pythonhosted.org/packages/89/66/c7a9e1b7429be72123441bfdbaf2bc13faab3f90b933f664db506dea5915/charset_normalizer-3.4.4-cp313-cp313-win32.whl", hash = "sha256:9b35f4c90079ff2e2edc5b26c0c77925e5d2d255c42c74fdb70fb49b172726ac", size = 99404, upload-time = "2025-10-14T04:41:29.95Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/26/b9924fa27db384bdcd97ab83b4f0a8058d96ad9626ead570674d5e737d90/charset_normalizer-3.4.4-cp313-cp313-win_amd64.whl", hash = "sha256:b435cba5f4f750aa6c0a0d92c541fb79f69a387c91e61f1795227e4ed9cece14", size = 107092, upload-time = "2025-10-14T04:41:31.188Z" },
+    { url = "https://files.pythonhosted.org/packages/af/8f/3ed4bfa0c0c72a7ca17f0380cd9e4dd842b09f664e780c13cff1dcf2ef1b/charset_normalizer-3.4.4-cp313-cp313-win_arm64.whl", hash = "sha256:542d2cee80be6f80247095cc36c418f7bddd14f4a6de45af91dfad36d817bba2", size = 100408, upload-time = "2025-10-14T04:41:32.624Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/4c/925909008ed5a988ccbb72dcc897407e5d6d3bd72410d69e051fc0c14647/charset_normalizer-3.4.4-py3-none-any.whl", hash = "sha256:7a32c560861a02ff789ad905a2fe94e3f840803362c84fecf1851cb4cf3dc37f", size = 53402, upload-time = "2025-10-14T04:42:31.76Z" },
+]
+
+[[package]]
+name = "click"
+version = "8.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a", size = 295065, upload-time = "2025-11-15T20:45:42.706Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6", size = 108274, upload-time = "2025-11-15T20:45:41.139Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "coverage"
+version = "7.13.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/23/f9/e92df5e07f3fc8d4c7f9a0f146ef75446bf870351cd37b788cf5897f8079/coverage-7.13.1.tar.gz", hash = "sha256:b7593fe7eb5feaa3fbb461ac79aac9f9fc0387a5ca8080b0c6fe2ca27b091afd", size = 825862, upload-time = "2025-12-28T15:42:56.969Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b4/9b/77baf488516e9ced25fc215a6f75d803493fc3f6a1a1227ac35697910c2a/coverage-7.13.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1a55d509a1dc5a5b708b5dad3b5334e07a16ad4c2185e27b40e4dba796ab7f88", size = 218755, upload-time = "2025-12-28T15:40:30.812Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/cd/7ab01154e6eb79ee2fab76bf4d89e94c6648116557307ee4ebbb85e5c1bf/coverage-7.13.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4d010d080c4888371033baab27e47c9df7d6fb28d0b7b7adf85a4a49be9298b3", size = 219257, upload-time = "2025-12-28T15:40:32.333Z" },
+    { url = "https://files.pythonhosted.org/packages/01/d5/b11ef7863ffbbdb509da0023fad1e9eda1c0eaea61a6d2ea5b17d4ac706e/coverage-7.13.1-cp311-cp311-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:d938b4a840fb1523b9dfbbb454f652967f18e197569c32266d4d13f37244c3d9", size = 249657, upload-time = "2025-12-28T15:40:34.1Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/7c/347280982982383621d29b8c544cf497ae07ac41e44b1ca4903024131f55/coverage-7.13.1-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:bf100a3288f9bb7f919b87eb84f87101e197535b9bd0e2c2b5b3179633324fee", size = 251581, upload-time = "2025-12-28T15:40:36.131Z" },
+    { url = "https://files.pythonhosted.org/packages/82/f6/ebcfed11036ade4c0d75fa4453a6282bdd225bc073862766eec184a4c643/coverage-7.13.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ef6688db9bf91ba111ae734ba6ef1a063304a881749726e0d3575f5c10a9facf", size = 253691, upload-time = "2025-12-28T15:40:37.626Z" },
+    { url = "https://files.pythonhosted.org/packages/02/92/af8f5582787f5d1a8b130b2dcba785fa5e9a7a8e121a0bb2220a6fdbdb8a/coverage-7.13.1-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0b609fc9cdbd1f02e51f67f51e5aee60a841ef58a68d00d5ee2c0faf357481a3", size = 249799, upload-time = "2025-12-28T15:40:39.47Z" },
+    { url = "https://files.pythonhosted.org/packages/24/aa/0e39a2a3b16eebf7f193863323edbff38b6daba711abaaf807d4290cf61a/coverage-7.13.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:c43257717611ff5e9a1d79dce8e47566235ebda63328718d9b65dd640bc832ef", size = 251389, upload-time = "2025-12-28T15:40:40.954Z" },
+    { url = "https://files.pythonhosted.org/packages/73/46/7f0c13111154dc5b978900c0ccee2e2ca239b910890e674a77f1363d483e/coverage-7.13.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:e09fbecc007f7b6afdfb3b07ce5bd9f8494b6856dd4f577d26c66c391b829851", size = 249450, upload-time = "2025-12-28T15:40:42.489Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/ca/e80da6769e8b669ec3695598c58eef7ad98b0e26e66333996aee6316db23/coverage-7.13.1-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:a03a4f3a19a189919c7055098790285cc5c5b0b3976f8d227aea39dbf9f8bfdb", size = 249170, upload-time = "2025-12-28T15:40:44.279Z" },
+    { url = "https://files.pythonhosted.org/packages/af/18/9e29baabdec1a8644157f572541079b4658199cfd372a578f84228e860de/coverage-7.13.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:3820778ea1387c2b6a818caec01c63adc5b3750211af6447e8dcfb9b6f08dbba", size = 250081, upload-time = "2025-12-28T15:40:45.748Z" },
+    { url = "https://files.pythonhosted.org/packages/00/f8/c3021625a71c3b2f516464d322e41636aea381018319050a8114105872ee/coverage-7.13.1-cp311-cp311-win32.whl", hash = "sha256:ff10896fa55167371960c5908150b434b71c876dfab97b69478f22c8b445ea19", size = 221281, upload-time = "2025-12-28T15:40:47.232Z" },
+    { url = "https://files.pythonhosted.org/packages/27/56/c216625f453df6e0559ed666d246fcbaaa93f3aa99eaa5080cea1229aa3d/coverage-7.13.1-cp311-cp311-win_amd64.whl", hash = "sha256:a998cc0aeeea4c6d5622a3754da5a493055d2d95186bad877b0a34ea6e6dbe0a", size = 222215, upload-time = "2025-12-28T15:40:49.19Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/9a/be342e76f6e531cae6406dc46af0d350586f24d9b67fdfa6daee02df71af/coverage-7.13.1-cp311-cp311-win_arm64.whl", hash = "sha256:fea07c1a39a22614acb762e3fbbb4011f65eedafcb2948feeef641ac78b4ee5c", size = 220886, upload-time = "2025-12-28T15:40:51.067Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/8a/87af46cccdfa78f53db747b09f5f9a21d5fc38d796834adac09b30a8ce74/coverage-7.13.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:6f34591000f06e62085b1865c9bc5f7858df748834662a51edadfd2c3bfe0dd3", size = 218927, upload-time = "2025-12-28T15:40:52.814Z" },
+    { url = "https://files.pythonhosted.org/packages/82/a8/6e22fdc67242a4a5a153f9438d05944553121c8f4ba70cb072af4c41362e/coverage-7.13.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:b67e47c5595b9224599016e333f5ec25392597a89d5744658f837d204e16c63e", size = 219288, upload-time = "2025-12-28T15:40:54.262Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/0a/853a76e03b0f7c4375e2ca025df45c918beb367f3e20a0a8e91967f6e96c/coverage-7.13.1-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:3e7b8bd70c48ffb28461ebe092c2345536fb18bbbf19d287c8913699735f505c", size = 250786, upload-time = "2025-12-28T15:40:56.059Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/b4/694159c15c52b9f7ec7adf49d50e5f8ee71d3e9ef38adb4445d13dd56c20/coverage-7.13.1-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:c223d078112e90dc0e5c4e35b98b9584164bea9fbbd221c0b21c5241f6d51b62", size = 253543, upload-time = "2025-12-28T15:40:57.585Z" },
+    { url = "https://files.pythonhosted.org/packages/96/b2/7f1f0437a5c855f87e17cf5d0dc35920b6440ff2b58b1ba9788c059c26c8/coverage-7.13.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:794f7c05af0763b1bbd1b9e6eff0e52ad068be3b12cd96c87de037b01390c968", size = 254635, upload-time = "2025-12-28T15:40:59.443Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/d1/73c3fdb8d7d3bddd9473c9c6a2e0682f09fc3dfbcb9c3f36412a7368bcab/coverage-7.13.1-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0642eae483cc8c2902e4af7298bf886d605e80f26382124cddc3967c2a3df09e", size = 251202, upload-time = "2025-12-28T15:41:01.328Z" },
+    { url = "https://files.pythonhosted.org/packages/66/3c/f0edf75dcc152f145d5598329e864bbbe04ab78660fe3e8e395f9fff010f/coverage-7.13.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:9f5e772ed5fef25b3de9f2008fe67b92d46831bd2bc5bdc5dd6bfd06b83b316f", size = 252566, upload-time = "2025-12-28T15:41:03.319Z" },
+    { url = "https://files.pythonhosted.org/packages/17/b3/e64206d3c5f7dcbceafd14941345a754d3dbc78a823a6ed526e23b9cdaab/coverage-7.13.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:45980ea19277dc0a579e432aef6a504fe098ef3a9032ead15e446eb0f1191aee", size = 250711, upload-time = "2025-12-28T15:41:06.411Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/ad/28a3eb970a8ef5b479ee7f0c484a19c34e277479a5b70269dc652b730733/coverage-7.13.1-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:e4f18eca6028ffa62adbd185a8f1e1dd242f2e68164dba5c2b74a5204850b4cf", size = 250278, upload-time = "2025-12-28T15:41:08.285Z" },
+    { url = "https://files.pythonhosted.org/packages/54/e3/c8f0f1a93133e3e1291ca76cbb63565bd4b5c5df63b141f539d747fff348/coverage-7.13.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:f8dca5590fec7a89ed6826fce625595279e586ead52e9e958d3237821fbc750c", size = 252154, upload-time = "2025-12-28T15:41:09.969Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/bf/9939c5d6859c380e405b19e736321f1c7d402728792f4c752ad1adcce005/coverage-7.13.1-cp312-cp312-win32.whl", hash = "sha256:ff86d4e85188bba72cfb876df3e11fa243439882c55957184af44a35bd5880b7", size = 221487, upload-time = "2025-12-28T15:41:11.468Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/dc/7282856a407c621c2aad74021680a01b23010bb8ebf427cf5eacda2e876f/coverage-7.13.1-cp312-cp312-win_amd64.whl", hash = "sha256:16cc1da46c04fb0fb128b4dc430b78fa2aba8a6c0c9f8eb391fd5103409a6ac6", size = 222299, upload-time = "2025-12-28T15:41:13.386Z" },
+    { url = "https://files.pythonhosted.org/packages/10/79/176a11203412c350b3e9578620013af35bcdb79b651eb976f4a4b32044fa/coverage-7.13.1-cp312-cp312-win_arm64.whl", hash = "sha256:8d9bc218650022a768f3775dd7fdac1886437325d8d295d923ebcfef4892ad5c", size = 220941, upload-time = "2025-12-28T15:41:14.975Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/a4/e98e689347a1ff1a7f67932ab535cef82eb5e78f32a9e4132e114bbb3a0a/coverage-7.13.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:cb237bfd0ef4d5eb6a19e29f9e528ac67ac3be932ea6b44fb6cc09b9f3ecff78", size = 218951, upload-time = "2025-12-28T15:41:16.653Z" },
+    { url = "https://files.pythonhosted.org/packages/32/33/7cbfe2bdc6e2f03d6b240d23dc45fdaf3fd270aaf2d640be77b7f16989ab/coverage-7.13.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:1dcb645d7e34dcbcc96cd7c132b1fc55c39263ca62eb961c064eb3928997363b", size = 219325, upload-time = "2025-12-28T15:41:18.609Z" },
+    { url = "https://files.pythonhosted.org/packages/59/f6/efdabdb4929487baeb7cb2a9f7dac457d9356f6ad1b255be283d58b16316/coverage-7.13.1-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:3d42df8201e00384736f0df9be2ced39324c3907607d17d50d50116c989d84cd", size = 250309, upload-time = "2025-12-28T15:41:20.629Z" },
+    { url = "https://files.pythonhosted.org/packages/12/da/91a52516e9d5aea87d32d1523f9cdcf7a35a3b298e6be05d6509ba3cfab2/coverage-7.13.1-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:fa3edde1aa8807de1d05934982416cb3ec46d1d4d91e280bcce7cca01c507992", size = 252907, upload-time = "2025-12-28T15:41:22.257Z" },
+    { url = "https://files.pythonhosted.org/packages/75/38/f1ea837e3dc1231e086db1638947e00d264e7e8c41aa8ecacf6e1e0c05f4/coverage-7.13.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9edd0e01a343766add6817bc448408858ba6b489039eaaa2018474e4001651a4", size = 254148, upload-time = "2025-12-28T15:41:23.87Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/43/f4f16b881aaa34954ba446318dea6b9ed5405dd725dd8daac2358eda869a/coverage-7.13.1-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:985b7836931d033570b94c94713c6dba5f9d3ff26045f72c3e5dbc5fe3361e5a", size = 250515, upload-time = "2025-12-28T15:41:25.437Z" },
+    { url = "https://files.pythonhosted.org/packages/84/34/8cba7f00078bd468ea914134e0144263194ce849ec3baad187ffb6203d1c/coverage-7.13.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ffed1e4980889765c84a5d1a566159e363b71d6b6fbaf0bebc9d3c30bc016766", size = 252292, upload-time = "2025-12-28T15:41:28.459Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/a4/cffac66c7652d84ee4ac52d3ccb94c015687d3b513f9db04bfcac2ac800d/coverage-7.13.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:8842af7f175078456b8b17f1b73a0d16a65dcbdc653ecefeb00a56b3c8c298c4", size = 250242, upload-time = "2025-12-28T15:41:30.02Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/78/9a64d462263dde416f3c0067efade7b52b52796f489b1037a95b0dc389c9/coverage-7.13.1-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:ccd7a6fca48ca9c131d9b0a2972a581e28b13416fc313fb98b6d24a03ce9a398", size = 250068, upload-time = "2025-12-28T15:41:32.007Z" },
+    { url = "https://files.pythonhosted.org/packages/69/c8/a8994f5fece06db7c4a97c8fc1973684e178599b42e66280dded0524ef00/coverage-7.13.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:0403f647055de2609be776965108447deb8e384fe4a553c119e3ff6bfbab4784", size = 251846, upload-time = "2025-12-28T15:41:33.946Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/f7/91fa73c4b80305c86598a2d4e54ba22df6bf7d0d97500944af7ef155d9f7/coverage-7.13.1-cp313-cp313-win32.whl", hash = "sha256:549d195116a1ba1e1ae2f5ca143f9777800f6636eab917d4f02b5310d6d73461", size = 221512, upload-time = "2025-12-28T15:41:35.519Z" },
+    { url = "https://files.pythonhosted.org/packages/45/0b/0768b4231d5a044da8f75e097a8714ae1041246bb765d6b5563bab456735/coverage-7.13.1-cp313-cp313-win_amd64.whl", hash = "sha256:5899d28b5276f536fcf840b18b61a9fce23cc3aec1d114c44c07fe94ebeaa500", size = 222321, upload-time = "2025-12-28T15:41:37.371Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/b8/bdcb7253b7e85157282450262008f1366aa04663f3e3e4c30436f596c3e2/coverage-7.13.1-cp313-cp313-win_arm64.whl", hash = "sha256:868a2fae76dfb06e87291bcbd4dcbcc778a8500510b618d50496e520bd94d9b9", size = 220949, upload-time = "2025-12-28T15:41:39.553Z" },
+    { url = "https://files.pythonhosted.org/packages/70/52/f2be52cc445ff75ea8397948c96c1b4ee14f7f9086ea62fc929c5ae7b717/coverage-7.13.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:67170979de0dacac3f3097d02b0ad188d8edcea44ccc44aaa0550af49150c7dc", size = 219643, upload-time = "2025-12-28T15:41:41.567Z" },
+    { url = "https://files.pythonhosted.org/packages/47/79/c85e378eaa239e2edec0c5523f71542c7793fe3340954eafb0bc3904d32d/coverage-7.13.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:f80e2bb21bfab56ed7405c2d79d34b5dc0bc96c2c1d2a067b643a09fb756c43a", size = 219997, upload-time = "2025-12-28T15:41:43.418Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/9b/b1ade8bfb653c0bbce2d6d6e90cc6c254cbb99b7248531cc76253cb4da6d/coverage-7.13.1-cp313-cp313t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:f83351e0f7dcdb14d7326c3d8d8c4e915fa685cbfdc6281f9470d97a04e9dfe4", size = 261296, upload-time = "2025-12-28T15:41:45.207Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/af/ebf91e3e1a2473d523e87e87fd8581e0aa08741b96265730e2d79ce78d8d/coverage-7.13.1-cp313-cp313t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:bb3f6562e89bad0110afbe64e485aac2462efdce6232cdec7862a095dc3412f6", size = 263363, upload-time = "2025-12-28T15:41:47.163Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/8b/fb2423526d446596624ac7fde12ea4262e66f86f5120114c3cfd0bb2befa/coverage-7.13.1-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:77545b5dcda13b70f872c3b5974ac64c21d05e65b1590b441c8560115dc3a0d1", size = 265783, upload-time = "2025-12-28T15:41:49.03Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/26/ef2adb1e22674913b89f0fe7490ecadcef4a71fa96f5ced90c60ec358789/coverage-7.13.1-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a4d240d260a1aed814790bbe1f10a5ff31ce6c21bc78f0da4a1e8268d6c80dbd", size = 260508, upload-time = "2025-12-28T15:41:51.035Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/7d/f0f59b3404caf662e7b5346247883887687c074ce67ba453ea08c612b1d5/coverage-7.13.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:d2287ac9360dec3837bfdad969963a5d073a09a85d898bd86bea82aa8876ef3c", size = 263357, upload-time = "2025-12-28T15:41:52.631Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/b1/29896492b0b1a047604d35d6fa804f12818fa30cdad660763a5f3159e158/coverage-7.13.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:0d2c11f3ea4db66b5cbded23b20185c35066892c67d80ec4be4bab257b9ad1e0", size = 260978, upload-time = "2025-12-28T15:41:54.589Z" },
+    { url = "https://files.pythonhosted.org/packages/48/f2/971de1238a62e6f0a4128d37adadc8bb882ee96afbe03ff1570291754629/coverage-7.13.1-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:3fc6a169517ca0d7ca6846c3c5392ef2b9e38896f61d615cb75b9e7134d4ee1e", size = 259877, upload-time = "2025-12-28T15:41:56.263Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/fc/0474efcbb590ff8628830e9aaec5f1831594874360e3251f1fdec31d07a3/coverage-7.13.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:d10a2ed46386e850bb3de503a54f9fe8192e5917fcbb143bfef653a9355e9a53", size = 262069, upload-time = "2025-12-28T15:41:58.093Z" },
+    { url = "https://files.pythonhosted.org/packages/88/4f/3c159b7953db37a7b44c0eab8a95c37d1aa4257c47b4602c04022d5cb975/coverage-7.13.1-cp313-cp313t-win32.whl", hash = "sha256:75a6f4aa904301dab8022397a22c0039edc1f51e90b83dbd4464b8a38dc87842", size = 222184, upload-time = "2025-12-28T15:41:59.763Z" },
+    { url = "https://files.pythonhosted.org/packages/58/a5/6b57d28f81417f9335774f20679d9d13b9a8fb90cd6160957aa3b54a2379/coverage-7.13.1-cp313-cp313t-win_amd64.whl", hash = "sha256:309ef5706e95e62578cda256b97f5e097916a2c26247c287bbe74794e7150df2", size = 223250, upload-time = "2025-12-28T15:42:01.52Z" },
+    { url = "https://files.pythonhosted.org/packages/81/7c/160796f3b035acfbb58be80e02e484548595aa67e16a6345e7910ace0a38/coverage-7.13.1-cp313-cp313t-win_arm64.whl", hash = "sha256:92f980729e79b5d16d221038dbf2e8f9a9136afa072f9d5d6ed4cb984b126a09", size = 221521, upload-time = "2025-12-28T15:42:03.275Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/48/d9f421cb8da5afaa1a64570d9989e00fb7955e6acddc5a12979f7666ef60/coverage-7.13.1-py3-none-any.whl", hash = "sha256:2016745cb3ba554469d02819d78958b571792bb68e31302610e898f80dd3a573", size = 210722, upload-time = "2025-12-28T15:42:54.901Z" },
+]
+
+[package.optional-dependencies]
+toml = [
+    { name = "tomli", marker = "python_full_version <= '3.11'" },
+]
+
+[[package]]
+name = "docutils"
+version = "0.21.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ae/ed/aefcc8cd0ba62a0560c3c18c33925362d46c6075480bfa4df87b28e169a9/docutils-0.21.2.tar.gz", hash = "sha256:3a6b18732edf182daa3cd12775bbb338cf5691468f91eeeb109deff6ebfa986f", size = 2204444, upload-time = "2024-04-23T18:57:18.24Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8f/d7/9322c609343d929e75e7e5e6255e614fcc67572cfd083959cdef3b7aad79/docutils-0.21.2-py3-none-any.whl", hash = "sha256:dafca5b9e384f0e419294eb4d2ff9fa826435bf15f15b7bd45723e8ad76811b2", size = 587408, upload-time = "2024-04-23T18:57:14.835Z" },
+]
+
+[[package]]
+name = "dynaconf"
+version = "3.2.12"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/cd/bd/7a6f84b68268fe1d12e709faec7d293e0c37c9c03bacaf363de41e7e7568/dynaconf-3.2.12.tar.gz", hash = "sha256:29cea583b007d890e6031fa89c0ac489b631c73dbee83bcd5e6f97602c26354e", size = 313801, upload-time = "2025-10-10T19:54:06.164Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/26/68/51adede38ab2ee9ecfddb8b60a80a42b618a72f1018fcf60974e5d852831/dynaconf-3.2.12-py2.py3-none-any.whl", hash = "sha256:eb2a11865917dff8810c6098cd736b8f4d2f4e39ad914500e2dfbe064b82c499", size = 237788, upload-time = "2025-10-10T19:54:03.731Z" },
+]
+
+[[package]]
+name = "furo"
+version = "2025.12.19"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "accessible-pygments" },
+    { name = "beautifulsoup4" },
+    { name = "pygments" },
+    { name = "sphinx" },
+    { name = "sphinx-basic-ng" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ec/20/5f5ad4da6a5a27c80f2ed2ee9aee3f9e36c66e56e21c00fde467b2f8f88f/furo-2025.12.19.tar.gz", hash = "sha256:188d1f942037d8b37cd3985b955839fea62baa1730087dc29d157677c857e2a7", size = 1661473, upload-time = "2025-12-19T17:34:40.889Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/b2/50e9b292b5cac13e9e81272c7171301abc753a60460d21505b606e15cf21/furo-2025.12.19-py3-none-any.whl", hash = "sha256:bb0ead5309f9500130665a26bee87693c41ce4dbdff864dbfb6b0dae4673d24f", size = 339262, upload-time = "2025-12-19T17:34:38.905Z" },
+]
+
+[[package]]
+name = "googleapis-common-protos"
+version = "1.72.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "protobuf" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e5/7b/adfd75544c415c487b33061fe7ae526165241c1ea133f9a9125a56b39fd8/googleapis_common_protos-1.72.0.tar.gz", hash = "sha256:e55a601c1b32b52d7a3e65f43563e2aa61bcd737998ee672ac9b951cd49319f5", size = 147433, upload-time = "2025-11-06T18:29:24.087Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c4/ab/09169d5a4612a5f92490806649ac8d41e3ec9129c636754575b3553f4ea4/googleapis_common_protos-1.72.0-py3-none-any.whl", hash = "sha256:4299c5a82d5ae1a9702ada957347726b167f9f8d1fc352477702a1e851ff4038", size = 297515, upload-time = "2025-11-06T18:29:13.14Z" },
+]
+
+[[package]]
+name = "grpcio"
+version = "1.76.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b6/e0/318c1ce3ae5a17894d5791e87aea147587c9e702f24122cc7a5c8bbaeeb1/grpcio-1.76.0.tar.gz", hash = "sha256:7be78388d6da1a25c0d5ec506523db58b18be22d9c37d8d3a32c08be4987bd73", size = 12785182, upload-time = "2025-10-21T16:23:12.106Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a0/00/8163a1beeb6971f66b4bbe6ac9457b97948beba8dd2fc8e1281dce7f79ec/grpcio-1.76.0-cp311-cp311-linux_armv7l.whl", hash = "sha256:2e1743fbd7f5fa713a1b0a8ac8ebabf0ec980b5d8809ec358d488e273b9cf02a", size = 5843567, upload-time = "2025-10-21T16:20:52.829Z" },
+    { url = "https://files.pythonhosted.org/packages/10/c1/934202f5cf335e6d852530ce14ddb0fef21be612ba9ecbbcbd4d748ca32d/grpcio-1.76.0-cp311-cp311-macosx_11_0_universal2.whl", hash = "sha256:a8c2cf1209497cf659a667d7dea88985e834c24b7c3b605e6254cbb5076d985c", size = 11848017, upload-time = "2025-10-21T16:20:56.705Z" },
+    { url = "https://files.pythonhosted.org/packages/11/0b/8dec16b1863d74af6eb3543928600ec2195af49ca58b16334972f6775663/grpcio-1.76.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:08caea849a9d3c71a542827d6df9d5a69067b0a1efbea8a855633ff5d9571465", size = 6412027, upload-time = "2025-10-21T16:20:59.3Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/64/7b9e6e7ab910bea9d46f2c090380bab274a0b91fb0a2fe9b0cd399fffa12/grpcio-1.76.0-cp311-cp311-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:f0e34c2079d47ae9f6188211db9e777c619a21d4faba6977774e8fa43b085e48", size = 7075913, upload-time = "2025-10-21T16:21:01.645Z" },
+    { url = "https://files.pythonhosted.org/packages/68/86/093c46e9546073cefa789bd76d44c5cb2abc824ca62af0c18be590ff13ba/grpcio-1.76.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8843114c0cfce61b40ad48df65abcfc00d4dba82eae8718fab5352390848c5da", size = 6615417, upload-time = "2025-10-21T16:21:03.844Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/b6/5709a3a68500a9c03da6fb71740dcdd5ef245e39266461a03f31a57036d8/grpcio-1.76.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:8eddfb4d203a237da6f3cc8a540dad0517d274b5a1e9e636fd8d2c79b5c1d397", size = 7199683, upload-time = "2025-10-21T16:21:06.195Z" },
+    { url = "https://files.pythonhosted.org/packages/91/d3/4b1f2bf16ed52ce0b508161df3a2d186e4935379a159a834cb4a7d687429/grpcio-1.76.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:32483fe2aab2c3794101c2a159070584e5db11d0aa091b2c0ea9c4fc43d0d749", size = 8163109, upload-time = "2025-10-21T16:21:08.498Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/61/d9043f95f5f4cf085ac5dd6137b469d41befb04bd80280952ffa2a4c3f12/grpcio-1.76.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:dcfe41187da8992c5f40aa8c5ec086fa3672834d2be57a32384c08d5a05b4c00", size = 7626676, upload-time = "2025-10-21T16:21:10.693Z" },
+    { url = "https://files.pythonhosted.org/packages/36/95/fd9a5152ca02d8881e4dd419cdd790e11805979f499a2e5b96488b85cf27/grpcio-1.76.0-cp311-cp311-win32.whl", hash = "sha256:2107b0c024d1b35f4083f11245c0e23846ae64d02f40b2b226684840260ed054", size = 3997688, upload-time = "2025-10-21T16:21:12.746Z" },
+    { url = "https://files.pythonhosted.org/packages/60/9c/5c359c8d4c9176cfa3c61ecd4efe5affe1f38d9bae81e81ac7186b4c9cc8/grpcio-1.76.0-cp311-cp311-win_amd64.whl", hash = "sha256:522175aba7af9113c48ec10cc471b9b9bd4f6ceb36aeb4544a8e2c80ed9d252d", size = 4709315, upload-time = "2025-10-21T16:21:15.26Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/05/8e29121994b8d959ffa0afd28996d452f291b48cfc0875619de0bde2c50c/grpcio-1.76.0-cp312-cp312-linux_armv7l.whl", hash = "sha256:81fd9652b37b36f16138611c7e884eb82e0cec137c40d3ef7c3f9b3ed00f6ed8", size = 5799718, upload-time = "2025-10-21T16:21:17.939Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/75/11d0e66b3cdf998c996489581bdad8900db79ebd83513e45c19548f1cba4/grpcio-1.76.0-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:04bbe1bfe3a68bbfd4e52402ab7d4eb59d72d02647ae2042204326cf4bbad280", size = 11825627, upload-time = "2025-10-21T16:21:20.466Z" },
+    { url = "https://files.pythonhosted.org/packages/28/50/2f0aa0498bc188048f5d9504dcc5c2c24f2eb1a9337cd0fa09a61a2e75f0/grpcio-1.76.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d388087771c837cdb6515539f43b9d4bf0b0f23593a24054ac16f7a960be16f4", size = 6359167, upload-time = "2025-10-21T16:21:23.122Z" },
+    { url = "https://files.pythonhosted.org/packages/66/e5/bbf0bb97d29ede1d59d6588af40018cfc345b17ce979b7b45424628dc8bb/grpcio-1.76.0-cp312-cp312-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:9f8f757bebaaea112c00dba718fc0d3260052ce714e25804a03f93f5d1c6cc11", size = 7044267, upload-time = "2025-10-21T16:21:25.995Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/86/f6ec2164f743d9609691115ae8ece098c76b894ebe4f7c94a655c6b03e98/grpcio-1.76.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:980a846182ce88c4f2f7e2c22c56aefd515daeb36149d1c897f83cf57999e0b6", size = 6573963, upload-time = "2025-10-21T16:21:28.631Z" },
+    { url = "https://files.pythonhosted.org/packages/60/bc/8d9d0d8505feccfdf38a766d262c71e73639c165b311c9457208b56d92ae/grpcio-1.76.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:f92f88e6c033db65a5ae3d97905c8fea9c725b63e28d5a75cb73b49bda5024d8", size = 7164484, upload-time = "2025-10-21T16:21:30.837Z" },
+    { url = "https://files.pythonhosted.org/packages/67/e6/5d6c2fc10b95edf6df9b8f19cf10a34263b7fd48493936fffd5085521292/grpcio-1.76.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:4baf3cbe2f0be3289eb68ac8ae771156971848bb8aaff60bad42005539431980", size = 8127777, upload-time = "2025-10-21T16:21:33.577Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/c8/dce8ff21c86abe025efe304d9e31fdb0deaaa3b502b6a78141080f206da0/grpcio-1.76.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:615ba64c208aaceb5ec83bfdce7728b80bfeb8be97562944836a7a0a9647d882", size = 7594014, upload-time = "2025-10-21T16:21:41.882Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/42/ad28191ebf983a5d0ecef90bab66baa5a6b18f2bfdef9d0a63b1973d9f75/grpcio-1.76.0-cp312-cp312-win32.whl", hash = "sha256:45d59a649a82df5718fd9527ce775fd66d1af35e6d31abdcdc906a49c6822958", size = 3984750, upload-time = "2025-10-21T16:21:44.006Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/00/7bd478cbb851c04a48baccaa49b75abaa8e4122f7d86da797500cccdd771/grpcio-1.76.0-cp312-cp312-win_amd64.whl", hash = "sha256:c088e7a90b6017307f423efbb9d1ba97a22aa2170876223f9709e9d1de0b5347", size = 4704003, upload-time = "2025-10-21T16:21:46.244Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/ed/71467ab770effc9e8cef5f2e7388beb2be26ed642d567697bb103a790c72/grpcio-1.76.0-cp313-cp313-linux_armv7l.whl", hash = "sha256:26ef06c73eb53267c2b319f43e6634c7556ea37672029241a056629af27c10e2", size = 5807716, upload-time = "2025-10-21T16:21:48.475Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/85/c6ed56f9817fab03fa8a111ca91469941fb514e3e3ce6d793cb8f1e1347b/grpcio-1.76.0-cp313-cp313-macosx_11_0_universal2.whl", hash = "sha256:45e0111e73f43f735d70786557dc38141185072d7ff8dc1829d6a77ac1471468", size = 11821522, upload-time = "2025-10-21T16:21:51.142Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/31/2b8a235ab40c39cbc141ef647f8a6eb7b0028f023015a4842933bc0d6831/grpcio-1.76.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:83d57312a58dcfe2a3a0f9d1389b299438909a02db60e2f2ea2ae2d8034909d3", size = 6362558, upload-time = "2025-10-21T16:21:54.213Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/64/9784eab483358e08847498ee56faf8ff6ea8e0a4592568d9f68edc97e9e9/grpcio-1.76.0-cp313-cp313-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:3e2a27c89eb9ac3d81ec8835e12414d73536c6e620355d65102503064a4ed6eb", size = 7049990, upload-time = "2025-10-21T16:21:56.476Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/94/8c12319a6369434e7a184b987e8e9f3b49a114c489b8315f029e24de4837/grpcio-1.76.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:61f69297cba3950a524f61c7c8ee12e55c486cb5f7db47ff9dcee33da6f0d3ae", size = 6575387, upload-time = "2025-10-21T16:21:59.051Z" },
+    { url = "https://files.pythonhosted.org/packages/15/0f/f12c32b03f731f4a6242f771f63039df182c8b8e2cf8075b245b409259d4/grpcio-1.76.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:6a15c17af8839b6801d554263c546c69c4d7718ad4321e3166175b37eaacca77", size = 7166668, upload-time = "2025-10-21T16:22:02.049Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/2d/3ec9ce0c2b1d92dd59d1c3264aaec9f0f7c817d6e8ac683b97198a36ed5a/grpcio-1.76.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:25a18e9810fbc7e7f03ec2516addc116a957f8cbb8cbc95ccc80faa072743d03", size = 8124928, upload-time = "2025-10-21T16:22:04.984Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/74/fd3317be5672f4856bcdd1a9e7b5e17554692d3db9a3b273879dc02d657d/grpcio-1.76.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:931091142fd8cc14edccc0845a79248bc155425eee9a98b2db2ea4f00a235a42", size = 7589983, upload-time = "2025-10-21T16:22:07.881Z" },
+    { url = "https://files.pythonhosted.org/packages/45/bb/ca038cf420f405971f19821c8c15bcbc875505f6ffadafe9ffd77871dc4c/grpcio-1.76.0-cp313-cp313-win32.whl", hash = "sha256:5e8571632780e08526f118f74170ad8d50fb0a48c23a746bef2a6ebade3abd6f", size = 3984727, upload-time = "2025-10-21T16:22:10.032Z" },
+    { url = "https://files.pythonhosted.org/packages/41/80/84087dc56437ced7cdd4b13d7875e7439a52a261e3ab4e06488ba6173b0a/grpcio-1.76.0-cp313-cp313-win_amd64.whl", hash = "sha256:f9f7bd5faab55f47231ad8dba7787866b69f5e93bc306e3915606779bbfb4ba8", size = 4702799, upload-time = "2025-10-21T16:22:12.709Z" },
+]
+
+[[package]]
+name = "grpcio-status"
+version = "1.76.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "googleapis-common-protos" },
+    { name = "grpcio" },
+    { name = "protobuf" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3f/46/e9f19d5be65e8423f886813a2a9d0056ba94757b0c5007aa59aed1a961fa/grpcio_status-1.76.0.tar.gz", hash = "sha256:25fcbfec74c15d1a1cb5da3fab8ee9672852dc16a5a9eeb5baf7d7a9952943cd", size = 13679, upload-time = "2025-10-21T16:28:52.545Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8c/cc/27ba60ad5a5f2067963e6a858743500df408eb5855e98be778eaef8c9b02/grpcio_status-1.76.0-py3-none-any.whl", hash = "sha256:380568794055a8efbbd8871162df92012e0228a5f6dffaf57f2a00c534103b18", size = 14425, upload-time = "2025-10-21T16:28:40.853Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.11"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" },
+]
+
+[[package]]
+name = "imagesize"
+version = "1.4.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a7/84/62473fb57d61e31fef6e36d64a179c8781605429fd927b5dd608c997be31/imagesize-1.4.1.tar.gz", hash = "sha256:69150444affb9cb0d5cc5a92b3676f0b2fb7cd9ae39e947a5e11a36b4497cd4a", size = 1280026, upload-time = "2022-07-01T12:21:05.687Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ff/62/85c4c919272577931d407be5ba5d71c20f0b616d31a0befe0ae45bb79abd/imagesize-1.4.1-py2.py3-none-any.whl", hash = "sha256:0d8d18d08f840c19d0ee7ca1fd82490fdc3729b7ac93f49870406ddde8ef8d8b", size = 8769, upload-time = "2022-07-01T12:21:02.467Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "jinja2"
+version = "3.1.6"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markupsafe" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/df/bf/f7da0350254c0ed7c72f3e33cef02e048281fec7ecec5f032d4aac52226b/jinja2-3.1.6.tar.gz", hash = "sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d", size = 245115, upload-time = "2025-03-05T20:05:02.478Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/62/a1/3d680cbfd5f4b8f15abc1d571870c5fc3e594bb582bc3b64ea099db13e56/jinja2-3.1.6-py3-none-any.whl", hash = "sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67", size = 134899, upload-time = "2025-03-05T20:05:00.369Z" },
+]
+
+[[package]]
+name = "lockfile"
+version = "0.12.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/17/47/72cb04a58a35ec495f96984dddb48232b551aafb95bde614605b754fe6f7/lockfile-0.12.2.tar.gz", hash = "sha256:6aed02de03cba24efabcd600b30540140634fc06cfa603822d508d5361e9f799", size = 20874, upload-time = "2015-11-25T18:29:58.279Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c8/22/9460e311f340cb62d26a38c419b1381b8593b0bb6b5d1f056938b086d362/lockfile-0.12.2-py2.py3-none-any.whl", hash = "sha256:6c3cb24f344923d30b2785d5ad75182c8ea7ac1b6171b08657258ec7429d50fa", size = 13564, upload-time = "2015-11-25T18:29:51.462Z" },
+]
+
+[[package]]
+name = "loguru"
+version = "0.7.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "win32-setctime", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3a/05/a1dae3dffd1116099471c643b8924f5aa6524411dc6c63fdae648c4f1aca/loguru-0.7.3.tar.gz", hash = "sha256:19480589e77d47b8d85b2c827ad95d49bf31b0dcde16593892eb51dd18706eb6", size = 63559, upload-time = "2024-12-06T11:20:56.608Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0c/29/0348de65b8cc732daa3e33e67806420b2ae89bdce2b04af740289c5c6c8c/loguru-0.7.3-py3-none-any.whl", hash = "sha256:31a33c10c8e1e10422bfd431aeb5d351c7cf7fa671e3c4df004162264b28220c", size = 61595, upload-time = "2024-12-06T11:20:54.538Z" },
+]
+
+[[package]]
+name = "markdown-it-py"
+version = "3.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/38/71/3b932df36c1a044d397a1f92d1cf91ee0a503d91e470cbd670aa66b07ed0/markdown-it-py-3.0.0.tar.gz", hash = "sha256:e3f60a94fa066dc52ec76661e37c851cb232d92f9886b15cb560aaada2df8feb", size = 74596, upload-time = "2023-06-03T06:41:14.443Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/42/d7/1ec15b46af6af88f19b8e5ffea08fa375d433c998b8a7639e76935c14f1f/markdown_it_py-3.0.0-py3-none-any.whl", hash = "sha256:355216845c60bd96232cd8d8c40e8f9765cc86f46880e43a8fd22dc1a1a8cab1", size = 87528, upload-time = "2023-06-03T06:41:11.019Z" },
+]
+
+[[package]]
+name = "markupsafe"
+version = "3.0.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7e/99/7690b6d4034fffd95959cbe0c02de8deb3098cc577c67bb6a24fe5d7caa7/markupsafe-3.0.3.tar.gz", hash = "sha256:722695808f4b6457b320fdc131280796bdceb04ab50fe1795cd540799ebe1698", size = 80313, upload-time = "2025-09-27T18:37:40.426Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/08/db/fefacb2136439fc8dd20e797950e749aa1f4997ed584c62cfb8ef7c2be0e/markupsafe-3.0.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1cc7ea17a6824959616c525620e387f6dd30fec8cb44f649e31712db02123dad", size = 11631, upload-time = "2025-09-27T18:36:18.185Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/2e/5898933336b61975ce9dc04decbc0a7f2fee78c30353c5efba7f2d6ff27a/markupsafe-3.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4bd4cd07944443f5a265608cc6aab442e4f74dff8088b0dfc8238647b8f6ae9a", size = 12058, upload-time = "2025-09-27T18:36:19.444Z" },
+    { url = "https://files.pythonhosted.org/packages/1d/09/adf2df3699d87d1d8184038df46a9c80d78c0148492323f4693df54e17bb/markupsafe-3.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b5420a1d9450023228968e7e6a9ce57f65d148ab56d2313fcd589eee96a7a50", size = 24287, upload-time = "2025-09-27T18:36:20.768Z" },
+    { url = "https://files.pythonhosted.org/packages/30/ac/0273f6fcb5f42e314c6d8cd99effae6a5354604d461b8d392b5ec9530a54/markupsafe-3.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0bf2a864d67e76e5c9a34dc26ec616a66b9888e25e7b9460e1c76d3293bd9dbf", size = 22940, upload-time = "2025-09-27T18:36:22.249Z" },
+    { url = "https://files.pythonhosted.org/packages/19/ae/31c1be199ef767124c042c6c3e904da327a2f7f0cd63a0337e1eca2967a8/markupsafe-3.0.3-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc51efed119bc9cfdf792cdeaa4d67e8f6fcccab66ed4bfdd6bde3e59bfcbb2f", size = 21887, upload-time = "2025-09-27T18:36:23.535Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/76/7edcab99d5349a4532a459e1fe64f0b0467a3365056ae550d3bcf3f79e1e/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:068f375c472b3e7acbe2d5318dea141359e6900156b5b2ba06a30b169086b91a", size = 23692, upload-time = "2025-09-27T18:36:24.823Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/28/6e74cdd26d7514849143d69f0bf2399f929c37dc2b31e6829fd2045b2765/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:7be7b61bb172e1ed687f1754f8e7484f1c8019780f6f6b0786e76bb01c2ae115", size = 21471, upload-time = "2025-09-27T18:36:25.95Z" },
+    { url = "https://files.pythonhosted.org/packages/62/7e/a145f36a5c2945673e590850a6f8014318d5577ed7e5920a4b3448e0865d/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:f9e130248f4462aaa8e2552d547f36ddadbeaa573879158d721bbd33dfe4743a", size = 22923, upload-time = "2025-09-27T18:36:27.109Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/62/d9c46a7f5c9adbeeeda52f5b8d802e1094e9717705a645efc71b0913a0a8/markupsafe-3.0.3-cp311-cp311-win32.whl", hash = "sha256:0db14f5dafddbb6d9208827849fad01f1a2609380add406671a26386cdf15a19", size = 14572, upload-time = "2025-09-27T18:36:28.045Z" },
+    { url = "https://files.pythonhosted.org/packages/83/8a/4414c03d3f891739326e1783338e48fb49781cc915b2e0ee052aa490d586/markupsafe-3.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:de8a88e63464af587c950061a5e6a67d3632e36df62b986892331d4620a35c01", size = 15077, upload-time = "2025-09-27T18:36:29.025Z" },
+    { url = "https://files.pythonhosted.org/packages/35/73/893072b42e6862f319b5207adc9ae06070f095b358655f077f69a35601f0/markupsafe-3.0.3-cp311-cp311-win_arm64.whl", hash = "sha256:3b562dd9e9ea93f13d53989d23a7e775fdfd1066c33494ff43f5418bc8c58a5c", size = 13876, upload-time = "2025-09-27T18:36:29.954Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/72/147da192e38635ada20e0a2e1a51cf8823d2119ce8883f7053879c2199b5/markupsafe-3.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d53197da72cc091b024dd97249dfc7794d6a56530370992a5e1a08983ad9230e", size = 11615, upload-time = "2025-09-27T18:36:30.854Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/81/7e4e08678a1f98521201c3079f77db69fb552acd56067661f8c2f534a718/markupsafe-3.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1872df69a4de6aead3491198eaf13810b565bdbeec3ae2dc8780f14458ec73ce", size = 12020, upload-time = "2025-09-27T18:36:31.971Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/2c/799f4742efc39633a1b54a92eec4082e4f815314869865d876824c257c1e/markupsafe-3.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3a7e8ae81ae39e62a41ec302f972ba6ae23a5c5396c8e60113e9066ef893da0d", size = 24332, upload-time = "2025-09-27T18:36:32.813Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/2e/8d0c2ab90a8c1d9a24f0399058ab8519a3279d1bd4289511d74e909f060e/markupsafe-3.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d6dd0be5b5b189d31db7cda48b91d7e0a9795f31430b7f271219ab30f1d3ac9d", size = 22947, upload-time = "2025-09-27T18:36:33.86Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/54/887f3092a85238093a0b2154bd629c89444f395618842e8b0c41783898ea/markupsafe-3.0.3-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:94c6f0bb423f739146aec64595853541634bde58b2135f27f61c1ffd1cd4d16a", size = 21962, upload-time = "2025-09-27T18:36:35.099Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/2f/336b8c7b6f4a4d95e91119dc8521402461b74a485558d8f238a68312f11c/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:be8813b57049a7dc738189df53d69395eba14fb99345e0a5994914a3864c8a4b", size = 23760, upload-time = "2025-09-27T18:36:36.001Z" },
+    { url = "https://files.pythonhosted.org/packages/32/43/67935f2b7e4982ffb50a4d169b724d74b62a3964bc1a9a527f5ac4f1ee2b/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:83891d0e9fb81a825d9a6d61e3f07550ca70a076484292a70fde82c4b807286f", size = 21529, upload-time = "2025-09-27T18:36:36.906Z" },
+    { url = "https://files.pythonhosted.org/packages/89/e0/4486f11e51bbba8b0c041098859e869e304d1c261e59244baa3d295d47b7/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:77f0643abe7495da77fb436f50f8dab76dbc6e5fd25d39589a0f1fe6548bfa2b", size = 23015, upload-time = "2025-09-27T18:36:37.868Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/e1/78ee7a023dac597a5825441ebd17170785a9dab23de95d2c7508ade94e0e/markupsafe-3.0.3-cp312-cp312-win32.whl", hash = "sha256:d88b440e37a16e651bda4c7c2b930eb586fd15ca7406cb39e211fcff3bf3017d", size = 14540, upload-time = "2025-09-27T18:36:38.761Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/5b/bec5aa9bbbb2c946ca2733ef9c4ca91c91b6a24580193e891b5f7dbe8e1e/markupsafe-3.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:26a5784ded40c9e318cfc2bdb30fe164bdb8665ded9cd64d500a34fb42067b1c", size = 15105, upload-time = "2025-09-27T18:36:39.701Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/f1/216fc1bbfd74011693a4fd837e7026152e89c4bcf3e77b6692fba9923123/markupsafe-3.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:35add3b638a5d900e807944a078b51922212fb3dedb01633a8defc4b01a3c85f", size = 13906, upload-time = "2025-09-27T18:36:40.689Z" },
+    { url = "https://files.pythonhosted.org/packages/38/2f/907b9c7bbba283e68f20259574b13d005c121a0fa4c175f9bed27c4597ff/markupsafe-3.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e1cf1972137e83c5d4c136c43ced9ac51d0e124706ee1c8aa8532c1287fa8795", size = 11622, upload-time = "2025-09-27T18:36:41.777Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/d9/5f7756922cdd676869eca1c4e3c0cd0df60ed30199ffd775e319089cb3ed/markupsafe-3.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:116bb52f642a37c115f517494ea5feb03889e04df47eeff5b130b1808ce7c219", size = 12029, upload-time = "2025-09-27T18:36:43.257Z" },
+    { url = "https://files.pythonhosted.org/packages/00/07/575a68c754943058c78f30db02ee03a64b3c638586fba6a6dd56830b30a3/markupsafe-3.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:133a43e73a802c5562be9bbcd03d090aa5a1fe899db609c29e8c8d815c5f6de6", size = 24374, upload-time = "2025-09-27T18:36:44.508Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/21/9b05698b46f218fc0e118e1f8168395c65c8a2c750ae2bab54fc4bd4e0e8/markupsafe-3.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ccfcd093f13f0f0b7fdd0f198b90053bf7b2f02a3927a30e63f3ccc9df56b676", size = 22980, upload-time = "2025-09-27T18:36:45.385Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/71/544260864f893f18b6827315b988c146b559391e6e7e8f7252839b1b846a/markupsafe-3.0.3-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:509fa21c6deb7a7a273d629cf5ec029bc209d1a51178615ddf718f5918992ab9", size = 21990, upload-time = "2025-09-27T18:36:46.916Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/28/b50fc2f74d1ad761af2f5dcce7492648b983d00a65b8c0e0cb457c82ebbe/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4afe79fb3de0b7097d81da19090f4df4f8d3a2b3adaa8764138aac2e44f3af1", size = 23784, upload-time = "2025-09-27T18:36:47.884Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/76/104b2aa106a208da8b17a2fb72e033a5a9d7073c68f7e508b94916ed47a9/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:795e7751525cae078558e679d646ae45574b47ed6e7771863fcc079a6171a0fc", size = 21588, upload-time = "2025-09-27T18:36:48.82Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/99/16a5eb2d140087ebd97180d95249b00a03aa87e29cc224056274f2e45fd6/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8485f406a96febb5140bfeca44a73e3ce5116b2501ac54fe953e488fb1d03b12", size = 23041, upload-time = "2025-09-27T18:36:49.797Z" },
+    { url = "https://files.pythonhosted.org/packages/19/bc/e7140ed90c5d61d77cea142eed9f9c303f4c4806f60a1044c13e3f1471d0/markupsafe-3.0.3-cp313-cp313-win32.whl", hash = "sha256:bdd37121970bfd8be76c5fb069c7751683bdf373db1ed6c010162b2a130248ed", size = 14543, upload-time = "2025-09-27T18:36:51.584Z" },
+    { url = "https://files.pythonhosted.org/packages/05/73/c4abe620b841b6b791f2edc248f556900667a5a1cf023a6646967ae98335/markupsafe-3.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:9a1abfdc021a164803f4d485104931fb8f8c1efd55bc6b748d2f5774e78b62c5", size = 15113, upload-time = "2025-09-27T18:36:52.537Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/3a/fa34a0f7cfef23cf9500d68cb7c32dd64ffd58a12b09225fb03dd37d5b80/markupsafe-3.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:7e68f88e5b8799aa49c85cd116c932a1ac15caaa3f5db09087854d218359e485", size = 13911, upload-time = "2025-09-27T18:36:53.513Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/d7/e05cd7efe43a88a17a37b3ae96e79a19e846f3f456fe79c57ca61356ef01/markupsafe-3.0.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:218551f6df4868a8d527e3062d0fb968682fe92054e89978594c28e642c43a73", size = 11658, upload-time = "2025-09-27T18:36:54.819Z" },
+    { url = "https://files.pythonhosted.org/packages/99/9e/e412117548182ce2148bdeacdda3bb494260c0b0184360fe0d56389b523b/markupsafe-3.0.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3524b778fe5cfb3452a09d31e7b5adefeea8c5be1d43c4f810ba09f2ceb29d37", size = 12066, upload-time = "2025-09-27T18:36:55.714Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/e6/fa0ffcda717ef64a5108eaa7b4f5ed28d56122c9a6d70ab8b72f9f715c80/markupsafe-3.0.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e885a3d1efa2eadc93c894a21770e4bc67899e3543680313b09f139e149ab19", size = 25639, upload-time = "2025-09-27T18:36:56.908Z" },
+    { url = "https://files.pythonhosted.org/packages/96/ec/2102e881fe9d25fc16cb4b25d5f5cde50970967ffa5dddafdb771237062d/markupsafe-3.0.3-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8709b08f4a89aa7586de0aadc8da56180242ee0ada3999749b183aa23df95025", size = 23569, upload-time = "2025-09-27T18:36:57.913Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/30/6f2fce1f1f205fc9323255b216ca8a235b15860c34b6798f810f05828e32/markupsafe-3.0.3-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b8512a91625c9b3da6f127803b166b629725e68af71f8184ae7e7d54686a56d6", size = 23284, upload-time = "2025-09-27T18:36:58.833Z" },
+    { url = "https://files.pythonhosted.org/packages/58/47/4a0ccea4ab9f5dcb6f79c0236d954acb382202721e704223a8aafa38b5c8/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9b79b7a16f7fedff2495d684f2b59b0457c3b493778c9eed31111be64d58279f", size = 24801, upload-time = "2025-09-27T18:36:59.739Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/70/3780e9b72180b6fecb83a4814d84c3bf4b4ae4bf0b19c27196104149734c/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:12c63dfb4a98206f045aa9563db46507995f7ef6d83b2f68eda65c307c6829eb", size = 22769, upload-time = "2025-09-27T18:37:00.719Z" },
+    { url = "https://files.pythonhosted.org/packages/98/c5/c03c7f4125180fc215220c035beac6b9cb684bc7a067c84fc69414d315f5/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8f71bc33915be5186016f675cd83a1e08523649b0e33efdb898db577ef5bb009", size = 23642, upload-time = "2025-09-27T18:37:01.673Z" },
+    { url = "https://files.pythonhosted.org/packages/80/d6/2d1b89f6ca4bff1036499b1e29a1d02d282259f3681540e16563f27ebc23/markupsafe-3.0.3-cp313-cp313t-win32.whl", hash = "sha256:69c0b73548bc525c8cb9a251cddf1931d1db4d2258e9599c28c07ef3580ef354", size = 14612, upload-time = "2025-09-27T18:37:02.639Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/98/e48a4bfba0a0ffcf9925fe2d69240bfaa19c6f7507b8cd09c70684a53c1e/markupsafe-3.0.3-cp313-cp313t-win_amd64.whl", hash = "sha256:1b4b79e8ebf6b55351f0d91fe80f893b4743f104bff22e90697db1590e47a218", size = 15200, upload-time = "2025-09-27T18:37:03.582Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/72/e3cc540f351f316e9ed0f092757459afbc595824ca724cbc5a5d4263713f/markupsafe-3.0.3-cp313-cp313t-win_arm64.whl", hash = "sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287", size = 13973, upload-time = "2025-09-27T18:37:04.929Z" },
+]
+
+[[package]]
+name = "mdit-py-plugins"
+version = "0.5.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b2/fd/a756d36c0bfba5f6e39a1cdbdbfdd448dc02692467d83816dff4592a1ebc/mdit_py_plugins-0.5.0.tar.gz", hash = "sha256:f4918cb50119f50446560513a8e311d574ff6aaed72606ddae6d35716fe809c6", size = 44655, upload-time = "2025-08-11T07:25:49.083Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fb/86/dd6e5db36df29e76c7a7699123569a4a18c1623ce68d826ed96c62643cae/mdit_py_plugins-0.5.0-py3-none-any.whl", hash = "sha256:07a08422fc1936a5d26d146759e9155ea466e842f5ab2f7d2266dd084c8dab1f", size = 57205, upload-time = "2025-08-11T07:25:47.597Z" },
+]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+
+[[package]]
+name = "myst-parser"
+version = "4.0.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "docutils" },
+    { name = "jinja2" },
+    { name = "markdown-it-py" },
+    { name = "mdit-py-plugins" },
+    { name = "pyyaml" },
+    { name = "sphinx" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/66/a5/9626ba4f73555b3735ad86247a8077d4603aa8628537687c839ab08bfe44/myst_parser-4.0.1.tar.gz", hash = "sha256:5cfea715e4f3574138aecbf7d54132296bfd72bb614d31168f48c477a830a7c4", size = 93985, upload-time = "2025-02-12T10:53:03.833Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5f/df/76d0321c3797b54b60fef9ec3bd6f4cfd124b9e422182156a1dd418722cf/myst_parser-4.0.1-py3-none-any.whl", hash = "sha256:9134e88959ec3b5780aedf8a99680ea242869d012e8821db3126d427edc9c95d", size = 84579, upload-time = "2025-02-12T10:53:02.078Z" },
+]
+
+[[package]]
+name = "numpy"
+version = "2.4.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/24/62/ae72ff66c0f1fd959925b4c11f8c2dea61f47f6acaea75a08512cdfe3fed/numpy-2.4.1.tar.gz", hash = "sha256:a1ceafc5042451a858231588a104093474c6a5c57dcc724841f5c888d237d690", size = 20721320, upload-time = "2026-01-10T06:44:59.619Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a5/34/2b1bc18424f3ad9af577f6ce23600319968a70575bd7db31ce66731bbef9/numpy-2.4.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:0cce2a669e3c8ba02ee563c7835f92c153cf02edff1ae05e1823f1dde21b16a5", size = 16944563, upload-time = "2026-01-10T06:42:14.615Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/57/26e5f97d075aef3794045a6ca9eada6a4ed70eb9a40e7a4a93f9ac80d704/numpy-2.4.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:899d2c18024984814ac7e83f8f49d8e8180e2fbe1b2e252f2e7f1d06bea92425", size = 12645658, upload-time = "2026-01-10T06:42:17.298Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/ba/80fc0b1e3cb2fd5c6143f00f42eb67762aa043eaa05ca924ecc3222a7849/numpy-2.4.1-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:09aa8a87e45b55a1c2c205d42e2808849ece5c484b2aab11fecabec3841cafba", size = 5474132, upload-time = "2026-01-10T06:42:19.637Z" },
+    { url = "https://files.pythonhosted.org/packages/40/ae/0a5b9a397f0e865ec171187c78d9b57e5588afc439a04ba9cab1ebb2c945/numpy-2.4.1-cp311-cp311-macosx_14_0_x86_64.whl", hash = "sha256:edee228f76ee2dab4579fad6f51f6a305de09d444280109e0f75df247ff21501", size = 6804159, upload-time = "2026-01-10T06:42:21.44Z" },
+    { url = "https://files.pythonhosted.org/packages/86/9c/841c15e691c7085caa6fd162f063eff494099c8327aeccd509d1ab1e36ab/numpy-2.4.1-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a92f227dbcdc9e4c3e193add1a189a9909947d4f8504c576f4a732fd0b54240a", size = 14708058, upload-time = "2026-01-10T06:42:23.546Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/9d/7862db06743f489e6a502a3b93136d73aea27d97b2cf91504f70a27501d6/numpy-2.4.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:538bf4ec353709c765ff75ae616c34d3c3dca1a68312727e8f2676ea644f8509", size = 16651501, upload-time = "2026-01-10T06:42:25.909Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/9c/6fc34ebcbd4015c6e5f0c0ce38264010ce8a546cb6beacb457b84a75dfc8/numpy-2.4.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:ac08c63cb7779b85e9d5318e6c3518b424bc1f364ac4cb2c6136f12e5ff2dccc", size = 16492627, upload-time = "2026-01-10T06:42:28.938Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/63/2494a8597502dacda439f61b3c0db4da59928150e62be0e99395c3ad23c5/numpy-2.4.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:4f9c360ecef085e5841c539a9a12b883dff005fbd7ce46722f5e9cef52634d82", size = 18585052, upload-time = "2026-01-10T06:42:31.312Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/93/098e1162ae7522fc9b618d6272b77404c4656c72432ecee3abc029aa3de0/numpy-2.4.1-cp311-cp311-win32.whl", hash = "sha256:0f118ce6b972080ba0758c6087c3617b5ba243d806268623dc34216d69099ba0", size = 6236575, upload-time = "2026-01-10T06:42:33.872Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/de/f5e79650d23d9e12f38a7bc6b03ea0835b9575494f8ec94c11c6e773b1b1/numpy-2.4.1-cp311-cp311-win_amd64.whl", hash = "sha256:18e14c4d09d55eef39a6ab5b08406e84bc6869c1e34eef45564804f90b7e0574", size = 12604479, upload-time = "2026-01-10T06:42:35.778Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/65/e1097a7047cff12ce3369bd003811516b20ba1078dbdec135e1cd7c16c56/numpy-2.4.1-cp311-cp311-win_arm64.whl", hash = "sha256:6461de5113088b399d655d45c3897fa188766415d0f568f175ab071c8873bd73", size = 10578325, upload-time = "2026-01-10T06:42:38.518Z" },
+    { url = "https://files.pythonhosted.org/packages/78/7f/ec53e32bf10c813604edf07a3682616bd931d026fcde7b6d13195dfb684a/numpy-2.4.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d3703409aac693fa82c0aee023a1ae06a6e9d065dba10f5e8e80f642f1e9d0a2", size = 16656888, upload-time = "2026-01-10T06:42:40.913Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/e0/1f9585d7dae8f14864e948fd7fa86c6cb72dee2676ca2748e63b1c5acfe0/numpy-2.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:7211b95ca365519d3596a1d8688a95874cc94219d417504d9ecb2df99fa7bfa8", size = 12373956, upload-time = "2026-01-10T06:42:43.091Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/43/9762e88909ff2326f5e7536fa8cb3c49fb03a7d92705f23e6e7f553d9cb3/numpy-2.4.1-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:5adf01965456a664fc727ed69cc71848f28d063217c63e1a0e200a118d5eec9a", size = 5202567, upload-time = "2026-01-10T06:42:45.107Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/ee/34b7930eb61e79feb4478800a4b95b46566969d837546aa7c034c742ef98/numpy-2.4.1-cp312-cp312-macosx_14_0_x86_64.whl", hash = "sha256:26f0bcd9c79a00e339565b303badc74d3ea2bd6d52191eeca5f95936cad107d0", size = 6549459, upload-time = "2026-01-10T06:42:48.152Z" },
+    { url = "https://files.pythonhosted.org/packages/79/e3/5f115fae982565771be994867c89bcd8d7208dbfe9469185497d70de5ddf/numpy-2.4.1-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0093e85df2960d7e4049664b26afc58b03236e967fb942354deef3208857a04c", size = 14404859, upload-time = "2026-01-10T06:42:49.947Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/7d/9c8a781c88933725445a859cac5d01b5871588a15969ee6aeb618ba99eee/numpy-2.4.1-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7ad270f438cbdd402c364980317fb6b117d9ec5e226fff5b4148dd9aa9fc6e02", size = 16371419, upload-time = "2026-01-10T06:42:52.409Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/d2/8aa084818554543f17cf4162c42f162acbd3bb42688aefdba6628a859f77/numpy-2.4.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:297c72b1b98100c2e8f873d5d35fb551fce7040ade83d67dd51d38c8d42a2162", size = 16182131, upload-time = "2026-01-10T06:42:54.694Z" },
+    { url = "https://files.pythonhosted.org/packages/60/db/0425216684297c58a8df35f3284ef56ec4a043e6d283f8a59c53562caf1b/numpy-2.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:cf6470d91d34bf669f61d515499859fa7a4c2f7c36434afb70e82df7217933f9", size = 18295342, upload-time = "2026-01-10T06:42:56.991Z" },
+    { url = "https://files.pythonhosted.org/packages/31/4c/14cb9d86240bd8c386c881bafbe43f001284b7cce3bc01623ac9475da163/numpy-2.4.1-cp312-cp312-win32.whl", hash = "sha256:b6bcf39112e956594b3331316d90c90c90fb961e39696bda97b89462f5f3943f", size = 5959015, upload-time = "2026-01-10T06:42:59.631Z" },
+    { url = "https://files.pythonhosted.org/packages/51/cf/52a703dbeb0c65807540d29699fef5fda073434ff61846a564d5c296420f/numpy-2.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:e1a27bb1b2dee45a2a53f5ca6ff2d1a7f135287883a1689e930d44d1ff296c87", size = 12310730, upload-time = "2026-01-10T06:43:01.627Z" },
+    { url = "https://files.pythonhosted.org/packages/69/80/a828b2d0ade5e74a9fe0f4e0a17c30fdc26232ad2bc8c9f8b3197cf7cf18/numpy-2.4.1-cp312-cp312-win_arm64.whl", hash = "sha256:0e6e8f9d9ecf95399982019c01223dc130542960a12edfa8edd1122dfa66a8a8", size = 10312166, upload-time = "2026-01-10T06:43:03.673Z" },
+    { url = "https://files.pythonhosted.org/packages/04/68/732d4b7811c00775f3bd522a21e8dd5a23f77eb11acdeb663e4a4ebf0ef4/numpy-2.4.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:d797454e37570cfd61143b73b8debd623c3c0952959adb817dd310a483d58a1b", size = 16652495, upload-time = "2026-01-10T06:43:06.283Z" },
+    { url = "https://files.pythonhosted.org/packages/20/ca/857722353421a27f1465652b2c66813eeeccea9d76d5f7b74b99f298e60e/numpy-2.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:82c55962006156aeef1629b953fd359064aa47e4d82cfc8e67f0918f7da3344f", size = 12368657, upload-time = "2026-01-10T06:43:09.094Z" },
+    { url = "https://files.pythonhosted.org/packages/81/0d/2377c917513449cc6240031a79d30eb9a163d32a91e79e0da47c43f2c0c8/numpy-2.4.1-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:71abbea030f2cfc3092a0ff9f8c8fdefdc5e0bf7d9d9c99663538bb0ecdac0b9", size = 5197256, upload-time = "2026-01-10T06:43:13.634Z" },
+    { url = "https://files.pythonhosted.org/packages/17/39/569452228de3f5de9064ac75137082c6214be1f5c532016549a7923ab4b5/numpy-2.4.1-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:5b55aa56165b17aaf15520beb9cbd33c9039810e0d9643dd4379e44294c7303e", size = 6545212, upload-time = "2026-01-10T06:43:15.661Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/a4/77333f4d1e4dac4395385482557aeecf4826e6ff517e32ca48e1dafbe42a/numpy-2.4.1-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c0faba4a331195bfa96f93dd9dfaa10b2c7aa8cda3a02b7fd635e588fe821bf5", size = 14402871, upload-time = "2026-01-10T06:43:17.324Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/87/d341e519956273b39d8d47969dd1eaa1af740615394fe67d06f1efa68773/numpy-2.4.1-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d3e3087f53e2b4428766b54932644d148613c5a595150533ae7f00dab2f319a8", size = 16359305, upload-time = "2026-01-10T06:43:19.376Z" },
+    { url = "https://files.pythonhosted.org/packages/32/91/789132c6666288eaa20ae8066bb99eba1939362e8f1a534949a215246e97/numpy-2.4.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:49e792ec351315e16da54b543db06ca8a86985ab682602d90c60ef4ff4db2a9c", size = 16181909, upload-time = "2026-01-10T06:43:21.808Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/b8/090b8bd27b82a844bb22ff8fdf7935cb1980b48d6e439ae116f53cdc2143/numpy-2.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:79e9e06c4c2379db47f3f6fc7a8652e7498251789bf8ff5bd43bf478ef314ca2", size = 18284380, upload-time = "2026-01-10T06:43:23.957Z" },
+    { url = "https://files.pythonhosted.org/packages/67/78/722b62bd31842ff029412271556a1a27a98f45359dea78b1548a3a9996aa/numpy-2.4.1-cp313-cp313-win32.whl", hash = "sha256:3d1a100e48cb266090a031397863ff8a30050ceefd798f686ff92c67a486753d", size = 5957089, upload-time = "2026-01-10T06:43:27.535Z" },
+    { url = "https://files.pythonhosted.org/packages/da/a6/cf32198b0b6e18d4fbfa9a21a992a7fca535b9bb2b0cdd217d4a3445b5ca/numpy-2.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:92a0e65272fd60bfa0d9278e0484c2f52fe03b97aedc02b357f33fe752c52ffb", size = 12307230, upload-time = "2026-01-10T06:43:29.298Z" },
+    { url = "https://files.pythonhosted.org/packages/44/6c/534d692bfb7d0afe30611320c5fb713659dcb5104d7cc182aff2aea092f5/numpy-2.4.1-cp313-cp313-win_arm64.whl", hash = "sha256:20d4649c773f66cc2fc36f663e091f57c3b7655f936a4c681b4250855d1da8f5", size = 10313125, upload-time = "2026-01-10T06:43:31.782Z" },
+    { url = "https://files.pythonhosted.org/packages/da/a1/354583ac5c4caa566de6ddfbc42744409b515039e085fab6e0ff942e0df5/numpy-2.4.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:f93bc6892fe7b0663e5ffa83b61aab510aacffd58c16e012bb9352d489d90cb7", size = 12496156, upload-time = "2026-01-10T06:43:34.237Z" },
+    { url = "https://files.pythonhosted.org/packages/51/b0/42807c6e8cce58c00127b1dc24d365305189991f2a7917aa694a109c8d7d/numpy-2.4.1-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:178de8f87948163d98a4c9ab5bee4ce6519ca918926ec8df195af582de28544d", size = 5324663, upload-time = "2026-01-10T06:43:36.211Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/55/7a621694010d92375ed82f312b2f28017694ed784775269115323e37f5e2/numpy-2.4.1-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:98b35775e03ab7f868908b524fc0a84d38932d8daf7b7e1c3c3a1b6c7a2c9f15", size = 6645224, upload-time = "2026-01-10T06:43:37.884Z" },
+    { url = "https://files.pythonhosted.org/packages/50/96/9fa8635ed9d7c847d87e30c834f7109fac5e88549d79ef3324ab5c20919f/numpy-2.4.1-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:941c2a93313d030f219f3a71fd3d91a728b82979a5e8034eb2e60d394a2b83f9", size = 14462352, upload-time = "2026-01-10T06:43:39.479Z" },
+    { url = "https://files.pythonhosted.org/packages/03/d1/8cf62d8bb2062da4fb82dd5d49e47c923f9c0738032f054e0a75342faba7/numpy-2.4.1-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:529050522e983e00a6c1c6b67411083630de8b57f65e853d7b03d9281b8694d2", size = 16407279, upload-time = "2026-01-10T06:43:41.93Z" },
+    { url = "https://files.pythonhosted.org/packages/86/1c/95c86e17c6b0b31ce6ef219da00f71113b220bcb14938c8d9a05cee0ff53/numpy-2.4.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:2302dc0224c1cbc49bb94f7064f3f923a971bfae45c33870dcbff63a2a550505", size = 16248316, upload-time = "2026-01-10T06:43:44.121Z" },
+    { url = "https://files.pythonhosted.org/packages/30/b4/e7f5ff8697274c9d0fa82398b6a372a27e5cef069b37df6355ccb1f1db1a/numpy-2.4.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:9171a42fcad32dcf3fa86f0a4faa5e9f8facefdb276f54b8b390d90447cff4e2", size = 18329884, upload-time = "2026-01-10T06:43:46.613Z" },
+    { url = "https://files.pythonhosted.org/packages/37/a4/b073f3e9d77f9aec8debe8ca7f9f6a09e888ad1ba7488f0c3b36a94c03ac/numpy-2.4.1-cp313-cp313t-win32.whl", hash = "sha256:382ad67d99ef49024f11d1ce5dcb5ad8432446e4246a4b014418ba3a1175a1f4", size = 6081138, upload-time = "2026-01-10T06:43:48.854Z" },
+    { url = "https://files.pythonhosted.org/packages/16/16/af42337b53844e67752a092481ab869c0523bc95c4e5c98e4dac4e9581ac/numpy-2.4.1-cp313-cp313t-win_amd64.whl", hash = "sha256:62fea415f83ad8fdb6c20840578e5fbaf5ddd65e0ec6c3c47eda0f69da172510", size = 12447478, upload-time = "2026-01-10T06:43:50.476Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/f8/fa85b2eac68ec631d0b631abc448552cb17d39afd17ec53dcbcc3537681a/numpy-2.4.1-cp313-cp313t-win_arm64.whl", hash = "sha256:a7870e8c5fc11aef57d6fea4b4085e537a3a60ad2cdd14322ed531fdca68d261", size = 10382981, upload-time = "2026-01-10T06:43:52.575Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/48/d86f97919e79314a1cdee4c832178763e6e98e623e123d0bada19e92c15a/numpy-2.4.1-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:8ad35f20be147a204e28b6a0575fbf3540c5e5f802634d4258d55b1ff5facce1", size = 16822202, upload-time = "2026-01-10T06:44:43.738Z" },
+    { url = "https://files.pythonhosted.org/packages/51/e9/1e62a7f77e0f37dcfb0ad6a9744e65df00242b6ea37dfafb55debcbf5b55/numpy-2.4.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:8097529164c0f3e32bb89412a0905d9100bf434d9692d9fc275e18dcf53c9344", size = 12569985, upload-time = "2026-01-10T06:44:45.945Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/7e/914d54f0c801342306fdcdce3e994a56476f1b818c46c47fc21ae968088c/numpy-2.4.1-pp311-pypy311_pp73-macosx_14_0_arm64.whl", hash = "sha256:ea66d2b41ca4a1630aae5507ee0a71647d3124d1741980138aa8f28f44dac36e", size = 5398484, upload-time = "2026-01-10T06:44:48.012Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/d8/9570b68584e293a33474e7b5a77ca404f1dcc655e40050a600dee81d27fb/numpy-2.4.1-pp311-pypy311_pp73-macosx_14_0_x86_64.whl", hash = "sha256:d3f8f0df9f4b8be57b3bf74a1d087fec68f927a2fab68231fdb442bf2c12e426", size = 6713216, upload-time = "2026-01-10T06:44:49.725Z" },
+    { url = "https://files.pythonhosted.org/packages/33/9b/9dd6e2db8d49eb24f86acaaa5258e5f4c8ed38209a4ee9de2d1a0ca25045/numpy-2.4.1-pp311-pypy311_pp73-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2023ef86243690c2791fd6353e5b4848eedaa88ca8a2d129f462049f6d484696", size = 14538937, upload-time = "2026-01-10T06:44:51.498Z" },
+    { url = "https://files.pythonhosted.org/packages/53/87/d5bd995b0f798a37105b876350d346eea5838bd8f77ea3d7a48392f3812b/numpy-2.4.1-pp311-pypy311_pp73-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8361ea4220d763e54cff2fbe7d8c93526b744f7cd9ddab47afeff7e14e8503be", size = 16479830, upload-time = "2026-01-10T06:44:53.931Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/c7/b801bf98514b6ae6475e941ac05c58e6411dd863ea92916bfd6d510b08c1/numpy-2.4.1-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:4f1b68ff47680c2925f8063402a693ede215f0257f02596b1318ecdfb1d79e33", size = 12492579, upload-time = "2026-01-10T06:44:57.094Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "25.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a1/d4/1fc4078c65507b51b96ca8f8c3ba19e6a61c8253c72794544580a7b6c24d/packaging-25.0.tar.gz", hash = "sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f", size = 165727, upload-time = "2025-04-19T11:48:59.673Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/20/12/38679034af332785aac8774540895e234f4d07f7545804097de4b666afd8/packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484", size = 66469, upload-time = "2025-04-19T11:48:57.875Z" },
+]
+
+[[package]]
+name = "pandas"
+version = "2.3.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "numpy" },
+    { name = "python-dateutil" },
+    { name = "pytz" },
+    { name = "tzdata" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/33/01/d40b85317f86cf08d853a4f495195c73815fdf205eef3993821720274518/pandas-2.3.3.tar.gz", hash = "sha256:e05e1af93b977f7eafa636d043f9f94c7ee3ac81af99c13508215942e64c993b", size = 4495223, upload-time = "2025-09-29T23:34:51.853Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c1/fa/7ac648108144a095b4fb6aa3de1954689f7af60a14cf25583f4960ecb878/pandas-2.3.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:602b8615ebcc4a0c1751e71840428ddebeb142ec02c786e8ad6b1ce3c8dec523", size = 11578790, upload-time = "2025-09-29T23:18:30.065Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/35/74442388c6cf008882d4d4bdfc4109be87e9b8b7ccd097ad1e7f006e2e95/pandas-2.3.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:8fe25fc7b623b0ef6b5009149627e34d2a4657e880948ec3c840e9402e5c1b45", size = 10833831, upload-time = "2025-09-29T23:38:56.071Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/e4/de154cbfeee13383ad58d23017da99390b91d73f8c11856f2095e813201b/pandas-2.3.3-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b468d3dad6ff947df92dcb32ede5b7bd41a9b3cceef0a30ed925f6d01fb8fa66", size = 12199267, upload-time = "2025-09-29T23:18:41.627Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/c9/63f8d545568d9ab91476b1818b4741f521646cbdd151c6efebf40d6de6f7/pandas-2.3.3-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b98560e98cb334799c0b07ca7967ac361a47326e9b4e5a7dfb5ab2b1c9d35a1b", size = 12789281, upload-time = "2025-09-29T23:18:56.834Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/00/a5ac8c7a0e67fd1a6059e40aa08fa1c52cc00709077d2300e210c3ce0322/pandas-2.3.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1d37b5848ba49824e5c30bedb9c830ab9b7751fd049bc7914533e01c65f79791", size = 13240453, upload-time = "2025-09-29T23:19:09.247Z" },
+    { url = "https://files.pythonhosted.org/packages/27/4d/5c23a5bc7bd209231618dd9e606ce076272c9bc4f12023a70e03a86b4067/pandas-2.3.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:db4301b2d1f926ae677a751eb2bd0e8c5f5319c9cb3f88b0becbbb0b07b34151", size = 13890361, upload-time = "2025-09-29T23:19:25.342Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/59/712db1d7040520de7a4965df15b774348980e6df45c129b8c64d0dbe74ef/pandas-2.3.3-cp311-cp311-win_amd64.whl", hash = "sha256:f086f6fe114e19d92014a1966f43a3e62285109afe874f067f5abbdcbb10e59c", size = 11348702, upload-time = "2025-09-29T23:19:38.296Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/fb/231d89e8637c808b997d172b18e9d4a4bc7bf31296196c260526055d1ea0/pandas-2.3.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:6d21f6d74eb1725c2efaa71a2bfc661a0689579b58e9c0ca58a739ff0b002b53", size = 11597846, upload-time = "2025-09-29T23:19:48.856Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/bd/bf8064d9cfa214294356c2d6702b716d3cf3bb24be59287a6a21e24cae6b/pandas-2.3.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:3fd2f887589c7aa868e02632612ba39acb0b8948faf5cc58f0850e165bd46f35", size = 10729618, upload-time = "2025-09-29T23:39:08.659Z" },
+    { url = "https://files.pythonhosted.org/packages/57/56/cf2dbe1a3f5271370669475ead12ce77c61726ffd19a35546e31aa8edf4e/pandas-2.3.3-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ecaf1e12bdc03c86ad4a7ea848d66c685cb6851d807a26aa245ca3d2017a1908", size = 11737212, upload-time = "2025-09-29T23:19:59.765Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/63/cd7d615331b328e287d8233ba9fdf191a9c2d11b6af0c7a59cfcec23de68/pandas-2.3.3-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b3d11d2fda7eb164ef27ffc14b4fcab16a80e1ce67e9f57e19ec0afaf715ba89", size = 12362693, upload-time = "2025-09-29T23:20:14.098Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/de/8b1895b107277d52f2b42d3a6806e69cfef0d5cf1d0ba343470b9d8e0a04/pandas-2.3.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:a68e15f780eddf2b07d242e17a04aa187a7ee12b40b930bfdd78070556550e98", size = 12771002, upload-time = "2025-09-29T23:20:26.76Z" },
+    { url = "https://files.pythonhosted.org/packages/87/21/84072af3187a677c5893b170ba2c8fbe450a6ff911234916da889b698220/pandas-2.3.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:371a4ab48e950033bcf52b6527eccb564f52dc826c02afd9a1bc0ab731bba084", size = 13450971, upload-time = "2025-09-29T23:20:41.344Z" },
+    { url = "https://files.pythonhosted.org/packages/86/41/585a168330ff063014880a80d744219dbf1dd7a1c706e75ab3425a987384/pandas-2.3.3-cp312-cp312-win_amd64.whl", hash = "sha256:a16dcec078a01eeef8ee61bf64074b4e524a2a3f4b3be9326420cabe59c4778b", size = 10992722, upload-time = "2025-09-29T23:20:54.139Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/4b/18b035ee18f97c1040d94debd8f2e737000ad70ccc8f5513f4eefad75f4b/pandas-2.3.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:56851a737e3470de7fa88e6131f41281ed440d29a9268dcbf0002da5ac366713", size = 11544671, upload-time = "2025-09-29T23:21:05.024Z" },
+    { url = "https://files.pythonhosted.org/packages/31/94/72fac03573102779920099bcac1c3b05975c2cb5f01eac609faf34bed1ca/pandas-2.3.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:bdcd9d1167f4885211e401b3036c0c8d9e274eee67ea8d0758a256d60704cfe8", size = 10680807, upload-time = "2025-09-29T23:21:15.979Z" },
+    { url = "https://files.pythonhosted.org/packages/16/87/9472cf4a487d848476865321de18cc8c920b8cab98453ab79dbbc98db63a/pandas-2.3.3-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e32e7cc9af0f1cc15548288a51a3b681cc2a219faa838e995f7dc53dbab1062d", size = 11709872, upload-time = "2025-09-29T23:21:27.165Z" },
+    { url = "https://files.pythonhosted.org/packages/15/07/284f757f63f8a8d69ed4472bfd85122bd086e637bf4ed09de572d575a693/pandas-2.3.3-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:318d77e0e42a628c04dc56bcef4b40de67918f7041c2b061af1da41dcff670ac", size = 12306371, upload-time = "2025-09-29T23:21:40.532Z" },
+    { url = "https://files.pythonhosted.org/packages/33/81/a3afc88fca4aa925804a27d2676d22dcd2031c2ebe08aabd0ae55b9ff282/pandas-2.3.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:4e0a175408804d566144e170d0476b15d78458795bb18f1304fb94160cabf40c", size = 12765333, upload-time = "2025-09-29T23:21:55.77Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/0f/b4d4ae743a83742f1153464cf1a8ecfafc3ac59722a0b5c8602310cb7158/pandas-2.3.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:93c2d9ab0fc11822b5eece72ec9587e172f63cff87c00b062f6e37448ced4493", size = 13418120, upload-time = "2025-09-29T23:22:10.109Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/c7/e54682c96a895d0c808453269e0b5928a07a127a15704fedb643e9b0a4c8/pandas-2.3.3-cp313-cp313-win_amd64.whl", hash = "sha256:f8bfc0e12dc78f777f323f55c58649591b2cd0c43534e8355c51d3fede5f4dee", size = 10993991, upload-time = "2025-09-29T23:25:04.889Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/ca/3f8d4f49740799189e1395812f3bf23b5e8fc7c190827d55a610da72ce55/pandas-2.3.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:75ea25f9529fdec2d2e93a42c523962261e567d250b0013b16210e1d40d7c2e5", size = 12048227, upload-time = "2025-09-29T23:22:24.343Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/5a/f43efec3e8c0cc92c4663ccad372dbdff72b60bdb56b2749f04aa1d07d7e/pandas-2.3.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:74ecdf1d301e812db96a465a525952f4dde225fdb6d8e5a521d47e1f42041e21", size = 11411056, upload-time = "2025-09-29T23:22:37.762Z" },
+    { url = "https://files.pythonhosted.org/packages/46/b1/85331edfc591208c9d1a63a06baa67b21d332e63b7a591a5ba42a10bb507/pandas-2.3.3-cp313-cp313t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6435cb949cb34ec11cc9860246ccb2fdc9ecd742c12d3304989017d53f039a78", size = 11645189, upload-time = "2025-09-29T23:22:51.688Z" },
+    { url = "https://files.pythonhosted.org/packages/44/23/78d645adc35d94d1ac4f2a3c4112ab6f5b8999f4898b8cdf01252f8df4a9/pandas-2.3.3-cp313-cp313t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:900f47d8f20860de523a1ac881c4c36d65efcb2eb850e6948140fa781736e110", size = 12121912, upload-time = "2025-09-29T23:23:05.042Z" },
+    { url = "https://files.pythonhosted.org/packages/53/da/d10013df5e6aaef6b425aa0c32e1fc1f3e431e4bcabd420517dceadce354/pandas-2.3.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:a45c765238e2ed7d7c608fc5bc4a6f88b642f2f01e70c0c23d2224dd21829d86", size = 12712160, upload-time = "2025-09-29T23:23:28.57Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/17/e756653095a083d8a37cbd816cb87148debcfcd920129b25f99dd8d04271/pandas-2.3.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:c4fc4c21971a1a9f4bdb4c73978c7f7256caa3e62b323f70d6cb80db583350bc", size = 13199233, upload-time = "2025-09-29T23:24:24.876Z" },
+]
+
+[[package]]
+name = "plotly"
+version = "5.24.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "packaging" },
+    { name = "tenacity" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/79/4f/428f6d959818d7425a94c190a6b26fbc58035cbef40bf249be0b62a9aedd/plotly-5.24.1.tar.gz", hash = "sha256:dbc8ac8339d248a4bcc36e08a5659bacfe1b079390b8953533f4eb22169b4bae", size = 9479398, upload-time = "2024-09-12T15:36:31.068Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e5/ae/580600f441f6fc05218bd6c9d5794f4aef072a7d9093b291f1c50a9db8bc/plotly-5.24.1-py3-none-any.whl", hash = "sha256:f67073a1e637eb0dc3e46324d9d51e2fe76e9727c892dde64ddf1e1b51f29089", size = 19054220, upload-time = "2024-09-12T15:36:24.08Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "prek"
+version = "0.4.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f6/13/3d71b3adbf385f7dc7fb6e16d6e25421fd8398b45d8f8410a328bf22bd3f/prek-0.4.4.tar.gz", hash = "sha256:4ec5771153d158a0e4473933b7fd9b51e1b1f57f2df50aeb7560ea6812226dc5", size = 470641, upload-time = "2026-06-04T07:26:07.199Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/06/9f/68a577888edf7f2647a652b02899508ccd84e57ce1f79c51a44edfd308d7/prek-0.4.4-py3-none-linux_armv6l.whl", hash = "sha256:23cfd96a25de1c93e3c43c746643b80489e3b2fa49ca9c0ffd6022e51535c900", size = 5550271, upload-time = "2026-06-04T07:26:17.834Z" },
+    { url = "https://files.pythonhosted.org/packages/35/b8/5427a0023116343a8d787b446536a7fddfa5db7eec7713dd05618da2bdfe/prek-0.4.4-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:a427b792c4436f49732b1f6ebccf221fdcc6390c148474280da9c2c6eaabc9c4", size = 5910136, upload-time = "2026-06-04T07:26:20.616Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/4f/d751e90b7e768e472e054cd41cbe502589436ca9c1a13bfe4fa9513f9cde/prek-0.4.4-py3-none-macosx_11_0_arm64.whl", hash = "sha256:b998038fc92c990e03147eb5b95b0f2c394517f8857ab911aac8e092f1b9b3ab", size = 5470124, upload-time = "2026-06-04T07:26:29.23Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/fe/e73241c5777b6f9b6b95132febbd27f9be9e89912e9e93c0982680593af2/prek-0.4.4-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl", hash = "sha256:9cebca8c15da4f1d6e3a25e6ae0611425c8596e926222050f2588c390e42df8a", size = 5732725, upload-time = "2026-06-04T07:26:19.133Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/a3/329bd910e7e5d9d0eb5e571f3ba48023213744e78411afb81f5ef8356cab/prek-0.4.4-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c8742ac26363e74c855df6215a709d5db183204d00ac0f1a722b13aed4da3cd0", size = 5457953, upload-time = "2026-06-04T07:26:23.41Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/f8/d642990513d9707398506bad45d39173d84266231f7d919899f694aefe2c/prek-0.4.4-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a2b7c8710546a1e894afa7ab022030cd4e21f1ee7ffb301b4360773d22f1f00f", size = 5860556, upload-time = "2026-06-04T07:26:11.692Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/17/a2e29cb278503a8c18612d8a62a15020648dc768e2e94bc4b4d4c9411e07/prek-0.4.4-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e02bd4d5e05c500e4d9f70f024e30d13aa361dc490724b7f476d2e35542c239f", size = 6652492, upload-time = "2026-06-04T07:26:09.962Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/10/ad3270b18135ee5d1af6f6cf4b0c8601b1cc2cb38d16e835081da820833a/prek-0.4.4-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f3a25041733de987a47e5a7bace47182a6f0e2ae5f960cb54c1d4630afd2591", size = 6113837, upload-time = "2026-06-04T07:26:24.873Z" },
+    { url = "https://files.pythonhosted.org/packages/59/d9/e8c201b9b41c4561673cea01c630ab604df89d13e952f87dbcb807d32588/prek-0.4.4-py3-none-manylinux_2_28_aarch64.whl", hash = "sha256:0b04a0f36d07474f2a9fc5b1ba1197a1b326b2b211f39cd74cf0d4613545f7f4", size = 5729155, upload-time = "2026-06-04T07:26:26.194Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/cd/227b0494fcbc91e8fe15c2a4db9e6dfff95314ef38db3e40e6ea96db249d/prek-0.4.4-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:f032ccbe2d6edc345f81a6d772c18cc169d63c27b5a8292bfe416b352bdfee57", size = 5590775, upload-time = "2026-06-04T07:26:22.038Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/e0/9d750b9cf21ece884afdc15668d0f005a36588fe1b0bb5ff4a8112ab51cb/prek-0.4.4-py3-none-musllinux_1_1_armv7l.whl", hash = "sha256:bad3586fcea3e913f0edf2e8f132f97889e03976b7ee3d120fd294ad4e89a5eb", size = 5437864, upload-time = "2026-06-04T07:26:30.673Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/48/e2e5c0299590ad18a253c0ac09508b615baa1b382010c511186572f711d3/prek-0.4.4-py3-none-musllinux_1_1_i686.whl", hash = "sha256:4058638532c6dcbf0076d23b9264cbdd9f0f0e320762e237a6b9e4e4b854a766", size = 5718579, upload-time = "2026-06-04T07:26:27.786Z" },
+    { url = "https://files.pythonhosted.org/packages/54/48/7fb3d4e7f664d1ce8ae35ec553872ffddf9fab4c5081735fdaae610b1e7c/prek-0.4.4-py3-none-musllinux_1_1_x86_64.whl", hash = "sha256:619bab14071670249777deea0cc0b29d904c4a514cf33b20e583900a544f0399", size = 6231622, upload-time = "2026-06-04T07:26:16.309Z" },
+    { url = "https://files.pythonhosted.org/packages/46/c0/a4ddbf38034afe67cfa97c4bd81c86429ada098e7c323218d9f9fd061566/prek-0.4.4-py3-none-win32.whl", hash = "sha256:143154b329c05b2f9fa3230e604d02d9c4297dd43f96135a8ba166772e8ecd60", size = 5240317, upload-time = "2026-06-04T07:26:08.726Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/8c/fe97b5b095187bb2f93bbe406bccf108c879e5e4c83f165809b0d16ce0fb/prek-0.4.4-py3-none-win_amd64.whl", hash = "sha256:c38c5140ae2ea55ebb02e6ca590a416664ea1af287cdd21f54daeec53a81015a", size = 5626104, upload-time = "2026-06-04T07:26:14.81Z" },
+    { url = "https://files.pythonhosted.org/packages/25/63/3586226d536796e65f8e725b531d6104e55caaa18659bdcb512661629586/prek-0.4.4-py3-none-win_arm64.whl", hash = "sha256:3efa28fb37b9ddbafb7759da8d497f0d36cf02a05816e15d6541f5669d5d2114", size = 5470399, upload-time = "2026-06-04T07:26:13.231Z" },
+]
+
+[[package]]
+name = "protobuf"
+version = "6.33.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/cc/5c/f912bdebdd4af4160da6a2c2b1b3aaa1b8c578d0243ba8f694f93c7095f0/protobuf-6.33.3.tar.gz", hash = "sha256:c8794debeb402963fddff41a595e1f649bcd76616ba56c835645cab4539e810e", size = 444318, upload-time = "2026-01-09T23:05:02.79Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/56/2a41b9dcc3b92fa672bb89610608f4fd4f71bec075d314956710503b29f5/protobuf-6.33.3-cp310-abi3-win32.whl", hash = "sha256:b4046f9f2ede57ad5b1d9917baafcbcad42f8151a73c755a1e2ec9557b0a764f", size = 425597, upload-time = "2026-01-09T23:04:50.11Z" },
+    { url = "https://files.pythonhosted.org/packages/23/07/1f1300fe7d204fd7aaabd9a0aafd54e6358de833b783f5bd161614e8e1e4/protobuf-6.33.3-cp310-abi3-win_amd64.whl", hash = "sha256:1fd18f030ae9df97712fbbb0849b6e54c63e3edd9b88d8c3bb4771f84d8db7a4", size = 436945, upload-time = "2026-01-09T23:04:51.921Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/5d/0ef28dded98973a26443a6a7bc49bff6206be8c57dc1d1e28e6c1147b879/protobuf-6.33.3-cp39-abi3-macosx_10_9_universal2.whl", hash = "sha256:648b7b0144222eb06cf529a3d7b01333c5f30b4196773b682d388f04db373759", size = 427594, upload-time = "2026-01-09T23:04:53.358Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/46/551c69b6ff1957bd703654342bfb776bb97db400bc80afc56fbb64e7c11d/protobuf-6.33.3-cp39-abi3-manylinux2014_aarch64.whl", hash = "sha256:08a6ca12f60ba99097dd3625ef4275280f99c9037990e47ce9368826b159b890", size = 324469, upload-time = "2026-01-09T23:04:54.332Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/6d/ade1cca06c64a421ee9745e082671465ead28164c809efaf2c15bc93f9a0/protobuf-6.33.3-cp39-abi3-manylinux2014_s390x.whl", hash = "sha256:642fce7187526c98683c79a3ad68e5d646a5ef5eb004582fe123fc9a33a9456b", size = 339242, upload-time = "2026-01-09T23:04:55.347Z" },
+    { url = "https://files.pythonhosted.org/packages/38/8c/6522b8e543ece46f645911c3cebe361d8460134c0fee02ddcf70ebf32999/protobuf-6.33.3-cp39-abi3-manylinux2014_x86_64.whl", hash = "sha256:6fa9b5f4baa12257542273e5e6f3c3d3867b30bc2770c14ad9ac8315264bf986", size = 323298, upload-time = "2026-01-09T23:04:56.866Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/b9/067b8a843569d5605ba6f7c039b9319720a974f82216cd623e13186d3078/protobuf-6.33.3-py3-none-any.whl", hash = "sha256:c2bf221076b0d463551efa2e1319f08d4cffcc5f0d864614ccd3d0e77a637794", size = 170518, upload-time = "2026-01-09T23:05:01.227Z" },
+]
+
+[[package]]
+name = "psutil"
+version = "7.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/73/cb/09e5184fb5fc0358d110fc3ca7f6b1d033800734d34cac10f4136cfac10e/psutil-7.2.1.tar.gz", hash = "sha256:f7583aec590485b43ca601dd9cea0dcd65bd7bb21d30ef4ddbf4ea6b5ed1bdd3", size = 490253, upload-time = "2025-12-29T08:26:00.169Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/77/8e/f0c242053a368c2aa89584ecd1b054a18683f13d6e5a318fc9ec36582c94/psutil-7.2.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:ba9f33bb525b14c3ea563b2fd521a84d2fa214ec59e3e6a2858f78d0844dd60d", size = 129624, upload-time = "2025-12-29T08:26:04.255Z" },
+    { url = "https://files.pythonhosted.org/packages/26/97/a58a4968f8990617decee234258a2b4fc7cd9e35668387646c1963e69f26/psutil-7.2.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:81442dac7abfc2f4f4385ea9e12ddf5a796721c0f6133260687fec5c3780fa49", size = 130132, upload-time = "2025-12-29T08:26:06.228Z" },
+    { url = "https://files.pythonhosted.org/packages/db/6d/ed44901e830739af5f72a85fa7ec5ff1edea7f81bfbf4875e409007149bd/psutil-7.2.1-cp313-cp313t-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ea46c0d060491051d39f0d2cff4f98d5c72b288289f57a21556cc7d504db37fc", size = 180612, upload-time = "2025-12-29T08:26:08.276Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/65/b628f8459bca4efbfae50d4bf3feaab803de9a160b9d5f3bd9295a33f0c2/psutil-7.2.1-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:35630d5af80d5d0d49cfc4d64c1c13838baf6717a13effb35869a5919b854cdf", size = 183201, upload-time = "2025-12-29T08:26:10.622Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/23/851cadc9764edcc18f0effe7d0bf69f727d4cf2442deb4a9f78d4e4f30f2/psutil-7.2.1-cp313-cp313t-win_amd64.whl", hash = "sha256:923f8653416604e356073e6e0bccbe7c09990acef442def2f5640dd0faa9689f", size = 139081, upload-time = "2025-12-29T08:26:12.483Z" },
+    { url = "https://files.pythonhosted.org/packages/59/82/d63e8494ec5758029f31c6cb06d7d161175d8281e91d011a4a441c8a43b5/psutil-7.2.1-cp313-cp313t-win_arm64.whl", hash = "sha256:cfbe6b40ca48019a51827f20d830887b3107a74a79b01ceb8cc8de4ccb17b672", size = 134767, upload-time = "2025-12-29T08:26:14.528Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/cf/5180eb8c8bdf6a503c6919f1da28328bd1e6b3b1b5b9d5b01ae64f019616/psutil-7.2.1-cp36-abi3-macosx_10_9_x86_64.whl", hash = "sha256:b2e953fcfaedcfbc952b44744f22d16575d3aa78eb4f51ae74165b4e96e55f42", size = 128137, upload-time = "2025-12-29T08:26:27.759Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/2c/78e4a789306a92ade5000da4f5de3255202c534acdadc3aac7b5458fadef/psutil-7.2.1-cp36-abi3-macosx_11_0_arm64.whl", hash = "sha256:05cc68dbb8c174828624062e73078e7e35406f4ca2d0866c272c2410d8ef06d1", size = 128947, upload-time = "2025-12-29T08:26:29.548Z" },
+    { url = "https://files.pythonhosted.org/packages/29/f8/40e01c350ad9a2b3cb4e6adbcc8a83b17ee50dd5792102b6142385937db5/psutil-7.2.1-cp36-abi3-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5e38404ca2bb30ed7267a46c02f06ff842e92da3bb8c5bfdadbd35a5722314d8", size = 154694, upload-time = "2025-12-29T08:26:32.147Z" },
+    { url = "https://files.pythonhosted.org/packages/06/e4/b751cdf839c011a9714a783f120e6a86b7494eb70044d7d81a25a5cd295f/psutil-7.2.1-cp36-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ab2b98c9fc19f13f59628d94df5cc4cc4844bc572467d113a8b517d634e362c6", size = 156136, upload-time = "2025-12-29T08:26:34.079Z" },
+    { url = "https://files.pythonhosted.org/packages/44/ad/bbf6595a8134ee1e94a4487af3f132cef7fce43aef4a93b49912a48c3af7/psutil-7.2.1-cp36-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:f78baafb38436d5a128f837fab2d92c276dfb48af01a240b861ae02b2413ada8", size = 148108, upload-time = "2025-12-29T08:26:36.225Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/15/dd6fd869753ce82ff64dcbc18356093471a5a5adf4f77ed1f805d473d859/psutil-7.2.1-cp36-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:99a4cd17a5fdd1f3d014396502daa70b5ec21bf4ffe38393e152f8e449757d67", size = 147402, upload-time = "2025-12-29T08:26:39.21Z" },
+    { url = "https://files.pythonhosted.org/packages/34/68/d9317542e3f2b180c4306e3f45d3c922d7e86d8ce39f941bb9e2e9d8599e/psutil-7.2.1-cp37-abi3-win_amd64.whl", hash = "sha256:b1b0671619343aa71c20ff9767eced0483e4fc9e1f489d50923738caf6a03c17", size = 136938, upload-time = "2025-12-29T08:26:41.036Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/73/2ce007f4198c80fcf2cb24c169884f833fe93fbc03d55d302627b094ee91/psutil-7.2.1-cp37-abi3-win_arm64.whl", hash = "sha256:0d67c1822c355aa6f7314d92018fb4268a76668a536f133599b91edd48759442", size = 133836, upload-time = "2025-12-29T08:26:43.086Z" },
+]
+
+[[package]]
+name = "py4j"
+version = "0.10.9.9"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/38/31/0b210511177070c8d5d3059556194352e5753602fa64b85b7ab81ec1a009/py4j-0.10.9.9.tar.gz", hash = "sha256:f694cad19efa5bd1dee4f3e5270eb406613c974394035e5bfc4ec1aba870b879", size = 761089, upload-time = "2025-01-15T03:53:18.624Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/bd/db/ea0203e495be491c85af87b66e37acfd3bf756fd985f87e46fc5e3bf022c/py4j-0.10.9.9-py2.py3-none-any.whl", hash = "sha256:c7c26e4158defb37b0bb124933163641a2ff6e3a3913f7811b0ddbe07ed61533", size = 203008, upload-time = "2025-01-15T03:53:15.648Z" },
+]
+
+[[package]]
+name = "pyarrow"
+version = "22.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/30/53/04a7fdc63e6056116c9ddc8b43bc28c12cdd181b85cbeadb79278475f3ae/pyarrow-22.0.0.tar.gz", hash = "sha256:3d600dc583260d845c7d8a6db540339dd883081925da2bd1c5cb808f720b3cd9", size = 1151151, upload-time = "2025-10-24T12:30:00.762Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2e/b7/18f611a8cdc43417f9394a3ccd3eace2f32183c08b9eddc3d17681819f37/pyarrow-22.0.0-cp311-cp311-macosx_12_0_arm64.whl", hash = "sha256:3e294c5eadfb93d78b0763e859a0c16d4051fc1c5231ae8956d61cb0b5666f5a", size = 34272022, upload-time = "2025-10-24T10:04:28.973Z" },
+    { url = "https://files.pythonhosted.org/packages/26/5c/f259e2526c67eb4b9e511741b19870a02363a47a35edbebc55c3178db22d/pyarrow-22.0.0-cp311-cp311-macosx_12_0_x86_64.whl", hash = "sha256:69763ab2445f632d90b504a815a2a033f74332997052b721002298ed6de40f2e", size = 35995834, upload-time = "2025-10-24T10:04:35.467Z" },
+    { url = "https://files.pythonhosted.org/packages/50/8d/281f0f9b9376d4b7f146913b26fac0aa2829cd1ee7e997f53a27411bbb92/pyarrow-22.0.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:b41f37cabfe2463232684de44bad753d6be08a7a072f6a83447eeaf0e4d2a215", size = 45030348, upload-time = "2025-10-24T10:04:43.366Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/e5/53c0a1c428f0976bf22f513d79c73000926cb00b9c138d8e02daf2102e18/pyarrow-22.0.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:35ad0f0378c9359b3f297299c3309778bb03b8612f987399a0333a560b43862d", size = 47699480, upload-time = "2025-10-24T10:04:51.486Z" },
+    { url = "https://files.pythonhosted.org/packages/95/e1/9dbe4c465c3365959d183e6345d0a8d1dc5b02ca3f8db4760b3bc834cf25/pyarrow-22.0.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:8382ad21458075c2e66a82a29d650f963ce51c7708c7c0ff313a8c206c4fd5e8", size = 48011148, upload-time = "2025-10-24T10:04:59.585Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/b4/7caf5d21930061444c3cf4fa7535c82faf5263e22ce43af7c2759ceb5b8b/pyarrow-22.0.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:1a812a5b727bc09c3d7ea072c4eebf657c2f7066155506ba31ebf4792f88f016", size = 50276964, upload-time = "2025-10-24T10:05:08.175Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/f3/cec89bd99fa3abf826f14d4e53d3d11340ce6f6af4d14bdcd54cd83b6576/pyarrow-22.0.0-cp311-cp311-win_amd64.whl", hash = "sha256:ec5d40dd494882704fb876c16fa7261a69791e784ae34e6b5992e977bd2e238c", size = 28106517, upload-time = "2025-10-24T10:05:14.314Z" },
+    { url = "https://files.pythonhosted.org/packages/af/63/ba23862d69652f85b615ca14ad14f3bcfc5bf1b99ef3f0cd04ff93fdad5a/pyarrow-22.0.0-cp312-cp312-macosx_12_0_arm64.whl", hash = "sha256:bea79263d55c24a32b0d79c00a1c58bb2ee5f0757ed95656b01c0fb310c5af3d", size = 34211578, upload-time = "2025-10-24T10:05:21.583Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/d0/f9ad86fe809efd2bcc8be32032fa72e8b0d112b01ae56a053006376c5930/pyarrow-22.0.0-cp312-cp312-macosx_12_0_x86_64.whl", hash = "sha256:12fe549c9b10ac98c91cf791d2945e878875d95508e1a5d14091a7aaa66d9cf8", size = 35989906, upload-time = "2025-10-24T10:05:29.485Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/a8/f910afcb14630e64d673f15904ec27dd31f1e009b77033c365c84e8c1e1d/pyarrow-22.0.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:334f900ff08ce0423407af97e6c26ad5d4e3b0763645559ece6fbf3747d6a8f5", size = 45021677, upload-time = "2025-10-24T10:05:38.274Z" },
+    { url = "https://files.pythonhosted.org/packages/13/95/aec81f781c75cd10554dc17a25849c720d54feafb6f7847690478dcf5ef8/pyarrow-22.0.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:c6c791b09c57ed76a18b03f2631753a4960eefbbca80f846da8baefc6491fcfe", size = 47726315, upload-time = "2025-10-24T10:05:47.314Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/d4/74ac9f7a54cfde12ee42734ea25d5a3c9a45db78f9def949307a92720d37/pyarrow-22.0.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:c3200cb41cdbc65156e5f8c908d739b0dfed57e890329413da2748d1a2cd1a4e", size = 47990906, upload-time = "2025-10-24T10:05:58.254Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/71/fedf2499bf7a95062eafc989ace56572f3343432570e1c54e6599d5b88da/pyarrow-22.0.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:ac93252226cf288753d8b46280f4edf3433bf9508b6977f8dd8526b521a1bbb9", size = 50306783, upload-time = "2025-10-24T10:06:08.08Z" },
+    { url = "https://files.pythonhosted.org/packages/68/ed/b202abd5a5b78f519722f3d29063dda03c114711093c1995a33b8e2e0f4b/pyarrow-22.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:44729980b6c50a5f2bfcc2668d36c569ce17f8b17bccaf470c4313dcbbf13c9d", size = 27972883, upload-time = "2025-10-24T10:06:14.204Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/d6/d0fac16a2963002fc22c8fa75180a838737203d558f0ed3b564c4a54eef5/pyarrow-22.0.0-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:e6e95176209257803a8b3d0394f21604e796dadb643d2f7ca21b66c9c0b30c9a", size = 34204629, upload-time = "2025-10-24T10:06:20.274Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/9c/1d6357347fbae062ad3f17082f9ebc29cc733321e892c0d2085f42a2212b/pyarrow-22.0.0-cp313-cp313-macosx_12_0_x86_64.whl", hash = "sha256:001ea83a58024818826a9e3f89bf9310a114f7e26dfe404a4c32686f97bd7901", size = 35985783, upload-time = "2025-10-24T10:06:27.301Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/c0/782344c2ce58afbea010150df07e3a2f5fdad299cd631697ae7bd3bac6e3/pyarrow-22.0.0-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:ce20fe000754f477c8a9125543f1936ea5b8867c5406757c224d745ed033e691", size = 45020999, upload-time = "2025-10-24T10:06:35.387Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/8b/5362443737a5307a7b67c1017c42cd104213189b4970bf607e05faf9c525/pyarrow-22.0.0-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:e0a15757fccb38c410947df156f9749ae4a3c89b2393741a50521f39a8cf202a", size = 47724601, upload-time = "2025-10-24T10:06:43.551Z" },
+    { url = "https://files.pythonhosted.org/packages/69/4d/76e567a4fc2e190ee6072967cb4672b7d9249ac59ae65af2d7e3047afa3b/pyarrow-22.0.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:cedb9dd9358e4ea1d9bce3665ce0797f6adf97ff142c8e25b46ba9cdd508e9b6", size = 48001050, upload-time = "2025-10-24T10:06:52.284Z" },
+    { url = "https://files.pythonhosted.org/packages/01/5e/5653f0535d2a1aef8223cee9d92944cb6bccfee5cf1cd3f462d7cb022790/pyarrow-22.0.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:252be4a05f9d9185bb8c18e83764ebcfea7185076c07a7a662253af3a8c07941", size = 50307877, upload-time = "2025-10-24T10:07:02.405Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/f8/1d0bd75bf9328a3b826e24a16e5517cd7f9fbf8d34a3184a4566ef5a7f29/pyarrow-22.0.0-cp313-cp313-win_amd64.whl", hash = "sha256:a4893d31e5ef780b6edcaf63122df0f8d321088bb0dee4c8c06eccb1ca28d145", size = 27977099, upload-time = "2025-10-24T10:08:07.259Z" },
+    { url = "https://files.pythonhosted.org/packages/90/81/db56870c997805bf2b0f6eeeb2d68458bf4654652dccdcf1bf7a42d80903/pyarrow-22.0.0-cp313-cp313t-macosx_12_0_arm64.whl", hash = "sha256:f7fe3dbe871294ba70d789be16b6e7e52b418311e166e0e3cba9522f0f437fb1", size = 34336685, upload-time = "2025-10-24T10:07:11.47Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/98/0727947f199aba8a120f47dfc229eeb05df15bcd7a6f1b669e9f882afc58/pyarrow-22.0.0-cp313-cp313t-macosx_12_0_x86_64.whl", hash = "sha256:ba95112d15fd4f1105fb2402c4eab9068f0554435e9b7085924bcfaac2cc306f", size = 36032158, upload-time = "2025-10-24T10:07:18.626Z" },
+    { url = "https://files.pythonhosted.org/packages/96/b4/9babdef9c01720a0785945c7cf550e4acd0ebcd7bdd2e6f0aa7981fa85e2/pyarrow-22.0.0-cp313-cp313t-manylinux_2_28_aarch64.whl", hash = "sha256:c064e28361c05d72eed8e744c9605cbd6d2bb7481a511c74071fd9b24bc65d7d", size = 44892060, upload-time = "2025-10-24T10:07:26.002Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/ca/2f8804edd6279f78a37062d813de3f16f29183874447ef6d1aadbb4efa0f/pyarrow-22.0.0-cp313-cp313t-manylinux_2_28_x86_64.whl", hash = "sha256:6f9762274496c244d951c819348afbcf212714902742225f649cf02823a6a10f", size = 47504395, upload-time = "2025-10-24T10:07:34.09Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/f0/77aa5198fd3943682b2e4faaf179a674f0edea0d55d326d83cb2277d9363/pyarrow-22.0.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:a9d9ffdc2ab696f6b15b4d1f7cec6658e1d788124418cb30030afbae31c64746", size = 48066216, upload-time = "2025-10-24T10:07:43.528Z" },
+    { url = "https://files.pythonhosted.org/packages/79/87/a1937b6e78b2aff18b706d738c9e46ade5bfcf11b294e39c87706a0089ac/pyarrow-22.0.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:ec1a15968a9d80da01e1d30349b2b0d7cc91e96588ee324ce1b5228175043e95", size = 50288552, upload-time = "2025-10-24T10:07:53.519Z" },
+    { url = "https://files.pythonhosted.org/packages/60/ae/b5a5811e11f25788ccfdaa8f26b6791c9807119dffcf80514505527c384c/pyarrow-22.0.0-cp313-cp313t-win_amd64.whl", hash = "sha256:bba208d9c7decf9961998edf5c65e3ea4355d5818dd6cd0f6809bec1afb951cc", size = 28262504, upload-time = "2025-10-24T10:08:00.932Z" },
+]
+
+[[package]]
+name = "pydantic"
+version = "2.12.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-types" },
+    { name = "pydantic-core" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/69/44/36f1a6e523abc58ae5f928898e4aca2e0ea509b5aa6f6f392a5d882be928/pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49", size = 821591, upload-time = "2025-11-26T15:11:46.471Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5a/87/b70ad306ebb6f9b585f114d0ac2137d792b48be34d732d60e597c2f8465a/pydantic-2.12.5-py3-none-any.whl", hash = "sha256:e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d", size = 463580, upload-time = "2025-11-26T15:11:44.605Z" },
+]
+
+[[package]]
+name = "pydantic-core"
+version = "2.41.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e8/72/74a989dd9f2084b3d9530b0915fdda64ac48831c30dbf7c72a41a5232db8/pydantic_core-2.41.5-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:a3a52f6156e73e7ccb0f8cced536adccb7042be67cb45f9562e12b319c119da6", size = 2105873, upload-time = "2025-11-04T13:39:31.373Z" },
+    { url = "https://files.pythonhosted.org/packages/12/44/37e403fd9455708b3b942949e1d7febc02167662bf1a7da5b78ee1ea2842/pydantic_core-2.41.5-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:7f3bf998340c6d4b0c9a2f02d6a400e51f123b59565d74dc60d252ce888c260b", size = 1899826, upload-time = "2025-11-04T13:39:32.897Z" },
+    { url = "https://files.pythonhosted.org/packages/33/7f/1d5cab3ccf44c1935a359d51a8a2a9e1a654b744b5e7f80d41b88d501eec/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:378bec5c66998815d224c9ca994f1e14c0c21cb95d2f52b6021cc0b2a58f2a5a", size = 1917869, upload-time = "2025-11-04T13:39:34.469Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/6a/30d94a9674a7fe4f4744052ed6c5e083424510be1e93da5bc47569d11810/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e7b576130c69225432866fe2f4a469a85a54ade141d96fd396dffcf607b558f8", size = 2063890, upload-time = "2025-11-04T13:39:36.053Z" },
+    { url = "https://files.pythonhosted.org/packages/50/be/76e5d46203fcb2750e542f32e6c371ffa9b8ad17364cf94bb0818dbfb50c/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6cb58b9c66f7e4179a2d5e0f849c48eff5c1fca560994d6eb6543abf955a149e", size = 2229740, upload-time = "2025-11-04T13:39:37.753Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/ee/fed784df0144793489f87db310a6bbf8118d7b630ed07aa180d6067e653a/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:88942d3a3dff3afc8288c21e565e476fc278902ae4d6d134f1eeda118cc830b1", size = 2350021, upload-time = "2025-11-04T13:39:40.94Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/be/8fed28dd0a180dca19e72c233cbf58efa36df055e5b9d90d64fd1740b828/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f31d95a179f8d64d90f6831d71fa93290893a33148d890ba15de25642c5d075b", size = 2066378, upload-time = "2025-11-04T13:39:42.523Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/3b/698cf8ae1d536a010e05121b4958b1257f0b5522085e335360e53a6b1c8b/pydantic_core-2.41.5-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c1df3d34aced70add6f867a8cf413e299177e0c22660cc767218373d0779487b", size = 2175761, upload-time = "2025-11-04T13:39:44.553Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/ba/15d537423939553116dea94ce02f9c31be0fa9d0b806d427e0308ec17145/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:4009935984bd36bd2c774e13f9a09563ce8de4abaa7226f5108262fa3e637284", size = 2146303, upload-time = "2025-11-04T13:39:46.238Z" },
+    { url = "https://files.pythonhosted.org/packages/58/7f/0de669bf37d206723795f9c90c82966726a2ab06c336deba4735b55af431/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:34a64bc3441dc1213096a20fe27e8e128bd3ff89921706e83c0b1ac971276594", size = 2340355, upload-time = "2025-11-04T13:39:48.002Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/de/e7482c435b83d7e3c3ee5ee4451f6e8973cff0eb6007d2872ce6383f6398/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:c9e19dd6e28fdcaa5a1de679aec4141f691023916427ef9bae8584f9c2fb3b0e", size = 2319875, upload-time = "2025-11-04T13:39:49.705Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/e6/8c9e81bb6dd7560e33b9053351c29f30c8194b72f2d6932888581f503482/pydantic_core-2.41.5-cp311-cp311-win32.whl", hash = "sha256:2c010c6ded393148374c0f6f0bf89d206bf3217f201faa0635dcd56bd1520f6b", size = 1987549, upload-time = "2025-11-04T13:39:51.842Z" },
+    { url = "https://files.pythonhosted.org/packages/11/66/f14d1d978ea94d1bc21fc98fcf570f9542fe55bfcc40269d4e1a21c19bf7/pydantic_core-2.41.5-cp311-cp311-win_amd64.whl", hash = "sha256:76ee27c6e9c7f16f47db7a94157112a2f3a00e958bc626e2f4ee8bec5c328fbe", size = 2011305, upload-time = "2025-11-04T13:39:53.485Z" },
+    { url = "https://files.pythonhosted.org/packages/56/d8/0e271434e8efd03186c5386671328154ee349ff0354d83c74f5caaf096ed/pydantic_core-2.41.5-cp311-cp311-win_arm64.whl", hash = "sha256:4bc36bbc0b7584de96561184ad7f012478987882ebf9f9c389b23f432ea3d90f", size = 1972902, upload-time = "2025-11-04T13:39:56.488Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/5d/5f6c63eebb5afee93bcaae4ce9a898f3373ca23df3ccaef086d0233a35a7/pydantic_core-2.41.5-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:f41a7489d32336dbf2199c8c0a215390a751c5b014c2c1c5366e817202e9cdf7", size = 2110990, upload-time = "2025-11-04T13:39:58.079Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/32/9c2e8ccb57c01111e0fd091f236c7b371c1bccea0fa85247ac55b1e2b6b6/pydantic_core-2.41.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:070259a8818988b9a84a449a2a7337c7f430a22acc0859c6b110aa7212a6d9c0", size = 1896003, upload-time = "2025-11-04T13:39:59.956Z" },
+    { url = "https://files.pythonhosted.org/packages/68/b8/a01b53cb0e59139fbc9e4fda3e9724ede8de279097179be4ff31f1abb65a/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e96cea19e34778f8d59fe40775a7a574d95816eb150850a85a7a4c8f4b94ac69", size = 1919200, upload-time = "2025-11-04T13:40:02.241Z" },
+    { url = "https://files.pythonhosted.org/packages/38/de/8c36b5198a29bdaade07b5985e80a233a5ac27137846f3bc2d3b40a47360/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ed2e99c456e3fadd05c991f8f437ef902e00eedf34320ba2b0842bd1c3ca3a75", size = 2052578, upload-time = "2025-11-04T13:40:04.401Z" },
+    { url = "https://files.pythonhosted.org/packages/00/b5/0e8e4b5b081eac6cb3dbb7e60a65907549a1ce035a724368c330112adfdd/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:65840751b72fbfd82c3c640cff9284545342a4f1eb1586ad0636955b261b0b05", size = 2208504, upload-time = "2025-11-04T13:40:06.072Z" },
+    { url = "https://files.pythonhosted.org/packages/77/56/87a61aad59c7c5b9dc8caad5a41a5545cba3810c3e828708b3d7404f6cef/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e536c98a7626a98feb2d3eaf75944ef6f3dbee447e1f841eae16f2f0a72d8ddc", size = 2335816, upload-time = "2025-11-04T13:40:07.835Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/76/941cc9f73529988688a665a5c0ecff1112b3d95ab48f81db5f7606f522d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eceb81a8d74f9267ef4081e246ffd6d129da5d87e37a77c9bde550cb04870c1c", size = 2075366, upload-time = "2025-11-04T13:40:09.804Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/43/ebef01f69baa07a482844faaa0a591bad1ef129253ffd0cdaa9d8a7f72d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d38548150c39b74aeeb0ce8ee1d8e82696f4a4e16ddc6de7b1d8823f7de4b9b5", size = 2171698, upload-time = "2025-11-04T13:40:12.004Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/87/41f3202e4193e3bacfc2c065fab7706ebe81af46a83d3e27605029c1f5a6/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:c23e27686783f60290e36827f9c626e63154b82b116d7fe9adba1fda36da706c", size = 2132603, upload-time = "2025-11-04T13:40:13.868Z" },
+    { url = "https://files.pythonhosted.org/packages/49/7d/4c00df99cb12070b6bccdef4a195255e6020a550d572768d92cc54dba91a/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:482c982f814460eabe1d3bb0adfdc583387bd4691ef00b90575ca0d2b6fe2294", size = 2329591, upload-time = "2025-11-04T13:40:15.672Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/6a/ebf4b1d65d458f3cda6a7335d141305dfa19bdc61140a884d165a8a1bbc7/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:bfea2a5f0b4d8d43adf9d7b8bf019fb46fdd10a2e5cde477fbcb9d1fa08c68e1", size = 2319068, upload-time = "2025-11-04T13:40:17.532Z" },
+    { url = "https://files.pythonhosted.org/packages/49/3b/774f2b5cd4192d5ab75870ce4381fd89cf218af999515baf07e7206753f0/pydantic_core-2.41.5-cp312-cp312-win32.whl", hash = "sha256:b74557b16e390ec12dca509bce9264c3bbd128f8a2c376eaa68003d7f327276d", size = 1985908, upload-time = "2025-11-04T13:40:19.309Z" },
+    { url = "https://files.pythonhosted.org/packages/86/45/00173a033c801cacf67c190fef088789394feaf88a98a7035b0e40d53dc9/pydantic_core-2.41.5-cp312-cp312-win_amd64.whl", hash = "sha256:1962293292865bca8e54702b08a4f26da73adc83dd1fcf26fbc875b35d81c815", size = 2020145, upload-time = "2025-11-04T13:40:21.548Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/22/91fbc821fa6d261b376a3f73809f907cec5ca6025642c463d3488aad22fb/pydantic_core-2.41.5-cp312-cp312-win_arm64.whl", hash = "sha256:1746d4a3d9a794cacae06a5eaaccb4b8643a131d45fbc9af23e353dc0a5ba5c3", size = 1976179, upload-time = "2025-11-04T13:40:23.393Z" },
+    { url = "https://files.pythonhosted.org/packages/87/06/8806241ff1f70d9939f9af039c6c35f2360cf16e93c2ca76f184e76b1564/pydantic_core-2.41.5-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:941103c9be18ac8daf7b7adca8228f8ed6bb7a1849020f643b3a14d15b1924d9", size = 2120403, upload-time = "2025-11-04T13:40:25.248Z" },
+    { url = "https://files.pythonhosted.org/packages/94/02/abfa0e0bda67faa65fef1c84971c7e45928e108fe24333c81f3bfe35d5f5/pydantic_core-2.41.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:112e305c3314f40c93998e567879e887a3160bb8689ef3d2c04b6cc62c33ac34", size = 1896206, upload-time = "2025-11-04T13:40:27.099Z" },
+    { url = "https://files.pythonhosted.org/packages/15/df/a4c740c0943e93e6500f9eb23f4ca7ec9bf71b19e608ae5b579678c8d02f/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cbaad15cb0c90aa221d43c00e77bb33c93e8d36e0bf74760cd00e732d10a6a0", size = 1919307, upload-time = "2025-11-04T13:40:29.806Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/e3/6324802931ae1d123528988e0e86587c2072ac2e5394b4bc2bc34b61ff6e/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:03ca43e12fab6023fc79d28ca6b39b05f794ad08ec2feccc59a339b02f2b3d33", size = 2063258, upload-time = "2025-11-04T13:40:33.544Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/d4/2230d7151d4957dd79c3044ea26346c148c98fbf0ee6ebd41056f2d62ab5/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dc799088c08fa04e43144b164feb0c13f9a0bc40503f8df3e9fde58a3c0c101e", size = 2214917, upload-time = "2025-11-04T13:40:35.479Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/9f/eaac5df17a3672fef0081b6c1bb0b82b33ee89aa5cec0d7b05f52fd4a1fa/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:97aeba56665b4c3235a0e52b2c2f5ae9cd071b8a8310ad27bddb3f7fb30e9aa2", size = 2332186, upload-time = "2025-11-04T13:40:37.436Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/4e/35a80cae583a37cf15604b44240e45c05e04e86f9cfd766623149297e971/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:406bf18d345822d6c21366031003612b9c77b3e29ffdb0f612367352aab7d586", size = 2073164, upload-time = "2025-11-04T13:40:40.289Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/e3/f6e262673c6140dd3305d144d032f7bd5f7497d3871c1428521f19f9efa2/pydantic_core-2.41.5-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:b93590ae81f7010dbe380cdeab6f515902ebcbefe0b9327cc4804d74e93ae69d", size = 2179146, upload-time = "2025-11-04T13:40:42.809Z" },
+    { url = "https://files.pythonhosted.org/packages/75/c7/20bd7fc05f0c6ea2056a4565c6f36f8968c0924f19b7d97bbfea55780e73/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:01a3d0ab748ee531f4ea6c3e48ad9dac84ddba4b0d82291f87248f2f9de8d740", size = 2137788, upload-time = "2025-11-04T13:40:44.752Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/8d/34318ef985c45196e004bc46c6eab2eda437e744c124ef0dbe1ff2c9d06b/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:6561e94ba9dacc9c61bce40e2d6bdc3bfaa0259d3ff36ace3b1e6901936d2e3e", size = 2340133, upload-time = "2025-11-04T13:40:46.66Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/59/013626bf8c78a5a5d9350d12e7697d3d4de951a75565496abd40ccd46bee/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:915c3d10f81bec3a74fbd4faebe8391013ba61e5a1a8d48c4455b923bdda7858", size = 2324852, upload-time = "2025-11-04T13:40:48.575Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/d9/c248c103856f807ef70c18a4f986693a46a8ffe1602e5d361485da502d20/pydantic_core-2.41.5-cp313-cp313-win32.whl", hash = "sha256:650ae77860b45cfa6e2cdafc42618ceafab3a2d9a3811fcfbd3bbf8ac3c40d36", size = 1994679, upload-time = "2025-11-04T13:40:50.619Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/8b/341991b158ddab181cff136acd2552c9f35bd30380422a639c0671e99a91/pydantic_core-2.41.5-cp313-cp313-win_amd64.whl", hash = "sha256:79ec52ec461e99e13791ec6508c722742ad745571f234ea6255bed38c6480f11", size = 2019766, upload-time = "2025-11-04T13:40:52.631Z" },
+    { url = "https://files.pythonhosted.org/packages/73/7d/f2f9db34af103bea3e09735bb40b021788a5e834c81eedb541991badf8f5/pydantic_core-2.41.5-cp313-cp313-win_arm64.whl", hash = "sha256:3f84d5c1b4ab906093bdc1ff10484838aca54ef08de4afa9de0f5f14d69639cd", size = 1981005, upload-time = "2025-11-04T13:40:54.734Z" },
+    { url = "https://files.pythonhosted.org/packages/11/72/90fda5ee3b97e51c494938a4a44c3a35a9c96c19bba12372fb9c634d6f57/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:b96d5f26b05d03cc60f11a7761a5ded1741da411e7fe0909e27a5e6a0cb7b034", size = 2115441, upload-time = "2025-11-04T13:42:39.557Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/53/8942f884fa33f50794f119012dc6a1a02ac43a56407adaac20463df8e98f/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:634e8609e89ceecea15e2d61bc9ac3718caaaa71963717bf3c8f38bfde64242c", size = 1930291, upload-time = "2025-11-04T13:42:42.169Z" },
+    { url = "https://files.pythonhosted.org/packages/79/c8/ecb9ed9cd942bce09fc888ee960b52654fbdbede4ba6c2d6e0d3b1d8b49c/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:93e8740d7503eb008aa2df04d3b9735f845d43ae845e6dcd2be0b55a2da43cd2", size = 1948632, upload-time = "2025-11-04T13:42:44.564Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/1b/687711069de7efa6af934e74f601e2a4307365e8fdc404703afc453eab26/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f15489ba13d61f670dcc96772e733aad1a6f9c429cc27574c6cdaed82d0146ad", size = 2138905, upload-time = "2025-11-04T13:42:47.156Z" },
+    { url = "https://files.pythonhosted.org/packages/09/32/59b0c7e63e277fa7911c2fc70ccfb45ce4b98991e7ef37110663437005af/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:7da7087d756b19037bc2c06edc6c170eeef3c3bafcb8f532ff17d64dc427adfd", size = 2110495, upload-time = "2025-11-04T13:42:49.689Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/81/05e400037eaf55ad400bcd318c05bb345b57e708887f07ddb2d20e3f0e98/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:aabf5777b5c8ca26f7824cb4a120a740c9588ed58df9b2d196ce92fba42ff8dc", size = 1915388, upload-time = "2025-11-04T13:42:52.215Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/0d/e3549b2399f71d56476b77dbf3cf8937cec5cd70536bdc0e374a421d0599/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c007fe8a43d43b3969e8469004e9845944f1a80e6acd47c150856bb87f230c56", size = 1942879, upload-time = "2025-11-04T13:42:56.483Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/07/34573da085946b6a313d7c42f82f16e8920bfd730665de2d11c0c37a74b5/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b", size = 2139017, upload-time = "2025-11-04T13:42:59.471Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/9b/1b3f0e9f9305839d7e84912f9e8bfbd191ed1b1ef48083609f0dabde978c/pydantic_core-2.41.5-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:b2379fa7ed44ddecb5bfe4e48577d752db9fc10be00a6b7446e9663ba143de26", size = 2101980, upload-time = "2025-11-04T13:43:25.97Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/ed/d71fefcb4263df0da6a85b5d8a7508360f2f2e9b3bf5814be9c8bccdccc1/pydantic_core-2.41.5-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:266fb4cbf5e3cbd0b53669a6d1b039c45e3ce651fd5442eff4d07c2cc8d66808", size = 1923865, upload-time = "2025-11-04T13:43:28.763Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/3a/626b38db460d675f873e4444b4bb030453bbe7b4ba55df821d026a0493c4/pydantic_core-2.41.5-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58133647260ea01e4d0500089a8c4f07bd7aa6ce109682b1426394988d8aaacc", size = 2134256, upload-time = "2025-11-04T13:43:31.71Z" },
+    { url = "https://files.pythonhosted.org/packages/83/d9/8412d7f06f616bbc053d30cb4e5f76786af3221462ad5eee1f202021eb4e/pydantic_core-2.41.5-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:287dad91cfb551c363dc62899a80e9e14da1f0e2b6ebde82c806612ca2a13ef1", size = 2174762, upload-time = "2025-11-04T13:43:34.744Z" },
+    { url = "https://files.pythonhosted.org/packages/55/4c/162d906b8e3ba3a99354e20faa1b49a85206c47de97a639510a0e673f5da/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:03b77d184b9eb40240ae9fd676ca364ce1085f203e1b1256f8ab9984dca80a84", size = 2143141, upload-time = "2025-11-04T13:43:37.701Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/f2/f11dd73284122713f5f89fc940f370d035fa8e1e078d446b3313955157fe/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:a668ce24de96165bb239160b3d854943128f4334822900534f2fe947930e5770", size = 2330317, upload-time = "2025-11-04T13:43:40.406Z" },
+    { url = "https://files.pythonhosted.org/packages/88/9d/b06ca6acfe4abb296110fb1273a4d848a0bfb2ff65f3ee92127b3244e16b/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:f14f8f046c14563f8eb3f45f499cc658ab8d10072961e07225e507adb700e93f", size = 2316992, upload-time = "2025-11-04T13:43:43.602Z" },
+    { url = "https://files.pythonhosted.org/packages/36/c7/cfc8e811f061c841d7990b0201912c3556bfeb99cdcb7ed24adc8d6f8704/pydantic_core-2.41.5-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:56121965f7a4dc965bff783d70b907ddf3d57f6eba29b6d2e5dabfaf07799c51", size = 2145302, upload-time = "2025-11-04T13:43:46.64Z" },
+]
+
+[[package]]
+name = "pydantic-settings"
+version = "2.12.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pydantic" },
+    { name = "python-dotenv" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/43/4b/ac7e0aae12027748076d72a8764ff1c9d82ca75a7a52622e67ed3f765c54/pydantic_settings-2.12.0.tar.gz", hash = "sha256:005538ef951e3c2a68e1c08b292b5f2e71490def8589d4221b95dab00dafcfd0", size = 194184, upload-time = "2025-11-10T14:25:47.013Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c1/60/5d4751ba3f4a40a6891f24eec885f51afd78d208498268c734e256fb13c4/pydantic_settings-2.12.0-py3-none-any.whl", hash = "sha256:fddb9fd99a5b18da837b29710391e945b1e30c135477f484084ee513adb93809", size = 51880, upload-time = "2025-11-10T14:25:45.546Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.19.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
+]
+
+[[package]]
+name = "pyspark"
+version = "4.1.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "py4j" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5e/71/4dd20c69332a2a4bf7ece8a655c9da98e4bd9b6bcea235349c1a00399d57/pyspark-4.1.2.tar.gz", hash = "sha256:fa5d6159f700d0990a07f4f62df1b7449401dccee9cd7d5d6df8957530841602", size = 455428043, upload-time = "2026-05-21T14:49:21.785Z" }
+
+[[package]]
+name = "pyspark-client"
+version = "4.1.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "googleapis-common-protos" },
+    { name = "grpcio" },
+    { name = "grpcio-status" },
+    { name = "numpy" },
+    { name = "pandas" },
+    { name = "pyarrow" },
+    { name = "pyyaml" },
+    { name = "zstandard" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f4/47/57c1234c69fb87234b8d080c64775eb5a088cfbb9fe419b190cb7d7ca40e/pyspark_client-4.1.2.tar.gz", hash = "sha256:4e5ac863064c3bd6c288da7e3932c72b491cd90e294e5e91aec37e1fa1c870f5", size = 1601811, upload-time = "2026-05-21T14:49:42.352Z" }
+
+[[package]]
+name = "pytest"
+version = "9.0.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d1/db/7ef3487e0fb0049ddb5ce41d3a49c235bf9ad299b6a25d5780a89f19230f/pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11", size = 1568901, upload-time = "2025-12-06T21:30:51.014Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" },
+]
+
+[[package]]
+name = "pytest-cov"
+version = "7.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "coverage", extra = ["toml"] },
+    { name = "pluggy" },
+    { name = "pytest" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5e/f7/c933acc76f5208b3b00089573cf6a2bc26dc80a8aece8f52bb7d6b1855ca/pytest_cov-7.0.0.tar.gz", hash = "sha256:33c97eda2e049a0c5298e91f519302a1334c26ac65c1a483d6206fd458361af1", size = 54328, upload-time = "2025-09-09T10:57:02.113Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ee/49/1377b49de7d0c1ce41292161ea0f721913fa8722c19fb9c1e3aa0367eecb/pytest_cov-7.0.0-py3-none-any.whl", hash = "sha256:3b8e9558b16cc1479da72058bdecf8073661c7f57f7d3c5f22a1c23507f2d861", size = 22424, upload-time = "2025-09-09T10:57:00.695Z" },
+]
+
+[[package]]
+name = "python-daemon"
+version = "3.1.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "lockfile" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3d/37/4f10e37bdabc058a32989da2daf29e57dc59dbc5395497f3d36d5f5e2694/python_daemon-3.1.2.tar.gz", hash = "sha256:f7b04335adc473de877f5117e26d5f1142f4c9f7cd765408f0877757be5afbf4", size = 71576, upload-time = "2024-12-03T08:41:07.843Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/45/3c/b88167e2d6785c0e781ee5d498b07472aeb9b6765da3b19e7cc9e0813841/python_daemon-3.1.2-py3-none-any.whl", hash = "sha256:b906833cef63502994ad48e2eab213259ed9bb18d54fa8774dcba2ff7864cec6", size = 30872, upload-time = "2024-12-03T08:41:03.322Z" },
+]
+
+[[package]]
+name = "python-dateutil"
+version = "2.9.0.post0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "six" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/66/c0/0c8b6ad9f17a802ee498c46e004a0eb49bc148f2fd230864601a86dcf6db/python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3", size = 342432, upload-time = "2024-03-01T18:36:20.211Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427", size = 229892, upload-time = "2024-03-01T18:36:18.57Z" },
+]
+
+[[package]]
+name = "python-dotenv"
+version = "1.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f0/26/19cadc79a718c5edbec86fd4919a6b6d3f681039a2f6d66d14be94e75fb9/python_dotenv-1.2.1.tar.gz", hash = "sha256:42667e897e16ab0d66954af0e60a9caa94f0fd4ecf3aaf6d2d260eec1aa36ad6", size = 44221, upload-time = "2025-10-26T15:12:10.434Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/14/1b/a298b06749107c305e1fe0f814c6c74aea7b2f1e10989cb30f544a1b3253/python_dotenv-1.2.1-py3-none-any.whl", hash = "sha256:b81ee9561e9ca4004139c6cbba3a238c32b03e4894671e181b671e8cb8425d61", size = 21230, upload-time = "2025-10-26T15:12:09.109Z" },
+]
+
+[[package]]
+name = "pytz"
+version = "2025.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f8/bf/abbd3cdfb8fbc7fb3d4d38d320f2441b1e7cbe29be4f23797b4a2b5d8aac/pytz-2025.2.tar.gz", hash = "sha256:360b9e3dbb49a209c21ad61809c7fb453643e048b38924c765813546746e81c3", size = 320884, upload-time = "2025-03-25T02:25:00.538Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/81/c4/34e93fe5f5429d7570ec1fa436f1986fb1f00c3e0f43a589fe2bbcd22c3f/pytz-2025.2-py2.py3-none-any.whl", hash = "sha256:5ddf76296dd8c44c26eb8f4b6f35488f3ccbf6fbbd7adee0b7262d43f0ec2f00", size = 509225, upload-time = "2025-03-25T02:24:58.468Z" },
+]
+
+[[package]]
+name = "pyyaml"
+version = "6.0.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960, upload-time = "2025-09-25T21:33:16.546Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/6d/16/a95b6757765b7b031c9374925bb718d55e0a9ba8a1b6a12d25962ea44347/pyyaml-6.0.3-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e", size = 185826, upload-time = "2025-09-25T21:31:58.655Z" },
+    { url = "https://files.pythonhosted.org/packages/16/19/13de8e4377ed53079ee996e1ab0a9c33ec2faf808a4647b7b4c0d46dd239/pyyaml-6.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824", size = 175577, upload-time = "2025-09-25T21:32:00.088Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/62/d2eb46264d4b157dae1275b573017abec435397aa59cbcdab6fc978a8af4/pyyaml-6.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c", size = 775556, upload-time = "2025-09-25T21:32:01.31Z" },
+    { url = "https://files.pythonhosted.org/packages/10/cb/16c3f2cf3266edd25aaa00d6c4350381c8b012ed6f5276675b9eba8d9ff4/pyyaml-6.0.3-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00", size = 882114, upload-time = "2025-09-25T21:32:03.376Z" },
+    { url = "https://files.pythonhosted.org/packages/71/60/917329f640924b18ff085ab889a11c763e0b573da888e8404ff486657602/pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d", size = 806638, upload-time = "2025-09-25T21:32:04.553Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/6f/529b0f316a9fd167281a6c3826b5583e6192dba792dd55e3203d3f8e655a/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a", size = 767463, upload-time = "2025-09-25T21:32:06.152Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/6a/b627b4e0c1dd03718543519ffb2f1deea4a1e6d42fbab8021936a4d22589/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4", size = 794986, upload-time = "2025-09-25T21:32:07.367Z" },
+    { url = "https://files.pythonhosted.org/packages/45/91/47a6e1c42d9ee337c4839208f30d9f09caa9f720ec7582917b264defc875/pyyaml-6.0.3-cp311-cp311-win32.whl", hash = "sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b", size = 142543, upload-time = "2025-09-25T21:32:08.95Z" },
+    { url = "https://files.pythonhosted.org/packages/da/e3/ea007450a105ae919a72393cb06f122f288ef60bba2dc64b26e2646fa315/pyyaml-6.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf", size = 158763, upload-time = "2025-09-25T21:32:09.96Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/33/422b98d2195232ca1826284a76852ad5a86fe23e31b009c9886b2d0fb8b2/pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196", size = 182063, upload-time = "2025-09-25T21:32:11.445Z" },
+    { url = "https://files.pythonhosted.org/packages/89/a0/6cf41a19a1f2f3feab0e9c0b74134aa2ce6849093d5517a0c550fe37a648/pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0", size = 173973, upload-time = "2025-09-25T21:32:12.492Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/23/7a778b6bd0b9a8039df8b1b1d80e2e2ad78aa04171592c8a5c43a56a6af4/pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28", size = 775116, upload-time = "2025-09-25T21:32:13.652Z" },
+    { url = "https://files.pythonhosted.org/packages/65/30/d7353c338e12baef4ecc1b09e877c1970bd3382789c159b4f89d6a70dc09/pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c", size = 844011, upload-time = "2025-09-25T21:32:15.21Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/9d/b3589d3877982d4f2329302ef98a8026e7f4443c765c46cfecc8858c6b4b/pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc", size = 807870, upload-time = "2025-09-25T21:32:16.431Z" },
+    { url = "https://files.pythonhosted.org/packages/05/c0/b3be26a015601b822b97d9149ff8cb5ead58c66f981e04fedf4e762f4bd4/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e", size = 761089, upload-time = "2025-09-25T21:32:17.56Z" },
+    { url = "https://files.pythonhosted.org/packages/be/8e/98435a21d1d4b46590d5459a22d88128103f8da4c2d4cb8f14f2a96504e1/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea", size = 790181, upload-time = "2025-09-25T21:32:18.834Z" },
+    { url = "https://files.pythonhosted.org/packages/74/93/7baea19427dcfbe1e5a372d81473250b379f04b1bd3c4c5ff825e2327202/pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5", size = 137658, upload-time = "2025-09-25T21:32:20.209Z" },
+    { url = "https://files.pythonhosted.org/packages/86/bf/899e81e4cce32febab4fb42bb97dcdf66bc135272882d1987881a4b519e9/pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b", size = 154003, upload-time = "2025-09-25T21:32:21.167Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/08/67bd04656199bbb51dbed1439b7f27601dfb576fb864099c7ef0c3e55531/pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd", size = 140344, upload-time = "2025-09-25T21:32:22.617Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669, upload-time = "2025-09-25T21:32:23.673Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252, upload-time = "2025-09-25T21:32:25.149Z" },
+    { url = "https://files.pythonhosted.org/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081, upload-time = "2025-09-25T21:32:26.575Z" },
+    { url = "https://files.pythonhosted.org/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159, upload-time = "2025-09-25T21:32:27.727Z" },
+    { url = "https://files.pythonhosted.org/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626, upload-time = "2025-09-25T21:32:28.878Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613, upload-time = "2025-09-25T21:32:30.178Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115, upload-time = "2025-09-25T21:32:31.353Z" },
+    { url = "https://files.pythonhosted.org/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427, upload-time = "2025-09-25T21:32:32.58Z" },
+    { url = "https://files.pythonhosted.org/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090, upload-time = "2025-09-25T21:32:33.659Z" },
+    { url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" },
+]
+
+[[package]]
+name = "requests"
+version = "2.32.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "charset-normalizer" },
+    { name = "idna" },
+    { name = "urllib3" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c9/74/b3ff8e6c8446842c3f5c837e9c3dfcfe2018ea6ecef224c710c85ef728f4/requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf", size = 134517, upload-time = "2025-08-18T20:46:02.573Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738, upload-time = "2025-08-18T20:46:00.542Z" },
+]
+
+[[package]]
+name = "rich"
+version = "14.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/fb/d2/8920e102050a0de7bfabeb4c4614a49248cf8d5d7a8d01885fbb24dc767a/rich-14.2.0.tar.gz", hash = "sha256:73ff50c7c0c1c77c8243079283f4edb376f0f6442433aecb8ce7e6d0b92d1fe4", size = 219990, upload-time = "2025-10-09T14:16:53.064Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/25/7a/b0178788f8dc6cafce37a212c99565fa1fe7872c70c6c9c1e1a372d9d88f/rich-14.2.0-py3-none-any.whl", hash = "sha256:76bc51fe2e57d2b1be1f96c524b890b816e334ab4c1e45888799bfaab0021edd", size = 243393, upload-time = "2025-10-09T14:16:51.245Z" },
+]
+
+[[package]]
+name = "rich-click"
+version = "1.9.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "click" },
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "rich" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/6b/d1/b60ca6a8745e76800b50c7ee246fd73f08a3be5d8e0b551fc93c19fa1203/rich_click-1.9.5.tar.gz", hash = "sha256:48120531493f1533828da80e13e839d471979ec8d7d0ca7b35f86a1379cc74b6", size = 73927, upload-time = "2025-12-21T14:49:44.167Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/25/0a/d865895e1e5d88a60baee0fc3703eb111c502ee10c8c107516bc7623abf8/rich_click-1.9.5-py3-none-any.whl", hash = "sha256:9b195721a773b1acf0e16ff9ec68cef1e7d237e53471e6e3f7ade462f86c403a", size = 70580, upload-time = "2025-12-21T14:49:42.905Z" },
+]
+
+[[package]]
+name = "rmon"
+version = "0.5.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "click" },
+    { name = "loguru" },
+    { name = "plotly" },
+    { name = "psutil" },
+    { name = "pydantic" },
+    { name = "python-daemon" },
+    { name = "rich-click" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a5/32/feb232611a3aa39aa5fd1777777e063e6891243219798b7e455d86fdd9cd/rmon-0.5.0.tar.gz", hash = "sha256:86146b27fee51ebc7f79cbcd5ac526910080c6498b4fad179e814394963780b1", size = 39635, upload-time = "2025-10-22T22:37:53.059Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/27/bf/2f24bdd15e26ad1e81817acb03cc316d81a3e73f42477a5cbc71af9b7c4d/rmon-0.5.0-py3-none-any.whl", hash = "sha256:0cd241479ddde31c7e7bfa32fae5ead9e16b28aa0996a2e54acc74400a980e81", size = 26991, upload-time = "2025-10-22T22:37:51.697Z" },
+]
+
+[[package]]
+name = "roman-numerals"
+version = "4.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ae/f9/41dc953bbeb056c17d5f7a519f50fdf010bd0553be2d630bc69d1e022703/roman_numerals-4.1.0.tar.gz", hash = "sha256:1af8b147eb1405d5839e78aeb93131690495fe9da5c91856cb33ad55a7f1e5b2", size = 9077, upload-time = "2025-12-17T18:25:34.381Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/54/6f679c435d28e0a568d8e8a7c0a93a09010818634c3c3907fc98d8983770/roman_numerals-4.1.0-py3-none-any.whl", hash = "sha256:647ba99caddc2cc1e55a51e4360689115551bf4476d90e8162cf8c345fe233c7", size = 7676, upload-time = "2025-12-17T18:25:33.098Z" },
+]
+
+[[package]]
+name = "roman-numerals-py"
+version = "4.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "roman-numerals" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/cb/b5/de96fca640f4f656eb79bbee0e79aeec52e3e0e359f8a3e6a0d366378b64/roman_numerals_py-4.1.0.tar.gz", hash = "sha256:f5d7b2b4ca52dd855ef7ab8eb3590f428c0b1ea480736ce32b01fef2a5f8daf9", size = 4274, upload-time = "2025-12-17T18:25:41.153Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/27/2c/daca29684cbe9fd4bc711f8246da3c10adca1ccc4d24436b17572eb2590e/roman_numerals_py-4.1.0-py3-none-any.whl", hash = "sha256:553114c1167141c1283a51743759723ecd05604a1b6b507225e91dc1a6df0780", size = 4547, upload-time = "2025-12-17T18:25:40.136Z" },
+]
+
+[[package]]
+name = "ruff"
+version = "0.15.17"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/8c/a9/3abdf488f1bf3d24c699415e454ed554a6350d5d89ce183be1ee0a3361ac/ruff-0.15.17.tar.gz", hash = "sha256:2ec446937fd16c8c4de2674a209cc5af64d9c6f17d21fbf1151054fa0bcf5219", size = 4743346, upload-time = "2026-06-11T17:54:47.663Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/db/4d/e11259f5da07cb6afb2d074c31bf09da9671993f7329d4f15d2fdc458301/ruff-0.15.17-py3-none-linux_armv6l.whl", hash = "sha256:d9feddb927fc68bd295f5eebc587a7e42cfaf9b65f60ca4a2386febff575da8f", size = 10856677, upload-time = "2026-06-11T17:54:49.533Z" },
+    { url = "https://files.pythonhosted.org/packages/29/3e/772d679e1a0dc058e58875bd2c0cb713a0530877b4a76fee3c7966df0d49/ruff-0.15.17-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:25805a226d741c47d274a35ad5c10a7dde175fcddfa511d7cf3da0a21eb3eab7", size = 11223443, upload-time = "2026-06-11T17:55:00.573Z" },
+    { url = "https://files.pythonhosted.org/packages/68/58/bd41f7688b2fd5623012605130ed70e60aa7f2244baa3d5066bdd61530c8/ruff-0.15.17-py3-none-macosx_11_0_arm64.whl", hash = "sha256:f6ad73b14c2d18a3bf8ad7cb6974294d7f613a7898604826058e6ac64918ef4d", size = 10566458, upload-time = "2026-06-11T17:55:07.52Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/5b/733371013fcf1ec339e477ece6ab42bfe10bdd9bba8ee88a9516aa56bfc0/ruff-0.15.17-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6ba0c1e4f95bcb3869d0d30cbd5917071ef2e28665abfec970cdab0492c713ed", size = 10914483, upload-time = "2026-06-11T17:55:05.501Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/cc/6f24251cc0252f7239391ccb85833f320efad14ebe5b443943f37ced6332/ruff-0.15.17-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:81647960f10bff57d2e51cadd0c3950fe598400c852863a038720ef5b8cca91e", size = 10647497, upload-time = "2026-06-11T17:54:57.733Z" },
+    { url = "https://files.pythonhosted.org/packages/68/dd/0d10c17ce1a1624d6fc3156309c3f834fdb5dfaad026ec90c85684f3990e/ruff-0.15.17-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0e01a84ddbc8c16c23055ba3924476850f1bbc1917cebbb9376665a63e74260d", size = 11416967, upload-time = "2026-06-11T17:54:51.461Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/91/556bfb156f6144f355e831c23db00b2fc4120f86b3ce81cc5f7fd2df51f3/ruff-0.15.17-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:84fe9f653152f8f294f9f7e03bf3a453d8b4a27f7a59c78c8666167f2b17b96c", size = 12335770, upload-time = "2026-06-11T17:54:45.793Z" },
+    { url = "https://files.pythonhosted.org/packages/88/82/8b5999aa13355e926f06d9f42a32dcca862f623bf0363785ff89d607dffd/ruff-0.15.17-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8c0fe88a7676e7a05b73174d4d4a59cb2ac21ff8263583f87a81a6018475a978", size = 11575441, upload-time = "2026-06-11T17:54:32.661Z" },
+    { url = "https://files.pythonhosted.org/packages/11/93/f10377bb04109ca0e8cbc483ff1982c54b6d418210041776f93e8cdc7fa9/ruff-0.15.17-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ecfc3c7878fff94633ab0348524e093f9ce3243080416dd7d14f8ba400174719", size = 11557614, upload-time = "2026-06-11T17:54:34.698Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/a6/eeeae7f7d5493df41649ab3db92f086b2d0a30199e4efdf8e3dd7a033f24/ruff-0.15.17-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:b8461180b22420b1bdc289909410930761629fddf2a5aaf60fae1ab26cedc4c4", size = 11544450, upload-time = "2026-06-11T17:54:39.042Z" },
+    { url = "https://files.pythonhosted.org/packages/32/88/5991ce565129a24dd4a00db1254b3b5db2e53018cbe4018ea5a89738e727/ruff-0.15.17-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:6eccbe50a038b503e7140b441aa9c7fc8c1f36edf23ebef9f4165c2f28f568b7", size = 10892524, upload-time = "2026-06-11T17:55:09.432Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/1d/0fdd248313425f55223968af04b0a42125466a8d88d21c1d99c6af0a51e8/ruff-0.15.17-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:382fc0521025f5a8ad447d8bdd523545d0d7646adb718eb1c2dac5065ec27c0f", size = 10659573, upload-time = "2026-06-11T17:54:36.824Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/0e/072e8260deb9461062ce9311ced27a8e541229a6ffd483013dd37661e43e/ruff-0.15.17-py3-none-musllinux_1_2_i686.whl", hash = "sha256:456d41fcd1b2777ad63f09a6e7121d43f7b688bbc76a800c10f7f8fb1f912c3f", size = 11127818, upload-time = "2026-06-11T17:55:03.124Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/b4/55060a34163121498014696b5f656db5b8c6963768f227dbf0d76b311073/ruff-0.15.17-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:b1a04bcc94ae6194e9db05d16ad31f298a7194bfbcb08258bbe589cee1d587b8", size = 11655901, upload-time = "2026-06-11T17:54:53.562Z" },
+    { url = "https://files.pythonhosted.org/packages/49/71/9b29d6b87cef468d697f43c6a91e3fae4a80185779d7d5a4ef27d173439f/ruff-0.15.17-py3-none-win32.whl", hash = "sha256:596065960ab1ff593f744220c9fe6580eda00a95003cffa9f4048bb5b1bf0392", size = 10925574, upload-time = "2026-06-11T17:54:55.723Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/b2/8fc77f3723228836fa5d12497eb71c808f83782e10d058d2b15cfa14640b/ruff-0.15.17-py3-none-win_amd64.whl", hash = "sha256:6769e5fa1710b179b92e0bfa5a51735b35baea9013dadb06d5f44cbcf9547084", size = 12058788, upload-time = "2026-06-11T17:54:41.042Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/c7/c53e8dbff9c9dc4b7928773421ae294a5d28fcb8dcda1a089579d3a7e510/ruff-0.15.17-py3-none-win_arm64.whl", hash = "sha256:f3be1fbb34bcdfd146240d8fb92a709d4c2c8191348580a3c044ec60fa0b4456", size = 11355275, upload-time = "2026-06-11T17:54:43.635Z" },
+]
+
+[[package]]
+name = "six"
+version = "1.17.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/94/e7/b2c673351809dca68a0e064b6af791aa332cf192da575fd474ed7d6f16a2/six-1.17.0.tar.gz", hash = "sha256:ff70335d468e7eb6ec65b95b99d3a2836546063f63acc5171de367e834932a81", size = 34031, upload-time = "2024-12-04T17:35:28.174Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050, upload-time = "2024-12-04T17:35:26.475Z" },
+]
+
+[[package]]
+name = "snowballstemmer"
+version = "3.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/75/a7/9810d872919697c9d01295633f5d574fb416d47e535f258272ca1f01f447/snowballstemmer-3.0.1.tar.gz", hash = "sha256:6d5eeeec8e9f84d4d56b847692bacf79bc2c8e90c7f80ca4444ff8b6f2e52895", size = 105575, upload-time = "2025-05-09T16:34:51.843Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c8/78/3565d011c61f5a43488987ee32b6f3f656e7f107ac2782dd57bdd7d91d9a/snowballstemmer-3.0.1-py3-none-any.whl", hash = "sha256:6cd7b3897da8d6c9ffb968a6781fa6532dce9c3618a4b127d920dab764a19064", size = 103274, upload-time = "2025-05-09T16:34:50.371Z" },
+]
+
+[[package]]
+name = "soupsieve"
+version = "2.8.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/89/23/adf3796d740536d63a6fbda113d07e60c734b6ed5d3058d1e47fc0495e47/soupsieve-2.8.1.tar.gz", hash = "sha256:4cf733bc50fa805f5df4b8ef4740fc0e0fa6218cf3006269afd3f9d6d80fd350", size = 117856, upload-time = "2025-12-18T13:50:34.655Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/48/f3/b67d6ea49ca9154453b6d70b34ea22f3996b9fa55da105a79d8732227adc/soupsieve-2.8.1-py3-none-any.whl", hash = "sha256:a11fe2a6f3d76ab3cf2de04eb339c1be5b506a8a47f2ceb6d139803177f85434", size = 36710, upload-time = "2025-12-18T13:50:33.267Z" },
+]
+
+[[package]]
+name = "sparkctl"
+version = "0.4.1"
+source = { editable = "." }
+dependencies = [
+    { name = "click" },
+    { name = "dynaconf" },
+    { name = "loguru" },
+    { name = "psutil" },
+    { name = "pydantic" },
+    { name = "pyspark-client" },
+    { name = "rich-click" },
+    { name = "rmon" },
+    { name = "toml" },
+    { name = "types-psutil" },
+]
+
+[package.optional-dependencies]
+dev = [
+    { name = "autodoc-pydantic" },
+    { name = "furo" },
+    { name = "myst-parser" },
+    { name = "prek" },
+    { name = "pytest" },
+    { name = "pytest-cov" },
+    { name = "requests" },
+    { name = "ruff" },
+    { name = "sphinx" },
+    { name = "sphinx-click" },
+    { name = "sphinx-copybutton" },
+    { name = "sphinx-tabs" },
+    { name = "sphinxcontrib-mermaid" },
+    { name = "ty" },
+    { name = "types-requests" },
+    { name = "types-toml" },
+]
+pyspark = [
+    { name = "pyspark" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "autodoc-pydantic", marker = "extra == 'dev'", specifier = "~=2.0" },
+    { name = "click", specifier = ">=8.2,<9" },
+    { name = "dynaconf" },
+    { name = "furo", marker = "extra == 'dev'" },
+    { name = "loguru", specifier = ">=0.7.2" },
+    { name = "myst-parser", marker = "extra == 'dev'" },
+    { name = "prek", marker = "extra == 'dev'", specifier = ">=0.2,<1" },
+    { name = "psutil" },
+    { name = "pydantic", specifier = ">=2.7,<3" },
+    { name = "pyspark", marker = "extra == 'pyspark'", specifier = "==4.1.2" },
+    { name = "pyspark-client", specifier = "==4.1.2" },
+    { name = "pytest", marker = "extra == 'dev'" },
+    { name = "pytest-cov", marker = "extra == 'dev'" },
+    { name = "requests", marker = "extra == 'dev'" },
+    { name = "rich-click" },
+    { name = "rmon", specifier = ">=0.4.0" },
+    { name = "ruff", marker = "extra == 'dev'", specifier = ">=0.15,<1" },
+    { name = "sphinx", marker = "extra == 'dev'" },
+    { name = "sphinx-click", marker = "extra == 'dev'" },
+    { name = "sphinx-copybutton", marker = "extra == 'dev'" },
+    { name = "sphinx-tabs", marker = "extra == 'dev'", specifier = "~=3.4" },
+    { name = "sphinxcontrib-mermaid", marker = "extra == 'dev'" },
+    { name = "toml" },
+    { name = "ty", marker = "extra == 'dev'", specifier = ">=0.0.26" },
+    { name = "types-psutil" },
+    { name = "types-requests", marker = "extra == 'dev'" },
+    { name = "types-toml", marker = "extra == 'dev'" },
+]
+provides-extras = ["pyspark", "dev"]
+
+[[package]]
+name = "sphinx"
+version = "8.2.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "alabaster" },
+    { name = "babel" },
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "docutils" },
+    { name = "imagesize" },
+    { name = "jinja2" },
+    { name = "packaging" },
+    { name = "pygments" },
+    { name = "requests" },
+    { name = "roman-numerals-py" },
+    { name = "snowballstemmer" },
+    { name = "sphinxcontrib-applehelp" },
+    { name = "sphinxcontrib-devhelp" },
+    { name = "sphinxcontrib-htmlhelp" },
+    { name = "sphinxcontrib-jsmath" },
+    { name = "sphinxcontrib-qthelp" },
+    { name = "sphinxcontrib-serializinghtml" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/38/ad/4360e50ed56cb483667b8e6dadf2d3fda62359593faabbe749a27c4eaca6/sphinx-8.2.3.tar.gz", hash = "sha256:398ad29dee7f63a75888314e9424d40f52ce5a6a87ae88e7071e80af296ec348", size = 8321876, upload-time = "2025-03-02T22:31:59.658Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/31/53/136e9eca6e0b9dc0e1962e2c908fbea2e5ac000c2a2fbd9a35797958c48b/sphinx-8.2.3-py3-none-any.whl", hash = "sha256:4405915165f13521d875a8c29c8970800a0141c14cc5416a38feca4ea5d9b9c3", size = 3589741, upload-time = "2025-03-02T22:31:56.836Z" },
+]
+
+[[package]]
+name = "sphinx-basic-ng"
+version = "1.0.0b2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "sphinx" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/98/0b/a866924ded68efec7a1759587a4e478aec7559d8165fac8b2ad1c0e774d6/sphinx_basic_ng-1.0.0b2.tar.gz", hash = "sha256:9ec55a47c90c8c002b5960c57492ec3021f5193cb26cebc2dc4ea226848651c9", size = 20736, upload-time = "2023-07-08T18:40:54.166Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3c/dd/018ce05c532a22007ac58d4f45232514cd9d6dd0ee1dc374e309db830983/sphinx_basic_ng-1.0.0b2-py3-none-any.whl", hash = "sha256:eb09aedbabfb650607e9b4b68c9d240b90b1e1be221d6ad71d61c52e29f7932b", size = 22496, upload-time = "2023-07-08T18:40:52.659Z" },
+]
+
+[[package]]
+name = "sphinx-click"
+version = "6.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "click" },
+    { name = "docutils" },
+    { name = "sphinx" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/9a/ed/a9767cd1b8b7fbdf260a89d5c8c86e20e3536b9878579e5ab7965a291e55/sphinx_click-6.2.0.tar.gz", hash = "sha256:fc78b4154a4e5159462e36de55b8643747da6cda86b3b52a8bb62289e603776c", size = 27035, upload-time = "2025-12-04T19:33:05.437Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/44/bd/cb244695f67f77b0a36200ce1670fc42a6fe2770847e870daab99cc2b177/sphinx_click-6.2.0-py3-none-any.whl", hash = "sha256:1fb1851cb4f2c286d43cbcd57f55db6ef5a8d208bfc3370f19adde232e5803d7", size = 8939, upload-time = "2025-12-04T19:33:04.037Z" },
+]
+
+[[package]]
+name = "sphinx-copybutton"
+version = "0.5.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "sphinx" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/fc/2b/a964715e7f5295f77509e59309959f4125122d648f86b4fe7d70ca1d882c/sphinx-copybutton-0.5.2.tar.gz", hash = "sha256:4cf17c82fb9646d1bc9ca92ac280813a3b605d8c421225fd9913154103ee1fbd", size = 23039, upload-time = "2023-04-14T08:10:22.998Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9e/48/1ea60e74949eecb12cdd6ac43987f9fd331156388dcc2319b45e2ebb81bf/sphinx_copybutton-0.5.2-py3-none-any.whl", hash = "sha256:fb543fd386d917746c9a2c50360c7905b605726b9355cd26e9974857afeae06e", size = 13343, upload-time = "2023-04-14T08:10:20.844Z" },
+]
+
+[[package]]
+name = "sphinx-tabs"
+version = "3.4.7"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "docutils" },
+    { name = "pygments" },
+    { name = "sphinx" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/6a/53/a9a91995cb365e589f413b77fc75f1c0e9b4ac61bfa8da52a779ad855cc0/sphinx-tabs-3.4.7.tar.gz", hash = "sha256:991ad4a424ff54119799ba1491701aa8130dd43509474aef45a81c42d889784d", size = 15891, upload-time = "2024-10-08T13:37:27.887Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/6b/c6/f47505b564b918a3ba60c1e99232d4942c4a7e44ecaae603e829e3d05dae/sphinx_tabs-3.4.7-py3-none-any.whl", hash = "sha256:c12d7a36fd413b369e9e9967a0a4015781b71a9c393575419834f19204bd1915", size = 9727, upload-time = "2024-10-08T13:37:26.192Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-applehelp"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ba/6e/b837e84a1a704953c62ef8776d45c3e8d759876b4a84fe14eba2859106fe/sphinxcontrib_applehelp-2.0.0.tar.gz", hash = "sha256:2f29ef331735ce958efa4734873f084941970894c6090408b079c61b2e1c06d1", size = 20053, upload-time = "2024-07-29T01:09:00.465Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5d/85/9ebeae2f76e9e77b952f4b274c27238156eae7979c5421fba91a28f4970d/sphinxcontrib_applehelp-2.0.0-py3-none-any.whl", hash = "sha256:4cd3f0ec4ac5dd9c17ec65e9ab272c9b867ea77425228e68ecf08d6b28ddbdb5", size = 119300, upload-time = "2024-07-29T01:08:58.99Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-devhelp"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f6/d2/5beee64d3e4e747f316bae86b55943f51e82bb86ecd325883ef65741e7da/sphinxcontrib_devhelp-2.0.0.tar.gz", hash = "sha256:411f5d96d445d1d73bb5d52133377b4248ec79db5c793ce7dbe59e074b4dd1ad", size = 12967, upload-time = "2024-07-29T01:09:23.417Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/35/7a/987e583882f985fe4d7323774889ec58049171828b58c2217e7f79cdf44e/sphinxcontrib_devhelp-2.0.0-py3-none-any.whl", hash = "sha256:aefb8b83854e4b0998877524d1029fd3e6879210422ee3780459e28a1f03a8a2", size = 82530, upload-time = "2024-07-29T01:09:21.945Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-htmlhelp"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/43/93/983afd9aa001e5201eab16b5a444ed5b9b0a7a010541e0ddfbbfd0b2470c/sphinxcontrib_htmlhelp-2.1.0.tar.gz", hash = "sha256:c9e2916ace8aad64cc13a0d233ee22317f2b9025b9cf3295249fa985cc7082e9", size = 22617, upload-time = "2024-07-29T01:09:37.889Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0a/7b/18a8c0bcec9182c05a0b3ec2a776bba4ead82750a55ff798e8d406dae604/sphinxcontrib_htmlhelp-2.1.0-py3-none-any.whl", hash = "sha256:166759820b47002d22914d64a075ce08f4c46818e17cfc9470a9786b759b19f8", size = 98705, upload-time = "2024-07-29T01:09:36.407Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-jsmath"
+version = "1.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b2/e8/9ed3830aeed71f17c026a07a5097edcf44b692850ef215b161b8ad875729/sphinxcontrib-jsmath-1.0.1.tar.gz", hash = "sha256:a9925e4a4587247ed2191a22df5f6970656cb8ca2bd6284309578f2153e0c4b8", size = 5787, upload-time = "2019-01-21T16:10:16.347Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c2/42/4c8646762ee83602e3fb3fbe774c2fac12f317deb0b5dbeeedd2d3ba4b77/sphinxcontrib_jsmath-1.0.1-py2.py3-none-any.whl", hash = "sha256:2ec2eaebfb78f3f2078e73666b1415417a116cc848b72e5172e596c871103178", size = 5071, upload-time = "2019-01-21T16:10:14.333Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-mermaid"
+version = "1.2.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pyyaml" },
+    { name = "sphinx" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f5/49/c6ddfe709a4ab76ac6e5a00e696f73626b2c189dc1e1965a361ec102e6cc/sphinxcontrib_mermaid-1.2.3.tar.gz", hash = "sha256:358699d0ec924ef679b41873d9edd97d0773446daf9760c75e18dc0adfd91371", size = 18885, upload-time = "2025-11-26T04:18:32.43Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/39/8b54299ffa00e597d3b0b4d042241a0a0b22cb429ad007ccfb9c1745b4d1/sphinxcontrib_mermaid-1.2.3-py3-none-any.whl", hash = "sha256:5be782b27026bef97bfb15ccb2f7868b674a1afc0982b54cb149702cfc25aa02", size = 13413, upload-time = "2025-11-26T04:18:31.269Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-qthelp"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/68/bc/9104308fc285eb3e0b31b67688235db556cd5b0ef31d96f30e45f2e51cae/sphinxcontrib_qthelp-2.0.0.tar.gz", hash = "sha256:4fe7d0ac8fc171045be623aba3e2a8f613f8682731f9153bb2e40ece16b9bbab", size = 17165, upload-time = "2024-07-29T01:09:56.435Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/27/83/859ecdd180cacc13b1f7e857abf8582a64552ea7a061057a6c716e790fce/sphinxcontrib_qthelp-2.0.0-py3-none-any.whl", hash = "sha256:b18a828cdba941ccd6ee8445dbe72ffa3ef8cbe7505d8cd1fa0d42d3f2d5f3eb", size = 88743, upload-time = "2024-07-29T01:09:54.885Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-serializinghtml"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/3b/44/6716b257b0aa6bfd51a1b31665d1c205fb12cb5ad56de752dfa15657de2f/sphinxcontrib_serializinghtml-2.0.0.tar.gz", hash = "sha256:e9d912827f872c029017a53f0ef2180b327c3f7fd23c87229f7a8e8b70031d4d", size = 16080, upload-time = "2024-07-29T01:10:09.332Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/52/a7/d2782e4e3f77c8450f727ba74a8f12756d5ba823d81b941f1b04da9d033a/sphinxcontrib_serializinghtml-2.0.0-py3-none-any.whl", hash = "sha256:6e2cb0eef194e10c27ec0023bfeb25badbbb5868244cf5bc5bdc04e4464bf331", size = 92072, upload-time = "2024-07-29T01:10:08.203Z" },
+]
+
+[[package]]
+name = "tenacity"
+version = "9.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0a/d4/2b0cd0fe285e14b36db076e78c93766ff1d529d70408bd1d2a5a84f1d929/tenacity-9.1.2.tar.gz", hash = "sha256:1169d376c297e7de388d18b4481760d478b0e99a777cad3a9c86e556f4b697cb", size = 48036, upload-time = "2025-04-02T08:25:09.966Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e5/30/643397144bfbfec6f6ef821f36f33e57d35946c44a2352d3c9f0ae847619/tenacity-9.1.2-py3-none-any.whl", hash = "sha256:f77bf36710d8b73a50b2dd155c97b870017ad21afe6ab300326b0371b3b05138", size = 28248, upload-time = "2025-04-02T08:25:07.678Z" },
+]
+
+[[package]]
+name = "toml"
+version = "0.10.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/be/ba/1f744cdc819428fc6b5084ec34d9b30660f6f9daaf70eead706e3203ec3c/toml-0.10.2.tar.gz", hash = "sha256:b3bda1d108d5dd99f4a20d24d9c348e91c4db7ab1b749200bded2f839ccbe68f", size = 22253, upload-time = "2020-11-01T01:40:22.204Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/44/6f/7120676b6d73228c96e17f1f794d8ab046fc910d781c8d151120c3f1569e/toml-0.10.2-py2.py3-none-any.whl", hash = "sha256:806143ae5bfb6a3c6e736a764057db0e6a0e05e338b5630894a5f779cabb4f9b", size = 16588, upload-time = "2020-11-01T01:40:20.672Z" },
+]
+
+[[package]]
+name = "tomli"
+version = "2.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/82/30/31573e9457673ab10aa432461bee537ce6cef177667deca369efb79df071/tomli-2.4.0.tar.gz", hash = "sha256:aa89c3f6c277dd275d8e243ad24f3b5e701491a860d5121f2cdd399fbb31fc9c", size = 17477, upload-time = "2026-01-11T11:22:38.165Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3c/d9/3dc2289e1f3b32eb19b9785b6a006b28ee99acb37d1d47f78d4c10e28bf8/tomli-2.4.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:b5ef256a3fd497d4973c11bf142e9ed78b150d36f5773f1ca6088c230ffc5867", size = 153663, upload-time = "2026-01-11T11:21:45.27Z" },
+    { url = "https://files.pythonhosted.org/packages/51/32/ef9f6845e6b9ca392cd3f64f9ec185cc6f09f0a2df3db08cbe8809d1d435/tomli-2.4.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:5572e41282d5268eb09a697c89a7bee84fae66511f87533a6f88bd2f7b652da9", size = 148469, upload-time = "2026-01-11T11:21:46.873Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/c2/506e44cce89a8b1b1e047d64bd495c22c9f71f21e05f380f1a950dd9c217/tomli-2.4.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:551e321c6ba03b55676970b47cb1b73f14a0a4dce6a3e1a9458fd6d921d72e95", size = 236039, upload-time = "2026-01-11T11:21:48.503Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/40/e1b65986dbc861b7e986e8ec394598187fa8aee85b1650b01dd925ca0be8/tomli-2.4.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5e3f639a7a8f10069d0e15408c0b96a2a828cfdec6fca05296ebcdcc28ca7c76", size = 243007, upload-time = "2026-01-11T11:21:49.456Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/6f/6e39ce66b58a5b7ae572a0f4352ff40c71e8573633deda43f6a379d56b3e/tomli-2.4.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1b168f2731796b045128c45982d3a4874057626da0e2ef1fdd722848b741361d", size = 240875, upload-time = "2026-01-11T11:21:50.755Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/ad/cb089cb190487caa80204d503c7fd0f4d443f90b95cf4ef5cf5aa0f439b0/tomli-2.4.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:133e93646ec4300d651839d382d63edff11d8978be23da4cc106f5a18b7d0576", size = 246271, upload-time = "2026-01-11T11:21:51.81Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/63/69125220e47fd7a3a27fd0de0c6398c89432fec41bc739823bcc66506af6/tomli-2.4.0-cp311-cp311-win32.whl", hash = "sha256:b6c78bdf37764092d369722d9946cb65b8767bfa4110f902a1b2542d8d173c8a", size = 96770, upload-time = "2026-01-11T11:21:52.647Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/0d/a22bb6c83f83386b0008425a6cd1fa1c14b5f3dd4bad05e98cf3dbbf4a64/tomli-2.4.0-cp311-cp311-win_amd64.whl", hash = "sha256:d3d1654e11d724760cdb37a3d7691f0be9db5fbdaef59c9f532aabf87006dbaa", size = 107626, upload-time = "2026-01-11T11:21:53.459Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/6d/77be674a3485e75cacbf2ddba2b146911477bd887dda9d8c9dfb2f15e871/tomli-2.4.0-cp311-cp311-win_arm64.whl", hash = "sha256:cae9c19ed12d4e8f3ebf46d1a75090e4c0dc16271c5bce1c833ac168f08fb614", size = 94842, upload-time = "2026-01-11T11:21:54.831Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/43/7389a1869f2f26dba52404e1ef13b4784b6b37dac93bac53457e3ff24ca3/tomli-2.4.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:920b1de295e72887bafa3ad9f7a792f811847d57ea6b1215154030cf131f16b1", size = 154894, upload-time = "2026-01-11T11:21:56.07Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/05/2f9bf110b5294132b2edf13fe6ca6ae456204f3d749f623307cbb7a946f2/tomli-2.4.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:7d6d9a4aee98fac3eab4952ad1d73aee87359452d1c086b5ceb43ed02ddb16b8", size = 149053, upload-time = "2026-01-11T11:21:57.467Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/41/1eda3ca1abc6f6154a8db4d714a4d35c4ad90adc0bcf700657291593fbf3/tomli-2.4.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:36b9d05b51e65b254ea6c2585b59d2c4cb91c8a3d91d0ed0f17591a29aaea54a", size = 243481, upload-time = "2026-01-11T11:21:58.661Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/6d/02ff5ab6c8868b41e7d4b987ce2b5f6a51d3335a70aa144edd999e055a01/tomli-2.4.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1c8a885b370751837c029ef9bc014f27d80840e48bac415f3412e6593bbc18c1", size = 251720, upload-time = "2026-01-11T11:22:00.178Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/57/0405c59a909c45d5b6f146107c6d997825aa87568b042042f7a9c0afed34/tomli-2.4.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8768715ffc41f0008abe25d808c20c3d990f42b6e2e58305d5da280ae7d1fa3b", size = 247014, upload-time = "2026-01-11T11:22:01.238Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/0e/2e37568edd944b4165735687cbaf2fe3648129e440c26d02223672ee0630/tomli-2.4.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:7b438885858efd5be02a9a133caf5812b8776ee0c969fea02c45e8e3f296ba51", size = 251820, upload-time = "2026-01-11T11:22:02.727Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/1c/ee3b707fdac82aeeb92d1a113f803cf6d0f37bdca0849cb489553e1f417a/tomli-2.4.0-cp312-cp312-win32.whl", hash = "sha256:0408e3de5ec77cc7f81960c362543cbbd91ef883e3138e81b729fc3eea5b9729", size = 97712, upload-time = "2026-01-11T11:22:03.777Z" },
+    { url = "https://files.pythonhosted.org/packages/69/13/c07a9177d0b3bab7913299b9278845fc6eaaca14a02667c6be0b0a2270c8/tomli-2.4.0-cp312-cp312-win_amd64.whl", hash = "sha256:685306e2cc7da35be4ee914fd34ab801a6acacb061b6a7abca922aaf9ad368da", size = 108296, upload-time = "2026-01-11T11:22:04.86Z" },
+    { url = "https://files.pythonhosted.org/packages/18/27/e267a60bbeeee343bcc279bb9e8fbed0cbe224bc7b2a3dc2975f22809a09/tomli-2.4.0-cp312-cp312-win_arm64.whl", hash = "sha256:5aa48d7c2356055feef06a43611fc401a07337d5b006be13a30f6c58f869e3c3", size = 94553, upload-time = "2026-01-11T11:22:05.854Z" },
+    { url = "https://files.pythonhosted.org/packages/34/91/7f65f9809f2936e1f4ce6268ae1903074563603b2a2bd969ebbda802744f/tomli-2.4.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:84d081fbc252d1b6a982e1870660e7330fb8f90f676f6e78b052ad4e64714bf0", size = 154915, upload-time = "2026-01-11T11:22:06.703Z" },
+    { url = "https://files.pythonhosted.org/packages/20/aa/64dd73a5a849c2e8f216b755599c511badde80e91e9bc2271baa7b2cdbb1/tomli-2.4.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:9a08144fa4cba33db5255f9b74f0b89888622109bd2776148f2597447f92a94e", size = 149038, upload-time = "2026-01-11T11:22:07.56Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/8a/6d38870bd3d52c8d1505ce054469a73f73a0fe62c0eaf5dddf61447e32fa/tomli-2.4.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c73add4bb52a206fd0c0723432db123c0c75c280cbd67174dd9d2db228ebb1b4", size = 242245, upload-time = "2026-01-11T11:22:08.344Z" },
+    { url = "https://files.pythonhosted.org/packages/59/bb/8002fadefb64ab2669e5b977df3f5e444febea60e717e755b38bb7c41029/tomli-2.4.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1fb2945cbe303b1419e2706e711b7113da57b7db31ee378d08712d678a34e51e", size = 250335, upload-time = "2026-01-11T11:22:09.951Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/3d/4cdb6f791682b2ea916af2de96121b3cb1284d7c203d97d92d6003e91c8d/tomli-2.4.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:bbb1b10aa643d973366dc2cb1ad94f99c1726a02343d43cbc011edbfac579e7c", size = 245962, upload-time = "2026-01-11T11:22:11.27Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/4a/5f25789f9a460bd858ba9756ff52d0830d825b458e13f754952dd15fb7bb/tomli-2.4.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4cbcb367d44a1f0c2be408758b43e1ffb5308abe0ea222897d6bfc8e8281ef2f", size = 250396, upload-time = "2026-01-11T11:22:12.325Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/2f/b73a36fea58dfa08e8b3a268750e6853a6aac2a349241a905ebd86f3047a/tomli-2.4.0-cp313-cp313-win32.whl", hash = "sha256:7d49c66a7d5e56ac959cb6fc583aff0651094ec071ba9ad43df785abc2320d86", size = 97530, upload-time = "2026-01-11T11:22:13.865Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/af/ca18c134b5d75de7e8dc551c5234eaba2e8e951f6b30139599b53de9c187/tomli-2.4.0-cp313-cp313-win_amd64.whl", hash = "sha256:3cf226acb51d8f1c394c1b310e0e0e61fecdd7adcb78d01e294ac297dd2e7f87", size = 108227, upload-time = "2026-01-11T11:22:15.224Z" },
+    { url = "https://files.pythonhosted.org/packages/22/c3/b386b832f209fee8073c8138ec50f27b4460db2fdae9ffe022df89a57f9b/tomli-2.4.0-cp313-cp313-win_arm64.whl", hash = "sha256:d20b797a5c1ad80c516e41bc1fb0443ddb5006e9aaa7bda2d71978346aeb9132", size = 94748, upload-time = "2026-01-11T11:22:16.009Z" },
+    { url = "https://files.pythonhosted.org/packages/23/d1/136eb2cb77520a31e1f64cbae9d33ec6df0d78bdf4160398e86eec8a8754/tomli-2.4.0-py3-none-any.whl", hash = "sha256:1f776e7d669ebceb01dee46484485f43a4048746235e683bcdffacdf1fb4785a", size = 14477, upload-time = "2026-01-11T11:22:37.446Z" },
+]
+
+[[package]]
+name = "ty"
+version = "0.0.49"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1d/8d/37cb91808069509d43a2a11743e12f1e854fd808dbef2203309d256718cd/ty-0.0.49.tar.gz", hash = "sha256:0a027bd0c9c75d035641a365d087ad883446057f9be0b9826251c2aecafbf145", size = 5884753, upload-time = "2026-06-12T03:08:20.221Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ca/de/9237c6a96356612dd0393db1e94cf21f903616adf3a3701bf3da6e4adc92/ty-0.0.49-py3-none-linux_armv6l.whl", hash = "sha256:12c0c4310b936d762a8586c210b53d4fa4bb361a04429afa89bf84b922e5e065", size = 11834671, upload-time = "2026-06-12T03:07:53.062Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/15/daf5a14a5e07012277d450c75325c94614e2acfec4c620c881486118c410/ty-0.0.49-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:737bfdc2caf9712a8580944dcdc80a450a37a4f2bc83c8fa9b7433b374f9e471", size = 11589570, upload-time = "2026-06-12T03:08:25.779Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/58/30bdf98436488aca25f0763bf7f92a061528d42461b686453029e845e4c5/ty-0.0.49-py3-none-macosx_11_0_arm64.whl", hash = "sha256:ab90c1baf3b1701d282fce4b02fa552a962d109f8972c46ef6b22429503bfea4", size = 10985236, upload-time = "2026-06-12T03:08:36.664Z" },
+    { url = "https://files.pythonhosted.org/packages/22/45/ece503e4a1396e13a1a9a0cde51afe476a6506a1d557eeadf8ad45c83bc0/ty-0.0.49-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b4ce8ecf6ba6fc79bd137cc0557a754f7e5f2dfe9436412551d480d680e248ad", size = 11504302, upload-time = "2026-06-12T03:08:01.664Z" },
+    { url = "https://files.pythonhosted.org/packages/17/dc/5d09333d289dfbca1804eaade125c9e8a1a992a2a592a8b80c5e9b589ca9/ty-0.0.49-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:10d85c6865c984e78661e0bd20b180514b4a289739224e84816e342bdf381e04", size = 11626629, upload-time = "2026-06-12T03:08:06.844Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/36/155f41c9dd7237c4b609211f29f77755a139ee6218605dadc7fe21d5e3c8/ty-0.0.49-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1d96a67a206619e01fa92f35a22267ec634bba62be24b1d0e947020cc179995b", size = 12074481, upload-time = "2026-06-12T03:08:09.643Z" },
+    { url = "https://files.pythonhosted.org/packages/96/4c/998ee13cd5045f1f8b36982de7343163832ac53f27debe01b0de0e8bd968/ty-0.0.49-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3de9f648564e0a66344ef397770387cb0d093735f8679d2c5a08a4741e79814d", size = 12678042, upload-time = "2026-06-12T03:08:39.319Z" },
+    { url = "https://files.pythonhosted.org/packages/85/c9/9a505aba85c41ce54cbcaa14f8d79aa084b86151d2d70df11c4655b92898/ty-0.0.49-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5779179ab397d15f8c9dbb8f506ec1b1745f54eac639982f76ef3ce538943b50", size = 12316194, upload-time = "2026-06-12T03:08:18.023Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/b8/ded37fb93503294abbc83c36470bb1413bea05048b745881d4470b518a06/ty-0.0.49-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:792d4974e93cc09bd32f934586080bbbe21b8e777099cb521cb2de18b68a49f0", size = 12145507, upload-time = "2026-06-12T03:07:56.505Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/07/392e80d78f02445f695b815bb9eb0fffacda68b03faee38c900f7b990815/ty-0.0.49-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:727bda86deb136073e525c2e78d60e38aedcce5d80579170844a52bbf7c1440d", size = 12365967, upload-time = "2026-06-12T03:08:12.553Z" },
+    { url = "https://files.pythonhosted.org/packages/50/d3/31b0c2a7fbedd3373e389cb1d81b8d2128f6f868fafb46557736a6f9aca8/ty-0.0.49-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:4f2fc2bc4a8d2ff1cca59fd94772cabdfec4062d47a0b3a0784be46d94d0540b", size = 11475283, upload-time = "2026-06-12T03:08:28.334Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/5b/329e101638920b468a3bb63059c9f66ef99b44aac501222c44832a507321/ty-0.0.49-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:3724bd9badef333321578b6a941fbc571ebf49141ec2356a8590fbe4c9aa588d", size = 11645343, upload-time = "2026-06-12T03:08:15.246Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/76/c897e615e32f80ca81c8c1bc49b9a1f72ff9e3cfea0f8345ba505fe28472/ty-0.0.49-py3-none-musllinux_1_2_i686.whl", hash = "sha256:166c6eb52ee4af3c5a9bb267d165d93000daa55c6758cd8ff3199741fb75917d", size = 11725585, upload-time = "2026-06-12T03:08:33.915Z" },
+    { url = "https://files.pythonhosted.org/packages/59/e1/fdb42ee239f618800842681af5bb8598117e74512c10974a8b7b9086a898/ty-0.0.49-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:91e81d832c287b05782ee32eb1b801f62c1fa08df37d589d2b88c3f1d51c9731", size = 12237261, upload-time = "2026-06-12T03:08:31.105Z" },
+    { url = "https://files.pythonhosted.org/packages/98/0f/a2d6a5fc9d0786cbeb3c200786da4e18c203589be3984bb5def83ca92320/ty-0.0.49-py3-none-win32.whl", hash = "sha256:7186af5ca9829d1f5d8916bcf767b8e819bfbf61b1b8ec843bb3fc699cb502e1", size = 11100789, upload-time = "2026-06-12T03:07:59.092Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/9d/473ac8bc57b5a2d121da893bf9dd74a118efb19a01d711df1a6e397f05cc/ty-0.0.49-py3-none-win_amd64.whl", hash = "sha256:ae2142fc126a01effcca0c222908b0e6654b5ba1266d4e4d406e4866aef8e1d1", size = 12204644, upload-time = "2026-06-12T03:08:04.327Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/a2/8959249da951ba3977fee20e688d28678b8a1d30a9ed4464228a85d45853/ty-0.0.49-py3-none-win_arm64.whl", hash = "sha256:75d5e2e7649765f31f4bed6c8adb149a75b18edd3fa6336dac4d0efc1a66466f", size = 11558965, upload-time = "2026-06-12T03:08:23.012Z" },
+]
+
+[[package]]
+name = "types-psutil"
+version = "7.2.1.20251231"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/09/e0/f4881668da3fcc9473b3fb4b3dc028840cf57374d72b798c0912a183163a/types_psutil-7.2.1.20251231.tar.gz", hash = "sha256:dbf9df530b1130e131e4211ed8cea62c08007bfa69faf2883d296bd241d30e4a", size = 25620, upload-time = "2025-12-31T03:18:29.302Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/12/61/81f180ffbcd0b3516fa3e0e95588dcd48200b6a08e3df53c6c0941a688fe/types_psutil-7.2.1.20251231-py3-none-any.whl", hash = "sha256:40735ca2fc818aed9dcbff7acb3317a774896615e3f4a7bd356afa224b9178e3", size = 32426, upload-time = "2025-12-31T03:18:28.14Z" },
+]
+
+[[package]]
+name = "types-requests"
+version = "2.32.4.20260107"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "urllib3" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/0f/f3/a0663907082280664d745929205a89d41dffb29e89a50f753af7d57d0a96/types_requests-2.32.4.20260107.tar.gz", hash = "sha256:018a11ac158f801bfa84857ddec1650750e393df8a004a8a9ae2a9bec6fcb24f", size = 23165, upload-time = "2026-01-07T03:20:54.091Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1c/12/709ea261f2bf91ef0a26a9eed20f2623227a8ed85610c1e54c5805692ecb/types_requests-2.32.4.20260107-py3-none-any.whl", hash = "sha256:b703fe72f8ce5b31ef031264fe9395cac8f46a04661a79f7ed31a80fb308730d", size = 20676, upload-time = "2026-01-07T03:20:52.929Z" },
+]
+
+[[package]]
+name = "types-toml"
+version = "0.10.8.20240310"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/86/47/3e4c75042792bff8e90d7991aa5c51812cc668828cc6cce711e97f63a607/types-toml-0.10.8.20240310.tar.gz", hash = "sha256:3d41501302972436a6b8b239c850b26689657e25281b48ff0ec06345b8830331", size = 4392, upload-time = "2024-03-10T02:18:37.518Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/da/a2/d32ab58c0b216912638b140ab2170ee4b8644067c293b170e19fba340ccc/types_toml-0.10.8.20240310-py3-none-any.whl", hash = "sha256:627b47775d25fa29977d9c70dc0cbab3f314f32c8d8d0c012f2ef5de7aaec05d", size = 4777, upload-time = "2024-03-10T02:18:36.568Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]
+
+[[package]]
+name = "typing-inspection"
+version = "0.4.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" },
+]
+
+[[package]]
+name = "tzdata"
+version = "2025.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/5e/a7/c202b344c5ca7daf398f3b8a477eeb205cf3b6f32e7ec3a6bac0629ca975/tzdata-2025.3.tar.gz", hash = "sha256:de39c2ca5dc7b0344f2eba86f49d614019d29f060fc4ebc8a417896a620b56a7", size = 196772, upload-time = "2025-12-13T17:45:35.667Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/b0/003792df09decd6849a5e39c28b513c06e84436a54440380862b5aeff25d/tzdata-2025.3-py2.py3-none-any.whl", hash = "sha256:06a47e5700f3081aab02b2e513160914ff0694bce9947d6b76ebd6bf57cfc5d1", size = 348521, upload-time = "2025-12-13T17:45:33.889Z" },
+]
+
+[[package]]
+name = "urllib3"
+version = "2.6.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c7/24/5f1b3bdffd70275f6661c76461e25f024d5a38a46f04aaca912426a2b1d3/urllib3-2.6.3.tar.gz", hash = "sha256:1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed", size = 435556, upload-time = "2026-01-07T16:24:43.925Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/39/08/aaaad47bc4e9dc8c725e68f9d04865dbcb2052843ff09c97b08904852d84/urllib3-2.6.3-py3-none-any.whl", hash = "sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4", size = 131584, upload-time = "2026-01-07T16:24:42.685Z" },
+]
+
+[[package]]
+name = "win32-setctime"
+version = "1.2.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b3/8f/705086c9d734d3b663af0e9bb3d4de6578d08f46b1b101c2442fd9aecaa2/win32_setctime-1.2.0.tar.gz", hash = "sha256:ae1fdf948f5640aae05c511ade119313fb6a30d7eabe25fef9764dca5873c4c0", size = 4867, upload-time = "2024-12-07T15:28:28.314Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e1/07/c6fe3ad3e685340704d314d765b7912993bcb8dc198f0e7a89382d37974b/win32_setctime-1.2.0-py3-none-any.whl", hash = "sha256:95d644c4e708aba81dc3704a116d8cbc974d70b3bdb8be1d150e36be6e9d1390", size = 4083, upload-time = "2024-12-07T15:28:26.465Z" },
+]
+
+[[package]]
+name = "zstandard"
+version = "0.25.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/fd/aa/3e0508d5a5dd96529cdc5a97011299056e14c6505b678fd58938792794b1/zstandard-0.25.0.tar.gz", hash = "sha256:7713e1179d162cf5c7906da876ec2ccb9c3a9dcbdffef0cc7f70c3667a205f0b", size = 711513, upload-time = "2025-09-14T22:15:54.002Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/83/c3ca27c363d104980f1c9cee1101cc8ba724ac8c28a033ede6aab89585b1/zstandard-0.25.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:933b65d7680ea337180733cf9e87293cc5500cc0eb3fc8769f4d3c88d724ec5c", size = 795254, upload-time = "2025-09-14T22:16:26.137Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/4d/e66465c5411a7cf4866aeadc7d108081d8ceba9bc7abe6b14aa21c671ec3/zstandard-0.25.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:a3f79487c687b1fc69f19e487cd949bf3aae653d181dfb5fde3bf6d18894706f", size = 640559, upload-time = "2025-09-14T22:16:27.973Z" },
+    { url = "https://files.pythonhosted.org/packages/12/56/354fe655905f290d3b147b33fe946b0f27e791e4b50a5f004c802cb3eb7b/zstandard-0.25.0-cp311-cp311-manylinux2010_i686.manylinux2014_i686.manylinux_2_12_i686.manylinux_2_17_i686.whl", hash = "sha256:0bbc9a0c65ce0eea3c34a691e3c4b6889f5f3909ba4822ab385fab9057099431", size = 5348020, upload-time = "2025-09-14T22:16:29.523Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/13/2b7ed68bd85e69a2069bcc72141d378f22cae5a0f3b353a2c8f50ef30c1b/zstandard-0.25.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:01582723b3ccd6939ab7b3a78622c573799d5d8737b534b86d0e06ac18dbde4a", size = 5058126, upload-time = "2025-09-14T22:16:31.811Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/dd/fdaf0674f4b10d92cb120ccff58bbb6626bf8368f00ebfd2a41ba4a0dc99/zstandard-0.25.0-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:5f1ad7bf88535edcf30038f6919abe087f606f62c00a87d7e33e7fc57cb69fcc", size = 5405390, upload-time = "2025-09-14T22:16:33.486Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/67/354d1555575bc2490435f90d67ca4dd65238ff2f119f30f72d5cde09c2ad/zstandard-0.25.0-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:06acb75eebeedb77b69048031282737717a63e71e4ae3f77cc0c3b9508320df6", size = 5452914, upload-time = "2025-09-14T22:16:35.277Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/1f/e9cfd801a3f9190bf3e759c422bbfd2247db9d7f3d54a56ecde70137791a/zstandard-0.25.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:9300d02ea7c6506f00e627e287e0492a5eb0371ec1670ae852fefffa6164b072", size = 5559635, upload-time = "2025-09-14T22:16:37.141Z" },
+    { url = "https://files.pythonhosted.org/packages/21/88/5ba550f797ca953a52d708c8e4f380959e7e3280af029e38fbf47b55916e/zstandard-0.25.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:bfd06b1c5584b657a2892a6014c2f4c20e0db0208c159148fa78c65f7e0b0277", size = 5048277, upload-time = "2025-09-14T22:16:38.807Z" },
+    { url = "https://files.pythonhosted.org/packages/46/c0/ca3e533b4fa03112facbe7fbe7779cb1ebec215688e5df576fe5429172e0/zstandard-0.25.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:f373da2c1757bb7f1acaf09369cdc1d51d84131e50d5fa9863982fd626466313", size = 5574377, upload-time = "2025-09-14T22:16:40.523Z" },
+    { url = "https://files.pythonhosted.org/packages/12/9b/3fb626390113f272abd0799fd677ea33d5fc3ec185e62e6be534493c4b60/zstandard-0.25.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:6c0e5a65158a7946e7a7affa6418878ef97ab66636f13353b8502d7ea03c8097", size = 4961493, upload-time = "2025-09-14T22:16:43.3Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/d3/23094a6b6a4b1343b27ae68249daa17ae0651fcfec9ed4de09d14b940285/zstandard-0.25.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:c8e167d5adf59476fa3e37bee730890e389410c354771a62e3c076c86f9f7778", size = 5269018, upload-time = "2025-09-14T22:16:45.292Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/a7/bb5a0c1c0f3f4b5e9d5b55198e39de91e04ba7c205cc46fcb0f95f0383c1/zstandard-0.25.0-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:98750a309eb2f020da61e727de7d7ba3c57c97cf6213f6f6277bb7fb42a8e065", size = 5443672, upload-time = "2025-09-14T22:16:47.076Z" },
+    { url = "https://files.pythonhosted.org/packages/27/22/503347aa08d073993f25109c36c8d9f029c7d5949198050962cb568dfa5e/zstandard-0.25.0-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:22a086cff1b6ceca18a8dd6096ec631e430e93a8e70a9ca5efa7561a00f826fa", size = 5822753, upload-time = "2025-09-14T22:16:49.316Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/be/94267dc6ee64f0f8ba2b2ae7c7a2df934a816baaa7291db9e1aa77394c3c/zstandard-0.25.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:72d35d7aa0bba323965da807a462b0966c91608ef3a48ba761678cb20ce5d8b7", size = 5366047, upload-time = "2025-09-14T22:16:51.328Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/a3/732893eab0a3a7aecff8b99052fecf9f605cf0fb5fb6d0290e36beee47a4/zstandard-0.25.0-cp311-cp311-win32.whl", hash = "sha256:f5aeea11ded7320a84dcdd62a3d95b5186834224a9e55b92ccae35d21a8b63d4", size = 436484, upload-time = "2025-09-14T22:16:55.005Z" },
+    { url = "https://files.pythonhosted.org/packages/43/a3/c6155f5c1cce691cb80dfd38627046e50af3ee9ddc5d0b45b9b063bfb8c9/zstandard-0.25.0-cp311-cp311-win_amd64.whl", hash = "sha256:daab68faadb847063d0c56f361a289c4f268706b598afbf9ad113cbe5c38b6b2", size = 506183, upload-time = "2025-09-14T22:16:52.753Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/3e/8945ab86a0820cc0e0cdbf38086a92868a9172020fdab8a03ac19662b0e5/zstandard-0.25.0-cp311-cp311-win_arm64.whl", hash = "sha256:22a06c5df3751bb7dc67406f5374734ccee8ed37fc5981bf1ad7041831fa1137", size = 462533, upload-time = "2025-09-14T22:16:53.878Z" },
+    { url = "https://files.pythonhosted.org/packages/82/fc/f26eb6ef91ae723a03e16eddb198abcfce2bc5a42e224d44cc8b6765e57e/zstandard-0.25.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7b3c3a3ab9daa3eed242d6ecceead93aebbb8f5f84318d82cee643e019c4b73b", size = 795738, upload-time = "2025-09-14T22:16:56.237Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/1c/d920d64b22f8dd028a8b90e2d756e431a5d86194caa78e3819c7bf53b4b3/zstandard-0.25.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:913cbd31a400febff93b564a23e17c3ed2d56c064006f54efec210d586171c00", size = 640436, upload-time = "2025-09-14T22:16:57.774Z" },
+    { url = "https://files.pythonhosted.org/packages/53/6c/288c3f0bd9fcfe9ca41e2c2fbfd17b2097f6af57b62a81161941f09afa76/zstandard-0.25.0-cp312-cp312-manylinux2010_i686.manylinux2014_i686.manylinux_2_12_i686.manylinux_2_17_i686.whl", hash = "sha256:011d388c76b11a0c165374ce660ce2c8efa8e5d87f34996aa80f9c0816698b64", size = 5343019, upload-time = "2025-09-14T22:16:59.302Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/15/efef5a2f204a64bdb5571e6161d49f7ef0fffdbca953a615efbec045f60f/zstandard-0.25.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:6dffecc361d079bb48d7caef5d673c88c8988d3d33fb74ab95b7ee6da42652ea", size = 5063012, upload-time = "2025-09-14T22:17:01.156Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/37/a6ce629ffdb43959e92e87ebdaeebb5ac81c944b6a75c9c47e300f85abdf/zstandard-0.25.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:7149623bba7fdf7e7f24312953bcf73cae103db8cae49f8154dd1eadc8a29ecb", size = 5394148, upload-time = "2025-09-14T22:17:03.091Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/79/2bf870b3abeb5c070fe2d670a5a8d1057a8270f125ef7676d29ea900f496/zstandard-0.25.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:6a573a35693e03cf1d67799fd01b50ff578515a8aeadd4595d2a7fa9f3ec002a", size = 5451652, upload-time = "2025-09-14T22:17:04.979Z" },
+    { url = "https://files.pythonhosted.org/packages/53/60/7be26e610767316c028a2cbedb9a3beabdbe33e2182c373f71a1c0b88f36/zstandard-0.25.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:5a56ba0db2d244117ed744dfa8f6f5b366e14148e00de44723413b2f3938a902", size = 5546993, upload-time = "2025-09-14T22:17:06.781Z" },
+    { url = "https://files.pythonhosted.org/packages/85/c7/3483ad9ff0662623f3648479b0380d2de5510abf00990468c286c6b04017/zstandard-0.25.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:10ef2a79ab8e2974e2075fb984e5b9806c64134810fac21576f0668e7ea19f8f", size = 5046806, upload-time = "2025-09-14T22:17:08.415Z" },
+    { url = "https://files.pythonhosted.org/packages/08/b3/206883dd25b8d1591a1caa44b54c2aad84badccf2f1de9e2d60a446f9a25/zstandard-0.25.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:aaf21ba8fb76d102b696781bddaa0954b782536446083ae3fdaa6f16b25a1c4b", size = 5576659, upload-time = "2025-09-14T22:17:10.164Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/31/76c0779101453e6c117b0ff22565865c54f48f8bd807df2b00c2c404b8e0/zstandard-0.25.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:1869da9571d5e94a85a5e8d57e4e8807b175c9e4a6294e3b66fa4efb074d90f6", size = 4953933, upload-time = "2025-09-14T22:17:11.857Z" },
+    { url = "https://files.pythonhosted.org/packages/18/e1/97680c664a1bf9a247a280a053d98e251424af51f1b196c6d52f117c9720/zstandard-0.25.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:809c5bcb2c67cd0ed81e9229d227d4ca28f82d0f778fc5fea624a9def3963f91", size = 5268008, upload-time = "2025-09-14T22:17:13.627Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/73/316e4010de585ac798e154e88fd81bb16afc5c5cb1a72eeb16dd37e8024a/zstandard-0.25.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:f27662e4f7dbf9f9c12391cb37b4c4c3cb90ffbd3b1fb9284dadbbb8935fa708", size = 5433517, upload-time = "2025-09-14T22:17:16.103Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/60/dd0f8cfa8129c5a0ce3ea6b7f70be5b33d2618013a161e1ff26c2b39787c/zstandard-0.25.0-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:99c0c846e6e61718715a3c9437ccc625de26593fea60189567f0118dc9db7512", size = 5814292, upload-time = "2025-09-14T22:17:17.827Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/5f/75aafd4b9d11b5407b641b8e41a57864097663699f23e9ad4dbb91dc6bfe/zstandard-0.25.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:474d2596a2dbc241a556e965fb76002c1ce655445e4e3bf38e5477d413165ffa", size = 5360237, upload-time = "2025-09-14T22:17:19.954Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/8d/0309daffea4fcac7981021dbf21cdb2e3427a9e76bafbcdbdf5392ff99a4/zstandard-0.25.0-cp312-cp312-win32.whl", hash = "sha256:23ebc8f17a03133b4426bcc04aabd68f8236eb78c3760f12783385171b0fd8bd", size = 436922, upload-time = "2025-09-14T22:17:24.398Z" },
+    { url = "https://files.pythonhosted.org/packages/79/3b/fa54d9015f945330510cb5d0b0501e8253c127cca7ebe8ba46a965df18c5/zstandard-0.25.0-cp312-cp312-win_amd64.whl", hash = "sha256:ffef5a74088f1e09947aecf91011136665152e0b4b359c42be3373897fb39b01", size = 506276, upload-time = "2025-09-14T22:17:21.429Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/6b/8b51697e5319b1f9ac71087b0af9a40d8a6288ff8025c36486e0c12abcc4/zstandard-0.25.0-cp312-cp312-win_arm64.whl", hash = "sha256:181eb40e0b6a29b3cd2849f825e0fa34397f649170673d385f3598ae17cca2e9", size = 462679, upload-time = "2025-09-14T22:17:23.147Z" },
+    { url = "https://files.pythonhosted.org/packages/35/0b/8df9c4ad06af91d39e94fa96cc010a24ac4ef1378d3efab9223cc8593d40/zstandard-0.25.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:ec996f12524f88e151c339688c3897194821d7f03081ab35d31d1e12ec975e94", size = 795735, upload-time = "2025-09-14T22:17:26.042Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/06/9ae96a3e5dcfd119377ba33d4c42a7d89da1efabd5cb3e366b156c45ff4d/zstandard-0.25.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:a1a4ae2dec3993a32247995bdfe367fc3266da832d82f8438c8570f989753de1", size = 640440, upload-time = "2025-09-14T22:17:27.366Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/14/933d27204c2bd404229c69f445862454dcc101cd69ef8c6068f15aaec12c/zstandard-0.25.0-cp313-cp313-manylinux2010_i686.manylinux2014_i686.manylinux_2_12_i686.manylinux_2_17_i686.whl", hash = "sha256:e96594a5537722fdfb79951672a2a63aec5ebfb823e7560586f7484819f2a08f", size = 5343070, upload-time = "2025-09-14T22:17:28.896Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/db/ddb11011826ed7db9d0e485d13df79b58586bfdec56e5c84a928a9a78c1c/zstandard-0.25.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:bfc4e20784722098822e3eee42b8e576b379ed72cca4a7cb856ae733e62192ea", size = 5063001, upload-time = "2025-09-14T22:17:31.044Z" },
+    { url = "https://files.pythonhosted.org/packages/db/00/87466ea3f99599d02a5238498b87bf84a6348290c19571051839ca943777/zstandard-0.25.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:457ed498fc58cdc12fc48f7950e02740d4f7ae9493dd4ab2168a47c93c31298e", size = 5394120, upload-time = "2025-09-14T22:17:32.711Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/95/fc5531d9c618a679a20ff6c29e2b3ef1d1f4ad66c5e161ae6ff847d102a9/zstandard-0.25.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:fd7a5004eb1980d3cefe26b2685bcb0b17989901a70a1040d1ac86f1d898c551", size = 5451230, upload-time = "2025-09-14T22:17:34.41Z" },
+    { url = "https://files.pythonhosted.org/packages/63/4b/e3678b4e776db00f9f7b2fe58e547e8928ef32727d7a1ff01dea010f3f13/zstandard-0.25.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8e735494da3db08694d26480f1493ad2cf86e99bdd53e8e9771b2752a5c0246a", size = 5547173, upload-time = "2025-09-14T22:17:36.084Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/d5/ba05ed95c6b8ec30bd468dfeab20589f2cf709b5c940483e31d991f2ca58/zstandard-0.25.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:3a39c94ad7866160a4a46d772e43311a743c316942037671beb264e395bdd611", size = 5046736, upload-time = "2025-09-14T22:17:37.891Z" },
+    { url = "https://files.pythonhosted.org/packages/50/d5/870aa06b3a76c73eced65c044b92286a3c4e00554005ff51962deef28e28/zstandard-0.25.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:172de1f06947577d3a3005416977cce6168f2261284c02080e7ad0185faeced3", size = 5576368, upload-time = "2025-09-14T22:17:40.206Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/35/398dc2ffc89d304d59bc12f0fdd931b4ce455bddf7038a0a67733a25f550/zstandard-0.25.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:3c83b0188c852a47cd13ef3bf9209fb0a77fa5374958b8c53aaa699398c6bd7b", size = 4954022, upload-time = "2025-09-14T22:17:41.879Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/5c/36ba1e5507d56d2213202ec2b05e8541734af5f2ce378c5d1ceaf4d88dc4/zstandard-0.25.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:1673b7199bbe763365b81a4f3252b8e80f44c9e323fc42940dc8843bfeaf9851", size = 5267889, upload-time = "2025-09-14T22:17:43.577Z" },
+    { url = "https://files.pythonhosted.org/packages/70/e8/2ec6b6fb7358b2ec0113ae202647ca7c0e9d15b61c005ae5225ad0995df5/zstandard-0.25.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:0be7622c37c183406f3dbf0cba104118eb16a4ea7359eeb5752f0794882fc250", size = 5433952, upload-time = "2025-09-14T22:17:45.271Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/01/b5f4d4dbc59ef193e870495c6f1275f5b2928e01ff5a81fecb22a06e22fb/zstandard-0.25.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:5f5e4c2a23ca271c218ac025bd7d635597048b366d6f31f420aaeb715239fc98", size = 5814054, upload-time = "2025-09-14T22:17:47.08Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/e5/fbd822d5c6f427cf158316d012c5a12f233473c2f9c5fe5ab1ae5d21f3d8/zstandard-0.25.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4f187a0bb61b35119d1926aee039524d1f93aaf38a9916b8c4b78ac8514a0aaf", size = 5360113, upload-time = "2025-09-14T22:17:48.893Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/e0/69a553d2047f9a2c7347caa225bb3a63b6d7704ad74610cb7823baa08ed7/zstandard-0.25.0-cp313-cp313-win32.whl", hash = "sha256:7030defa83eef3e51ff26f0b7bfb229f0204b66fe18e04359ce3474ac33cbc09", size = 436936, upload-time = "2025-09-14T22:17:52.658Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/82/b9c06c870f3bd8767c201f1edbdf9e8dc34be5b0fbc5682c4f80fe948475/zstandard-0.25.0-cp313-cp313-win_amd64.whl", hash = "sha256:1f830a0dac88719af0ae43b8b2d6aef487d437036468ef3c2ea59c51f9d55fd5", size = 506232, upload-time = "2025-09-14T22:17:50.402Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/57/60c3c01243bb81d381c9916e2a6d9e149ab8627c0c7d7abb2d73384b3c0c/zstandard-0.25.0-cp313-cp313-win_arm64.whl", hash = "sha256:85304a43f4d513f5464ceb938aa02c1e78c2943b29f44a750b48b25ac999a049", size = 462671, upload-time = "2025-09-14T22:17:51.533Z" },
+]

From 121317d8f7c483535cc47061b299a3e1223e884b Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 09:01:40 -0600
Subject: [PATCH 03/24] docs: add uv-based install option to the installation
 guide

Present pip and uv side by side with sphinx-tabs for creating the virtual
environment and installing sparkctl, and add a tip covering
`uv tool install sparkctl` for CLI-only usage.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 docs/how_tos/getting_started/installation.md | 98 ++++++++++++++++----
 1 file changed, 81 insertions(+), 17 deletions(-)

diff --git a/docs/how_tos/getting_started/installation.md b/docs/how_tos/getting_started/installation.md
index 0f1d282..8d1947e 100644
--- a/docs/how_tos/getting_started/installation.md
+++ b/docs/how_tos/getting_started/installation.md
@@ -1,14 +1,30 @@
 # Installation
 
-1. Create a virtual environment with Python 3.11 or later. This example uses the `venv` module in
-   the standard library to create a virtual environment in your home directory.
-
-   You may prefer `conda` or `mamba`.
+1. Create a virtual environment with Python 3.11 or later. These examples create a virtual
+   environment in your home directory.
 
    If you are running on an HPC, you may need to `module load python` first.
 
-   ```console
-   $ python -m venv ~/python-envs/sparkctl
+   ```{eval-rst}
+   .. tabs::
+
+      .. tab:: venv
+
+         This uses the ``venv`` module in the standard library. You may prefer ``conda`` or
+         ``mamba``.
+
+         .. code-block:: console
+
+            $ python -m venv ~/python-envs/sparkctl
+
+      .. tab:: uv
+
+         `uv <https://docs.astral.sh/uv/>`_ creates the environment quickly and can install the
+         requested Python version for you.
+
+         .. code-block:: console
+
+            $ uv venv --python 3.11 ~/python-envs/sparkctl
    ```
 
 2. Activate the virtual environment.
@@ -22,26 +38,74 @@
 3. Install the Python package `sparkctl`.
 
    If you will be using Spark Connect to run Spark jobs, the base installation is sufficient.
-   
+
    ```{eval-rst}
    .. note:: This does not include `spark-submit` or `pyspark`.
    ```
 
-   ```console
-   $ pip install sparkctl
+   ```{eval-rst}
+   .. tabs::
+
+      .. tab:: pip
+
+         .. code-block:: console
+
+            $ pip install sparkctl
+
+      .. tab:: uv
+
+         .. code-block:: console
+
+            $ uv pip install sparkctl
    ```
-   
+
    If you will be running Spark jobs with `spark-submit` or `pyspark`, you will need to install
-   the full `pyspark` package. This command will do that:
+   the full `pyspark` package:
 
-   ```console
-   $ pip install sparkctl[pyspark]
+   ```{eval-rst}
+   .. tabs::
+
+      .. tab:: pip
+
+         .. code-block:: console
+
+            $ pip install "sparkctl[pyspark]"
+
+      .. tab:: uv
+
+         .. code-block:: console
+
+            $ uv pip install "sparkctl[pyspark]"
+   ```
+
+   ```{eval-rst}
+   .. tip::
+
+      If you only need the ``sparkctl`` command-line tool (and not the Python API), you can install
+      it as a standalone, isolated tool with uv. This does not require creating or activating a
+      virtual environment:
+
+      .. code-block:: console
+
+         $ uv tool install sparkctl
    ```
-   
+
 4. Optional, install from the main branch (or substitute another branch or tag).
 
-   ```console
-   $ pip install git+https://github.com/NatLabRockies/sparkctl.git@main
+   ```{eval-rst}
+   .. tabs::
+
+      .. tab:: pip
+
+         .. code-block:: console
+
+            $ pip install git+https://github.com/NatLabRockies/sparkctl.git@main
+
+      .. tab:: uv
+
+         .. code-block:: console
+
+            $ uv pip install git+https://github.com/NatLabRockies/sparkctl.git@main
    ```
 
 5. Create a one-time sparkctl default configuration file. The parameters will vary based on your
@@ -58,6 +122,6 @@
    Wrote sparkctl settings to /Users/dthom/.sparkctl.toml
    ```
    Refer to `sparkctl default-config --help` for additional options.
-   
+
    The paths to the Spark binaries will likely not change often. This file will also seed the default
    values for your `sparkctl configure` commands, and so you may want to manually edit those settings.

From 5fd0a78d223ae2ea5f5ae3fc6835416fca814366 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 09:12:25 -0600
Subject: [PATCH 04/24] docs: fix install, correctness, and debuggability
 issues

Installation:
- Fix the environment-activation command in every tutorial and how-to:
  `source ~/python-envs/sparkctl` -> `source ~/python-envs/sparkctl/bin/activate`.
- Correct the `~/.sparkctl.toml` keys in the explanation page: `spark_path`/
  `java_path` (not `spark_home`/`java_home`) and `start_connect_server` under a
  `[runtime]` section (not `spark_connect_server`).
- Finish the truncated "Python script" tutorial: close the code block and add
  the step to run the script.

Correctness:
- Hive warehouse directory is `spark-warehouse`, not `spark_warehouse`.
- `--spark-log-level` only accepts debug/info/warn/error; note that trace/
  fatal/off require editing log4j2.properties. Refresh the stale Spark version
  in the example output.
- Fix the out-of-order list in the "Why is my job slow?" FAQ entry and the
  `spark-default.conf` -> `spark-defaults.conf` filename typo.

Debuggability:
- Executor logs live under `spark_scratch/workers/` (plural); fix the path and
  the `tail` command in the debugging page.
- Replace the macOS-only `stat -f` invocation with GNU `stat -c`, which is what
  runs on the Linux compute nodes.
- Fix the Spark Web UI SSH tunnel in the FAQ to target the compute node
  (`$COMPUTE_NODE`) instead of `$(hostname)`, and fix the `--constraint` typo.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 docs/explanation/index.md                        | 12 +++++++++---
 docs/faq.md                                      | 16 +++++++++-------
 docs/how_tos/applications/hive_metastore.md      |  2 +-
 .../configuration/custom_spark_defaults.md       |  4 ++--
 docs/how_tos/configuration/spark_log_level.md    | 13 ++++++++-----
 docs/how_tos/debugging/index.md                  |  6 +++---
 docs/how_tos/execution/start_a_cluster.md        |  2 +-
 docs/tutorials/run_ibis_spark_jobs.md            |  6 +++---
 .../run_python_spark_jobs_interactively.md       |  2 +-
 docs/tutorials/run_python_spark_jobs_script.md   | 15 +++++++++++----
 .../run_python_spark_jobs_spark_connect.md       |  2 +-
 docs/tutorials/run_spark_jobs.md                 |  2 +-
 12 files changed, 50 insertions(+), 32 deletions(-)

diff --git a/docs/explanation/index.md b/docs/explanation/index.md
index 2a592e2..7d1504b 100644
--- a/docs/explanation/index.md
+++ b/docs/explanation/index.md
@@ -94,13 +94,19 @@ This TOML file stores environment-specific settings that rarely change:
 
 ```toml
 [binaries]
-spark_home = "/path/to/spark"
-java_home = "/path/to/java"
+spark_path = "/path/to/spark"
+java_path = "/path/to/java"
 ```
 
 These settings tell sparkctl where to find Spark and Java. You can also set global settings that
 apply every time you run `sparkctl configure`. For example, if you always want to use Spark Connect,
-you can set `spark_connect_server = true` and avoid having to set it each time you configure.
+you can set `start_connect_server = true` in a `[runtime]` section and avoid having to set it each
+time you configure:
+
+```toml
+[runtime]
+start_connect_server = true
+```
 
 ### Runtime Configuration (`./conf/`)
 
diff --git a/docs/faq.md b/docs/faq.md
index a890250..5497f83 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -77,17 +77,19 @@ incompatible with cluster version 4.1.2.
 Common causes:
 
 1. **High-bandwidth nodes**: Some NLR Kestrel compute nodes have two network cards, which Spark
-   cannot deal with. Set `--constaint lbw` when allocating nodes.
+   cannot deal with. Set `--constraint lbw` when allocating nodes.
 
 Check the Spark master logs in `./spark_scratch/logs/` for connection errors.
 
 ### How do I connect to the Spark Web UI?
 
-The Spark master runs a web UI on port 4040 (driver) or 8080 (master). Since HPC compute nodes
-aren't directly accessible, use SSH tunneling:
+Spark runs a web UI on port 8080 (master) and port 4040 (driver/application). Since HPC compute
+nodes aren't directly accessible, use SSH tunneling. Substitute the name of your compute node
+(it is listed in `./conf/workers`) for `$COMPUTE_NODE`:
 
 ```console
-$ ssh -L 8080:$(hostname):8080 user@hpc-login-node
+$ export COMPUTE_NODE=<your-compute-node-name>
+$ ssh -L 8080:$COMPUTE_NODE:8080 -L 4040:$COMPUTE_NODE:4040 user@hpc-login-node
 ```
 
 Then open `http://localhost:8080` or `http://localhost:4040` in your browser.
@@ -104,13 +106,13 @@ Common causes:
 3. **Too few partitions**: Increase `spark.sql.shuffle.partitions`.
 4. **Too many partitions**: Decrease partitions if you have many small tasks.
 5. **Slow storage**: Ensure shuffle storage uses fast local SSDs, not shared filesystem.
+6. **Non-ideal partitioning**: If you are trying to partition-by-column in the same query as your
+   main work, especially where you significantly increased the shuffle partitions, persist your
+   main work first. Then repartition in a second task.
 7. **Query too complex**: If you are trying to run a very complex query where subtasks have
    different data sizes and partitioning needs, consider breaking the query into smaller parts with
    different settings. Persist intermediate results to the filesystem so that you can checkpoint and
    make incremental progress.
-6. **Non-ideal partitioning**: If you are trying to partition-by-column in the same query as your
-   main work, especially where you significantly increased the shuffle partitions, persist your
-   main work first. Then repartition in a second task.
 
 See the {ref}`how-tos-debugging` for performance troubleshooting.
 
diff --git a/docs/how_tos/applications/hive_metastore.md b/docs/how_tos/applications/hive_metastore.md
index eb88227..c751713 100644
--- a/docs/how_tos/applications/hive_metastore.md
+++ b/docs/how_tos/applications/hive_metastore.md
@@ -26,6 +26,6 @@ start the server. Apptainer will cache the container image and you can reuse the
 across Slurm allocations.
 
 **Note**: The metadata about your tables will be stored in Derby or Postgres. Your tables will
-be stored on the filesystem (Parquet files by default) in a directory called `spark_warehouse`,
+be stored on the filesystem (Parquet files by default) in a directory called `spark-warehouse`,
 which gets created in the directory passed to `--metastore-dir` (current directory by default).
 Postgres data, if enabled, will be in the same directory (`pg_data`).
diff --git a/docs/how_tos/configuration/custom_spark_defaults.md b/docs/how_tos/configuration/custom_spark_defaults.md
index 7b41ecd..9a6263b 100644
--- a/docs/how_tos/configuration/custom_spark_defaults.md
+++ b/docs/how_tos/configuration/custom_spark_defaults.md
@@ -1,4 +1,4 @@
-# How to use a custom spark-default.conf file
+# How to use a custom spark-defaults.conf file
 sparkctl sets custom settings in the `spark-defaults.conf` file. For example, it sets
 
 ```
@@ -24,5 +24,5 @@ If you don't want these settings or want to add your own settings every time you
    
 ```{eval-rst}
 .. note:: sparkctl will still append Spark driver, executor, and other settings to the runtime
-   version of the spark-default.conf file.
+   version of the spark-defaults.conf file.
 ```
diff --git a/docs/how_tos/configuration/spark_log_level.md b/docs/how_tos/configuration/spark_log_level.md
index 4cb0f38..6fbf449 100644
--- a/docs/how_tos/configuration/spark_log_level.md
+++ b/docs/how_tos/configuration/spark_log_level.md
@@ -14,17 +14,20 @@ This sets the root logger to `WARN`, so you'll only see warnings and errors.
 
 ## Available Log Levels
 
-Spark uses Log4j 2 with these levels (from most to least verbose):
+The `--spark-log-level` option accepts these values:
 
 | Level | Description | Use Case |
 |-------|-------------|----------|
-| `trace` | Fine-grained debugging | Deep Spark internals debugging |
 | `debug` | Detailed debugging | Troubleshooting specific issues |
 | `info` | General information (default) | Development, understanding job progress |
 | `warn` | Warnings only | Production jobs, cleaner output |
 | `error` | Errors only | When you only care about failures |
-| `fatal` | Critical failures only | Minimal output |
-| `off` | No logging | Not recommended |
+
+```{eval-rst}
+.. note:: Log4j 2 also defines ``trace``, ``fatal``, and ``off`` levels, but ``--spark-log-level``
+   does not accept them. To use one of those, edit ``log4j2.properties`` in ``./conf/`` after
+   running ``sparkctl configure``, as described in the Per-Logger Configuration section below.
+```
 
 ## Recommendations
 
@@ -36,7 +39,7 @@ Spark uses Log4j 2 with these levels (from most to least verbose):
 
 With `INFO` (default), you'll see messages like:
 ```
-INFO SparkContext: Running Spark version 3.5.1
+INFO SparkContext: Running Spark version 4.1.2
 INFO ResourceUtils: Resources for spark.driver: ...
 INFO SparkContext: Submitted application: My Job
 INFO Executor: Starting executor ID driver on host ...
diff --git a/docs/how_tos/debugging/index.md b/docs/how_tos/debugging/index.md
index ac04ede..ec5274f 100644
--- a/docs/how_tos/debugging/index.md
+++ b/docs/how_tos/debugging/index.md
@@ -18,7 +18,7 @@ Open your browser to http://localhost:4040 after configuring the tunnel to acces
 ## Log files
 sparkctl configures Spark to record log files in the base directory. Spark master, worker, connect
 server, etc, will be in `./spark_scratch/logs`. Executor logs will be in
-`./spark_scratch/worker/app-*/*/stderr`
+`./spark_scratch/workers/app-*/*/stderr`
 
 For example,
 ```console
@@ -44,12 +44,12 @@ queries are often visible in the executor `stderr` files. For example, if a job
 you can tail the `stderr` files to see what is happening:
 
 ```console
-$ tail -f spark_scratch/worker/*/*/stderr
+$ tail -f spark_scratch/workers/*/*/stderr
 ```
 
 If you have many executors, you may want to tail only the most recent ones. Identify them with
 ```console
-$ find spark_scratch -type f -name stderr -exec stat -f '%m %Sm %N' {} + 2>/dev/null | sort -n
+$ find spark_scratch -type f -name stderr -exec stat -c '%Y %y %n' {} + 2>/dev/null | sort -n
 ```
 
 ## Spark shuffle partitions
diff --git a/docs/how_tos/execution/start_a_cluster.md b/docs/how_tos/execution/start_a_cluster.md
index f92ed18..97eec8c 100644
--- a/docs/how_tos/execution/start_a_cluster.md
+++ b/docs/how_tos/execution/start_a_cluster.md
@@ -6,7 +6,7 @@ This page assumes that you have allocated compute nodes via Slurm.
 
    ```console
    $ module load python
-   $ source ~/python-envs/sparkctl
+   $ source ~/python-envs/sparkctl/bin/activate
    ```
 
 2. Configure and start the Spark cluster. The sparkctl code will detect the compute nodes based on
diff --git a/docs/tutorials/run_ibis_spark_jobs.md b/docs/tutorials/run_ibis_spark_jobs.md
index 53d1efd..ab5c5b3 100644
--- a/docs/tutorials/run_ibis_spark_jobs.md
+++ b/docs/tutorials/run_ibis_spark_jobs.md
@@ -39,7 +39,7 @@ This approach uses Spark Connect under the hood.
 
    ```console
    $ module load python
-   $ source ~/python-envs/sparkctl
+   $ source ~/python-envs/sparkctl/bin/activate
    ```
 
 3. Add the code below to a Python script. This will configure and start the Spark cluster, create
@@ -93,7 +93,7 @@ multiple scripts or interactive sessions against it.
 
    ```console
    $ module load python
-   $ source ~/python-envs/sparkctl
+   $ source ~/python-envs/sparkctl/bin/activate
    ```
 
 3. Configure the Spark cluster with the Connect Server enabled. The sparkctl code will detect
@@ -158,7 +158,7 @@ issues with Spark Connect.
 
    ```console
    $ module load python
-   $ source ~/python-envs/sparkctl
+   $ source ~/python-envs/sparkctl/bin/activate
    ```
 
 3. Configure the Spark cluster without the Connect Server.
diff --git a/docs/tutorials/run_python_spark_jobs_interactively.md b/docs/tutorials/run_python_spark_jobs_interactively.md
index 528b619..fc379e6 100644
--- a/docs/tutorials/run_python_spark_jobs_interactively.md
+++ b/docs/tutorials/run_python_spark_jobs_interactively.md
@@ -18,7 +18,7 @@ environment variables for you.
 
    ```console
    $ module load python
-   $ source ~/python-envs/sparkctl
+   $ source ~/python-envs/sparkctl/bin/activate
    ```
 
 3. Configure and start the Spark cluster.
diff --git a/docs/tutorials/run_python_spark_jobs_script.md b/docs/tutorials/run_python_spark_jobs_script.md
index 87850ec..377964b 100644
--- a/docs/tutorials/run_python_spark_jobs_script.md
+++ b/docs/tutorials/run_python_spark_jobs_script.md
@@ -18,15 +18,15 @@ Python library to hide the details of starting the cluster and setting environme
 
    ```console
    $ module load python
-   $ source ~/python-envs/sparkctl
+   $ source ~/python-envs/sparkctl/bin/activate
    ```
 
-3. Add the code below to a Python script. This code block will configure and start the Spark
-   cluster, run your Spark job, and then stop the cluster.
+3. Add the code below to a Python script named `my_job.py`. This code block will configure and
+   start the Spark cluster, run your Spark job, and then stop the cluster.
 
    ```python
    from sparkctl import ClusterManager, make_default_spark_config
-   
+
    # This loads your global sparkctl configuration file (~/.sparkctl.toml).
    config = make_default_spark_config()
    # Set runtime options as desired.
@@ -36,3 +36,10 @@ Python library to hide the details of starting the cluster and setting environme
    with mgr.managed_cluster() as spark:
        df = spark.createDataFrame([(x, x + 1) for x in range(1000)], ["a", "b"])
        df.show()
+   ```
+
+4. Run the script.
+
+   ```console
+   $ python my_job.py
+   ```
diff --git a/docs/tutorials/run_python_spark_jobs_spark_connect.md b/docs/tutorials/run_python_spark_jobs_spark_connect.md
index aaba293..826b67e 100644
--- a/docs/tutorials/run_python_spark_jobs_spark_connect.md
+++ b/docs/tutorials/run_python_spark_jobs_spark_connect.md
@@ -16,7 +16,7 @@ Connect Server.
 
    ```console
    $ module load python
-   $ source ~/python-envs/sparkctl
+   $ source ~/python-envs/sparkctl/bin/activate
    ```
 
 3. Configure the Spark cluster. The sparkctl code will detect the compute nodes based on
diff --git a/docs/tutorials/run_spark_jobs.md b/docs/tutorials/run_spark_jobs.md
index 27088d1..c87635b 100644
--- a/docs/tutorials/run_spark_jobs.md
+++ b/docs/tutorials/run_spark_jobs.md
@@ -26,7 +26,7 @@ the CLI help, e.g. `spark-submit --help`, for details on how to set these option
 
    ```console
    $ module load python
-   $ source ~/python-envs/sparkctl
+   $ source ~/python-envs/sparkctl/bin/activate
    ```
 
 4. Configure the Spark cluster. The sparkctl code will detect the compute nodes based on

From b94e20e4c705125ff077f81cf34b16f3b0ba5fb0 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 09:40:08 -0600
Subject: [PATCH 05/24] Add reverse proxy, Prometheus, JupyterLab, and
 experimental GPU features

Deploy four additional Spark features through sparkctl:

- Web UI reverse proxy (--reverse-proxy): run the master as a reverse
  proxy for worker/application UIs, so the UIs are reachable through the
  master node on HPC clusters where compute nodes are not.
- Prometheus metrics (--prometheus): register Spark's PrometheusServlet
  via metrics.properties on the existing web UI ports.
- JupyterLab service (--jupyter): start/stop a notebook server on the
  master node, pre-wired to the Connect server via SPARK_REMOTE.
- GPU scheduling and NVIDIA RAPIDS (--gpus/--rapids), marked EXPERIMENTAL
  and untested: GPU detection in the compute interface, a generated GPU
  discovery script, and RAPIDS plugin wiring via spark.jars.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/applications/index.md            |   1 +
 docs/how_tos/applications/jupyter.md          |  59 ++++++
 docs/how_tos/configuration/gpus.md            |  72 +++++++
 docs/how_tos/configuration/index.md           |   2 +
 .../configuration/web_ui_reverse_proxy.md     |  43 ++++
 docs/how_tos/execution/index.md               |   1 +
 docs/how_tos/execution/prometheus_metrics.md  |  36 ++++
 src/sparkctl/cli/sparkctl.py                  |  98 ++++++++++
 src/sparkctl/cluster_manager.py               | 183 ++++++++++++++++--
 src/sparkctl/compute_interface.py             |   4 +
 src/sparkctl/fake_compute.py                  |   3 +
 src/sparkctl/models.py                        |  72 ++++++-
 src/sparkctl/native_compute.py                |  19 ++
 src/sparkctl/slurm_compute.py                 |  38 ++++
 src/sparkctl/spark_process_runner.py          |  78 ++++++++
 tests/test_cluster_manager.py                 |  53 +++++
 tests/test_sparkctl_cli.py                    |  27 +++
 17 files changed, 772 insertions(+), 17 deletions(-)
 create mode 100644 docs/how_tos/applications/jupyter.md
 create mode 100644 docs/how_tos/configuration/gpus.md
 create mode 100644 docs/how_tos/configuration/web_ui_reverse_proxy.md
 create mode 100644 docs/how_tos/execution/prometheus_metrics.md

diff --git a/docs/how_tos/applications/index.md b/docs/how_tos/applications/index.md
index 65c8976..aceab48 100644
--- a/docs/how_tos/applications/index.md
+++ b/docs/how_tos/applications/index.md
@@ -7,4 +7,5 @@
 
     hive_metastore
     tableau
+    jupyter
 ```
diff --git a/docs/how_tos/applications/jupyter.md b/docs/how_tos/applications/jupyter.md
new file mode 100644
index 0000000..c627235
--- /dev/null
+++ b/docs/how_tos/applications/jupyter.md
@@ -0,0 +1,59 @@
+# How to run a JupyterLab notebook against the cluster
+
+sparkctl can start a JupyterLab server on the master node so you can run interactive notebooks
+against the Spark cluster. When the Spark Connect server is enabled, the notebook's `SparkSession`
+connects to the cluster automatically.
+
+## Prerequisites
+
+Install JupyterLab in the same environment as sparkctl:
+
+```console
+$ pip install jupyterlab    # or: uv pip install jupyterlab
+```
+
+## Start JupyterLab with the Connect server
+
+The recommended setup enables the Spark Connect server so the notebook connects remotely without
+any extra configuration:
+
+```console
+$ sparkctl configure --connect-server --jupyter --start
+```
+
+sparkctl sets `SPARK_REMOTE` for the JupyterLab process, so inside a notebook you can simply do:
+
+```python
+from pyspark.sql import SparkSession
+
+spark = SparkSession.builder.getOrCreate()
+spark.createDataFrame([(1, 2), (3, 4)], ["a", "b"]).show()
+```
+
+## Find the access URL
+
+The JupyterLab access URL, including its login token, is written to `jupyter.log` in the cluster
+base directory:
+
+```console
+$ grep -m1 'http' jupyter.log
+```
+
+JupyterLab listens on port 8889 by default. Change it with `--jupyter-port`, and forward it to your
+laptop over SSH (replacing `master-node` with the node running the server):
+
+```console
+$ ssh -L 8889:master-node:8889 <hpc-login-host>
+```
+
+Then open the URL from `jupyter.log`, replacing the host with `localhost`.
+
+## Stopping
+
+`sparkctl stop` shuts the JupyterLab server down along with the rest of the cluster.
+
+```{eval-rst}
+.. note:: If you enable ``--jupyter`` without ``--connect-server``, JupyterLab still starts, but
+   the notebook is responsible for creating its own ``SparkSession`` (for example, a local driver
+   that connects to ``spark://<master>:7077``). The Connect server path is recommended.
+```
diff --git a/docs/how_tos/configuration/gpus.md b/docs/how_tos/configuration/gpus.md
new file mode 100644
index 0000000..133493c
--- /dev/null
+++ b/docs/how_tos/configuration/gpus.md
@@ -0,0 +1,72 @@
+# How to enable GPU acceleration (experimental)
+
+```{eval-rst}
+.. warning:: GPU support is **experimental and untested**. The options below configure Spark's
+   GPU-aware scheduling and, optionally, the NVIDIA RAPIDS Accelerator, but they have not been
+   validated on a real GPU cluster. Treat the generated settings as a starting point and expect to
+   tune them for your site.
+```
+
+## GPU-aware scheduling
+
+Enable GPU scheduling so Spark workers advertise their GPUs and executors/tasks request them:
+
+```console
+$ sparkctl configure --gpus
+```
+
+sparkctl detects the number of GPUs per node from the compute environment (Slurm GPU variables such
+as `SLURM_GPUS_ON_NODE`, or `nvidia-smi` in a native environment). Override the count when detection
+is unavailable or incorrect:
+
+```console
+$ sparkctl configure --gpus --gpus-per-node 4
+```
+
+This generates a GPU discovery script in the cluster's `conf` directory and writes these settings to
+`spark-defaults.conf`:
+
+- `spark.worker.resource.gpu.amount` and `spark.worker.resource.gpu.discoveryScript`
+- `spark.executor.resource.gpu.amount` and `spark.executor.resource.gpu.discoveryScript`
+- `spark.task.resource.gpu.amount`
+
+By default each executor is assigned one GPU and tasks share that GPU
+(`task.resource.gpu.amount = executor_gpu_amount / executor_cores`). Tune these through your
+settings file:
+
+```toml
+[runtime]
+enable_gpus = true
+gpus_per_node = 4
+executor_gpu_amount = 1
+task_gpu_amount = 0.25
+```
+
+## RAPIDS Accelerator
+
+The [NVIDIA RAPIDS Accelerator for Apache Spark](https://nvidia.github.io/spark-rapids/) offloads
+SQL and DataFrame operations to GPUs.
+
+1. Download the RAPIDS Accelerator jar from the
+   [RAPIDS download page](https://nvidia.github.io/spark-rapids/docs/download.html).
+
+2. Record its path when creating your settings file:
+
+   ```console
+   $ sparkctl default-config --rapids-jar-file /path/to/rapids-4-spark_2.13-<version>.jar \
+       /path/to/spark /path/to/java
+   ```
+
+3. Enable RAPIDS (this implies `--gpus`):
+
+   ```console
+   $ sparkctl configure --rapids
+   ```
+
+This adds the plugin jar with `spark.jars`, sets `spark.plugins com.nvidia.spark.SQLPlugin`, and
+enables `spark.rapids.sql.enabled`.
+
+```{eval-rst}
+.. note:: ``spark.jars`` is used instead of ``spark.{driver,executor}.extraClassPath`` so the
+   RAPIDS jar does not conflict with the classpath entries the PostgreSQL Hive metastore sets.
+```
diff --git a/docs/how_tos/configuration/index.md b/docs/how_tos/configuration/index.md
index 74159a5..21c34c7 100644
--- a/docs/how_tos/configuration/index.md
+++ b/docs/how_tos/configuration/index.md
@@ -9,5 +9,7 @@
     heterogeneous_slurm_jobs
     compute_node_failures
     custom_spark_defaults
+    web_ui_reverse_proxy
+    gpus
     spark_log_level
 ```
diff --git a/docs/how_tos/configuration/web_ui_reverse_proxy.md b/docs/how_tos/configuration/web_ui_reverse_proxy.md
new file mode 100644
index 0000000..d16bf7e
--- /dev/null
+++ b/docs/how_tos/configuration/web_ui_reverse_proxy.md
@@ -0,0 +1,43 @@
+# How to access the Spark web UIs through a reverse proxy
+
+On an HPC cluster the compute nodes that run the Spark workers and your application driver are
+usually not directly reachable from your laptop. That makes the worker and application web UIs,
+whose links point at those nodes, hard to open.
+
+Enabling the reverse proxy tells the Spark master to proxy the worker and application UIs through
+itself, so you only need to reach the master node (for example, through a single SSH tunnel).
+
+## Enable the reverse proxy
+
+```console
+$ sparkctl configure --reverse-proxy
+```
+
+This sets `spark.ui.reverseProxy true`. Open the master web UI (default port 8080) and follow the
+links to the worker and application UIs; they are served through the master.
+
+## Reach the master from your laptop
+
+Forward the master web UI port over SSH, replacing `master-node` with the node running the master
+(typically your submission node):
+
+```console
+$ ssh -L 8080:master-node:8080 <hpc-login-host>
+```
+
+Then browse to `http://localhost:8080`.
+
+## When the master is itself behind another proxy
+
+If you put your own front-end proxy in front of the master, give Spark the externally visible URL
+so it can rewrite links correctly:
+
+```console
+$ sparkctl configure --reverse-proxy --reverse-proxy-url https://my-proxy.example.com/spark
+```
+
+```{eval-rst}
+.. note:: Leave ``--reverse-proxy-url`` unset when you reach the master directly through an SSH
+   tunnel. Spark then serves relative links, which work through the tunnel without extra
+   configuration.
+```
diff --git a/docs/how_tos/execution/index.md b/docs/how_tos/execution/index.md
index 7aad30c..ab4f071 100644
--- a/docs/how_tos/execution/index.md
+++ b/docs/how_tos/execution/index.md
@@ -8,4 +8,5 @@
     start_a_cluster
     run_jobs
     resource_monitoring
+    prometheus_metrics
 ```
diff --git a/docs/how_tos/execution/prometheus_metrics.md b/docs/how_tos/execution/prometheus_metrics.md
new file mode 100644
index 0000000..769a965
--- /dev/null
+++ b/docs/how_tos/execution/prometheus_metrics.md
@@ -0,0 +1,36 @@
+# How to expose Spark metrics in Prometheus format
+
+sparkctl can configure Spark's built-in `PrometheusServlet` so that Spark's internal metrics
+(JVM, scheduler, shuffle, executor, and task metrics) are exposed in Prometheus format. This
+complements [resource monitoring](resource_monitoring.md), which captures host-level CPU, memory,
+disk, and network utilization.
+
+The servlet reuses the existing web UI ports, so no additional ports are opened.
+
+## Enable Prometheus metrics
+
+```console
+$ sparkctl configure --prometheus
+```
+
+This writes a `metrics.properties` file into the cluster's `conf` directory (Spark loads it
+automatically) and sets `spark.ui.prometheus.enabled true`.
+
+## Scrape endpoints
+
+| Component | Endpoint |
+| --------- | -------- |
+| Master | `http://<master>:8080/metrics/master/prometheus` |
+| Worker | `http://<worker>:8081/metrics/prometheus` |
+| Driver / application | `http://<driver>:4040/metrics/executors/prometheus` |
+
+Point a Prometheus scraper at these endpoints, or fetch them directly with `curl` for a quick look:
+
+```console
+$ curl http://localhost:4040/metrics/executors/prometheus
+```
+
+```{eval-rst}
+.. tip:: Combine this with the :doc:`reverse proxy <../configuration/web_ui_reverse_proxy>` to
+   reach the worker and application endpoints through the master node on an HPC cluster.
+```
diff --git a/src/sparkctl/cli/sparkctl.py b/src/sparkctl/cli/sparkctl.py
index 6568c27..2ba6637 100644
--- a/src/sparkctl/cli/sparkctl.py
+++ b/src/sparkctl/cli/sparkctl.py
@@ -104,6 +104,12 @@ def cli(ctx: click.Context, console_level: str, file_level: str, reraise_excepti
     help="Path to PostgreSQL jar file.",
     type=click.Path(path_type=Path),
 )
+@click.option(
+    "-R",
+    "--rapids-jar-file",
+    help=BinaryLocations.model_fields["rapids_jar_file"].description,
+    type=click.Path(path_type=Path),
+)
 def default_config(
     spark_path: Path,
     java_path: Path,
@@ -112,6 +118,7 @@ def default_config(
     hadoop_path: Path | None,
     hive_tarball: Path | None,
     postgresql_jar_file: Path | None,
+    rapids_jar_file: Path | None,
 ):
     """Create a sparkctl config file that defines paths to Spark binaries.
     This is a one-time requirement when installing sparkctl in a new environment."""
@@ -122,6 +129,8 @@ def default_config(
         config.binaries.hive_tarball = hive_tarball
     if postgresql_jar_file is not None:
         config.binaries.postgresql_jar_file = postgresql_jar_file
+    if rapids_jar_file is not None:
+        config.binaries.rapids_jar_file = rapids_jar_file
     data = config.model_dump(mode="json", exclude={"directories"})
     # Don't hard-code the password globally.
     data["runtime"].pop("postgres_password")
@@ -269,6 +278,79 @@ def _create_default_config(
     show_default=True,
     help=SparkRuntimeParams.model_fields["start_thrift_server"].description,
 )
+@click.option(
+    "--jupyter/--no-jupyter",
+    is_flag=True,
+    # Fall back to the model default so options added after a user's settings file was written
+    # still work (a missing key would otherwise bind the default to None).
+    default=sparkctl_settings.runtime.get(
+        "start_jupyter", SparkRuntimeParams.model_fields["start_jupyter"].default
+    ),
+    show_default=True,
+    help=SparkRuntimeParams.model_fields["start_jupyter"].description,
+)
+@click.option(
+    "--jupyter-port",
+    default=sparkctl_settings.runtime.get(
+        "jupyter_port", SparkRuntimeParams.model_fields["jupyter_port"].default
+    ),
+    show_default=True,
+    type=int,
+    help=SparkRuntimeParams.model_fields["jupyter_port"].description,
+)
+@click.option(
+    "--reverse-proxy/--no-reverse-proxy",
+    is_flag=True,
+    default=sparkctl_settings.runtime.get(
+        "enable_reverse_proxy", SparkRuntimeParams.model_fields["enable_reverse_proxy"].default
+    ),
+    show_default=True,
+    help=SparkRuntimeParams.model_fields["enable_reverse_proxy"].description,
+)
+@click.option(
+    "--reverse-proxy-url",
+    default=sparkctl_settings.runtime.get(
+        "reverse_proxy_url", SparkRuntimeParams.model_fields["reverse_proxy_url"].default
+    ),
+    show_default=True,
+    help=SparkRuntimeParams.model_fields["reverse_proxy_url"].description,
+)
+@click.option(
+    "--prometheus/--no-prometheus",
+    is_flag=True,
+    default=sparkctl_settings.runtime.get(
+        "enable_prometheus", SparkRuntimeParams.model_fields["enable_prometheus"].default
+    ),
+    show_default=True,
+    help=SparkRuntimeParams.model_fields["enable_prometheus"].description,
+)
+@click.option(
+    "--gpus/--no-gpus",
+    is_flag=True,
+    default=sparkctl_settings.runtime.get(
+        "enable_gpus", SparkRuntimeParams.model_fields["enable_gpus"].default
+    ),
+    show_default=True,
+    help=SparkRuntimeParams.model_fields["enable_gpus"].description,
+)
+@click.option(
+    "--gpus-per-node",
+    default=sparkctl_settings.runtime.get(
+        "gpus_per_node", SparkRuntimeParams.model_fields["gpus_per_node"].default
+    ),
+    show_default=True,
+    type=int,
+    help=SparkRuntimeParams.model_fields["gpus_per_node"].description,
+)
+@click.option(
+    "--rapids/--no-rapids",
+    is_flag=True,
+    default=sparkctl_settings.runtime.get(
+        "enable_rapids", SparkRuntimeParams.model_fields["enable_rapids"].default
+    ),
+    show_default=True,
+    help=SparkRuntimeParams.model_fields["enable_rapids"].description,
+)
 @click.option(
     "-l",
     "--spark-log-level",
@@ -344,6 +426,14 @@ def configure(
     connect_server_port: int,
     history_server: bool,
     thrift_server: bool,
+    jupyter: bool,
+    jupyter_port: int,
+    reverse_proxy: bool,
+    reverse_proxy_url: str | None,
+    prometheus: bool,
+    gpus: bool,
+    gpus_per_node: int | None,
+    rapids: bool,
     spark_log_level: str | None,
     hive_metastore: bool,
     postgres_hive_metastore: bool,
@@ -381,6 +471,14 @@ def build_config() -> SparkConfig:
                 connect_server_port=connect_server_port,
                 start_history_server=history_server,
                 start_thrift_server=thrift_server,
+                start_jupyter=jupyter,
+                jupyter_port=jupyter_port,
+                enable_reverse_proxy=reverse_proxy,
+                reverse_proxy_url=reverse_proxy_url,
+                enable_prometheus=prometheus,
+                enable_gpus=gpus,
+                gpus_per_node=gpus_per_node,
+                enable_rapids=rapids,
                 spark_log_level=spark_log_level,
                 enable_hive_metastore=hive_metastore,
                 enable_postgres_hive_metastore=postgres_hive_metastore,
diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index 4daa92f..79ef0eb 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -2,6 +2,7 @@
 import os
 import re
 import shutil
+import stat
 import subprocess
 import sys
 from contextlib import contextmanager
@@ -123,6 +124,8 @@ def clean(self) -> None:
             base / self.STATUS_FILENAME,
             base / "srun_workers.pid",
             base / "srun_workers.log",
+            base / "jupyter.pid",
+            base / "jupyter.log",
         ]
         for directory in directories:
             if directory.exists():
@@ -235,22 +238,7 @@ def start(self, print_env_paths: bool = True) -> None:
             self._start(runner, tracker)
         except Exception:
             logger.error("Stopping all processes after unhandled exception")
-            if tracker.started_master:
-                runner.stop_master_process()
-            if tracker.started_connect_server:
-                runner.stop_connect_server()
-            if tracker.started_history_server:
-                runner.stop_history_server()
-            if tracker.started_thrift_server:
-                runner.stop_thrift_server()
-            if tracker.started_workers:
-                workers = self._read_workers()
-                if len(workers) == 1:
-                    runner.stop_worker_process()
-                else:
-                    runner.stop_worker_processes(workers)
-            if tracker.started_postgres:
-                self._stop_postgres()
+            self._rollback_started_processes(runner, tracker)
             raise
 
         if print_env_paths:
@@ -264,6 +252,29 @@ def start(self, print_env_paths: bool = True) -> None:
         os.environ["SPARK_CONF_DIR"] = str(self._config.directories.get_spark_conf_dir())
         os.environ["JAVA_HOME"] = str(self._config.binaries.java_path)
 
+    def _rollback_started_processes(
+        self, runner: SparkProcessRunner, tracker: StatusTracker
+    ) -> None:
+        """Stop any processes that were started before an unhandled exception."""
+        if tracker.started_master:
+            runner.stop_master_process()
+        if tracker.started_connect_server:
+            runner.stop_connect_server()
+        if tracker.started_history_server:
+            runner.stop_history_server()
+        if tracker.started_thrift_server:
+            runner.stop_thrift_server()
+        if tracker.started_jupyter:
+            runner.stop_jupyter_server()
+        if tracker.started_workers:
+            workers = self._read_workers()
+            if len(workers) == 1:
+                runner.stop_worker_process()
+            else:
+                runner.stop_worker_processes(workers)
+        if tracker.started_postgres:
+            self._stop_postgres()
+
     @contextmanager
     def managed_cluster(self) -> Generator[SparkSession, None, None]:
         """Configure and start the Spark cluster, yield a SparkSession in a context manager,
@@ -321,6 +332,11 @@ def _start(self, runner: SparkProcessRunner, tracker: StatusTracker) -> None:
             tracker.started_thrift_server = True
             logger.info("Started Apache Thrift Server")
 
+        if self._config.runtime.start_jupyter:
+            runner.start_jupyter_server()
+            tracker.started_jupyter = True
+            logger.info("Started JupyterLab server")
+
         worker_memory_gb = self._get_worker_memory_gb(self._get_runtime_spark_driver_memory_gb())
         if is_single_node_cluster:
             runner.start_worker_process(worker_memory_gb)
@@ -362,6 +378,7 @@ def stop(self) -> None:
                 started_connect_server=rt.start_connect_server,
                 started_history_server=self._is_history_server_enabled(),
                 started_thrift_server=rt.start_thrift_server,
+                started_jupyter=rt.start_jupyter,
                 started_postgres=rt.enable_postgres_hive_metastore,
             )
         url = make_spark_url(gethostname())
@@ -374,6 +391,8 @@ def stop(self) -> None:
             runner.stop_history_server()
         if tracker.started_thrift_server:
             runner.stop_thrift_server()
+        if tracker.started_jupyter:
+            runner.stop_jupyter_server()
         if tracker.started_workers:
             workers = self._intf.get_worker_node_names()
             is_single_node_cluster = self._is_single_node_cluster(workers)
@@ -440,6 +459,18 @@ def _add_spark_settings_to_defaults_file(self, defaults_file: Path) -> None:
         if rt_params.start_history_server:
             self._enable_history_server(defaults_file)
 
+        if rt_params.enable_reverse_proxy:
+            self._enable_reverse_proxy(defaults_file)
+
+        if rt_params.enable_prometheus:
+            self._enable_prometheus(defaults_file)
+
+        # RAPIDS requires GPU scheduling, so enabling it implies enabling GPUs.
+        if rt_params.enable_gpus or rt_params.enable_rapids:
+            self._enable_gpus(defaults_file)
+        if rt_params.enable_rapids:
+            self._enable_rapids(defaults_file)
+
         if rt_params.enable_hive_metastore or rt_params.enable_postgres_hive_metastore:
             self._enable_metastore(defaults_file)
             if not rt_params.enable_dynamic_allocation:
@@ -565,6 +596,126 @@ def _enable_history_server(self, defaults_file: Path) -> None:
             )
         logger.info("Enabled Spark history server at {}", events_dir)
 
+    def _enable_reverse_proxy(self, defaults_file: Path) -> None:
+        with open(defaults_file, "a") as f_out:
+            f_out.write("\nspark.ui.reverseProxy true\n")
+            url = self._config.runtime.reverse_proxy_url
+            if url is not None:
+                f_out.write(f"spark.ui.reverseProxyUrl {url}\n")
+        logger.info(
+            "Enabled the Spark master reverse proxy for worker and application UIs. "
+            "Access all UIs through the master web UI (default port 8080)."
+        )
+
+    def _enable_prometheus(self, defaults_file: Path) -> None:
+        metrics_file = self._config.directories.get_metrics_properties_file()
+        # Spark automatically loads $SPARK_CONF_DIR/metrics.properties, so writing it into the conf
+        # directory is enough to register the Prometheus sink on every component.
+        metrics_file.write_text(
+            """# Generated by sparkctl. Exposes Spark metrics in Prometheus format on the existing
+# web UI ports (no additional ports are opened).
+*.sink.prometheusServlet.class=org.apache.spark.metrics.sink.PrometheusServlet
+*.sink.prometheusServlet.path=/metrics/prometheus
+master.sink.prometheusServlet.path=/metrics/master/prometheus
+applications.sink.prometheusServlet.path=/metrics/applications/prometheus
+""",
+            encoding="utf-8",
+        )
+        with open(defaults_file, "a") as f_out:
+            f_out.write(
+                """
+spark.ui.prometheus.enabled true
+spark.executor.processTreeMetrics.enabled true
+"""
+            )
+        logger.info(
+            "Enabled Prometheus metrics. Scrape /metrics/prometheus on the master/worker UIs and "
+            "/metrics/executors/prometheus on the driver UI (port 4040)."
+        )
+
+    def _enable_gpus(self, defaults_file: Path) -> None:
+        rt_params = self._config.runtime
+        num_gpus = rt_params.gpus_per_node
+        if num_gpus is None:
+            num_gpus = self._intf.get_worker_num_gpus()
+        if num_gpus <= 0:
+            msg = (
+                "GPU scheduling was enabled but no GPUs were detected on the worker nodes. "
+                "Set runtime.gpus_per_node explicitly or request GPUs in the allocation."
+            )
+            raise InvalidConfiguration(msg)
+
+        discovery_script = self._write_gpu_discovery_script()
+        executor_gpu_amount = rt_params.executor_gpu_amount
+        if executor_gpu_amount > num_gpus:
+            msg = (
+                f"executor_gpu_amount ({executor_gpu_amount}) cannot exceed the number of GPUs "
+                f"per node ({num_gpus})."
+            )
+            raise InvalidConfiguration(msg)
+        if rt_params.task_gpu_amount is not None:
+            task_gpu_amount = rt_params.task_gpu_amount
+        else:
+            # Let the cores in an executor share that executor's GPU(s) by default.
+            task_gpu_amount = executor_gpu_amount / rt_params.executor_cores
+        with open(defaults_file, "a") as f_out:
+            f_out.write(
+                f"""
+spark.worker.resource.gpu.amount {num_gpus}
+spark.worker.resource.gpu.discoveryScript {discovery_script}
+spark.executor.resource.gpu.amount {executor_gpu_amount}
+spark.executor.resource.gpu.discoveryScript {discovery_script}
+spark.task.resource.gpu.amount {task_gpu_amount}
+"""
+            )
+        logger.warning(
+            "Enabled EXPERIMENTAL (untested) GPU scheduling with {} GPU(s) per node.", num_gpus
+        )
+
+    def _write_gpu_discovery_script(self) -> Path:
+        script = self._config.directories.get_gpu_discovery_script_file()
+        # Spark calls this script on each worker and expects JSON describing the available GPU
+        # addresses. This mirrors Spark's example getGpusResources.sh.
+        script.write_text(
+            """#!/usr/bin/env bash
+# Generated by sparkctl. Reports the GPUs visible to Spark in the format it expects.
+ADDRS=$(nvidia-smi --query-gpu=index --format=csv,noheader | sed -e ':a' -e 'N' -e '$!ba' \\
+    -e 's/\\n/","/g')
+echo "{\\"name\\": \\"gpu\\", \\"addresses\\": [\\"$ADDRS\\"]}"
+""",
+            encoding="utf-8",
+        )
+        script.chmod(script.stat().st_mode | stat.S_IXUSR | stat.S_IXGRP)
+        return script
+
+    def _enable_rapids(self, defaults_file: Path) -> None:
+        rapids_jar = self._config.binaries.rapids_jar_file
+        if rapids_jar is None:
+            msg = (
+                "RAPIDS acceleration was enabled but binaries.rapids_jar_file is not set. "
+                "Download the RAPIDS Accelerator jar and set its path "
+                "(see https://nvidia.github.io/spark-rapids/docs/download.html)."
+            )
+            raise InvalidConfiguration(msg)
+        if not Path(rapids_jar).exists():
+            msg = f"The RAPIDS jar file does not exist: {rapids_jar}"
+            raise InvalidConfiguration(msg)
+        with open(defaults_file, "a") as f_out:
+            # Distribute the plugin jar to executors and add it to the driver/executor classpath.
+            # Using spark.jars avoids clobbering spark.{driver,executor}.extraClassPath, which the
+            # Postgres metastore may also set.
+            f_out.write(
+                f"""
+spark.jars {rapids_jar}
+spark.plugins com.nvidia.spark.SQLPlugin
+spark.rapids.sql.enabled true
+spark.rapids.sql.concurrentGpuTasks 1
+"""
+            )
+        logger.warning(
+            "Enabled EXPERIMENTAL (untested) RAPIDS GPU acceleration using {}", rapids_jar
+        )
+
     def _get_runtime_spark_driver_memory_gb(self) -> int:
         # Note that spark-defaults.conf takes precedence over our config.json.
         regex = re.compile(r"^\s*spark.driver.memory\s*=?\s*(\d+)g")
diff --git a/src/sparkctl/compute_interface.py b/src/sparkctl/compute_interface.py
index a40ca9e..c5c0197 100644
--- a/src/sparkctl/compute_interface.py
+++ b/src/sparkctl/compute_interface.py
@@ -40,6 +40,10 @@ def get_worker_memory_gb(self) -> int:
     def get_worker_num_cpus(self) -> int:
         """Return the number of CPUs in the compute node"""
 
+    @abc.abstractmethod
+    def get_worker_num_gpus(self) -> int:
+        """Return the number of GPUs in the compute node. Returns 0 if none are detected."""
+
     @abc.abstractmethod
     def is_heterogeneous_slurm_job(self) -> bool:
         """Return True if the environment indicates a heterogeneous Slurm job."""
diff --git a/src/sparkctl/fake_compute.py b/src/sparkctl/fake_compute.py
index 9f06cda..1465c6e 100644
--- a/src/sparkctl/fake_compute.py
+++ b/src/sparkctl/fake_compute.py
@@ -35,6 +35,9 @@ def get_worker_memory_gb(self) -> int:
     def get_worker_num_cpus(self) -> int:
         return 12
 
+    def get_worker_num_gpus(self) -> int:
+        return 0
+
     def is_heterogeneous_slurm_job(self) -> bool:
         return False
 
diff --git a/src/sparkctl/models.py b/src/sparkctl/models.py
index cec29c1..bf76289 100644
--- a/src/sparkctl/models.py
+++ b/src/sparkctl/models.py
@@ -39,9 +39,19 @@ class BinaryLocations(SparkctlBaseModel):
     postgresql_jar_file: Path | None = Field(
         default=None, description="Path to the PostgreSQL jar file."
     )
+    rapids_jar_file: Path | None = Field(
+        default=None,
+        description="Path to the NVIDIA RAPIDS Accelerator for Apache Spark jar file. Only "
+        "required to enable RAPIDS GPU acceleration (experimental).",
+    )
 
     @field_validator(
-        "spark_path", "java_path", "hadoop_path", "hive_tarball", "postgresql_jar_file"
+        "spark_path",
+        "java_path",
+        "hadoop_path",
+        "hive_tarball",
+        "postgresql_jar_file",
+        "rapids_jar_file",
     )
     @classmethod
     def make_absolute(cls, val: Path | None) -> Path | None:
@@ -91,6 +101,57 @@ class SparkRuntimeParams(SparkctlBaseModel):
         default=False,
         description="Enable the Thrift server to connect a SQL client.",
     )
+    start_jupyter: bool = Field(
+        default=False,
+        description="Start a JupyterLab server on the master node. Pre-wired to the Spark Connect "
+        "server when it is enabled (the notebook's SparkSession connects automatically).",
+    )
+    jupyter_port: int = Field(
+        default=8889,
+        description="Port on which the JupyterLab server listens.",
+    )
+    enable_reverse_proxy: bool = Field(
+        default=False,
+        description="Run the Spark master as a reverse proxy for the worker and application web "
+        "UIs. Useful on HPC clusters where the compute nodes are not directly reachable, so the "
+        "UIs are served through the master node only.",
+    )
+    reverse_proxy_url: str | None = Field(
+        default=None,
+        description="External URL used to reach the Spark master UI when reverse proxy is enabled "
+        "and the master is itself behind another front-end proxy. Leave unset to serve relative "
+        "links (recommended when reaching the master through an SSH tunnel).",
+    )
+    enable_prometheus: bool = Field(
+        default=False,
+        description="Expose Spark metrics in Prometheus format through the existing web UI ports "
+        "(no extra ports are opened).",
+    )
+    enable_gpus: bool = Field(
+        default=False,
+        description="EXPERIMENTAL (untested): Enable GPU-aware scheduling. Spark workers advertise "
+        "GPUs and executors/tasks request them. Requires GPUs on the worker nodes.",
+    )
+    gpus_per_node: int | None = Field(
+        default=None,
+        description="EXPERIMENTAL (untested): Number of GPUs available on each worker node. "
+        "Auto-detected from the compute environment by default.",
+    )
+    executor_gpu_amount: int = Field(
+        default=1,
+        description="EXPERIMENTAL (untested): Number of GPUs assigned to each executor.",
+    )
+    task_gpu_amount: float | None = Field(
+        default=None,
+        description="EXPERIMENTAL (untested): GPUs assigned to each task. Defaults to "
+        "executor_gpu_amount / executor_cores so that concurrent tasks share an executor's GPUs.",
+    )
+    enable_rapids: bool = Field(
+        default=False,
+        description="EXPERIMENTAL (untested): Enable the NVIDIA RAPIDS Accelerator for Apache "
+        "Spark to offload SQL/DataFrame operations to GPUs. Implies enable_gpus and requires "
+        "binaries.rapids_jar_file.",
+    )
     spark_log_level: str | None = Field(
         default=None,
         description="Set the root log level for all Spark processes. Defaults to Spark's defaults.",
@@ -181,6 +242,14 @@ def get_spark_log_file(self) -> Path:
         """Return the file path to log properties file"""
         return self.get_spark_conf_dir() / "log4j2.properties"
 
+    def get_metrics_properties_file(self) -> Path:
+        """Return the file path to metrics.properties"""
+        return self.get_spark_conf_dir() / "metrics.properties"
+
+    def get_gpu_discovery_script_file(self) -> Path:
+        """Return the file path to the GPU discovery script."""
+        return self.get_spark_conf_dir() / "get_gpus_resources.sh"
+
     def get_workers_file(self) -> Path:
         """Return the file path to workers"""
         return self.get_spark_conf_dir() / "workers"
@@ -297,4 +366,5 @@ class StatusTracker(SparkctlBaseModel):
     started_connect_server: bool = False
     started_history_server: bool = False
     started_thrift_server: bool = False
+    started_jupyter: bool = False
     started_postgres: bool = False
diff --git a/src/sparkctl/native_compute.py b/src/sparkctl/native_compute.py
index 87df11f..0c59ccf 100644
--- a/src/sparkctl/native_compute.py
+++ b/src/sparkctl/native_compute.py
@@ -1,4 +1,6 @@
 import multiprocessing
+import shutil
+import subprocess
 import tempfile
 from pathlib import Path
 from socket import gethostname
@@ -37,6 +39,23 @@ def get_worker_memory_gb(self) -> int:
     def get_worker_num_cpus(self) -> int:
         return multiprocessing.cpu_count()
 
+    def get_worker_num_gpus(self) -> int:
+        # Best-effort detection via nvidia-smi. Returns 0 when it is unavailable or fails so that
+        # GPU support stays opt-in and never blocks a normal CPU-only run.
+        nvidia_smi = shutil.which("nvidia-smi")
+        if nvidia_smi is None:
+            return 0
+        try:
+            proc = subprocess.run(
+                [nvidia_smi, "--query-gpu=name", "--format=csv,noheader"],
+                capture_output=True,
+                check=True,
+                text=True,
+            )
+        except (subprocess.CalledProcessError, OSError):
+            return 0
+        return len([x for x in proc.stdout.splitlines() if x.strip()])
+
     def is_heterogeneous_slurm_job(self) -> bool:
         return False
 
diff --git a/src/sparkctl/slurm_compute.py b/src/sparkctl/slurm_compute.py
index ffda70d..9dc877a 100644
--- a/src/sparkctl/slurm_compute.py
+++ b/src/sparkctl/slurm_compute.py
@@ -77,6 +77,30 @@ def get_worker_num_cpus(self) -> int:
 
         return int(num_cpus)
 
+    def get_worker_num_gpus(self) -> int:
+        # Slurm exposes the per-node GPU count in several variables depending on how the job
+        # requested GPUs. Check them in order of specificity, then fall back to the visible-device
+        # list. Return 0 when none indicate GPUs so that GPU support stays opt-in.
+        het = self.is_heterogeneous_slurm_job()
+        candidates = []
+        if het:
+            candidates.append(os.getenv("SLURM_GPUS_PER_NODE_HET_GROUP_1"))
+        candidates.extend(
+            (
+                os.getenv("SLURM_GPUS_ON_NODE"),
+                os.getenv("SLURM_GPUS_PER_NODE"),
+            )
+        )
+        for value in candidates:
+            num_gpus = _parse_slurm_gpu_count(value)
+            if num_gpus is not None:
+                return num_gpus
+
+        visible = os.getenv("CUDA_VISIBLE_DEVICES")
+        if visible:
+            return len([x for x in visible.split(",") if x.strip()])
+        return 0
+
     def is_heterogeneous_slurm_job(self) -> bool:
         return "SLURM_HET_SIZE" in os.environ
 
@@ -103,6 +127,20 @@ def run_checks(self) -> None:
                 raise ValueError(msg)
 
 
+def _parse_slurm_gpu_count(value: str | None) -> int | None:
+    """Parse a Slurm GPU count variable. Returns None when the value is unset or unparseable.
+
+    Slurm reports these in a few formats, e.g. "4", "gpu:4", or "gpu:a100:4".
+    """
+    if not value:
+        return None
+    # The count is the trailing integer, optionally preceded by "<type>:" fields.
+    match = re.search(r"(\d+)\s*$", value.split("(")[0])
+    if match is None:
+        return None
+    return int(match.group(1))
+
+
 def get_node_names(job_id: str) -> list[str]:
     # The squeue command will produce multiple lines if the job is heterogeneous.
     proc = subprocess.run(
diff --git a/src/sparkctl/spark_process_runner.py b/src/sparkctl/spark_process_runner.py
index 9d061e8..1bcb7d9 100644
--- a/src/sparkctl/spark_process_runner.py
+++ b/src/sparkctl/spark_process_runner.py
@@ -63,6 +63,84 @@ def stop_thrift_server(self) -> int:
         """Stop the Apache Thrift server."""
         return self._run_command(self._stop_thrift_server_cmd())
 
+    def start_jupyter_server(self) -> None:
+        """Start a JupyterLab server on the local node."""
+        jupyter = shutil.which("jupyter")
+        if jupyter is None:
+            msg = (
+                "jupyter is not installed in the current environment. Install it with "
+                "`pip install jupyterlab` (or `uv pip install jupyterlab`)."
+            )
+            raise ExecutionError(msg)
+
+        port = self._config.runtime.jupyter_port
+        log_file = self._get_jupyter_log_file()
+        pid_file = self._get_jupyter_pid_file()
+        env = self._get_env()
+        if self._config.runtime.start_connect_server:
+            # Pre-wire notebooks to the Connect server so SparkSession.builder.getOrCreate()
+            # connects to the running cluster without any extra configuration.
+            env["SPARK_REMOTE"] = f"sc://localhost:{self._config.runtime.connect_server_port}"
+        cmd = [
+            jupyter,
+            "lab",
+            "--no-browser",
+            f"--port={port}",
+            "--ip=0.0.0.0",
+            f"--notebook-dir={self._config.directories.base}",
+        ]
+        logger.info("Start JupyterLab server: {}", " ".join(cmd))
+        with open(log_file, "w", encoding="utf-8") as f_out:
+            proc = subprocess.Popen(
+                cmd,
+                stdin=subprocess.DEVNULL,
+                stdout=f_out,
+                stderr=subprocess.STDOUT,
+                start_new_session=True,
+                env=env,
+            )
+        time.sleep(1)
+        ret = proc.poll()
+        if ret is not None:
+            msg = (
+                f"The JupyterLab server exited immediately with return code {ret}. See {log_file}."
+            )
+            raise ExecutionError(msg)
+        pid_file.write_text(f"{proc.pid}\n", encoding="utf-8")
+        logger.info(
+            "Started JupyterLab server with pid {} on port {}. The access URL (with token) is in "
+            "{}.",
+            proc.pid,
+            port,
+            log_file,
+        )
+
+    def stop_jupyter_server(self) -> int:
+        """Stop the JupyterLab server."""
+        pid_file = self._get_jupyter_pid_file()
+        if not pid_file.exists():
+            logger.error("Cannot stop JupyterLab server: {} does not exist", pid_file)
+            return 1
+        pid = int(pid_file.read_text(encoding="utf-8").strip())
+        try:
+            os.kill(pid, signal.SIGTERM)
+        except ProcessLookupError:
+            logger.info("The JupyterLab server has already exited")
+            pid_file.unlink()
+            return 0
+        if self._wait_for_process_exit(pid, timeout_s=30):
+            logger.info("Stopped the JupyterLab server")
+            pid_file.unlink()
+            return 0
+        logger.error("The JupyterLab server process {} did not exit within the timeout", pid)
+        return 1
+
+    def _get_jupyter_pid_file(self) -> Path:
+        return self._config.directories.base / "jupyter.pid"
+
+    def _get_jupyter_log_file(self) -> Path:
+        return self._config.directories.base / "jupyter.log"
+
     def start_worker_process(self, memory_gb: int) -> None:
         """Start one Spark worker process."""
         tmp_script = self._make_start_worker_script(self._start_worker_cmd(), memory_gb)
diff --git a/tests/test_cluster_manager.py b/tests/test_cluster_manager.py
index 2e0b3d1..0c48658 100644
--- a/tests/test_cluster_manager.py
+++ b/tests/test_cluster_manager.py
@@ -9,6 +9,7 @@
     ClusterManager,
     SparkConfig,
 )
+from sparkctl.exceptions import InvalidConfiguration
 
 
 def test_cluster_manager_workers(setup_local_env: tuple[SparkConfig, Path]):
@@ -22,6 +23,58 @@ def test_cluster_manager_workers(setup_local_env: tuple[SparkConfig, Path]):
     assert mgr.get_workers() == new_workers
 
 
+def test_configure_reverse_proxy_and_prometheus(setup_local_env: tuple[SparkConfig, Path]):
+    config, tmp_path = setup_local_env
+    config.directories.spark_scratch = tmp_path / "spark_scratch"
+    config.runtime.enable_reverse_proxy = True
+    config.runtime.reverse_proxy_url = "http://login01:8080"
+    config.runtime.enable_prometheus = True
+    mgr = ClusterManager.from_config(config)
+    mgr.configure()
+    defaults = config.directories.get_spark_defaults_file().read_text(encoding="utf-8")
+    assert "spark.ui.reverseProxy true" in defaults
+    assert "spark.ui.reverseProxyUrl http://login01:8080" in defaults
+    assert "spark.ui.prometheus.enabled true" in defaults
+    metrics = config.directories.get_metrics_properties_file().read_text(encoding="utf-8")
+    assert "PrometheusServlet" in metrics
+
+
+def test_configure_gpus_without_detection_fails(setup_local_env: tuple[SparkConfig, Path]):
+    config, tmp_path = setup_local_env
+    config.directories.spark_scratch = tmp_path / "spark_scratch"
+    # FakeCompute reports zero GPUs and no override is set.
+    config.runtime.enable_gpus = True
+    mgr = ClusterManager.from_config(config)
+    with pytest.raises(InvalidConfiguration):
+        mgr.configure()
+
+
+def test_configure_gpus_with_override(setup_local_env: tuple[SparkConfig, Path]):
+    config, tmp_path = setup_local_env
+    config.directories.spark_scratch = tmp_path / "spark_scratch"
+    config.runtime.enable_gpus = True
+    config.runtime.gpus_per_node = 4
+    mgr = ClusterManager.from_config(config)
+    mgr.configure()
+    defaults = config.directories.get_spark_defaults_file().read_text(encoding="utf-8")
+    assert "spark.worker.resource.gpu.amount 4" in defaults
+    assert "spark.executor.resource.gpu.discoveryScript" in defaults
+    discovery_script = config.directories.get_gpu_discovery_script_file()
+    assert discovery_script.exists()
+    assert discovery_script.stat().st_mode & 0o100  # owner-executable
+
+
+def test_configure_rapids_without_jar_fails(setup_local_env: tuple[SparkConfig, Path]):
+    config, tmp_path = setup_local_env
+    config.directories.spark_scratch = tmp_path / "spark_scratch"
+    config.runtime.gpus_per_node = 2
+    config.runtime.enable_rapids = True
+    config.binaries.rapids_jar_file = None
+    mgr = ClusterManager.from_config(config)
+    with pytest.raises(InvalidConfiguration):
+        mgr.configure()
+
+
 @pytest.mark.integration
 def test_managed_start(setup_local_env: tuple[SparkConfig, Path]):
     config, output_dir = setup_local_env
diff --git a/tests/test_sparkctl_cli.py b/tests/test_sparkctl_cli.py
index 388bdc4..db487e5 100644
--- a/tests/test_sparkctl_cli.py
+++ b/tests/test_sparkctl_cli.py
@@ -88,6 +88,33 @@ def test_configure_start_stop(setup_local_env):
     assert result.exit_code == 0
 
 
+def test_configure_new_feature_flags(setup_local_env):
+    config, tmp_path = setup_local_env
+    cmd = [
+        "configure",
+        "--directory",
+        str(tmp_path),
+        "--spark-scratch",
+        str(tmp_path / "spark_scratch"),
+        "--reverse-proxy",
+        "--prometheus",
+        "--jupyter",
+        "--jupyter-port",
+        "9999",
+        "--gpus-per-node",
+        "8",
+    ]
+    runner = CliRunner()
+    result = runner.invoke(cli, cmd)
+    assert result.exit_code == 0
+    data = json.loads((tmp_path / "config.json").read_text(encoding="utf-8"))
+    assert data["runtime"]["enable_reverse_proxy"]
+    assert data["runtime"]["enable_prometheus"]
+    assert data["runtime"]["start_jupyter"]
+    assert data["runtime"]["jupyter_port"] == 9999
+    assert data["runtime"]["gpus_per_node"] == 8
+
+
 def test_invalid_executor_memory(setup_local_env):
     _, tmp_path = setup_local_env
     cmd = [

From 7c5ea5a693504f4e21f9bf9f4b3306ef2aa259e1 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 09:50:54 -0600
Subject: [PATCH 06/24] Add CSV metrics sink option

Add --metrics-csv (and --metrics-csv-period) to write Spark metrics to CSV
files in <base>/metrics-csv, leaving a durable on-disk record after an
ephemeral cluster shuts down (the Prometheus sink only exposes metrics over
HTTP).

Refactor the Prometheus setup into _configure_metrics so the Prometheus and
CSV sinks compose into a single metrics.properties when both are enabled.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/execution/prometheus_metrics.md | 24 ++++++++
 src/sparkctl/cli/sparkctl.py                 | 22 +++++++
 src/sparkctl/cluster_manager.py              | 63 +++++++++++++-------
 src/sparkctl/models.py                       |  9 +++
 tests/test_cluster_manager.py                | 31 ++++++++++
 5 files changed, 128 insertions(+), 21 deletions(-)

diff --git a/docs/how_tos/execution/prometheus_metrics.md b/docs/how_tos/execution/prometheus_metrics.md
index 769a965..ec9e76c 100644
--- a/docs/how_tos/execution/prometheus_metrics.md
+++ b/docs/how_tos/execution/prometheus_metrics.md
@@ -34,3 +34,27 @@ $ curl http://localhost:4040/metrics/executors/prometheus
 .. tip:: Combine this with the :doc:`reverse proxy <../configuration/web_ui_reverse_proxy>` to
    reach the worker and application endpoints through the master node on an HPC cluster.
 ```
+
+## Write metrics to CSV files
+
+The Prometheus sink is pull-based: it only exposes metrics over HTTP and keeps nothing on disk, so
+the data is gone once the cluster shuts down. To keep a durable record, enable the CSV sink, which
+periodically writes one CSV file per metric:
+
+```console
+$ sparkctl configure --metrics-csv
+```
+
+This writes the metrics to `<base>/metrics-csv` (alongside `stats-output`) and survives cluster
+teardown, which fits the ephemeral-allocation model better than relying on a live Prometheus
+scraper. Change the sampling interval with `--metrics-csv-period` (seconds):
+
+```console
+$ sparkctl configure --metrics-csv --metrics-csv-period 30
+```
+
+The two sinks are independent and can be combined; they share a single `metrics.properties`:
+
+```console
+$ sparkctl configure --prometheus --metrics-csv
+```
diff --git a/src/sparkctl/cli/sparkctl.py b/src/sparkctl/cli/sparkctl.py
index 2ba6637..8bbc054 100644
--- a/src/sparkctl/cli/sparkctl.py
+++ b/src/sparkctl/cli/sparkctl.py
@@ -324,6 +324,24 @@ def _create_default_config(
     show_default=True,
     help=SparkRuntimeParams.model_fields["enable_prometheus"].description,
 )
+@click.option(
+    "--metrics-csv/--no-metrics-csv",
+    is_flag=True,
+    default=sparkctl_settings.runtime.get(
+        "enable_metrics_csv", SparkRuntimeParams.model_fields["enable_metrics_csv"].default
+    ),
+    show_default=True,
+    help=SparkRuntimeParams.model_fields["enable_metrics_csv"].description,
+)
+@click.option(
+    "--metrics-csv-period",
+    default=sparkctl_settings.runtime.get(
+        "metrics_csv_period", SparkRuntimeParams.model_fields["metrics_csv_period"].default
+    ),
+    show_default=True,
+    type=int,
+    help=SparkRuntimeParams.model_fields["metrics_csv_period"].description,
+)
 @click.option(
     "--gpus/--no-gpus",
     is_flag=True,
@@ -431,6 +449,8 @@ def configure(
     reverse_proxy: bool,
     reverse_proxy_url: str | None,
     prometheus: bool,
+    metrics_csv: bool,
+    metrics_csv_period: int,
     gpus: bool,
     gpus_per_node: int | None,
     rapids: bool,
@@ -476,6 +496,8 @@ def build_config() -> SparkConfig:
                 enable_reverse_proxy=reverse_proxy,
                 reverse_proxy_url=reverse_proxy_url,
                 enable_prometheus=prometheus,
+                enable_metrics_csv=metrics_csv,
+                metrics_csv_period=metrics_csv_period,
                 enable_gpus=gpus,
                 gpus_per_node=gpus_per_node,
                 enable_rapids=rapids,
diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index 79ef0eb..cbe4ae5 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -116,6 +116,7 @@ def clean(self) -> None:
             self._config.directories.get_spark_conf_dir(),
             self._config.directories.spark_scratch.absolute(),
             base / "stats-output",
+            base / "metrics-csv",
             base / "pg_data",
             base / "pg_run",
         ]
@@ -462,8 +463,8 @@ def _add_spark_settings_to_defaults_file(self, defaults_file: Path) -> None:
         if rt_params.enable_reverse_proxy:
             self._enable_reverse_proxy(defaults_file)
 
-        if rt_params.enable_prometheus:
-            self._enable_prometheus(defaults_file)
+        if rt_params.enable_prometheus or rt_params.enable_metrics_csv:
+            self._configure_metrics(defaults_file)
 
         # RAPIDS requires GPU scheduling, so enabling it implies enabling GPUs.
         if rt_params.enable_gpus or rt_params.enable_rapids:
@@ -607,31 +608,51 @@ def _enable_reverse_proxy(self, defaults_file: Path) -> None:
             "Access all UIs through the master web UI (default port 8080)."
         )
 
-    def _enable_prometheus(self, defaults_file: Path) -> None:
-        metrics_file = self._config.directories.get_metrics_properties_file()
-        # Spark automatically loads $SPARK_CONF_DIR/metrics.properties, so writing it into the conf
-        # directory is enough to register the Prometheus sink on every component.
-        metrics_file.write_text(
-            """# Generated by sparkctl. Exposes Spark metrics in Prometheus format on the existing
-# web UI ports (no additional ports are opened).
+    def _configure_metrics(self, defaults_file: Path) -> None:
+        # The Prometheus and CSV sinks share a single metrics.properties, so build the file from
+        # whichever sinks are enabled. Spark automatically loads $SPARK_CONF_DIR/metrics.properties.
+        rt_params = self._config.runtime
+        sinks: list[str] = []
+        if rt_params.enable_prometheus:
+            sinks.append(
+                """# Expose metrics in Prometheus format on the existing web UI ports.
 *.sink.prometheusServlet.class=org.apache.spark.metrics.sink.PrometheusServlet
 *.sink.prometheusServlet.path=/metrics/prometheus
 master.sink.prometheusServlet.path=/metrics/master/prometheus
 applications.sink.prometheusServlet.path=/metrics/applications/prometheus
-""",
-            encoding="utf-8",
-        )
-        with open(defaults_file, "a") as f_out:
-            f_out.write(
-                """
-spark.ui.prometheus.enabled true
-spark.executor.processTreeMetrics.enabled true
 """
             )
-        logger.info(
-            "Enabled Prometheus metrics. Scrape /metrics/prometheus on the master/worker UIs and "
-            "/metrics/executors/prometheus on the driver UI (port 4040)."
-        )
+        csv_dir = self._config.directories.base / "metrics-csv"
+        if rt_params.enable_metrics_csv:
+            csv_dir.mkdir(exist_ok=True)
+            sinks.append(
+                f"""# Write metrics to CSV files, one per metric, for a durable on-disk record.
+*.sink.csv.class=org.apache.spark.metrics.sink.CsvSink
+*.sink.csv.directory={csv_dir}
+*.sink.csv.period={rt_params.metrics_csv_period}
+*.sink.csv.unit=seconds
+"""
+            )
+
+        metrics_file = self._config.directories.get_metrics_properties_file()
+        metrics_file.write_text("# Generated by sparkctl.\n" + "\n".join(sinks), encoding="utf-8")
+
+        with open(defaults_file, "a") as f_out:
+            f_out.write("\nspark.executor.processTreeMetrics.enabled true\n")
+            if rt_params.enable_prometheus:
+                f_out.write("spark.ui.prometheus.enabled true\n")
+
+        if rt_params.enable_prometheus:
+            logger.info(
+                "Enabled Prometheus metrics. Scrape /metrics/prometheus on the master/worker UIs "
+                "and /metrics/executors/prometheus on the driver UI (port 4040)."
+            )
+        if rt_params.enable_metrics_csv:
+            logger.info(
+                "Enabled CSV metrics sink writing to {} every {} seconds.",
+                csv_dir,
+                rt_params.metrics_csv_period,
+            )
 
     def _enable_gpus(self, defaults_file: Path) -> None:
         rt_params = self._config.runtime
diff --git a/src/sparkctl/models.py b/src/sparkctl/models.py
index bf76289..9967d5d 100644
--- a/src/sparkctl/models.py
+++ b/src/sparkctl/models.py
@@ -127,6 +127,15 @@ class SparkRuntimeParams(SparkctlBaseModel):
         description="Expose Spark metrics in Prometheus format through the existing web UI ports "
         "(no extra ports are opened).",
     )
+    enable_metrics_csv: bool = Field(
+        default=False,
+        description="Write Spark metrics to CSV files in <base>/metrics-csv. Unlike the Prometheus "
+        "sink, this leaves a durable record on disk after the cluster shuts down.",
+    )
+    metrics_csv_period: int = Field(
+        default=10,
+        description="Interval in seconds at which the CSV metrics sink writes samples.",
+    )
     enable_gpus: bool = Field(
         default=False,
         description="EXPERIMENTAL (untested): Enable GPU-aware scheduling. Spark workers advertise "
diff --git a/tests/test_cluster_manager.py b/tests/test_cluster_manager.py
index 0c48658..a54257a 100644
--- a/tests/test_cluster_manager.py
+++ b/tests/test_cluster_manager.py
@@ -39,6 +39,37 @@ def test_configure_reverse_proxy_and_prometheus(setup_local_env: tuple[SparkConf
     assert "PrometheusServlet" in metrics
 
 
+def test_configure_metrics_csv(setup_local_env: tuple[SparkConfig, Path]):
+    config, tmp_path = setup_local_env
+    config.directories.base = tmp_path
+    config.directories.spark_scratch = tmp_path / "spark_scratch"
+    config.runtime.enable_metrics_csv = True
+    config.runtime.metrics_csv_period = 30
+    mgr = ClusterManager.from_config(config)
+    mgr.configure()
+    metrics = config.directories.get_metrics_properties_file().read_text(encoding="utf-8")
+    assert "org.apache.spark.metrics.sink.CsvSink" in metrics
+    assert f"*.sink.csv.directory={tmp_path / 'metrics-csv'}" in metrics
+    assert "*.sink.csv.period=30" in metrics
+    assert (tmp_path / "metrics-csv").is_dir()
+    # The CSV sink alone does not need the Prometheus servlet setting.
+    defaults = config.directories.get_spark_defaults_file().read_text(encoding="utf-8")
+    assert "spark.ui.prometheus.enabled" not in defaults
+
+
+def test_configure_prometheus_and_csv_compose(setup_local_env: tuple[SparkConfig, Path]):
+    config, tmp_path = setup_local_env
+    config.directories.base = tmp_path
+    config.directories.spark_scratch = tmp_path / "spark_scratch"
+    config.runtime.enable_prometheus = True
+    config.runtime.enable_metrics_csv = True
+    mgr = ClusterManager.from_config(config)
+    mgr.configure()
+    metrics = config.directories.get_metrics_properties_file().read_text(encoding="utf-8")
+    assert "PrometheusServlet" in metrics
+    assert "CsvSink" in metrics
+
+
 def test_configure_gpus_without_detection_fails(setup_local_env: tuple[SparkConfig, Path]):
     config, tmp_path = setup_local_env
     config.directories.spark_scratch = tmp_path / "spark_scratch"

From ddca495d838dae88b72d00f6e4de96bc20cb02de Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 10:05:01 -0600
Subject: [PATCH 07/24] Make the Jupyter frontend configurable, default to
 classic notebook

Replace the hardcoded `jupyter lab` invocation with a configurable
jupyter_command (--jupyter-command), defaulting to the classic 'notebook'
frontend, which is lighter to install and simpler for a single-user
cluster. JupyterLab is still available with --jupyter-command lab.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/applications/jupyter.md | 31 ++++++++++++++++------------
 src/sparkctl/cli/sparkctl.py         | 10 +++++++++
 src/sparkctl/cluster_manager.py      |  2 +-
 src/sparkctl/models.py               |  9 ++++++--
 src/sparkctl/spark_process_runner.py | 27 ++++++++++++------------
 5 files changed, 49 insertions(+), 30 deletions(-)

diff --git a/docs/how_tos/applications/jupyter.md b/docs/how_tos/applications/jupyter.md
index c627235..d483043 100644
--- a/docs/how_tos/applications/jupyter.md
+++ b/docs/how_tos/applications/jupyter.md
@@ -1,18 +1,23 @@
-# How to run a JupyterLab notebook against the cluster
+# How to run a Jupyter notebook against the cluster
 
-sparkctl can start a JupyterLab server on the master node so you can run interactive notebooks
+sparkctl can start a Jupyter server on the master node so you can run interactive notebooks
 against the Spark cluster. When the Spark Connect server is enabled, the notebook's `SparkSession`
 connects to the cluster automatically.
 
+By default sparkctl launches the classic notebook (`jupyter notebook`), which is a good fit for a
+single-user cluster. Use `--jupyter-command lab` if you prefer JupyterLab.
+
 ## Prerequisites
 
-Install JupyterLab in the same environment as sparkctl:
+Install Jupyter in the same environment as sparkctl:
 
 ```console
-$ pip install jupyterlab    # or: uv pip install jupyterlab
+$ pip install notebook       # or: uv pip install notebook
 ```
 
-## Start JupyterLab with the Connect server
+If you want JupyterLab instead, install `jupyterlab` and pass `--jupyter-command lab`.
+
+## Start Jupyter with the Connect server
 
 The recommended setup enables the Spark Connect server so the notebook connects remotely without
 any extra configuration:
@@ -21,7 +26,7 @@ any extra configuration:
 $ sparkctl configure --connect-server --jupyter --start
 ```
 
-sparkctl sets `SPARK_REMOTE` for the JupyterLab process, so inside a notebook you can simply do:
+sparkctl sets `SPARK_REMOTE` for the Jupyter process, so inside a notebook you can simply do:
 
 ```python
 from pyspark.sql import SparkSession
@@ -32,14 +37,14 @@ spark.createDataFrame([(1, 2), (3, 4)], ["a", "b"]).show()
 
 ## Find the access URL
 
-The JupyterLab access URL, including its login token, is written to `jupyter.log` in the cluster
-base directory:
+The Jupyter access URL, including its login token, is written to `jupyter.log` in the cluster base
+directory:
 
 ```console
 $ grep -m1 'http' jupyter.log
 ```
 
-JupyterLab listens on port 8889 by default. Change it with `--jupyter-port`, and forward it to your
+Jupyter listens on port 8889 by default. Change it with `--jupyter-port`, and forward it to your
 laptop over SSH (replacing `master-node` with the node running the server):
 
 ```console
@@ -50,10 +55,10 @@ Then open the URL from `jupyter.log`, replacing the host with `localhost`.
 
 ## Stopping
 
-`sparkctl stop` shuts the JupyterLab server down along with the rest of the cluster.
+`sparkctl stop` shuts the Jupyter server down along with the rest of the cluster.
 
 ```{eval-rst}
-.. note:: If you enable ``--jupyter`` without ``--connect-server``, JupyterLab still starts, but
-   the notebook is responsible for creating its own ``SparkSession`` (for example, a local driver
-   that connects to ``spark://<master>:7077``). The Connect server path is recommended.
+.. note:: If you enable ``--jupyter`` without ``--connect-server``, Jupyter still starts, but the
+   notebook is responsible for creating its own ``SparkSession`` (for example, a local driver that
+   connects to ``spark://<master>:7077``). The Connect server path is recommended.
 ```
diff --git a/src/sparkctl/cli/sparkctl.py b/src/sparkctl/cli/sparkctl.py
index 8bbc054..c68b27d 100644
--- a/src/sparkctl/cli/sparkctl.py
+++ b/src/sparkctl/cli/sparkctl.py
@@ -289,6 +289,14 @@ def _create_default_config(
     show_default=True,
     help=SparkRuntimeParams.model_fields["start_jupyter"].description,
 )
+@click.option(
+    "--jupyter-command",
+    default=sparkctl_settings.runtime.get(
+        "jupyter_command", SparkRuntimeParams.model_fields["jupyter_command"].default
+    ),
+    show_default=True,
+    help=SparkRuntimeParams.model_fields["jupyter_command"].description,
+)
 @click.option(
     "--jupyter-port",
     default=sparkctl_settings.runtime.get(
@@ -445,6 +453,7 @@ def configure(
     history_server: bool,
     thrift_server: bool,
     jupyter: bool,
+    jupyter_command: str,
     jupyter_port: int,
     reverse_proxy: bool,
     reverse_proxy_url: str | None,
@@ -492,6 +501,7 @@ def build_config() -> SparkConfig:
                 start_history_server=history_server,
                 start_thrift_server=thrift_server,
                 start_jupyter=jupyter,
+                jupyter_command=jupyter_command,
                 jupyter_port=jupyter_port,
                 enable_reverse_proxy=reverse_proxy,
                 reverse_proxy_url=reverse_proxy_url,
diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index cbe4ae5..d095255 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -336,7 +336,7 @@ def _start(self, runner: SparkProcessRunner, tracker: StatusTracker) -> None:
         if self._config.runtime.start_jupyter:
             runner.start_jupyter_server()
             tracker.started_jupyter = True
-            logger.info("Started JupyterLab server")
+            logger.info("Started Jupyter server")
 
         worker_memory_gb = self._get_worker_memory_gb(self._get_runtime_spark_driver_memory_gb())
         if is_single_node_cluster:
diff --git a/src/sparkctl/models.py b/src/sparkctl/models.py
index 9967d5d..4cb32ea 100644
--- a/src/sparkctl/models.py
+++ b/src/sparkctl/models.py
@@ -103,12 +103,17 @@ class SparkRuntimeParams(SparkctlBaseModel):
     )
     start_jupyter: bool = Field(
         default=False,
-        description="Start a JupyterLab server on the master node. Pre-wired to the Spark Connect "
+        description="Start a Jupyter server on the master node. Pre-wired to the Spark Connect "
         "server when it is enabled (the notebook's SparkSession connects automatically).",
     )
+    jupyter_command: str = Field(
+        default="notebook",
+        description="Jupyter frontend to launch, i.e. the `jupyter <command>` subcommand. "
+        "Defaults to the classic 'notebook'; use 'lab' for JupyterLab.",
+    )
     jupyter_port: int = Field(
         default=8889,
-        description="Port on which the JupyterLab server listens.",
+        description="Port on which the Jupyter server listens.",
     )
     enable_reverse_proxy: bool = Field(
         default=False,
diff --git a/src/sparkctl/spark_process_runner.py b/src/sparkctl/spark_process_runner.py
index 1bcb7d9..9a61770 100644
--- a/src/sparkctl/spark_process_runner.py
+++ b/src/sparkctl/spark_process_runner.py
@@ -64,12 +64,14 @@ def stop_thrift_server(self) -> int:
         return self._run_command(self._stop_thrift_server_cmd())
 
     def start_jupyter_server(self) -> None:
-        """Start a JupyterLab server on the local node."""
+        """Start a Jupyter server on the local node."""
         jupyter = shutil.which("jupyter")
+        command = self._config.runtime.jupyter_command
         if jupyter is None:
+            package = "jupyterlab" if command == "lab" else "notebook"
             msg = (
                 "jupyter is not installed in the current environment. Install it with "
-                "`pip install jupyterlab` (or `uv pip install jupyterlab`)."
+                f"`pip install {package}` (or `uv pip install {package}`)."
             )
             raise ExecutionError(msg)
 
@@ -83,13 +85,13 @@ def start_jupyter_server(self) -> None:
             env["SPARK_REMOTE"] = f"sc://localhost:{self._config.runtime.connect_server_port}"
         cmd = [
             jupyter,
-            "lab",
+            command,
             "--no-browser",
             f"--port={port}",
             "--ip=0.0.0.0",
             f"--notebook-dir={self._config.directories.base}",
         ]
-        logger.info("Start JupyterLab server: {}", " ".join(cmd))
+        logger.info("Start Jupyter server: {}", " ".join(cmd))
         with open(log_file, "w", encoding="utf-8") as f_out:
             proc = subprocess.Popen(
                 cmd,
@@ -102,37 +104,34 @@ def start_jupyter_server(self) -> None:
         time.sleep(1)
         ret = proc.poll()
         if ret is not None:
-            msg = (
-                f"The JupyterLab server exited immediately with return code {ret}. See {log_file}."
-            )
+            msg = f"The Jupyter server exited immediately with return code {ret}. See {log_file}."
             raise ExecutionError(msg)
         pid_file.write_text(f"{proc.pid}\n", encoding="utf-8")
         logger.info(
-            "Started JupyterLab server with pid {} on port {}. The access URL (with token) is in "
-            "{}.",
+            "Started Jupyter server with pid {} on port {}. The access URL (with token) is in {}.",
             proc.pid,
             port,
             log_file,
         )
 
     def stop_jupyter_server(self) -> int:
-        """Stop the JupyterLab server."""
+        """Stop the Jupyter server."""
         pid_file = self._get_jupyter_pid_file()
         if not pid_file.exists():
-            logger.error("Cannot stop JupyterLab server: {} does not exist", pid_file)
+            logger.error("Cannot stop Jupyter server: {} does not exist", pid_file)
             return 1
         pid = int(pid_file.read_text(encoding="utf-8").strip())
         try:
             os.kill(pid, signal.SIGTERM)
         except ProcessLookupError:
-            logger.info("The JupyterLab server has already exited")
+            logger.info("The Jupyter server has already exited")
             pid_file.unlink()
             return 0
         if self._wait_for_process_exit(pid, timeout_s=30):
-            logger.info("Stopped the JupyterLab server")
+            logger.info("Stopped the Jupyter server")
             pid_file.unlink()
             return 0
-        logger.error("The JupyterLab server process {} did not exit within the timeout", pid)
+        logger.error("The Jupyter server process {} did not exit within the timeout", pid)
         return 1
 
     def _get_jupyter_pid_file(self) -> Path:

From 9c1cccec410cc22d3a05267615edbd17048bf7a1 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 10:08:40 -0600
Subject: [PATCH 08/24] Add optional jupyter extra instead of a core dependency

Jupyter is only needed for `sparkctl configure --jupyter` and is gated at
runtime, so add it as an optional extra (sparkctl[jupyter] -> notebook)
rather than a core dependency. This keeps the default install slim.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/applications/jupyter.md | 5 +++--
 pyproject.toml                       | 5 +++++
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/docs/how_tos/applications/jupyter.md b/docs/how_tos/applications/jupyter.md
index d483043..e7549fa 100644
--- a/docs/how_tos/applications/jupyter.md
+++ b/docs/how_tos/applications/jupyter.md
@@ -9,10 +9,11 @@ single-user cluster. Use `--jupyter-command lab` if you prefer JupyterLab.
 
 ## Prerequisites
 
-Install Jupyter in the same environment as sparkctl:
+Install Jupyter in the same environment as sparkctl. The `jupyter` extra pulls in the classic
+notebook frontend:
 
 ```console
-$ pip install notebook       # or: uv pip install notebook
+$ pip install "sparkctl[jupyter]"    # or: uv pip install "sparkctl[jupyter]"
 ```
 
 If you want JupyterLab instead, install `jupyterlab` and pass `--jupyter-command lab`.
diff --git a/pyproject.toml b/pyproject.toml
index a7d2db5..6bdac24 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -39,6 +39,11 @@ dependencies = [
 pyspark = [
     "pyspark == 4.1.2",
 ]
+# Optional notebook frontend for `sparkctl configure --jupyter`. Installs the classic notebook
+# (the default frontend); install jupyterlab separately to use `--jupyter-command lab`.
+jupyter = [
+    "notebook",
+]
 dev = [
     "furo",
     "myst_parser",

From b8e8bd8437b0257ae7116c0f678ce9b9c382600a Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 10:13:12 -0600
Subject: [PATCH 09/24] Address Copilot review: Jupyter bind, ssh thread cap,
 pg password checks

- Bind the Jupyter server to 127.0.0.1 by default (configurable via
  --jupyter-ip); document an SSH ProxyJump tunnel and the 0.0.0.0 escape
  hatch. Avoids exposing the notebook server on all interfaces.
- Cap the ssh worker start/stop thread pool at 32 so large allocations do
  not spawn thousands of threads.
- Validate SPARKCTL_PG_PASSWORD is set and non-empty in the Postgres
  start/setup scripts instead of silently using an empty password.
- Lock the notebook dependency added by the jupyter extra in uv.lock.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/applications/jupyter.md     |   18 +-
 src/sparkctl/cli/sparkctl.py             |   10 +
 src/sparkctl/models.py                   |    6 +
 src/sparkctl/postgres/setup_metastore.sh |    4 +
 src/sparkctl/postgres/start_container.sh |    4 +
 src/sparkctl/spark_process_runner.py     |    7 +-
 uv.lock                                  | 1120 +++++++++++++++++++++-
 7 files changed, 1162 insertions(+), 7 deletions(-)

diff --git a/docs/how_tos/applications/jupyter.md b/docs/how_tos/applications/jupyter.md
index e7549fa..67e3780 100644
--- a/docs/how_tos/applications/jupyter.md
+++ b/docs/how_tos/applications/jupyter.md
@@ -45,14 +45,24 @@ directory:
 $ grep -m1 'http' jupyter.log
 ```
 
-Jupyter listens on port 8889 by default. Change it with `--jupyter-port`, and forward it to your
-laptop over SSH (replacing `master-node` with the node running the server):
+Jupyter listens on `127.0.0.1:8889` by default. Binding to localhost keeps the server off the
+cluster network; reach it with an SSH tunnel. From your laptop, forward the port to the master node
+(use `-J <hpc-login-host>` to hop through the login node, and replace `master-node` with the node
+running the server):
 
 ```console
-$ ssh -L 8889:master-node:8889 <hpc-login-host>
+$ ssh -J <hpc-login-host> -L 8889:localhost:8889 master-node
 ```
 
-Then open the URL from `jupyter.log`, replacing the host with `localhost`.
+Then open the URL from `jupyter.log`, replacing the host with `localhost`. Change the port with
+`--jupyter-port`.
+
+```{eval-rst}
+.. note:: If you cannot reach the master node directly, ``--jupyter-ip 0.0.0.0`` makes Jupyter
+   listen on all interfaces so you can tunnel through the login node to the master's hostname. This
+   exposes the server to the cluster network (it is still protected by Jupyter's access token), so
+   prefer the localhost default when possible.
+```
 
 ## Stopping
 
diff --git a/src/sparkctl/cli/sparkctl.py b/src/sparkctl/cli/sparkctl.py
index c68b27d..0140471 100644
--- a/src/sparkctl/cli/sparkctl.py
+++ b/src/sparkctl/cli/sparkctl.py
@@ -297,6 +297,14 @@ def _create_default_config(
     show_default=True,
     help=SparkRuntimeParams.model_fields["jupyter_command"].description,
 )
+@click.option(
+    "--jupyter-ip",
+    default=sparkctl_settings.runtime.get(
+        "jupyter_ip", SparkRuntimeParams.model_fields["jupyter_ip"].default
+    ),
+    show_default=True,
+    help=SparkRuntimeParams.model_fields["jupyter_ip"].description,
+)
 @click.option(
     "--jupyter-port",
     default=sparkctl_settings.runtime.get(
@@ -454,6 +462,7 @@ def configure(
     thrift_server: bool,
     jupyter: bool,
     jupyter_command: str,
+    jupyter_ip: str,
     jupyter_port: int,
     reverse_proxy: bool,
     reverse_proxy_url: str | None,
@@ -502,6 +511,7 @@ def build_config() -> SparkConfig:
                 start_thrift_server=thrift_server,
                 start_jupyter=jupyter,
                 jupyter_command=jupyter_command,
+                jupyter_ip=jupyter_ip,
                 jupyter_port=jupyter_port,
                 enable_reverse_proxy=reverse_proxy,
                 reverse_proxy_url=reverse_proxy_url,
diff --git a/src/sparkctl/models.py b/src/sparkctl/models.py
index 4cb32ea..eac7fa5 100644
--- a/src/sparkctl/models.py
+++ b/src/sparkctl/models.py
@@ -111,6 +111,12 @@ class SparkRuntimeParams(SparkctlBaseModel):
         description="Jupyter frontend to launch, i.e. the `jupyter <command>` subcommand. "
         "Defaults to the classic 'notebook'; use 'lab' for JupyterLab.",
     )
+    jupyter_ip: str = Field(
+        default="127.0.0.1",
+        description="IP address the Jupyter server binds to. Defaults to localhost, which is "
+        "secure and works with an SSH tunnel to the master node. Set to 0.0.0.0 to listen on all "
+        "interfaces (only if you understand the exposure).",
+    )
     jupyter_port: int = Field(
         default=8889,
         description="Port on which the Jupyter server listens.",
diff --git a/src/sparkctl/postgres/setup_metastore.sh b/src/sparkctl/postgres/setup_metastore.sh
index dba23b9..14978d2 100644
--- a/src/sparkctl/postgres/setup_metastore.sh
+++ b/src/sparkctl/postgres/setup_metastore.sh
@@ -1,6 +1,10 @@
 #!/bin/bash
 pg_exists=$1
 # The password is passed through the environment so that it does not appear in process listings.
+if [ -z "${SPARKCTL_PG_PASSWORD}" ]; then
+    echo "SPARKCTL_PG_PASSWORD must be set and non-empty" >&2
+    exit 1
+fi
 pg_password=${SPARKCTL_PG_PASSWORD}
 module load apptainer
 
diff --git a/src/sparkctl/postgres/start_container.sh b/src/sparkctl/postgres/start_container.sh
index 6c42aaf..a515a9c 100644
--- a/src/sparkctl/postgres/start_container.sh
+++ b/src/sparkctl/postgres/start_container.sh
@@ -2,6 +2,10 @@
 pg_data_dir=$1
 pg_run_dir=$2
 # The password is passed through the environment so that it does not appear in process listings.
+if [ -z "${SPARKCTL_PG_PASSWORD}" ]; then
+    echo "SPARKCTL_PG_PASSWORD must be set and non-empty" >&2
+    exit 1
+fi
 pg_password=${SPARKCTL_PG_PASSWORD}
 
 # TODO: Make these configurable.
diff --git a/src/sparkctl/spark_process_runner.py b/src/sparkctl/spark_process_runner.py
index 9a61770..6a71eec 100644
--- a/src/sparkctl/spark_process_runner.py
+++ b/src/sparkctl/spark_process_runner.py
@@ -88,7 +88,7 @@ def start_jupyter_server(self) -> None:
             command,
             "--no-browser",
             f"--port={port}",
-            "--ip=0.0.0.0",
+            f"--ip={self._config.runtime.jupyter_ip}",
             f"--notebook-dir={self._config.directories.base}",
         ]
         logger.info("Start Jupyter server: {}", " ".join(cmd))
@@ -202,7 +202,10 @@ def run_one(worker: str) -> int:
             return subprocess.run(["ssh", worker, script]).returncode
 
         failures: dict[str, int] = {}
-        with ThreadPoolExecutor(max_workers=max(1, len(workers))) as executor:
+        # Cap concurrency so a large allocation does not spawn thousands of ssh threads at once;
+        # the bounded pool keeps most of the speedup without exhausting local resources.
+        max_workers = min(32, max(1, len(workers)))
+        with ThreadPoolExecutor(max_workers=max_workers) as executor:
             futures = {executor.submit(run_one, worker): worker for worker in workers}
             for future in as_completed(futures):
                 worker = futures[future]
diff --git a/uv.lock b/uv.lock
index b901090..18e8548 100644
--- a/uv.lock
+++ b/uv.lock
@@ -36,6 +36,101 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
 ]
 
+[[package]]
+name = "anyio"
+version = "4.13.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/14/2c5dd9f512b66549ae92767a9c7b330ae88e1932ca57876909410251fe13/anyio-4.13.0.tar.gz", hash = "sha256:334b70e641fd2221c1505b3890c69882fe4a2df910cba14d97019b90b24439dc", size = 231622, upload-time = "2026-03-24T12:59:09.671Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/da/42/e921fccf5015463e32a3cf6ee7f980a6ed0f395ceeaa45060b61d86486c2/anyio-4.13.0-py3-none-any.whl", hash = "sha256:08b310f9e24a9594186fd75b4f73f4a4152069e3853f1ed8bfbf58369f4ad708", size = 114353, upload-time = "2026-03-24T12:59:08.246Z" },
+]
+
+[[package]]
+name = "appnope"
+version = "0.1.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/35/5d/752690df9ef5b76e169e68d6a129fa6d08a7100ca7f754c89495db3c6019/appnope-0.1.4.tar.gz", hash = "sha256:1de3860566df9caf38f01f86f65e0e13e379af54f9e4bee1e66b48f2efffd1ee", size = 4170, upload-time = "2024-02-06T09:43:11.258Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/81/29/5ecc3a15d5a33e31b26c11426c45c501e439cb865d0bff96315d86443b78/appnope-0.1.4-py2.py3-none-any.whl", hash = "sha256:502575ee11cd7a28c0205f379b525beefebab9d161b7c964670864014ed7213c", size = 4321, upload-time = "2024-02-06T09:43:09.663Z" },
+]
+
+[[package]]
+name = "argon2-cffi"
+version = "25.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "argon2-cffi-bindings" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/0e/89/ce5af8a7d472a67cc819d5d998aa8c82c5d860608c4db9f46f1162d7dab9/argon2_cffi-25.1.0.tar.gz", hash = "sha256:694ae5cc8a42f4c4e2bf2ca0e64e51e23a040c6a517a85074683d3959e1346c1", size = 45706, upload-time = "2025-06-03T06:55:32.073Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/4f/d3/a8b22fa575b297cd6e3e3b0155c7e25db170edf1c74783d6a31a2490b8d9/argon2_cffi-25.1.0-py3-none-any.whl", hash = "sha256:fdc8b074db390fccb6eb4a3604ae7231f219aa669a2652e0f20e16ba513d5741", size = 14657, upload-time = "2025-06-03T06:55:30.804Z" },
+]
+
+[[package]]
+name = "argon2-cffi-bindings"
+version = "25.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cffi" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5c/2d/db8af0df73c1cf454f71b2bbe5e356b8c1f8041c979f505b3d3186e520a9/argon2_cffi_bindings-25.1.0.tar.gz", hash = "sha256:b957f3e6ea4d55d820e40ff76f450952807013d361a65d7f28acc0acbf29229d", size = 1783441, upload-time = "2025-07-30T10:02:05.147Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1d/57/96b8b9f93166147826da5f90376e784a10582dd39a393c99bb62cfcf52f0/argon2_cffi_bindings-25.1.0-cp39-abi3-macosx_10_9_universal2.whl", hash = "sha256:aecba1723ae35330a008418a91ea6cfcedf6d31e5fbaa056a166462ff066d500", size = 54121, upload-time = "2025-07-30T10:01:50.815Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/08/a9bebdb2e0e602dde230bdde8021b29f71f7841bd54801bcfd514acb5dcf/argon2_cffi_bindings-25.1.0-cp39-abi3-macosx_10_9_x86_64.whl", hash = "sha256:2630b6240b495dfab90aebe159ff784d08ea999aa4b0d17efa734055a07d2f44", size = 29177, upload-time = "2025-07-30T10:01:51.681Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/02/d297943bcacf05e4f2a94ab6f462831dc20158614e5d067c35d4e63b9acb/argon2_cffi_bindings-25.1.0-cp39-abi3-macosx_11_0_arm64.whl", hash = "sha256:7aef0c91e2c0fbca6fc68e7555aa60ef7008a739cbe045541e438373bc54d2b0", size = 31090, upload-time = "2025-07-30T10:01:53.184Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/93/44365f3d75053e53893ec6d733e4a5e3147502663554b4d864587c7828a7/argon2_cffi_bindings-25.1.0-cp39-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1e021e87faa76ae0d413b619fe2b65ab9a037f24c60a1e6cc43457ae20de6dc6", size = 81246, upload-time = "2025-07-30T10:01:54.145Z" },
+    { url = "https://files.pythonhosted.org/packages/09/52/94108adfdd6e2ddf58be64f959a0b9c7d4ef2fa71086c38356d22dc501ea/argon2_cffi_bindings-25.1.0-cp39-abi3-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d3e924cfc503018a714f94a49a149fdc0b644eaead5d1f089330399134fa028a", size = 87126, upload-time = "2025-07-30T10:01:55.074Z" },
+    { url = "https://files.pythonhosted.org/packages/72/70/7a2993a12b0ffa2a9271259b79cc616e2389ed1a4d93842fac5a1f923ffd/argon2_cffi_bindings-25.1.0-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:c87b72589133f0346a1cb8d5ecca4b933e3c9b64656c9d175270a000e73b288d", size = 80343, upload-time = "2025-07-30T10:01:56.007Z" },
+    { url = "https://files.pythonhosted.org/packages/78/9a/4e5157d893ffc712b74dbd868c7f62365618266982b64accab26bab01edc/argon2_cffi_bindings-25.1.0-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:1db89609c06afa1a214a69a462ea741cf735b29a57530478c06eb81dd403de99", size = 86777, upload-time = "2025-07-30T10:01:56.943Z" },
+    { url = "https://files.pythonhosted.org/packages/74/cd/15777dfde1c29d96de7f18edf4cc94c385646852e7c7b0320aa91ccca583/argon2_cffi_bindings-25.1.0-cp39-abi3-win32.whl", hash = "sha256:473bcb5f82924b1becbb637b63303ec8d10e84c8d241119419897a26116515d2", size = 27180, upload-time = "2025-07-30T10:01:57.759Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/c6/a759ece8f1829d1f162261226fbfd2c6832b3ff7657384045286d2afa384/argon2_cffi_bindings-25.1.0-cp39-abi3-win_amd64.whl", hash = "sha256:a98cd7d17e9f7ce244c0803cad3c23a7d379c301ba618a5fa76a67d116618b98", size = 31715, upload-time = "2025-07-30T10:01:58.56Z" },
+    { url = "https://files.pythonhosted.org/packages/42/b9/f8d6fa329ab25128b7e98fd83a3cb34d9db5b059a9847eddb840a0af45dd/argon2_cffi_bindings-25.1.0-cp39-abi3-win_arm64.whl", hash = "sha256:b0fdbcf513833809c882823f98dc2f931cf659d9a1429616ac3adebb49f5db94", size = 27149, upload-time = "2025-07-30T10:01:59.329Z" },
+]
+
+[[package]]
+name = "arrow"
+version = "1.4.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "python-dateutil" },
+    { name = "tzdata" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b9/33/032cdc44182491aa708d06a68b62434140d8c50820a087fac7af37703357/arrow-1.4.0.tar.gz", hash = "sha256:ed0cc050e98001b8779e84d461b0098c4ac597e88704a655582b21d116e526d7", size = 152931, upload-time = "2025-10-18T17:46:46.761Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ed/c9/d7977eaacb9df673210491da99e6a247e93df98c715fc43fd136ce1d3d33/arrow-1.4.0-py3-none-any.whl", hash = "sha256:749f0769958ebdc79c173ff0b0670d59051a535fa26e8eba02953dc19eb43205", size = 68797, upload-time = "2025-10-18T17:46:45.663Z" },
+]
+
+[[package]]
+name = "asttokens"
+version = "3.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/be/a5/8e3f9b6771b0b408517c82d97aed8f2036509bc247d46114925e32fe33f0/asttokens-3.0.1.tar.gz", hash = "sha256:71a4ee5de0bde6a31d64f6b13f2293ac190344478f081c3d1bccfcf5eacb0cb7", size = 62308, upload-time = "2025-11-15T16:43:48.578Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d2/39/e7eaf1799466a4aef85b6a4fe7bd175ad2b1c6345066aa33f1f58d4b18d0/asttokens-3.0.1-py3-none-any.whl", hash = "sha256:15a3ebc0f43c2d0a50eeafea25e19046c68398e487b9f1f5b517f7c0f40f976a", size = 27047, upload-time = "2025-11-15T16:43:16.109Z" },
+]
+
+[[package]]
+name = "async-lru"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e8/1f/989ecfef8e64109a489fff357450cb73fa73a865a92bd8c272170a6922c2/async_lru-2.3.0.tar.gz", hash = "sha256:89bdb258a0140d7313cf8f4031d816a042202faa61d0ab310a0a538baa1c24b6", size = 16332, upload-time = "2026-03-19T01:04:32.413Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e5/e2/c2e3abf398f80732e58b03be77bde9022550d221dd8781bf586bd4d97cc1/async_lru-2.3.0-py3-none-any.whl", hash = "sha256:eea27b01841909316f2cc739807acea1c623df2be8c5cfad7583286397bb8315", size = 8403, upload-time = "2026-03-19T01:04:30.883Z" },
+]
+
+[[package]]
+name = "attrs"
+version = "26.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/9a/8e/82a0fe20a541c03148528be8cac2408564a6c9a0cc7e9171802bc1d26985/attrs-26.1.0.tar.gz", hash = "sha256:d03ceb89cb322a8fd706d4fb91940737b6642aa36998fe130a9bc96c985eff32", size = 952055, upload-time = "2026-03-19T14:22:25.026Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/64/b4/17d4b0b2a2dc85a6df63d1157e028ed19f90d4cd97c36717afef2bc2f395/attrs-26.1.0-py3-none-any.whl", hash = "sha256:c647aa4a12dfbad9333ca4e71fe62ddc36f4e63b2d260a37a8b83d2f043ac309", size = 67548, upload-time = "2026-03-19T14:22:23.645Z" },
+]
+
 [[package]]
 name = "autodoc-pydantic"
 version = "2.2.0"
@@ -71,6 +166,23 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/1a/39/47f9197bdd44df24d67ac8893641e16f386c984a0619ef2ee4c51fbbc019/beautifulsoup4-4.14.3-py3-none-any.whl", hash = "sha256:0918bfe44902e6ad8d57732ba310582e98da931428d231a5ecb9e7c703a735bb", size = 107721, upload-time = "2025-11-30T15:08:24.087Z" },
 ]
 
+[[package]]
+name = "bleach"
+version = "6.4.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "webencodings" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/48/3c/e12ac860709702bd5ebeb9b56a4fe334f1001246ee1b8f2b7ee28912df7d/bleach-6.4.0.tar.gz", hash = "sha256:4202482733d85cedd04e59fcb2f89f4e4c7c385a78d3c3c23c30446843a37452", size = 204857, upload-time = "2026-06-05T13:01:13.734Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/58/9d/40b6267367182187139a4000b82a3b287d84d745bccd808e75d916920e9d/bleach-6.4.0-py3-none-any.whl", hash = "sha256:4b6b6a54fff2e69a3dde9d21cc6301220bee3c3cb792187d11403fd795031081", size = 165109, upload-time = "2026-06-05T13:01:12.504Z" },
+]
+
+[package.optional-dependencies]
+css = [
+    { name = "tinycss2" },
+]
+
 [[package]]
 name = "certifi"
 version = "2026.1.4"
@@ -80,6 +192,54 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/e6/ad/3cc14f097111b4de0040c83a525973216457bbeeb63739ef1ed275c1c021/certifi-2026.1.4-py3-none-any.whl", hash = "sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c", size = 152900, upload-time = "2026-01-04T02:42:40.15Z" },
 ]
 
+[[package]]
+name = "cffi"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pycparser", marker = "implementation_name != 'PyPy'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/eb/56/b1ba7935a17738ae8453301356628e8147c79dbb825bcbc73dc7401f9846/cffi-2.0.0.tar.gz", hash = "sha256:44d1b5909021139fe36001ae048dbdde8214afa20200eda0f64c068cac5d5529", size = 523588, upload-time = "2025-09-08T23:24:04.541Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/12/4a/3dfd5f7850cbf0d06dc84ba9aa00db766b52ca38d8b86e3a38314d52498c/cffi-2.0.0-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:b4c854ef3adc177950a8dfc81a86f5115d2abd545751a304c5bcf2c2c7283cfe", size = 184344, upload-time = "2025-09-08T23:22:26.456Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/8b/f0e4c441227ba756aafbe78f117485b25bb26b1c059d01f137fa6d14896b/cffi-2.0.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:2de9a304e27f7596cd03d16f1b7c72219bd944e99cc52b84d0145aefb07cbd3c", size = 180560, upload-time = "2025-09-08T23:22:28.197Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/b7/1200d354378ef52ec227395d95c2576330fd22a869f7a70e88e1447eb234/cffi-2.0.0-cp311-cp311-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:baf5215e0ab74c16e2dd324e8ec067ef59e41125d3eade2b863d294fd5035c92", size = 209613, upload-time = "2025-09-08T23:22:29.475Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/56/6033f5e86e8cc9bb629f0077ba71679508bdf54a9a5e112a3c0b91870332/cffi-2.0.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:730cacb21e1bdff3ce90babf007d0a0917cc3e6492f336c2f0134101e0944f93", size = 216476, upload-time = "2025-09-08T23:22:31.063Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/7f/55fecd70f7ece178db2f26128ec41430d8720f2d12ca97bf8f0a628207d5/cffi-2.0.0-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:6824f87845e3396029f3820c206e459ccc91760e8fa24422f8b0c3d1731cbec5", size = 203374, upload-time = "2025-09-08T23:22:32.507Z" },
+    { url = "https://files.pythonhosted.org/packages/84/ef/a7b77c8bdc0f77adc3b46888f1ad54be8f3b7821697a7b89126e829e676a/cffi-2.0.0-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:9de40a7b0323d889cf8d23d1ef214f565ab154443c42737dfe52ff82cf857664", size = 202597, upload-time = "2025-09-08T23:22:34.132Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/91/500d892b2bf36529a75b77958edfcd5ad8e2ce4064ce2ecfeab2125d72d1/cffi-2.0.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8941aaadaf67246224cee8c3803777eed332a19d909b47e29c9842ef1e79ac26", size = 215574, upload-time = "2025-09-08T23:22:35.443Z" },
+    { url = "https://files.pythonhosted.org/packages/44/64/58f6255b62b101093d5df22dcb752596066c7e89dd725e0afaed242a61be/cffi-2.0.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:a05d0c237b3349096d3981b727493e22147f934b20f6f125a3eba8f994bec4a9", size = 218971, upload-time = "2025-09-08T23:22:36.805Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/49/fa72cebe2fd8a55fbe14956f9970fe8eb1ac59e5df042f603ef7c8ba0adc/cffi-2.0.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:94698a9c5f91f9d138526b48fe26a199609544591f859c870d477351dc7b2414", size = 211972, upload-time = "2025-09-08T23:22:38.436Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/28/dd0967a76aab36731b6ebfe64dec4e981aff7e0608f60c2d46b46982607d/cffi-2.0.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:5fed36fccc0612a53f1d4d9a816b50a36702c28a2aa880cb8a122b3466638743", size = 217078, upload-time = "2025-09-08T23:22:39.776Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/c0/015b25184413d7ab0a410775fdb4a50fca20f5589b5dab1dbbfa3baad8ce/cffi-2.0.0-cp311-cp311-win32.whl", hash = "sha256:c649e3a33450ec82378822b3dad03cc228b8f5963c0c12fc3b1e0ab940f768a5", size = 172076, upload-time = "2025-09-08T23:22:40.95Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/8f/dc5531155e7070361eb1b7e4c1a9d896d0cb21c49f807a6c03fd63fc877e/cffi-2.0.0-cp311-cp311-win_amd64.whl", hash = "sha256:66f011380d0e49ed280c789fbd08ff0d40968ee7b665575489afa95c98196ab5", size = 182820, upload-time = "2025-09-08T23:22:42.463Z" },
+    { url = "https://files.pythonhosted.org/packages/95/5c/1b493356429f9aecfd56bc171285a4c4ac8697f76e9bbbbb105e537853a1/cffi-2.0.0-cp311-cp311-win_arm64.whl", hash = "sha256:c6638687455baf640e37344fe26d37c404db8b80d037c3d29f58fe8d1c3b194d", size = 177635, upload-time = "2025-09-08T23:22:43.623Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/47/4f61023ea636104d4f16ab488e268b93008c3d0bb76893b1b31db1f96802/cffi-2.0.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:6d02d6655b0e54f54c4ef0b94eb6be0607b70853c45ce98bd278dc7de718be5d", size = 185271, upload-time = "2025-09-08T23:22:44.795Z" },
+    { url = "https://files.pythonhosted.org/packages/df/a2/781b623f57358e360d62cdd7a8c681f074a71d445418a776eef0aadb4ab4/cffi-2.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8eca2a813c1cb7ad4fb74d368c2ffbbb4789d377ee5bb8df98373c2cc0dee76c", size = 181048, upload-time = "2025-09-08T23:22:45.938Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/df/a4f0fbd47331ceeba3d37c2e51e9dfc9722498becbeec2bd8bc856c9538a/cffi-2.0.0-cp312-cp312-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:21d1152871b019407d8ac3985f6775c079416c282e431a4da6afe7aefd2bccbe", size = 212529, upload-time = "2025-09-08T23:22:47.349Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/72/12b5f8d3865bf0f87cf1404d8c374e7487dcf097a1c91c436e72e6badd83/cffi-2.0.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:b21e08af67b8a103c71a250401c78d5e0893beff75e28c53c98f4de42f774062", size = 220097, upload-time = "2025-09-08T23:22:48.677Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/95/7a135d52a50dfa7c882ab0ac17e8dc11cec9d55d2c18dda414c051c5e69e/cffi-2.0.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:1e3a615586f05fc4065a8b22b8152f0c1b00cdbc60596d187c2a74f9e3036e4e", size = 207983, upload-time = "2025-09-08T23:22:50.06Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/c8/15cb9ada8895957ea171c62dc78ff3e99159ee7adb13c0123c001a2546c1/cffi-2.0.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:81afed14892743bbe14dacb9e36d9e0e504cd204e0b165062c488942b9718037", size = 206519, upload-time = "2025-09-08T23:22:51.364Z" },
+    { url = "https://files.pythonhosted.org/packages/78/2d/7fa73dfa841b5ac06c7b8855cfc18622132e365f5b81d02230333ff26e9e/cffi-2.0.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:3e17ed538242334bf70832644a32a7aae3d83b57567f9fd60a26257e992b79ba", size = 219572, upload-time = "2025-09-08T23:22:52.902Z" },
+    { url = "https://files.pythonhosted.org/packages/07/e0/267e57e387b4ca276b90f0434ff88b2c2241ad72b16d31836adddfd6031b/cffi-2.0.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3925dd22fa2b7699ed2617149842d2e6adde22b262fcbfada50e3d195e4b3a94", size = 222963, upload-time = "2025-09-08T23:22:54.518Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/75/1f2747525e06f53efbd878f4d03bac5b859cbc11c633d0fb81432d98a795/cffi-2.0.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:2c8f814d84194c9ea681642fd164267891702542f028a15fc97d4674b6206187", size = 221361, upload-time = "2025-09-08T23:22:55.867Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/2b/2b6435f76bfeb6bbf055596976da087377ede68df465419d192acf00c437/cffi-2.0.0-cp312-cp312-win32.whl", hash = "sha256:da902562c3e9c550df360bfa53c035b2f241fed6d9aef119048073680ace4a18", size = 172932, upload-time = "2025-09-08T23:22:57.188Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/ed/13bd4418627013bec4ed6e54283b1959cf6db888048c7cf4b4c3b5b36002/cffi-2.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:da68248800ad6320861f129cd9c1bf96ca849a2771a59e0344e88681905916f5", size = 183557, upload-time = "2025-09-08T23:22:58.351Z" },
+    { url = "https://files.pythonhosted.org/packages/95/31/9f7f93ad2f8eff1dbc1c3656d7ca5bfd8fb52c9d786b4dcf19b2d02217fa/cffi-2.0.0-cp312-cp312-win_arm64.whl", hash = "sha256:4671d9dd5ec934cb9a73e7ee9676f9362aba54f7f34910956b84d727b0d73fb6", size = 177762, upload-time = "2025-09-08T23:22:59.668Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/8d/a0a47a0c9e413a658623d014e91e74a50cdd2c423f7ccfd44086ef767f90/cffi-2.0.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:00bdf7acc5f795150faa6957054fbbca2439db2f775ce831222b66f192f03beb", size = 185230, upload-time = "2025-09-08T23:23:00.879Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/d2/a6c0296814556c68ee32009d9c2ad4f85f2707cdecfd7727951ec228005d/cffi-2.0.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:45d5e886156860dc35862657e1494b9bae8dfa63bf56796f2fb56e1679fc0bca", size = 181043, upload-time = "2025-09-08T23:23:02.231Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/1e/d22cc63332bd59b06481ceaac49d6c507598642e2230f201649058a7e704/cffi-2.0.0-cp313-cp313-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:07b271772c100085dd28b74fa0cd81c8fb1a3ba18b21e03d7c27f3436a10606b", size = 212446, upload-time = "2025-09-08T23:23:03.472Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/f5/a2c23eb03b61a0b8747f211eb716446c826ad66818ddc7810cc2cc19b3f2/cffi-2.0.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d48a880098c96020b02d5a1f7d9251308510ce8858940e6fa99ece33f610838b", size = 220101, upload-time = "2025-09-08T23:23:04.792Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/7f/e6647792fc5850d634695bc0e6ab4111ae88e89981d35ac269956605feba/cffi-2.0.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:f93fd8e5c8c0a4aa1f424d6173f14a892044054871c771f8566e4008eaa359d2", size = 207948, upload-time = "2025-09-08T23:23:06.127Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/1e/a5a1bd6f1fb30f22573f76533de12a00bf274abcdc55c8edab639078abb6/cffi-2.0.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:dd4f05f54a52fb558f1ba9f528228066954fee3ebe629fc1660d874d040ae5a3", size = 206422, upload-time = "2025-09-08T23:23:07.753Z" },
+    { url = "https://files.pythonhosted.org/packages/98/df/0a1755e750013a2081e863e7cd37e0cdd02664372c754e5560099eb7aa44/cffi-2.0.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c8d3b5532fc71b7a77c09192b4a5a200ea992702734a2e9279a37f2478236f26", size = 219499, upload-time = "2025-09-08T23:23:09.648Z" },
+    { url = "https://files.pythonhosted.org/packages/50/e1/a969e687fcf9ea58e6e2a928ad5e2dd88cc12f6f0ab477e9971f2309b57c/cffi-2.0.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d9b29c1f0ae438d5ee9acb31cadee00a58c46cc9c0b2f9038c6b0b3470877a8c", size = 222928, upload-time = "2025-09-08T23:23:10.928Z" },
+    { url = "https://files.pythonhosted.org/packages/36/54/0362578dd2c9e557a28ac77698ed67323ed5b9775ca9d3fe73fe191bb5d8/cffi-2.0.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6d50360be4546678fc1b79ffe7a66265e28667840010348dd69a314145807a1b", size = 221302, upload-time = "2025-09-08T23:23:12.42Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/6d/bf9bda840d5f1dfdbf0feca87fbdb64a918a69bca42cfa0ba7b137c48cb8/cffi-2.0.0-cp313-cp313-win32.whl", hash = "sha256:74a03b9698e198d47562765773b4a8309919089150a0bb17d829ad7b44b60d27", size = 172909, upload-time = "2025-09-08T23:23:14.32Z" },
+    { url = "https://files.pythonhosted.org/packages/37/18/6519e1ee6f5a1e579e04b9ddb6f1676c17368a7aba48299c3759bbc3c8b3/cffi-2.0.0-cp313-cp313-win_amd64.whl", hash = "sha256:19f705ada2530c1167abacb171925dd886168931e0a7b78f5bffcae5c6b5be75", size = 183402, upload-time = "2025-09-08T23:23:15.535Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/0e/02ceeec9a7d6ee63bb596121c2c8e9b3a9e150936f4fbef6ca1943e6137c/cffi-2.0.0-cp313-cp313-win_arm64.whl", hash = "sha256:256f80b80ca3853f90c21b23ee78cd008713787b1b1e93eae9f3d6a7134abd91", size = 177780, upload-time = "2025-09-08T23:23:16.761Z" },
+]
+
 [[package]]
 name = "charset-normalizer"
 version = "3.4.4"
@@ -158,6 +318,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
 ]
 
+[[package]]
+name = "comm"
+version = "0.2.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4c/13/7d740c5849255756bc17888787313b61fd38a0a8304fc4f073dfc46122aa/comm-0.2.3.tar.gz", hash = "sha256:2dc8048c10962d55d7ad693be1e7045d891b7ce8d999c97963a5e3e99c055971", size = 6319, upload-time = "2025-07-25T14:02:04.452Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/60/97/891a0971e1e4a8c5d2b20bbe0e524dc04548d2307fee33cdeba148fd4fc7/comm-0.2.3-py3-none-any.whl", hash = "sha256:c615d91d75f7f04f095b30d1c1711babd43bdc6419c1be9886a85f2f4e489417", size = 7294, upload-time = "2025-07-25T14:02:02.896Z" },
+]
+
 [[package]]
 name = "coverage"
 version = "7.13.1"
@@ -224,6 +393,45 @@ toml = [
     { name = "tomli", marker = "python_full_version <= '3.11'" },
 ]
 
+[[package]]
+name = "debugpy"
+version = "1.8.21"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f2/aa/12037145b7a56eaa5b29b41872f7a21b538e807e13f32c4d3c46e59be084/debugpy-1.8.21.tar.gz", hash = "sha256:a3c53278e84c94e11bd87c53970ec391d1a67396c8b22609fcac576520e611a6", size = 1697577, upload-time = "2026-06-01T19:30:35.156Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/89/fb/cbf306d6e07a313a91e7171a98669054502840931432c227cfd505ee367f/debugpy-1.8.21-cp311-cp311-macosx_15_0_universal2.whl", hash = "sha256:da456226c7b4c69e35dbe35dcee6623d912000a77816db7856a41af1c72a0264", size = 2203120, upload-time = "2026-06-01T19:30:43.964Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/57/aa739bd4ad2cbf96aeb1b20b56918ddd5ae4c28b68709bfcd327f02123ee/debugpy-1.8.21-cp311-cp311-manylinux_2_34_x86_64.whl", hash = "sha256:f68b891688e61bdc08b8d364d919ff0051e0b94657b39dcd027bc3173edb7cdc", size = 3059958, upload-time = "2026-06-01T19:30:45.622Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/31/453d2c9a23d133fe2c8ec7ca1d816ded52a913487fe3ffef7c01b4b706af/debugpy-1.8.21-cp311-cp311-win32.whl", hash = "sha256:f843a8b08c2edeaf9b1582eed4f25441af21a297c22ff16bf76a662557aa9c9e", size = 5236515, upload-time = "2026-06-01T19:30:47.461Z" },
+    { url = "https://files.pythonhosted.org/packages/60/94/6660de2f2d7bf388f229335ba4637646eebabdbf38564cb439a95a9193c9/debugpy-1.8.21-cp311-cp311-win_amd64.whl", hash = "sha256:84c564d8cc701d41843b29a92814c1f1bef6798724ca9d675c284ad9f6a547d7", size = 5256138, upload-time = "2026-06-01T19:30:49.113Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/df/bf625547431a9cadc9f4cbfeda38866e2b17f6aed147b625377e87834449/debugpy-1.8.21-cp312-cp312-macosx_15_0_universal2.whl", hash = "sha256:9f96713896f39c3dff0ee841f47320c3f2983d33c341e009361bb0ebc79adc4e", size = 2483609, upload-time = "2026-06-01T19:30:50.794Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/09/59324b903599031ff9faaec1758292409f6561a0ec2492fe4b703327705a/debugpy-1.8.21-cp312-cp312-manylinux_2_34_x86_64.whl", hash = "sha256:c193d474f0a211191f2b4449d2d06157c689013035bd952f3b617e0ef422b176", size = 3968900, upload-time = "2026-06-01T19:30:52.341Z" },
+    { url = "https://files.pythonhosted.org/packages/14/cd/27f65b805d7fe005c44e1a36b9183ecdfbcdbf9d3e721a5115d461ecc7ee/debugpy-1.8.21-cp312-cp312-win32.whl", hash = "sha256:4743373c1cac7f9e74a1b9915bf1dbe0e900eca657ffb170ae07ac8363205ae9", size = 5336340, upload-time = "2026-06-01T19:30:54.047Z" },
+    { url = "https://files.pythonhosted.org/packages/77/1d/c84e30c0c674184948b66f076ab271c01d940618a2824c23cd035a27bc20/debugpy-1.8.21-cp312-cp312-win_amd64.whl", hash = "sha256:bd7ba9dd3daa7c2f942c6ca8d4695a16bf9ac16b63615261c7982bc74f7ed20c", size = 5374751, upload-time = "2026-06-01T19:30:55.891Z" },
+    { url = "https://files.pythonhosted.org/packages/77/6b/d817e1f8cc77aa055d37fba092e0febfdff40fe652d8d53d4cd7a86ad98d/debugpy-1.8.21-cp313-cp313-macosx_15_0_universal2.whl", hash = "sha256:13678151fc401e2d68c9880b91e28714f797d40422994572b24560ef80910a88", size = 2477398, upload-time = "2026-06-01T19:30:57.644Z" },
+    { url = "https://files.pythonhosted.org/packages/48/57/412421516afc3055fa577516f00beec3d663f9b0ab330639547ae6c57720/debugpy-1.8.21-cp313-cp313-manylinux_2_34_x86_64.whl", hash = "sha256:ecbd158386c31ffe71d46f72d44d56e66331ab9b16cad649156d514368f23ab2", size = 3962096, upload-time = "2026-06-01T19:30:59.235Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/62/2c616337cf6ba7b07ebbc97f02c6c945a8e2f76b365e33ee809c32ee36d1/debugpy-1.8.21-cp313-cp313-win32.whl", hash = "sha256:2c2ae706dec41d99a9ca1f7ebc987a83e65578363be6f6b3ac9067504917fae1", size = 5336288, upload-time = "2026-06-01T19:31:00.79Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/99/9175103392f84c4b1bf7622888cdc68da07f0ff7d9e581266428f6776033/debugpy-1.8.21-cp313-cp313-win_amd64.whl", hash = "sha256:aa648733047443eb1d07682c4ef287d36a54507b643ffdf38b09a3ef002c72a0", size = 5376567, upload-time = "2026-06-01T19:31:02.56Z" },
+    { url = "https://files.pythonhosted.org/packages/95/51/67e7cf11a53e40694f720457d5b3a1cdaaa3d5a9a633e482f225456b93ff/debugpy-1.8.21-py2.py3-none-any.whl", hash = "sha256:b1e37d333663c8851516a47364ef473da127f9caebe4417e6df6f5825a7e9a92", size = 5352888, upload-time = "2026-06-01T19:31:25.186Z" },
+]
+
+[[package]]
+name = "decorator"
+version = "5.3.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/60/8b/32f9823da46cde7df2087faa08cd98d01b908f8dcab982cdba9c84e85355/decorator-5.3.1.tar.gz", hash = "sha256:4cbcdd55a6efadb9dbea26b858f4fb3264567b52d69ca0d25b721b553f60ea82", size = 58084, upload-time = "2026-05-18T06:03:28.057Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/05/7f/798705f5296a58ca505d600456748d1be48078eac8a7050d8a98bc9edb89/decorator-5.3.1-py3-none-any.whl", hash = "sha256:f47fe6fdbd2edd623ecfe36875d37aba411624e2670dd395dddae1358689bb3c", size = 10365, upload-time = "2026-05-18T06:03:26.517Z" },
+]
+
+[[package]]
+name = "defusedxml"
+version = "0.7.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0f/d5/c66da9b79e5bdb124974bfe172b4daf3c984ebd9c2a06e2b8a4dc7331c72/defusedxml-0.7.1.tar.gz", hash = "sha256:1bb3032db185915b62d7c6209c5a8792be6a32ab2fedacc84e01b52c51aa3e69", size = 75520, upload-time = "2021-03-08T10:59:26.269Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/07/6c/aa3f2f849e01cb6a001cd8554a88d4c77c5c1a31c95bdf1cf9301e6d9ef4/defusedxml-0.7.1-py2.py3-none-any.whl", hash = "sha256:a352e7e428770286cc899e2542b6cdaedb2b4953ff269a210103ec58f6198a61", size = 25604, upload-time = "2021-03-08T10:59:24.45Z" },
+]
+
 [[package]]
 name = "docutils"
 version = "0.21.2"
@@ -242,6 +450,33 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/26/68/51adede38ab2ee9ecfddb8b60a80a42b618a72f1018fcf60974e5d852831/dynaconf-3.2.12-py2.py3-none-any.whl", hash = "sha256:eb2a11865917dff8810c6098cd736b8f4d2f4e39ad914500e2dfbe064b82c499", size = 237788, upload-time = "2025-10-10T19:54:03.731Z" },
 ]
 
+[[package]]
+name = "executing"
+version = "2.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/cc/28/c14e053b6762b1044f34a13aab6859bbf40456d37d23aa286ac24cfd9a5d/executing-2.2.1.tar.gz", hash = "sha256:3632cc370565f6648cc328b32435bd120a1e4ebb20c77e3fdde9a13cd1e533c4", size = 1129488, upload-time = "2025-09-01T09:48:10.866Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c1/ea/53f2148663b321f21b5a606bd5f191517cf40b7072c0497d3c92c4a13b1e/executing-2.2.1-py2.py3-none-any.whl", hash = "sha256:760643d3452b4d777d295bb167ccc74c64a81df23fb5e08eff250c425a4b2017", size = 28317, upload-time = "2025-09-01T09:48:08.5Z" },
+]
+
+[[package]]
+name = "fastjsonschema"
+version = "2.21.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/20/b5/23b216d9d985a956623b6bd12d4086b60f0059b27799f23016af04a74ea1/fastjsonschema-2.21.2.tar.gz", hash = "sha256:b1eb43748041c880796cd077f1a07c3d94e93ae84bba5ed36800a33554ae05de", size = 374130, upload-time = "2025-08-14T18:49:36.666Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/a8/20d0723294217e47de6d9e2e40fd4a9d2f7c4b6ef974babd482a59743694/fastjsonschema-2.21.2-py3-none-any.whl", hash = "sha256:1c797122d0a86c5cace2e54bf4e819c36223b552017172f32c5c024a6b77e463", size = 24024, upload-time = "2025-08-14T18:49:34.776Z" },
+]
+
+[[package]]
+name = "fqdn"
+version = "1.5.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/30/3e/a80a8c077fd798951169626cde3e239adeba7dab75deb3555716415bd9b0/fqdn-1.5.1.tar.gz", hash = "sha256:105ed3677e767fb5ca086a0c1f4bb66ebc3c100be518f0e0d755d9eae164d89f", size = 6015, upload-time = "2021-03-11T07:16:29.08Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cf/58/8acf1b3e91c58313ce5cb67df61001fc9dcd21be4fadb76c1a2d540e09ed/fqdn-1.5.1-py3-none-any.whl", hash = "sha256:3a179af3761e4df6eb2e026ff9e1a3033d3587bf980a0b1b2e1e5d08d7358014", size = 9121, upload-time = "2021-03-11T07:16:28.351Z" },
+]
+
 [[package]]
 name = "furo"
 version = "2025.12.19"
@@ -325,6 +560,43 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/8c/cc/27ba60ad5a5f2067963e6a858743500df408eb5855e98be778eaef8c9b02/grpcio_status-1.76.0-py3-none-any.whl", hash = "sha256:380568794055a8efbbd8871162df92012e0228a5f6dffaf57f2a00c534103b18", size = 14425, upload-time = "2025-10-21T16:28:40.853Z" },
 ]
 
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
 [[package]]
 name = "idna"
 version = "3.11"
@@ -352,6 +624,89 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
 ]
 
+[[package]]
+name = "ipykernel"
+version = "7.3.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "appnope", marker = "sys_platform == 'darwin'" },
+    { name = "comm" },
+    { name = "debugpy" },
+    { name = "ipython" },
+    { name = "jupyter-client" },
+    { name = "jupyter-core" },
+    { name = "matplotlib-inline" },
+    { name = "nest-asyncio2" },
+    { name = "packaging" },
+    { name = "psutil" },
+    { name = "pyzmq" },
+    { name = "tornado" },
+    { name = "traitlets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3d/c4/e4a38f579de4225a561305666f7541cdabb30075def2aa1ac17bd73c1fb5/ipykernel-7.3.0.tar.gz", hash = "sha256:9acaaaf97d16355166e4085afe9d225bfbdf2b7ef520f9df3be8f2b248275e09", size = 184899, upload-time = "2026-06-10T08:41:25.481Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3d/02/77b271f5dc58bfbc0b577c877b2365d1ffea2afe66a80c13f2312820348c/ipykernel-7.3.0-py3-none-any.whl", hash = "sha256:897eb64da762549ef610698fca5e9675195ec6ac8ec7f19d81ce1ca20c876057", size = 120583, upload-time = "2026-06-10T08:41:23.648Z" },
+]
+
+[[package]]
+name = "ipython"
+version = "9.14.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "decorator" },
+    { name = "ipython-pygments-lexers" },
+    { name = "jedi" },
+    { name = "matplotlib-inline" },
+    { name = "pexpect", marker = "sys_platform != 'emscripten' and sys_platform != 'win32'" },
+    { name = "prompt-toolkit" },
+    { name = "psutil", marker = "sys_platform != 'emscripten'" },
+    { name = "pygments" },
+    { name = "stack-data" },
+    { name = "traitlets" },
+    { name = "typing-extensions", marker = "python_full_version < '3.12'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e2/23/3a27530575643c8bb7bfc757a28e2e7ef80092afbf59a2bc5716320b6602/ipython-9.14.1.tar.gz", hash = "sha256:f913bf74df06d458e46ced84ca506c23797590d594b236fe60b14df213291e7b", size = 4433457, upload-time = "2026-06-05T08:12:34.921Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9d/22/58818a63eaf8982b67632b1bc20585c811611b15a8da19d6012323dc76a5/ipython-9.14.1-py3-none-any.whl", hash = "sha256:5d4a9ecaa3b10e6e5f269dd0948bdb58ca9cb851899cd23e07c320d3eb11613c", size = 627770, upload-time = "2026-06-05T08:12:33.045Z" },
+]
+
+[[package]]
+name = "ipython-pygments-lexers"
+version = "1.1.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ef/4c/5dd1d8af08107f88c7f741ead7a40854b8ac24ddf9ae850afbcf698aa552/ipython_pygments_lexers-1.1.1.tar.gz", hash = "sha256:09c0138009e56b6854f9535736f4171d855c8c08a563a0dcd8022f78355c7e81", size = 8393, upload-time = "2025-01-17T11:24:34.505Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d9/33/1f075bf72b0b747cb3288d011319aaf64083cf2efef8354174e3ed4540e2/ipython_pygments_lexers-1.1.1-py3-none-any.whl", hash = "sha256:a9462224a505ade19a605f71f8fa63c2048833ce50abc86768a0d81d876dc81c", size = 8074, upload-time = "2025-01-17T11:24:33.271Z" },
+]
+
+[[package]]
+name = "isoduration"
+version = "20.11.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "arrow" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7c/1a/3c8edc664e06e6bd06cce40c6b22da5f1429aa4224d0c590f3be21c91ead/isoduration-20.11.0.tar.gz", hash = "sha256:ac2f9015137935279eac671f94f89eb00584f940f5dc49462a0c4ee692ba1bd9", size = 11649, upload-time = "2020-11-01T11:00:00.312Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7b/55/e5326141505c5d5e34c5e0935d2908a74e4561eca44108fbfb9c13d2911a/isoduration-20.11.0-py3-none-any.whl", hash = "sha256:b2904c2a4228c3d44f409c8ae8e2370eb21a26f7ac2ec5446df141dde3452042", size = 11321, upload-time = "2020-11-01T10:59:58.02Z" },
+]
+
+[[package]]
+name = "jedi"
+version = "0.20.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "parso" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/46/b7/a3635f6a2d7cf5b5dd98064fc1d5fbbafcb25477bcea204a3a92145d158b/jedi-0.20.0.tar.gz", hash = "sha256:c3f4ccbd276696f4b19c54618d4fb18f9fc24b0aef02acf704b23f487daa1011", size = 3119416, upload-time = "2026-05-01T23:38:47.814Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9a/93/242e2eab5fe682ffcb8b0084bde703a41d51e17ee0f3a31ff0d9d813620a/jedi-0.20.0-py2.py3-none-any.whl", hash = "sha256:7bdd9c2634f56713299976f4cbd59cb3fa92165cc5e05ea811fb253480728b67", size = 4884812, upload-time = "2026-05-01T23:38:43.919Z" },
+]
+
 [[package]]
 name = "jinja2"
 version = "3.1.6"
@@ -364,6 +719,228 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/62/a1/3d680cbfd5f4b8f15abc1d571870c5fc3e594bb582bc3b64ea099db13e56/jinja2-3.1.6-py3-none-any.whl", hash = "sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67", size = 134899, upload-time = "2025-03-05T20:05:00.369Z" },
 ]
 
+[[package]]
+name = "json5"
+version = "0.14.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/9c/4b/6f8906aaf67d501e259b0adab4d312945bb7211e8b8d4dcc77c92320edaa/json5-0.14.0.tar.gz", hash = "sha256:b3f492fad9f6cdbced8b7d40b28b9b1c9701c5f561bef0d33b81c2ff433fefcb", size = 52656, upload-time = "2026-03-27T22:50:48.108Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b8/42/cf027b4ac873b076189d935b135397675dac80cb29acb13e1ab86ad6c631/json5-0.14.0-py3-none-any.whl", hash = "sha256:56cf861bab076b1178eb8c92e1311d273a9b9acea2ccc82c276abf839ebaef3a", size = 36271, upload-time = "2026-03-27T22:50:47.073Z" },
+]
+
+[[package]]
+name = "jsonpointer"
+version = "3.1.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/18/c7/af399a2e7a67fd18d63c40c5e62d3af4e67b836a2107468b6a5ea24c4304/jsonpointer-3.1.1.tar.gz", hash = "sha256:0b801c7db33a904024f6004d526dcc53bbb8a4a0f4e32bfd10beadf60adf1900", size = 9068, upload-time = "2026-03-23T22:32:32.458Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9e/6a/a83720e953b1682d2d109d3c2dbb0bc9bf28cc1cbc205be4ef4be5da709d/jsonpointer-3.1.1-py3-none-any.whl", hash = "sha256:8ff8b95779d071ba472cf5bc913028df06031797532f08a7d5b602d8b2a488ca", size = 7659, upload-time = "2026-03-23T22:32:31.568Z" },
+]
+
+[[package]]
+name = "jsonschema"
+version = "4.26.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "jsonschema-specifications" },
+    { name = "referencing" },
+    { name = "rpds-py" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/69/90/f63fb5873511e014207a475e2bb4e8b2e570d655b00ac19a9a0ca0a385ee/jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce", size = 90630, upload-time = "2026-01-07T13:41:05.306Z" },
+]
+
+[package.optional-dependencies]
+format-nongpl = [
+    { name = "fqdn" },
+    { name = "idna" },
+    { name = "isoduration" },
+    { name = "jsonpointer" },
+    { name = "rfc3339-validator" },
+    { name = "rfc3986-validator" },
+    { name = "rfc3987-syntax" },
+    { name = "uri-template" },
+    { name = "webcolors" },
+]
+
+[[package]]
+name = "jsonschema-specifications"
+version = "2025.9.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "referencing" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" },
+]
+
+[[package]]
+name = "jupyter-client"
+version = "8.9.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "jupyter-core" },
+    { name = "python-dateutil" },
+    { name = "pyzmq" },
+    { name = "tornado" },
+    { name = "traitlets" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7d/dc/5512503b088997c2250b8bf18258fba9d9ce5ead641183700960d3c9d342/jupyter_client-8.9.1.tar.gz", hash = "sha256:a58f730dd9e728ba16ba1d62ebccf7ffe1ebbdbce4e95cfae941b7321ae1f4fa", size = 359256, upload-time = "2026-06-09T13:15:01.033Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3f/6f/56d39bf385c5c27988aebaf0c18a2a17e960575740100973511018bd904e/jupyter_client-8.9.1-py3-none-any.whl", hash = "sha256:0b7a295bc46e8751e9adae84781f726c851c1d911bd793edc4a3bde942e3da81", size = 109828, upload-time = "2026-06-09T13:14:58.835Z" },
+]
+
+[[package]]
+name = "jupyter-core"
+version = "5.9.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "platformdirs" },
+    { name = "traitlets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/02/49/9d1284d0dc65e2c757b74c6687b6d319b02f822ad039e5c512df9194d9dd/jupyter_core-5.9.1.tar.gz", hash = "sha256:4d09aaff303b9566c3ce657f580bd089ff5c91f5f89cf7d8846c3cdf465b5508", size = 89814, upload-time = "2025-10-16T19:19:18.444Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e7/e7/80988e32bf6f73919a113473a604f5a8f09094de312b9d52b79c2df7612b/jupyter_core-5.9.1-py3-none-any.whl", hash = "sha256:ebf87fdc6073d142e114c72c9e29a9d7ca03fad818c5d300ce2adc1fb0743407", size = 29032, upload-time = "2025-10-16T19:19:16.783Z" },
+]
+
+[[package]]
+name = "jupyter-events"
+version = "0.12.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "jsonschema", extra = ["format-nongpl"] },
+    { name = "packaging" },
+    { name = "python-json-logger" },
+    { name = "pyyaml" },
+    { name = "referencing" },
+    { name = "rfc3339-validator" },
+    { name = "rfc3986-validator" },
+    { name = "traitlets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/18/f8/475c4241b2b75af0deaae453ed003c6c851766dbc44d332d8baf245dc931/jupyter_events-0.12.1.tar.gz", hash = "sha256:faff25f77218335752f35f23c5fe6e4a392a7bd99a5939ccb9b8fbf594636cf3", size = 62854, upload-time = "2026-04-20T23:17:50.66Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/eb/6c/6fcde0c8f616ed360ffd3587f7db9e225a7e62b583a04494d2f069cf64ea/jupyter_events-0.12.1-py3-none-any.whl", hash = "sha256:c366585253f537a627da52fa7ca7410c5b5301fe893f511e7b077c2d93ec8bcf", size = 19512, upload-time = "2026-04-20T23:17:48.927Z" },
+]
+
+[[package]]
+name = "jupyter-lsp"
+version = "2.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "jupyter-server" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/36/ff/1e4a61f5170a9a1d978f3ac3872449de6c01fc71eaf89657824c878b1549/jupyter_lsp-2.3.1.tar.gz", hash = "sha256:fdf8a4aa7d85813976d6e29e95e6a2c8f752701f926f2715305249a3829805a6", size = 55677, upload-time = "2026-04-02T08:10:06.749Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/23/e8/9d61dcbd1dce8ef418f06befd4ac084b4720429c26b0b1222bc218685eff/jupyter_lsp-2.3.1-py3-none-any.whl", hash = "sha256:71b954d834e85ff3096400554f2eefaf7fe37053036f9a782b0f7c5e42dadb81", size = 77513, upload-time = "2026-04-02T08:10:01.753Z" },
+]
+
+[[package]]
+name = "jupyter-server"
+version = "2.19.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "argon2-cffi" },
+    { name = "jinja2" },
+    { name = "jupyter-client" },
+    { name = "jupyter-core" },
+    { name = "jupyter-events" },
+    { name = "jupyter-server-terminals" },
+    { name = "nbconvert" },
+    { name = "nbformat" },
+    { name = "overrides", marker = "python_full_version < '3.12'" },
+    { name = "packaging" },
+    { name = "prometheus-client" },
+    { name = "pywinpty", marker = "os_name == 'nt'" },
+    { name = "pyzmq" },
+    { name = "send2trash" },
+    { name = "terminado" },
+    { name = "tornado" },
+    { name = "traitlets" },
+    { name = "websocket-client" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/76/a0/eb3c511f54df7b54ca5fc7bff3f4d2277d69052d6a7f521643dfed5279d6/jupyter_server-2.19.0.tar.gz", hash = "sha256:1731236bc32b680223e1ceb9d68209a845203475012ef68773a81434b46a31a7", size = 754561, upload-time = "2026-05-29T11:21:26.057Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c1/78/d2881e68894cecdcd05912a9c585cfb776ef1fb38b62c8dba98f12ab3adc/jupyter_server-2.19.0-py3-none-any.whl", hash = "sha256:cb76591b76d7093584c2ad2ae72ac3d58614a4b597507a1bb04e1f9f683cf9ea", size = 392244, upload-time = "2026-05-29T11:21:23.871Z" },
+]
+
+[[package]]
+name = "jupyter-server-terminals"
+version = "0.5.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pywinpty", marker = "os_name == 'nt'" },
+    { name = "terminado" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f4/a7/bcd0a9b0cbba88986fe944aaaf91bfda603e5a50bda8ed15123f381a3b2f/jupyter_server_terminals-0.5.4.tar.gz", hash = "sha256:bbda128ed41d0be9020349f9f1f2a4ab9952a73ed5f5ac9f1419794761fb87f5", size = 31770, upload-time = "2026-01-14T16:53:20.213Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/2d/6674563f71c6320841fc300911a55143925112a72a883e2ca71fba4c618d/jupyter_server_terminals-0.5.4-py3-none-any.whl", hash = "sha256:55be353fc74a80bc7f3b20e6be50a55a61cd525626f578dcb66a5708e2007d14", size = 13704, upload-time = "2026-01-14T16:53:18.738Z" },
+]
+
+[[package]]
+name = "jupyterlab"
+version = "4.5.8"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "async-lru" },
+    { name = "httpx" },
+    { name = "ipykernel" },
+    { name = "jinja2" },
+    { name = "jupyter-core" },
+    { name = "jupyter-lsp" },
+    { name = "jupyter-server" },
+    { name = "jupyterlab-server" },
+    { name = "notebook-shim" },
+    { name = "packaging" },
+    { name = "setuptools" },
+    { name = "tornado" },
+    { name = "traitlets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/0e/74/089613e6099e851a6130816f2df592c839d8565f8746a701edada05a33e4/jupyterlab-4.5.8.tar.gz", hash = "sha256:af54d7242cc689a1e6c3ad213cc9b6d9781787d9ec67c52ec9a8f4707088cadd", size = 23994076, upload-time = "2026-06-04T12:32:12.906Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c9/d1/56a400100559cbf154a23cd29989261941ae5c9f743898fc10e8a5508b7c/jupyterlab-4.5.8-py3-none-any.whl", hash = "sha256:7d514c856d0d607601ec7692374da4f26e2aaf3b6e7cd363136b422a50588d6c", size = 12449443, upload-time = "2026-06-04T12:32:08.442Z" },
+]
+
+[[package]]
+name = "jupyterlab-pygments"
+version = "0.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/90/51/9187be60d989df97f5f0aba133fa54e7300f17616e065d1ada7d7646b6d6/jupyterlab_pygments-0.3.0.tar.gz", hash = "sha256:721aca4d9029252b11cfa9d185e5b5af4d54772bb8072f9b7036f4170054d35d", size = 512900, upload-time = "2023-11-23T09:26:37.44Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b1/dd/ead9d8ea85bf202d90cc513b533f9c363121c7792674f78e0d8a854b63b4/jupyterlab_pygments-0.3.0-py3-none-any.whl", hash = "sha256:841a89020971da1d8693f1a99997aefc5dc424bb1b251fd6322462a1b8842780", size = 15884, upload-time = "2023-11-23T09:26:34.325Z" },
+]
+
+[[package]]
+name = "jupyterlab-server"
+version = "2.28.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "babel" },
+    { name = "jinja2" },
+    { name = "json5" },
+    { name = "jsonschema" },
+    { name = "jupyter-server" },
+    { name = "packaging" },
+    { name = "requests" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d6/2c/90153f189e421e93c4bb4f9e3f59802a1f01abd2ac5cf40b152d7f735232/jupyterlab_server-2.28.0.tar.gz", hash = "sha256:35baa81898b15f93573e2deca50d11ac0ae407ebb688299d3a5213265033712c", size = 76996, upload-time = "2025-10-22T13:59:18.37Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e0/07/a000fe835f76b7e1143242ab1122e6362ef1c03f23f83a045c38859c2ae0/jupyterlab_server-2.28.0-py3-none-any.whl", hash = "sha256:e4355b148fdcf34d312bbbc80f22467d6d20460e8b8736bf235577dd18506968", size = 59830, upload-time = "2025-10-22T13:59:16.767Z" },
+]
+
+[[package]]
+name = "lark"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/da/34/28fff3ab31ccff1fd4f6c7c7b0ceb2b6968d8ea4950663eadcb5720591a0/lark-1.3.1.tar.gz", hash = "sha256:b426a7a6d6d53189d318f2b6236ab5d6429eaf09259f1ca33eb716eed10d2905", size = 382732, upload-time = "2025-10-27T18:25:56.653Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/82/3d/14ce75ef66813643812f3093ab17e46d3a206942ce7376d31ec2d36229e7/lark-1.3.1-py3-none-any.whl", hash = "sha256:c629b661023a014c37da873b4ff58a817398d12635d3bbb2c5a03be7fe5d1e12", size = 113151, upload-time = "2025-10-27T18:25:54.882Z" },
+]
+
 [[package]]
 name = "lockfile"
 version = "0.12.2"
@@ -450,6 +1027,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/0e/72/e3cc540f351f316e9ed0f092757459afbc595824ca724cbc5a5d4263713f/markupsafe-3.0.3-cp313-cp313t-win_arm64.whl", hash = "sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287", size = 13973, upload-time = "2025-09-27T18:37:04.929Z" },
 ]
 
+[[package]]
+name = "matplotlib-inline"
+version = "0.2.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "traitlets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/bd/c0/9f7c9a46090390368a4d7bcb76bb87a4a36c421e4c0792cdb53486ffac7a/matplotlib_inline-0.2.2.tar.gz", hash = "sha256:72f3fe8fce36b70d4a5b612f899090cd0401deddc4ea90e1572b9f4bfb058c79", size = 8150, upload-time = "2026-05-08T17:33:33.49Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/41/09/5b161152e2d90f7b87f781c2e1267494aef9c32498df793f73ad0a0a494a/matplotlib_inline-0.2.2-py3-none-any.whl", hash = "sha256:3c821cf1c209f59fb2d2d64abbf5b23b67bcb2210d663f9918dd851c6da1fcf6", size = 9534, upload-time = "2026-05-08T17:33:32.055Z" },
+]
+
 [[package]]
 name = "mdit-py-plugins"
 version = "0.5.0"
@@ -471,6 +1060,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
 ]
 
+[[package]]
+name = "mistune"
+version = "3.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ca/84/620cc3f7e3adf6f5067e10f4dbae71295d8f9e16d5d3f9ef97c40f2f592c/mistune-3.2.1.tar.gz", hash = "sha256:7c8e5501d38bac1582e067e46c8343f17d57ea1aaa735823f3aba1fd59c88a28", size = 98003, upload-time = "2026-05-03T14:33:22.312Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/7f/a946aa4f8752b37102b41e64dca18a1976ac705c3a0d1dfe74d820a02552/mistune-3.2.1-py3-none-any.whl", hash = "sha256:78cdb0ba5e938053ccf63651b352508d2efa9411dc8810bfb05f2dc5140c0048", size = 53749, upload-time = "2026-05-03T14:33:20.551Z" },
+]
+
 [[package]]
 name = "myst-parser"
 version = "4.0.1"
@@ -488,6 +1086,98 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/5f/df/76d0321c3797b54b60fef9ec3bd6f4cfd124b9e422182156a1dd418722cf/myst_parser-4.0.1-py3-none-any.whl", hash = "sha256:9134e88959ec3b5780aedf8a99680ea242869d012e8821db3126d427edc9c95d", size = 84579, upload-time = "2025-02-12T10:53:02.078Z" },
 ]
 
+[[package]]
+name = "nbclient"
+version = "0.11.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "jupyter-client" },
+    { name = "jupyter-core" },
+    { name = "nbformat" },
+    { name = "traitlets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/28/a5/b3bae4b590c0cbcada2c63a34f7580024e834a8ba213e949a2f906705787/nbclient-0.11.0.tar.gz", hash = "sha256:04a134a5b087f2c5887f228aca155db50169b8cd9334dee6942c8e927e56081a", size = 62535, upload-time = "2026-06-05T07:52:41.746Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/36/c9/94d73e5a01c5b926c3fa2496e97d7a8dc28ed5a77c0b2ed712f1a62e6694/nbclient-0.11.0-py3-none-any.whl", hash = "sha256:ef7fa0d59d6e1d41103933d8a445a18d5de860ca6b613b87b8574accdb3c2895", size = 25288, upload-time = "2026-06-05T07:52:40.115Z" },
+]
+
+[[package]]
+name = "nbconvert"
+version = "7.17.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "beautifulsoup4" },
+    { name = "bleach", extra = ["css"] },
+    { name = "defusedxml" },
+    { name = "jinja2" },
+    { name = "jupyter-core" },
+    { name = "jupyterlab-pygments" },
+    { name = "markupsafe" },
+    { name = "mistune" },
+    { name = "nbclient" },
+    { name = "nbformat" },
+    { name = "packaging" },
+    { name = "pandocfilters" },
+    { name = "pygments" },
+    { name = "traitlets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/01/b1/708e53fe2e429c103c6e6e159106bcf0357ac41aa4c28772bd8402339051/nbconvert-7.17.1.tar.gz", hash = "sha256:34d0d0a7e73ce3cbab6c5aae8f4f468797280b01fd8bd2ca746da8569eddd7d2", size = 865311, upload-time = "2026-04-08T00:44:14.914Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/67/f8/bb0a9d5f46819c821dc1f004aa2cc29b1d91453297dbf5ff20470f00f193/nbconvert-7.17.1-py3-none-any.whl", hash = "sha256:aa85c087b435e7bf1ffd03319f658e285f2b89eccab33bc1ba7025495ab3e7c8", size = 261927, upload-time = "2026-04-08T00:44:12.845Z" },
+]
+
+[[package]]
+name = "nbformat"
+version = "5.10.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "fastjsonschema" },
+    { name = "jsonschema" },
+    { name = "jupyter-core" },
+    { name = "traitlets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/6d/fd/91545e604bc3dad7dca9ed03284086039b294c6b3d75c0d2fa45f9e9caf3/nbformat-5.10.4.tar.gz", hash = "sha256:322168b14f937a5d11362988ecac2a4952d3d8e3a2cbeb2319584631226d5b3a", size = 142749, upload-time = "2024-04-04T11:20:37.371Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a9/82/0340caa499416c78e5d8f5f05947ae4bc3cba53c9f038ab6e9ed964e22f1/nbformat-5.10.4-py3-none-any.whl", hash = "sha256:3b48d6c8fbca4b299bf3982ea7db1af21580e4fec269ad087b9e81588891200b", size = 78454, upload-time = "2024-04-04T11:20:34.895Z" },
+]
+
+[[package]]
+name = "nest-asyncio2"
+version = "1.7.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b4/73/731debf26e27e0a0323d7bda270dc2f634b398e38f040a09da1f4351d0aa/nest_asyncio2-1.7.2.tar.gz", hash = "sha256:1921d70b92cc4612c374928d081552efb59b83d91b2b789d935c665fa01729a8", size = 14743, upload-time = "2026-02-13T00:34:04.386Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c5/3c/3179b85b0e1c3659f0369940200cd6d0fa900e6cefcc7ea0bc6dd0e29ffb/nest_asyncio2-1.7.2-py3-none-any.whl", hash = "sha256:f5dfa702f3f81f6a03857e9a19e2ba578c0946a4ad417b4c50a24d7ba641fe01", size = 7843, upload-time = "2026-02-13T00:34:02.691Z" },
+]
+
+[[package]]
+name = "notebook"
+version = "7.5.7"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "jupyter-server" },
+    { name = "jupyterlab" },
+    { name = "jupyterlab-server" },
+    { name = "notebook-shim" },
+    { name = "tornado" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3e/c4/f71f8716f2903e9e817a47f534b9fd84831e155e2acb32c26691c8e06243/notebook-7.5.7.tar.gz", hash = "sha256:d6d59288a25303b25e1dcb71e9b017ec3a785f7d92f38b9bc288ca1970d5b0a8", size = 14171612, upload-time = "2026-06-04T18:33:45.224Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e1/4d/b3347f7073a377273531efe4ffc738fc910e93718fd2838c7ebf6736c6af/notebook-7.5.7-py3-none-any.whl", hash = "sha256:1f95f79d117e47d20b5555b5c85a397d2cfecf136978aaab767cf0314b09165b", size = 14583767, upload-time = "2026-06-04T18:33:40.987Z" },
+]
+
+[[package]]
+name = "notebook-shim"
+version = "0.2.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "jupyter-server" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/54/d2/92fa3243712b9a3e8bafaf60aac366da1cada3639ca767ff4b5b3654ec28/notebook_shim-0.2.4.tar.gz", hash = "sha256:b4b2cfa1b65d98307ca24361f5b30fe785b53c3fd07b7a47e89acb5e6ac638cb", size = 13167, upload-time = "2024-02-14T23:35:18.353Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f9/33/bd5b9137445ea4b680023eb0469b2bb969d61303dedb2aac6560ff3d14a1/notebook_shim-0.2.4-py3-none-any.whl", hash = "sha256:411a5be4e9dc882a074ccbcae671eda64cceb068767e9a3419096986560e1cef", size = 13307, upload-time = "2024-02-14T23:35:16.286Z" },
+]
+
 [[package]]
 name = "numpy"
 version = "2.4.1"
@@ -546,6 +1236,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/5b/c7/b801bf98514b6ae6475e941ac05c58e6411dd863ea92916bfd6d510b08c1/numpy-2.4.1-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:4f1b68ff47680c2925f8063402a693ede215f0257f02596b1318ecdfb1d79e33", size = 12492579, upload-time = "2026-01-10T06:44:57.094Z" },
 ]
 
+[[package]]
+name = "overrides"
+version = "7.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/36/86/b585f53236dec60aba864e050778b25045f857e17f6e5ea0ae95fe80edd2/overrides-7.7.0.tar.gz", hash = "sha256:55158fa3d93b98cc75299b1e67078ad9003ca27945c76162c1c0766d6f91820a", size = 22812, upload-time = "2024-01-27T21:01:33.423Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/ab/fc8290c6a4c722e5514d80f62b2dc4c4df1a68a41d1364e625c35990fcf3/overrides-7.7.0-py3-none-any.whl", hash = "sha256:c7ed9d062f78b8e4c1a7b70bd8796b35ead4d9f510227ef9c5dc7626c60d7e49", size = 17832, upload-time = "2024-01-27T21:01:31.393Z" },
+]
+
 [[package]]
 name = "packaging"
 version = "25.0"
@@ -596,6 +1295,45 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/bd/17/e756653095a083d8a37cbd816cb87148debcfcd920129b25f99dd8d04271/pandas-2.3.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:c4fc4c21971a1a9f4bdb4c73978c7f7256caa3e62b323f70d6cb80db583350bc", size = 13199233, upload-time = "2025-09-29T23:24:24.876Z" },
 ]
 
+[[package]]
+name = "pandocfilters"
+version = "1.5.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/70/6f/3dd4940bbe001c06a65f88e36bad298bc7a0de5036115639926b0c5c0458/pandocfilters-1.5.1.tar.gz", hash = "sha256:002b4a555ee4ebc03f8b66307e287fa492e4a77b4ea14d3f934328297bb4939e", size = 8454, upload-time = "2024-01-18T20:08:13.726Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ef/af/4fbc8cab944db5d21b7e2a5b8e9211a03a79852b1157e2c102fcc61ac440/pandocfilters-1.5.1-py2.py3-none-any.whl", hash = "sha256:93be382804a9cdb0a7267585f157e5d1731bbe5545a85b268d6f5fe6232de2bc", size = 8663, upload-time = "2024-01-18T20:08:11.28Z" },
+]
+
+[[package]]
+name = "parso"
+version = "0.8.7"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/30/4b/90c937815137d43ce71ba043cd3566221e9df6b9c805f24b5d138c9d40a7/parso-0.8.7.tar.gz", hash = "sha256:eaaac4c9fdd5e9e8852dc778d2d7405897ec510f2a298071453e5e3a07914bb1", size = 401824, upload-time = "2026-05-01T23:13:02.138Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/99/5d/8268b644392ee874ee82a635cd0df1773de230bde356c38de28e298392cc/parso-0.8.7-py2.py3-none-any.whl", hash = "sha256:a8926eb2a1b915486941fdbd31e86a4baf88fe8c210f25f2f35ecec5b574ca1c", size = 107025, upload-time = "2026-05-01T23:12:58.867Z" },
+]
+
+[[package]]
+name = "pexpect"
+version = "4.9.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "ptyprocess" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/42/92/cc564bf6381ff43ce1f4d06852fc19a2f11d180f23dc32d9588bee2f149d/pexpect-4.9.0.tar.gz", hash = "sha256:ee7d41123f3c9911050ea2c2dac107568dc43b2d3b0c7557a33212c398ead30f", size = 166450, upload-time = "2023-11-25T09:07:26.339Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9e/c3/059298687310d527a58bb01f3b1965787ee3b40dce76752eda8b44e9a2c5/pexpect-4.9.0-py2.py3-none-any.whl", hash = "sha256:7236d1e080e4936be2dc3e326cec0af72acf9212a7e1d060210e70a47e253523", size = 63772, upload-time = "2023-11-25T06:56:14.81Z" },
+]
+
+[[package]]
+name = "platformdirs"
+version = "4.10.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d7/47/e4501f49c178ae1d9f4a75073fda4204f52647993f075a9db4d14930e0c5/platformdirs-4.10.0.tar.gz", hash = "sha256:31e761a6a0ca04faf7353ea759bdba55652be214725111e5aac52dfa29d4bef7", size = 31224, upload-time = "2026-05-28T03:32:53.587Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/81/e6/cd9575ac904136b3cbf7aa7ee819ef86eedb7274e46f230e94ea4342e729/platformdirs-4.10.0-py3-none-any.whl", hash = "sha256:fb516cdb12eb0d857d0cd85a7c57cea4d060bee4578d6cf5a14dfdf8cbf8784a", size = 22743, upload-time = "2026-05-28T03:32:52.175Z" },
+]
+
 [[package]]
 name = "plotly"
 version = "5.24.1"
@@ -642,6 +1380,27 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/25/63/3586226d536796e65f8e725b531d6104e55caaa18659bdcb512661629586/prek-0.4.4-py3-none-win_arm64.whl", hash = "sha256:3efa28fb37b9ddbafb7759da8d497f0d36cf02a05816e15d6541f5669d5d2114", size = 5470399, upload-time = "2026-06-04T07:26:13.231Z" },
 ]
 
+[[package]]
+name = "prometheus-client"
+version = "0.25.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1b/fb/d9aa83ffe43ce1f19e557c0971d04b90561b0cfd50762aafb01968285553/prometheus_client-0.25.0.tar.gz", hash = "sha256:5e373b75c31afb3c86f1a52fa1ad470c9aace18082d39ec0d2f918d11cc9ba28", size = 86035, upload-time = "2026-04-09T19:53:42.359Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8d/9b/d4b1e644385499c8346fa9b622a3f030dce14cd6ef8a1871c221a17a67e7/prometheus_client-0.25.0-py3-none-any.whl", hash = "sha256:d5aec89e349a6ec230805d0df882f3807f74fd6c1a2fa86864e3c2279059fed1", size = 64154, upload-time = "2026-04-09T19:53:41.324Z" },
+]
+
+[[package]]
+name = "prompt-toolkit"
+version = "3.0.52"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "wcwidth" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a1/96/06e01a7b38dce6fe1db213e061a4602dd6032a8a97ef6c1a862537732421/prompt_toolkit-3.0.52.tar.gz", hash = "sha256:28cde192929c8e7321de85de1ddbe736f1375148b02f2e17edd840042b1be855", size = 434198, upload-time = "2025-08-27T15:24:02.057Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/84/03/0d3ce49e2505ae70cf43bc5bb3033955d2fc9f932163e84dc0779cc47f48/prompt_toolkit-3.0.52-py3-none-any.whl", hash = "sha256:9aac639a3bbd33284347de5ad8d68ecc044b91a762dc39b7c21095fcd6a19955", size = 391431, upload-time = "2025-08-27T15:23:59.498Z" },
+]
+
 [[package]]
 name = "protobuf"
 version = "6.33.3"
@@ -679,6 +1438,24 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/3e/73/2ce007f4198c80fcf2cb24c169884f833fe93fbc03d55d302627b094ee91/psutil-7.2.1-cp37-abi3-win_arm64.whl", hash = "sha256:0d67c1822c355aa6f7314d92018fb4268a76668a536f133599b91edd48759442", size = 133836, upload-time = "2025-12-29T08:26:43.086Z" },
 ]
 
+[[package]]
+name = "ptyprocess"
+version = "0.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/20/e5/16ff212c1e452235a90aeb09066144d0c5a6a8c0834397e03f5224495c4e/ptyprocess-0.7.0.tar.gz", hash = "sha256:5c5d0a3b48ceee0b48485e0c26037c0acd7d29765ca3fbb5cb3831d347423220", size = 70762, upload-time = "2020-12-28T15:15:30.155Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/22/a6/858897256d0deac81a172289110f31629fc4cee19b6f01283303e18c8db3/ptyprocess-0.7.0-py2.py3-none-any.whl", hash = "sha256:4b41f3967fce3af57cc7e94b888626c18bf37a083e3651ca8feeb66d492fef35", size = 13993, upload-time = "2020-12-28T15:15:28.35Z" },
+]
+
+[[package]]
+name = "pure-eval"
+version = "0.2.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/cd/05/0a34433a064256a578f1783a10da6df098ceaa4a57bbeaa96a6c0352786b/pure_eval-0.2.3.tar.gz", hash = "sha256:5f4e983f40564c576c7c8635ae88db5956bb2229d7e9237d03b3c0b0190eaf42", size = 19752, upload-time = "2024-07-21T12:58:21.801Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8e/37/efad0257dc6e593a18957422533ff0f87ede7c9c6ea010a2177d738fb82f/pure_eval-0.2.3-py3-none-any.whl", hash = "sha256:1db8e35b67b3d218d818ae653e27f06c3aa420901fa7b081ca98cbedc874e0d0", size = 11842, upload-time = "2024-07-21T12:58:20.04Z" },
+]
+
 [[package]]
 name = "py4j"
 version = "0.10.9.9"
@@ -724,6 +1501,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/60/ae/b5a5811e11f25788ccfdaa8f26b6791c9807119dffcf80514505527c384c/pyarrow-22.0.0-cp313-cp313t-win_amd64.whl", hash = "sha256:bba208d9c7decf9961998edf5c65e3ea4355d5818dd6cd0f6809bec1afb951cc", size = 28262504, upload-time = "2025-10-24T10:08:00.932Z" },
 ]
 
+[[package]]
+name = "pycparser"
+version = "3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1b/7d/92392ff7815c21062bea51aa7b87d45576f649f16458d78b7cf94b9ab2e6/pycparser-3.0.tar.gz", hash = "sha256:600f49d217304a5902ac3c37e1281c9fe94e4d0489de643a9504c5cdfdfc6b29", size = 103492, upload-time = "2026-01-21T14:26:51.89Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0c/c3/44f3fbbfa403ea2a7c779186dc20772604442dde72947e7d01069cbe98e3/pycparser-3.0-py3-none-any.whl", hash = "sha256:b727414169a36b7d524c1c3e31839a521725078d7b2ff038656844266160a992", size = 48172, upload-time = "2026-01-21T14:26:50.693Z" },
+]
+
 [[package]]
 name = "pydantic"
 version = "2.12.5"
@@ -919,6 +1705,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/14/1b/a298b06749107c305e1fe0f814c6c74aea7b2f1e10989cb30f544a1b3253/python_dotenv-1.2.1-py3-none-any.whl", hash = "sha256:b81ee9561e9ca4004139c6cbba3a238c32b03e4894671e181b671e8cb8425d61", size = 21230, upload-time = "2025-10-26T15:12:09.109Z" },
 ]
 
+[[package]]
+name = "python-json-logger"
+version = "4.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f7/ff/3cc9165fd44106973cd7ac9facb674a65ed853494592541d339bdc9a30eb/python_json_logger-4.1.0.tar.gz", hash = "sha256:b396b9e3ed782b09ff9d6e4f1683d46c83ad0d35d2e407c09a9ebbf038f88195", size = 17573, upload-time = "2026-03-29T04:39:56.805Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/27/be/0631a861af4d1c875f096c07d34e9a63639560a717130e7a87cbc82b7e3f/python_json_logger-4.1.0-py3-none-any.whl", hash = "sha256:132994765cf75bf44554be9aa49b06ef2345d23661a96720262716438141b6b2", size = 15021, upload-time = "2026-03-29T04:39:55.266Z" },
+]
+
 [[package]]
 name = "pytz"
 version = "2025.2"
@@ -928,6 +1723,22 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/81/c4/34e93fe5f5429d7570ec1fa436f1986fb1f00c3e0f43a589fe2bbcd22c3f/pytz-2025.2-py2.py3-none-any.whl", hash = "sha256:5ddf76296dd8c44c26eb8f4b6f35488f3ccbf6fbbd7adee0b7262d43f0ec2f00", size = 509225, upload-time = "2025-03-25T02:24:58.468Z" },
 ]
 
+[[package]]
+name = "pywinpty"
+version = "3.0.5"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a9/ef/2d27f30c59a67be7025b2d7858c8c2d282b74d66544b2384730b82de74fd/pywinpty-3.0.5.tar.gz", hash = "sha256:61db0db063de9865adbea66db294628f8577f608d9764a4c7d3384eeacc4e81b", size = 16223484, upload-time = "2026-06-11T00:11:58.93Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b0/5c/31feb3dd82d1b33ae0bd09ca601edb993d9da1b7f0226b3336d4b4c39e1e/pywinpty-3.0.5-cp311-cp311-win_amd64.whl", hash = "sha256:af7a8720c78776ddd6259b71dd567944f766a6cd67f8d2887fbc4973967bacda", size = 2092466, upload-time = "2026-06-10T23:44:24.453Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/fe/fe23e2229ffec0c10190cef5964f5c9b2dba179d23b69ae537b7ea90bcab/pywinpty-3.0.5-cp311-cp311-win_arm64.whl", hash = "sha256:c2406f54f699eab75953fb75ce805f2ae55a33a957cd070890abd454fb4b7680", size = 818395, upload-time = "2026-06-10T23:41:56.93Z" },
+    { url = "https://files.pythonhosted.org/packages/45/34/942cc95ca4e26489875aa8a95192766247a687379ec29543eebe73ec945f/pywinpty-3.0.5-cp312-cp312-win_amd64.whl", hash = "sha256:d62946adf14b15b54c0b8d785f93fe18b04da23f4ad59e2e8c4612646e9abd23", size = 2090915, upload-time = "2026-06-10T23:43:14.98Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/70/5b9053004844139ea8bd86209c57ade12b134b2782f383a095784c8531ec/pywinpty-3.0.5-cp312-cp312-win_arm64.whl", hash = "sha256:e9391c05fbfa7a992a97e831fc6849887b4014a614192e3d984a7ca59592b376", size = 815934, upload-time = "2026-06-10T23:41:42.384Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/f4/2a464b9893cceb3b3f416356e94fdc3e1bca9476993927e4e6d99fe95382/pywinpty-3.0.5-cp313-cp313-win_amd64.whl", hash = "sha256:48db1b0ad9d0a1b81dcaaa7163a99a7808deaceb0c1b2344716dc1fc090c3c4c", size = 2090471, upload-time = "2026-06-10T23:42:11.071Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/2c/a138491a0afbdb50eb79395577bd326d4b0fbde7209417d1a8087ff2493a/pywinpty-3.0.5-cp313-cp313-win_arm64.whl", hash = "sha256:2c6008fb2d3774b48693b2fcb7f2cc317ade9dc581289a964ffeeaf81307c9b5", size = 815518, upload-time = "2026-06-10T23:42:02.363Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/15/54400049a380582acd1282665c70fcf11e0bd3713679aca78e24c3aae738/pywinpty-3.0.5-cp313-cp313t-win_amd64.whl", hash = "sha256:22ce1b780d89821cc52daf6eac0708af22d93d000ce9c7c07e37489db8594598", size = 2089920, upload-time = "2026-06-10T23:44:13.395Z" },
+    { url = "https://files.pythonhosted.org/packages/94/0c/6f24f3c0799f502259b24bdf841a99ad2b0d59df5c2525b4e2a286d14be2/pywinpty-3.0.5-cp313-cp313t-win_arm64.whl", hash = "sha256:9c2919a81bc5cfb09b86fc5a002112b2de95ca4304a07413cbeeb746a1307a5c", size = 814520, upload-time = "2026-06-10T23:43:28.588Z" },
+]
+
 [[package]]
 name = "pyyaml"
 version = "6.0.3"
@@ -965,6 +1776,68 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" },
 ]
 
+[[package]]
+name = "pyzmq"
+version = "27.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cffi", marker = "implementation_name == 'pypy'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/04/0b/3c9baedbdf613ecaa7aa07027780b8867f57b6293b6ee50de316c9f3222b/pyzmq-27.1.0.tar.gz", hash = "sha256:ac0765e3d44455adb6ddbf4417dcce460fc40a05978c08efdf2948072f6db540", size = 281750, upload-time = "2025-09-08T23:10:18.157Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/06/5d/305323ba86b284e6fcb0d842d6adaa2999035f70f8c38a9b6d21ad28c3d4/pyzmq-27.1.0-cp311-cp311-macosx_10_15_universal2.whl", hash = "sha256:226b091818d461a3bef763805e75685e478ac17e9008f49fce2d3e52b3d58b86", size = 1333328, upload-time = "2025-09-08T23:07:45.946Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/a0/fc7e78a23748ad5443ac3275943457e8452da67fda347e05260261108cbc/pyzmq-27.1.0-cp311-cp311-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:0790a0161c281ca9723f804871b4027f2e8b5a528d357c8952d08cd1a9c15581", size = 908803, upload-time = "2025-09-08T23:07:47.551Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/22/37d15eb05f3bdfa4abea6f6d96eb3bb58585fbd3e4e0ded4e743bc650c97/pyzmq-27.1.0-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c895a6f35476b0c3a54e3eb6ccf41bf3018de937016e6e18748317f25d4e925f", size = 668836, upload-time = "2025-09-08T23:07:49.436Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/c4/2a6fe5111a01005fc7af3878259ce17684fabb8852815eda6225620f3c59/pyzmq-27.1.0-cp311-cp311-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5bbf8d3630bf96550b3be8e1fc0fea5cbdc8d5466c1192887bd94869da17a63e", size = 857038, upload-time = "2025-09-08T23:07:51.234Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/eb/bfdcb41d0db9cd233d6fb22dc131583774135505ada800ebf14dfb0a7c40/pyzmq-27.1.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:15c8bd0fe0dabf808e2d7a681398c4e5ded70a551ab47482067a572c054c8e2e", size = 1657531, upload-time = "2025-09-08T23:07:52.795Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/21/e3180ca269ed4a0de5c34417dfe71a8ae80421198be83ee619a8a485b0c7/pyzmq-27.1.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:bafcb3dd171b4ae9f19ee6380dfc71ce0390fefaf26b504c0e5f628d7c8c54f2", size = 2034786, upload-time = "2025-09-08T23:07:55.047Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/b1/5e21d0b517434b7f33588ff76c177c5a167858cc38ef740608898cd329f2/pyzmq-27.1.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:e829529fcaa09937189178115c49c504e69289abd39967cd8a4c215761373394", size = 1894220, upload-time = "2025-09-08T23:07:57.172Z" },
+    { url = "https://files.pythonhosted.org/packages/03/f2/44913a6ff6941905efc24a1acf3d3cb6146b636c546c7406c38c49c403d4/pyzmq-27.1.0-cp311-cp311-win32.whl", hash = "sha256:6df079c47d5902af6db298ec92151db82ecb557af663098b92f2508c398bb54f", size = 567155, upload-time = "2025-09-08T23:07:59.05Z" },
+    { url = "https://files.pythonhosted.org/packages/23/6d/d8d92a0eb270a925c9b4dd039c0b4dc10abc2fcbc48331788824ef113935/pyzmq-27.1.0-cp311-cp311-win_amd64.whl", hash = "sha256:190cbf120fbc0fc4957b56866830def56628934a9d112aec0e2507aa6a032b97", size = 633428, upload-time = "2025-09-08T23:08:00.663Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/14/01afebc96c5abbbd713ecfc7469cfb1bc801c819a74ed5c9fad9a48801cb/pyzmq-27.1.0-cp311-cp311-win_arm64.whl", hash = "sha256:eca6b47df11a132d1745eb3b5b5e557a7dae2c303277aa0e69c6ba91b8736e07", size = 559497, upload-time = "2025-09-08T23:08:02.15Z" },
+    { url = "https://files.pythonhosted.org/packages/92/e7/038aab64a946d535901103da16b953c8c9cc9c961dadcbf3609ed6428d23/pyzmq-27.1.0-cp312-abi3-macosx_10_15_universal2.whl", hash = "sha256:452631b640340c928fa343801b0d07eb0c3789a5ffa843f6e1a9cee0ba4eb4fc", size = 1306279, upload-time = "2025-09-08T23:08:03.807Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/5e/c3c49fdd0f535ef45eefcc16934648e9e59dace4a37ee88fc53f6cd8e641/pyzmq-27.1.0-cp312-abi3-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:1c179799b118e554b66da67d88ed66cd37a169f1f23b5d9f0a231b4e8d44a113", size = 895645, upload-time = "2025-09-08T23:08:05.301Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/e5/b0b2504cb4e903a74dcf1ebae157f9e20ebb6ea76095f6cfffea28c42ecd/pyzmq-27.1.0-cp312-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3837439b7f99e60312f0c926a6ad437b067356dc2bc2ec96eb395fd0fe804233", size = 652574, upload-time = "2025-09-08T23:08:06.828Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/9b/c108cdb55560eaf253f0cbdb61b29971e9fb34d9c3499b0e96e4e60ed8a5/pyzmq-27.1.0-cp312-abi3-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:43ad9a73e3da1fab5b0e7e13402f0b2fb934ae1c876c51d0afff0e7c052eca31", size = 840995, upload-time = "2025-09-08T23:08:08.396Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/bb/b79798ca177b9eb0825b4c9998c6af8cd2a7f15a6a1a4272c1d1a21d382f/pyzmq-27.1.0-cp312-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:0de3028d69d4cdc475bfe47a6128eb38d8bc0e8f4d69646adfbcd840facbac28", size = 1642070, upload-time = "2025-09-08T23:08:09.989Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/80/2df2e7977c4ede24c79ae39dcef3899bfc5f34d1ca7a5b24f182c9b7a9ca/pyzmq-27.1.0-cp312-abi3-musllinux_1_2_i686.whl", hash = "sha256:cf44a7763aea9298c0aa7dbf859f87ed7012de8bda0f3977b6fb1d96745df856", size = 2021121, upload-time = "2025-09-08T23:08:11.907Z" },
+    { url = "https://files.pythonhosted.org/packages/46/bd/2d45ad24f5f5ae7e8d01525eb76786fa7557136555cac7d929880519e33a/pyzmq-27.1.0-cp312-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:f30f395a9e6fbca195400ce833c731e7b64c3919aa481af4d88c3759e0cb7496", size = 1878550, upload-time = "2025-09-08T23:08:13.513Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/2f/104c0a3c778d7c2ab8190e9db4f62f0b6957b53c9d87db77c284b69f33ea/pyzmq-27.1.0-cp312-abi3-win32.whl", hash = "sha256:250e5436a4ba13885494412b3da5d518cd0d3a278a1ae640e113c073a5f88edd", size = 559184, upload-time = "2025-09-08T23:08:15.163Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/7f/a21b20d577e4100c6a41795842028235998a643b1ad406a6d4163ea8f53e/pyzmq-27.1.0-cp312-abi3-win_amd64.whl", hash = "sha256:9ce490cf1d2ca2ad84733aa1d69ce6855372cb5ce9223802450c9b2a7cba0ccf", size = 619480, upload-time = "2025-09-08T23:08:17.192Z" },
+    { url = "https://files.pythonhosted.org/packages/78/c2/c012beae5f76b72f007a9e91ee9401cb88c51d0f83c6257a03e785c81cc2/pyzmq-27.1.0-cp312-abi3-win_arm64.whl", hash = "sha256:75a2f36223f0d535a0c919e23615fc85a1e23b71f40c7eb43d7b1dedb4d8f15f", size = 552993, upload-time = "2025-09-08T23:08:18.926Z" },
+    { url = "https://files.pythonhosted.org/packages/60/cb/84a13459c51da6cec1b7b1dc1a47e6db6da50b77ad7fd9c145842750a011/pyzmq-27.1.0-cp313-cp313-android_24_arm64_v8a.whl", hash = "sha256:93ad4b0855a664229559e45c8d23797ceac03183c7b6f5b4428152a6b06684a5", size = 1122436, upload-time = "2025-09-08T23:08:20.801Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/b6/94414759a69a26c3dd674570a81813c46a078767d931a6c70ad29fc585cb/pyzmq-27.1.0-cp313-cp313-android_24_x86_64.whl", hash = "sha256:fbb4f2400bfda24f12f009cba62ad5734148569ff4949b1b6ec3b519444342e6", size = 1156301, upload-time = "2025-09-08T23:08:22.47Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/ad/15906493fd40c316377fd8a8f6b1f93104f97a752667763c9b9c1b71d42d/pyzmq-27.1.0-cp313-cp313t-macosx_10_15_universal2.whl", hash = "sha256:e343d067f7b151cfe4eb3bb796a7752c9d369eed007b91231e817071d2c2fec7", size = 1341197, upload-time = "2025-09-08T23:08:24.286Z" },
+    { url = "https://files.pythonhosted.org/packages/14/1d/d343f3ce13db53a54cb8946594e567410b2125394dafcc0268d8dda027e0/pyzmq-27.1.0-cp313-cp313t-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:08363b2011dec81c354d694bdecaef4770e0ae96b9afea70b3f47b973655cc05", size = 897275, upload-time = "2025-09-08T23:08:26.063Z" },
+    { url = "https://files.pythonhosted.org/packages/69/2d/d83dd6d7ca929a2fc67d2c3005415cdf322af7751d773524809f9e585129/pyzmq-27.1.0-cp313-cp313t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d54530c8c8b5b8ddb3318f481297441af102517602b569146185fa10b63f4fa9", size = 660469, upload-time = "2025-09-08T23:08:27.623Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/cd/9822a7af117f4bc0f1952dbe9ef8358eb50a24928efd5edf54210b850259/pyzmq-27.1.0-cp313-cp313t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6f3afa12c392f0a44a2414056d730eebc33ec0926aae92b5ad5cf26ebb6cc128", size = 847961, upload-time = "2025-09-08T23:08:29.672Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/12/f003e824a19ed73be15542f172fd0ec4ad0b60cf37436652c93b9df7c585/pyzmq-27.1.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:c65047adafe573ff023b3187bb93faa583151627bc9c51fc4fb2c561ed689d39", size = 1650282, upload-time = "2025-09-08T23:08:31.349Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/4a/e82d788ed58e9a23995cee70dbc20c9aded3d13a92d30d57ec2291f1e8a3/pyzmq-27.1.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:90e6e9441c946a8b0a667356f7078d96411391a3b8f80980315455574177ec97", size = 2024468, upload-time = "2025-09-08T23:08:33.543Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/94/2da0a60841f757481e402b34bf4c8bf57fa54a5466b965de791b1e6f747d/pyzmq-27.1.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:add071b2d25f84e8189aaf0882d39a285b42fa3853016ebab234a5e78c7a43db", size = 1885394, upload-time = "2025-09-08T23:08:35.51Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/6f/55c10e2e49ad52d080dc24e37adb215e5b0d64990b57598abc2e3f01725b/pyzmq-27.1.0-cp313-cp313t-win32.whl", hash = "sha256:7ccc0700cfdf7bd487bea8d850ec38f204478681ea02a582a8da8171b7f90a1c", size = 574964, upload-time = "2025-09-08T23:08:37.178Z" },
+    { url = "https://files.pythonhosted.org/packages/87/4d/2534970ba63dd7c522d8ca80fb92777f362c0f321900667c615e2067cb29/pyzmq-27.1.0-cp313-cp313t-win_amd64.whl", hash = "sha256:8085a9fba668216b9b4323be338ee5437a235fe275b9d1610e422ccc279733e2", size = 641029, upload-time = "2025-09-08T23:08:40.595Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/fa/f8aea7a28b0641f31d40dea42d7ef003fded31e184ef47db696bc74cd610/pyzmq-27.1.0-cp313-cp313t-win_arm64.whl", hash = "sha256:6bb54ca21bcfe361e445256c15eedf083f153811c37be87e0514934d6913061e", size = 561541, upload-time = "2025-09-08T23:08:42.668Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/c6/c4dcdecdbaa70969ee1fdced6d7b8f60cfabe64d25361f27ac4665a70620/pyzmq-27.1.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:18770c8d3563715387139060d37859c02ce40718d1faf299abddcdcc6a649066", size = 836265, upload-time = "2025-09-08T23:09:49.376Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/79/f38c92eeaeb03a2ccc2ba9866f0439593bb08c5e3b714ac1d553e5c96e25/pyzmq-27.1.0-pp311-pypy311_pp73-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:ac25465d42f92e990f8d8b0546b01c391ad431c3bf447683fdc40565941d0604", size = 800208, upload-time = "2025-09-08T23:09:51.073Z" },
+    { url = "https://files.pythonhosted.org/packages/49/0e/3f0d0d335c6b3abb9b7b723776d0b21fa7f3a6c819a0db6097059aada160/pyzmq-27.1.0-pp311-pypy311_pp73-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:53b40f8ae006f2734ee7608d59ed661419f087521edbfc2149c3932e9c14808c", size = 567747, upload-time = "2025-09-08T23:09:52.698Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/cf/f2b3784d536250ffd4be70e049f3b60981235d70c6e8ce7e3ef21e1adb25/pyzmq-27.1.0-pp311-pypy311_pp73-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f605d884e7c8be8fe1aa94e0a783bf3f591b84c24e4bc4f3e7564c82ac25e271", size = 747371, upload-time = "2025-09-08T23:09:54.563Z" },
+    { url = "https://files.pythonhosted.org/packages/01/1b/5dbe84eefc86f48473947e2f41711aded97eecef1231f4558f1f02713c12/pyzmq-27.1.0-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:c9f7f6e13dff2e44a6afeaf2cf54cee5929ad64afaf4d40b50f93c58fc687355", size = 544862, upload-time = "2025-09-08T23:09:56.509Z" },
+]
+
+[[package]]
+name = "referencing"
+version = "0.37.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "rpds-py" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/22/f5/df4e9027acead3ecc63e50fe1e36aca1523e1719559c499951bb4b53188f/referencing-0.37.0.tar.gz", hash = "sha256:44aefc3142c5b842538163acb373e24cce6632bd54bdb01b21ad5863489f50d8", size = 78036, upload-time = "2025-10-13T15:30:48.871Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl", hash = "sha256:381329a9f99628c9069361716891d34ad94af76e461dcb0335825aecc7692231", size = 26766, upload-time = "2025-10-13T15:30:47.625Z" },
+]
+
 [[package]]
 name = "requests"
 version = "2.32.5"
@@ -980,6 +1853,39 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738, upload-time = "2025-08-18T20:46:00.542Z" },
 ]
 
+[[package]]
+name = "rfc3339-validator"
+version = "0.1.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "six" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/28/ea/a9387748e2d111c3c2b275ba970b735e04e15cdb1eb30693b6b5708c4dbd/rfc3339_validator-0.1.4.tar.gz", hash = "sha256:138a2abdf93304ad60530167e51d2dfb9549521a836871b88d7f4695d0022f6b", size = 5513, upload-time = "2021-05-12T16:37:54.178Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7b/44/4e421b96b67b2daff264473f7465db72fbdf36a07e05494f50300cc7b0c6/rfc3339_validator-0.1.4-py2.py3-none-any.whl", hash = "sha256:24f6ec1eda14ef823da9e36ec7113124b39c04d50a4d3d3a3c2859577e7791fa", size = 3490, upload-time = "2021-05-12T16:37:52.536Z" },
+]
+
+[[package]]
+name = "rfc3986-validator"
+version = "0.1.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/da/88/f270de456dd7d11dcc808abfa291ecdd3f45ff44e3b549ffa01b126464d0/rfc3986_validator-0.1.1.tar.gz", hash = "sha256:3d44bde7921b3b9ec3ae4e3adca370438eccebc676456449b145d533b240d055", size = 6760, upload-time = "2019-10-28T16:00:19.144Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9e/51/17023c0f8f1869d8806b979a2bffa3f861f26a3f1a66b094288323fba52f/rfc3986_validator-0.1.1-py2.py3-none-any.whl", hash = "sha256:2f235c432ef459970b4306369336b9d5dbdda31b510ca1e327636e01f528bfa9", size = 4242, upload-time = "2019-10-28T16:00:13.976Z" },
+]
+
+[[package]]
+name = "rfc3987-syntax"
+version = "1.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "lark" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/2c/06/37c1a5557acf449e8e406a830a05bf885ac47d33270aec454ef78675008d/rfc3987_syntax-1.1.0.tar.gz", hash = "sha256:717a62cbf33cffdd16dfa3a497d81ce48a660ea691b1ddd7be710c22f00b4a0d", size = 14239, upload-time = "2025-07-18T01:05:05.015Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/71/44ce230e1b7fadd372515a97e32a83011f906ddded8d03e3c6aafbdedbb7/rfc3987_syntax-1.1.0-py3-none-any.whl", hash = "sha256:6c3d97604e4c5ce9f714898e05401a0445a641cfa276432b0a648c80856f6a3f", size = 8046, upload-time = "2025-07-18T01:05:03.843Z" },
+]
+
 [[package]]
 name = "rich"
 version = "14.2.0"
@@ -1046,6 +1952,85 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/27/2c/daca29684cbe9fd4bc711f8246da3c10adca1ccc4d24436b17572eb2590e/roman_numerals_py-4.1.0-py3-none-any.whl", hash = "sha256:553114c1167141c1283a51743759723ecd05604a1b6b507225e91dc1a6df0780", size = 4547, upload-time = "2025-12-17T18:25:40.136Z" },
 ]
 
+[[package]]
+name = "rpds-py"
+version = "2026.5.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/2e/43/25a8dcd3feedd735039a8f0b5b7e3b118232b5eae288c4fd9ab200d41094/rpds_py-2026.5.1.tar.gz", hash = "sha256:07b24fea40541e28570e5b795a4a38fbdcd12550c06bd0748005ecc8116ca256", size = 64459, upload-time = "2026-05-28T12:02:13.232Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/4f/a0/acf8b6fc20bfdcd3a45bd3f57680fb198e157b7e997b9123b10763798bd2/rpds_py-2026.5.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:3397a5ed7174dc2786bb214030232fc36fe8e5584fec43a9952cc542b1a12036", size = 355609, upload-time = "2026-05-28T11:58:50.78Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/95/f8203fd997484b1690a6869cd0e503b6c3c6be55b0ecc36d1a491fe742f0/rpds_py-2026.5.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:99ab6ba7bfa2cb0f96a04e3652355bf04e3f51aceb1e943b8541dab7ba4828cc", size = 348460, upload-time = "2026-05-28T11:58:52.374Z" },
+    { url = "https://files.pythonhosted.org/packages/33/8c/b47326ad2f0be545a5e5c1a55937a12afaea7d392ba2837bb9680f57e6c9/rpds_py-2026.5.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d0efbe45632665e53e3db8fe1e5692db58fc5cb9bab4459d570b83efefe11164", size = 381031, upload-time = "2026-05-28T11:58:53.775Z" },
+    { url = "https://files.pythonhosted.org/packages/22/0b/e83bbd97ffac6f6389b605cd4e1c8ac5761dc7e977769c9255d8c5adb7bd/rpds_py-2026.5.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:01d17b29c0c23d82b1f4751147ec49cf451f1fc2554eb9ef5f957e55d2656ead", size = 387121, upload-time = "2026-05-28T11:58:55.243Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/0e/d285d1bc8864245919c61e1ca82263e4a66d337759c3a4cef72766ff9afc/rpds_py-2026.5.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:7559f72b94ae52659086c595dfa017cde03155f7832071d30959049052cb3ece", size = 501026, upload-time = "2026-05-28T11:58:56.788Z" },
+    { url = "https://files.pythonhosted.org/packages/86/06/ccb2109a1e543437b5e43816f2b43b9554cc6783145528a4e3711e05c011/rpds_py-2026.5.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9e25b7088f9ccbfc0dfcaa52bf969300ca229e10ecf758974ebcbb080a4b37bb", size = 391865, upload-time = "2026-05-28T11:58:58.298Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/33/237173db1cfef10105b3839a24de00eb8d2a523711add4632447cdf0aedd/rpds_py-2026.5.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:613fc4ee9eaef26dc5840666214dd6fbcebcf32f46e76f4abc473059f4e13dda", size = 378012, upload-time = "2026-05-28T11:58:59.589Z" },
+    { url = "https://files.pythonhosted.org/packages/97/64/1eae54e34d5161f9969295e80bd6b62a55f2b6ac5f2a5b60d02c2140e758/rpds_py-2026.5.1-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:85264a90ff4c05c1568dd65f5921c837614b67c60358fb4c17df3b7f2e90690a", size = 391111, upload-time = "2026-05-28T11:59:01.104Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/34/5bb334a5a0f65d77869217c4654f34c78a7d11b93938a3c076a2edeafc52/rpds_py-2026.5.1-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe71bca7d547acb17027c7fd1624ff8aae623499c498d3e7011182c4de5c25e0", size = 409225, upload-time = "2026-05-28T11:59:02.433Z" },
+    { url = "https://files.pythonhosted.org/packages/16/0f/007ec21283b5b040b4ec3bd95e0402591e22bfa7d5c93dfe01c465c2d2d7/rpds_py-2026.5.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:a05fa4f41f37ec97c9c260441a940450a192f78d774d2b097eee1379f1e1246a", size = 556487, upload-time = "2026-05-28T11:59:04.012Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/10/5437c94508169b6b22d8418fef7a66e9ffb5f3b9e9c94460f2eedafe06ff/rpds_py-2026.5.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:df1d2a1996755b24b9ecee92cb4d36c28f86f464a6a173349c26bab41e94b8c2", size = 620798, upload-time = "2026-05-28T11:59:05.485Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/d5/9937dce4d6bda74157b954e7d1460db05a22f5929dccfeeba1ed27a93df0/rpds_py-2026.5.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:8895840ac4809e5f60c88fd07617cd71326e73d6e5a8aa783c5c0f7c24985de2", size = 584053, upload-time = "2026-05-28T11:59:06.837Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/31/750617dd0ae1752471bf43f9e41d263398fae7cde7849d23b8574a70e617/rpds_py-2026.5.1-cp311-cp311-win32.whl", hash = "sha256:3684a59b158a7683aaeb8e25352e9a9dd2122cec78f2d8530266e4f91b4c7b3f", size = 214390, upload-time = "2026-05-28T11:59:08.402Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/bb/3dcab0e1d9516303f2eb672a5d6f62eca5a69e2886301e9c8c54b520c39b/rpds_py-2026.5.1-cp311-cp311-win_amd64.whl", hash = "sha256:7bd530e6a530bb3ea892f194fafa455f3516ac25ecf7143fd33c09be62b0470a", size = 231097, upload-time = "2026-05-28T11:59:09.786Z" },
+    { url = "https://files.pythonhosted.org/packages/49/d6/c6bbf5cb1cf12b9732df8074b57f6ef8341ba884c95d40632ae8bddb44e4/rpds_py-2026.5.1-cp311-cp311-win_arm64.whl", hash = "sha256:0a5ae4dbe43c1076983b72616496919872ae7bbe7a1e21cc48336bc3154d130b", size = 226361, upload-time = "2026-05-28T11:59:11.079Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/e7/a78582dc57caa592dcc7d4fb69b61390561e908eb3d2f5df5928a8e354c0/rpds_py-2026.5.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:3abe24a66e57adcfa645d718063a5fa5103ecc71ddbf26d78af8f9368018ff1d", size = 353040, upload-time = "2026-05-28T11:59:12.531Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/43/35e3f136343aef451e545ce8c38d36c2f93c0ed88703db8b64ba2b205c68/rpds_py-2026.5.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:58b1d94308ddf0b1982f61f2eb54bf92997c9ece8a8093ef014250f4a517906c", size = 345775, upload-time = "2026-05-28T11:59:13.827Z" },
+    { url = "https://files.pythonhosted.org/packages/20/e1/0f2160c5982d3157734d5cb3ed63d8b2d583a73c9864f77b666449f32cf8/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0fa92420128dadce7f54bd73ba1825a273e9268fe9e35dbf7e6362890efa4e08", size = 376329, upload-time = "2026-05-28T11:59:15.271Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/11/ee0ba42aff83bf4effdbc576673c6be64c5e173978c3f6d537e94482f77d/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ca653c6546386227cd9800d1bef6a348099acf8db4250341da6d90f663d6dfcb", size = 383539, upload-time = "2026-05-28T11:59:16.665Z" },
+    { url = "https://files.pythonhosted.org/packages/11/df/d94aa6a499d4ac40afe2d7620f2c597fd3c0f182e854ad7cf3f596a81cb6/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:66c93681c4729e4e3ecba31b8179fae083ff3118841672835140338b4b9867c1", size = 494674, upload-time = "2026-05-28T11:59:17.991Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/75/33d30f43bb2f458de11979486a591b1bf6e5651765ed1704c6197c2dc773/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:40ff257542e04796880e011e15cd4dc21c2599975df2aaa8f2c8495ca574e1a5", size = 389268, upload-time = "2026-05-28T11:59:19.434Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/1e/2c9096fc19d5fd084b0184ca2b651e659aa0a37e6fdbecf6ece47f147fe1/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b6825cc329b290e93c5f6a9be2393118a763f6ccf6abd83704e0c102ca583644", size = 376280, upload-time = "2026-05-28T11:59:21Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/e5/61ec9f8be8211ea7f48448195549e4aaf02004083475493b0e137702ecb2/rpds_py-2026.5.1-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:de42116e69cb53b911cc34aee5ab98f36c597b822545045d49e938818b99e5e4", size = 387233, upload-time = "2026-05-28T11:59:22.454Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/ca/bcec1005c4f4a234f92a29078631fee49206c7265ccae966f18fd332e80e/rpds_py-2026.5.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c0f920015df2a504bebaba6d4c31ccf3fcf942f92655c086da30b671aad19aa6", size = 405009, upload-time = "2026-05-28T11:59:23.845Z" },
+    { url = "https://files.pythonhosted.org/packages/72/e6/4d5718c5cf26c522dc7c9999e238da1e77380b81d0c5d1df11e271ddfeb1/rpds_py-2026.5.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:0408a24e44feb919423dc6d9da677cb5cddb894d2ca9e763967d156d9c60fab4", size = 553113, upload-time = "2026-05-28T11:59:25.184Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/25/2ee807bdb3e1f0b7eddf7782acd5665a8b5205a331a7d7244a52c4812fd9/rpds_py-2026.5.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:cea68bcd53467561ae2f96a6bdad1544299ba97b5b0ddcd5ac3d376e5c781c24", size = 618838, upload-time = "2026-05-28T11:59:26.749Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/c1/7d4c26f167f8c41501cc073d30ee22082b16ce358cf5b00ec97cbc7804ea/rpds_py-2026.5.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:4be8b1d2a705cc37d08256004e1d07de143fa0075c8e85a3df020b776f62b732", size = 582436, upload-time = "2026-05-28T11:59:28.11Z" },
+    { url = "https://files.pythonhosted.org/packages/04/1d/9d12b0a337bab46f4769f8857f4007e3b2d639e14f9a44a0efe157696e64/rpds_py-2026.5.1-cp312-cp312-win32.whl", hash = "sha256:6736718bd4fc49cbcb538ba30516fdbef161522acefb739657d48b97bd864fed", size = 212734, upload-time = "2026-05-28T11:59:29.689Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/93/e4116f2de7f56bc7406a76033dc501811ddeb22b7f056b92d632871ebb0c/rpds_py-2026.5.1-cp312-cp312-win_amd64.whl", hash = "sha256:0a7d1eec967df0e9b22614a5e177622e0c89611d03727fa0cb48e45028907870", size = 229045, upload-time = "2026-05-28T11:59:31.033Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/53/6c3419d85eb2ec5938a37627c585b42d76a63bb731d6e42ed4b079ebf486/rpds_py-2026.5.1-cp312-cp312-win_arm64.whl", hash = "sha256:1841d067089e117142d79b98aa0df2f08b52f2ecc1819dd2700636c0db74a473", size = 223967, upload-time = "2026-05-28T11:59:32.318Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/32/14c961ad295f490eb0849ada8b79683e93a59b9de3afdd983eaf55fa6867/rpds_py-2026.5.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:efef4ac29c6ff495531eb17ee705b62841ecaa291b7c7077e848ea03e237164d", size = 352787, upload-time = "2026-05-28T11:59:33.655Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/bb/d1b85117967c11191441a7274ae616c65d93901d082c588f89a50a8da5ae/rpds_py-2026.5.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:c39f5b67a8a2e67179ada2a954227d670fe65fa9098457f698f56ddf248709b3", size = 345179, upload-time = "2026-05-28T11:59:35Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/46/d84105f062e626a1b233f863907288a4708c2d833b8b4c6fb2764bc080c0/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b5c30f3f04eef4fbd362226a6f31d7c8895ca4fbb6e0b790f6890a98d8da8559", size = 376173, upload-time = "2026-05-28T11:59:36.43Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/ae/469d7959ce5b1201e1de135dc735b86db3b35dd0d1734f6a44246d5f061c/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:277f6c82f0580848796c7ecc8a7173aa3bfb928e4ff831261c2f60a81dc270db", size = 383162, upload-time = "2026-05-28T11:59:37.995Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/a2/57853d31a1116a561aa072794602ad3f6341e18d70a8523f1bd5b9fc1e5a/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:63c2c4c213f1a4e3f3de28ecab029dbdee976324e729c0d7a55211be72576b02", size = 495093, upload-time = "2026-05-28T11:59:39.453Z" },
+    { url = "https://files.pythonhosted.org/packages/99/63/3a8eabcad9314b7daf5c65f451d2c33d989235cd8a5762186cf2c3f5a4f8/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3350ec808fb538fe71a1f94dfaa0e29c598dfad805ce49f0caec5ae3183c652b", size = 389829, upload-time = "2026-05-28T11:59:40.896Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/25/05678d97fc25e2622df14dc530fb82023174ecfff6733991ed0d78f167bd/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b1b964e3ab599e718dc46c018d104b1ebc007cbc6567d827c94a687fca56d77e", size = 374786, upload-time = "2026-05-28T11:59:42.626Z" },
+    { url = "https://files.pythonhosted.org/packages/88/d1/8c90b6431e80a3b91b284a5c7c8c0c4f9c006444d90477a740d6e0f9c694/rpds_py-2026.5.1-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:19cb09fab7b7fc96b2a6e28f2e34b72a3705ff27b37edb77455316e5d3f3dc9b", size = 386920, upload-time = "2026-05-28T11:59:44.124Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/99/4638f672ab356682d633ee0da9255f5b67ce6efd0b85eb94ad3e255e65a5/rpds_py-2026.5.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:abe76bcdba31e576cb83eeb8797aa0d882b738fef6dc65d0601fc753806a5b46", size = 405059, upload-time = "2026-05-28T11:59:47.177Z" },
+    { url = "https://files.pythonhosted.org/packages/66/3f/3546524b6eb4cc2e1f363a3d638fa52f6c24faae3500c25fb488b02f1740/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:8bff7073db3899158fff55ebf57b113a67030af26f80a18978f9f0aa60250ddf", size = 553030, upload-time = "2026-05-28T11:59:48.603Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/c3/7b3388c796fcf471bd17194242d4dc1a7608567c0fa422bcc1c5e79f9c1e/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:8ba264fa49be666cd9cc56bf34ec7002fb3d27a4aee5bcb4d43d0d18feb1bb6f", size = 618975, upload-time = "2026-05-28T11:59:50.314Z" },
+    { url = "https://files.pythonhosted.org/packages/61/1e/a3cb07f2795075d1d88efddae2f541359fde5f08c81ee114c29c2949c90a/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4860b603ddda0475a8885499b3729e90229d480105b42651962a5397d995fa89", size = 581178, upload-time = "2026-05-28T11:59:51.673Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/74/e758c03a5ef46f04c37f2651a2893db846d569ba8a7bca469d4b58939bcd/rpds_py-2026.5.1-cp313-cp313-win32.whl", hash = "sha256:7944270ae71383f6e2657dd7d5ce4eeb4ac2d0059a6738f0510583d462ab4842", size = 212481, upload-time = "2026-05-28T11:59:53.148Z" },
+    { url = "https://files.pythonhosted.org/packages/70/ec/a2aca432db9c7359b40fa393eeeaa0d166c2f70175be956e75fa24197c44/rpds_py-2026.5.1-cp313-cp313-win_amd64.whl", hash = "sha256:88647f43a73c4e01be19b04ceef0c8d3a1958153604d13c773becd8016f2a0cf", size = 228519, upload-time = "2026-05-28T11:59:54.505Z" },
+    { url = "https://files.pythonhosted.org/packages/29/60/a73bfdd45b096574556acf303bbd9fa9eed36ca8a818b514e2a5d5fe2b9d/rpds_py-2026.5.1-cp313-cp313-win_arm64.whl", hash = "sha256:453895624ecf7db7063b1004e44037522bbaef9ff6a945e59bc71662d7a03abd", size = 223446, upload-time = "2026-05-28T11:59:56.081Z" },
+    { url = "https://files.pythonhosted.org/packages/18/e2/408105fd611823f00882aea810f3989a30d26b1bab8b6beb20f98c724e0e/rpds_py-2026.5.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:b4e4bc98639ec915f512fde3aa7a95e0041d95d9c3cc86eea841fa63cb1e8600", size = 355287, upload-time = "2026-05-28T11:59:57.448Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/58/5c4a43436843c90d0f6d19f82c200c80e3843ca9fa07b237623327f6d384/rpds_py-2026.5.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:cacedb7a6e167680acba45ad5716e89067d225dc80da0d7040cae8c81d4572fa", size = 347033, upload-time = "2026-05-28T11:59:58.881Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/c2/1a71acdacaf4e259b10278fb87b039ded3cf80041bcd89dd8a3ea702ded6/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:68700371c5d7ae1412862ddfa719090925c93ecf351c566d66f09d04b136ea00", size = 376891, upload-time = "2026-05-28T12:00:00.516Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/c8/535f3d9b65addd8e28aa87b83c6e526799c3717a88273db8ea795beeef7a/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:296c799becfa849c779c8725494fe9ed94959ed886787df4364b058465bad7f0", size = 385646, upload-time = "2026-05-28T12:00:02.394Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/91/dc033f313345c354ade914dbe73cdb90b615a4409ea02430d5356794f3d8/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d3858b908218ee108d0bbfb2095ccc237648053c9bf98affad7cb079acaf1d97", size = 498830, upload-time = "2026-05-28T12:00:04.189Z" },
+    { url = "https://files.pythonhosted.org/packages/27/fc/90fcbea459dbb8ddc18a2e0fd1de9412b48bc84ffff2db771cf714bacfd6/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4fb8d2e7cb2f850b169806d61d1b991738acec96500a75c30f49caf064ce7cef", size = 392830, upload-time = "2026-05-28T12:00:05.797Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/1d/46cd11a228c9750684a798d98f878be6f614aa762438da7378f035e79e35/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:27b74c10ed6a8f190f4287f53bcfea348b92a84a9c9f70d30183d1e6172d580d", size = 379613, upload-time = "2026-05-28T12:00:07.433Z" },
+    { url = "https://files.pythonhosted.org/packages/24/4a/d9b0c6af3a1de03eb93741bbe8be2bdce84d8fda8224f3005451d86df389/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:b9a6528956191c48c52294a592dbd4a8386d7048bdb25c0efcb6b966466c6d83", size = 388183, upload-time = "2026-05-28T12:00:09.227Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/b4/db7aaabdda6d020afc87d981bcc2f57a434c7dec60ecfc2ab3dd50b20351/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:af03e34e860047bc7a352b842856fcf78798fbb81132cc98bd2f907ab4eb9cd2", size = 408578, upload-time = "2026-05-28T12:00:10.779Z" },
+    { url = "https://files.pythonhosted.org/packages/08/d6/070f6a41cbb343e2ac4171859bf3f3623e0ab002f72619d6d505313ec2de/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:fea6e836d10abbe191d557d33bd58bd5987725fe63aa1eefe557d230209855bd", size = 553573, upload-time = "2026-05-28T12:00:12.443Z" },
+    { url = "https://files.pythonhosted.org/packages/75/ab/1a71ea3589c4345dac0a0518f0e6a031cb42689277851b683c46d27463a5/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:fc0c0f878ea770a0a8a462456c5ad36fc9fe6358e6b76fdadc7f17575e0b8bf1", size = 620861, upload-time = "2026-05-28T12:00:14.09Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/22/9bf80a56069c0c443fcfefac639a86a744550a2898817a6dfd3e26654924/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:e0b360f316d966b048b085857630b3cc51f3db2f07b06f440eac8f695374d1e3", size = 585633, upload-time = "2026-05-28T12:00:15.66Z" },
+    { url = "https://files.pythonhosted.org/packages/da/68/3b2c0a75c9e04125696f84ebdbbf304acf5a40b58ba4481cdb98a922c3ba/rpds_py-2026.5.1-cp313-cp313t-win32.whl", hash = "sha256:a2999883eedf72fdfb7520b92c7d4ec2572a71ff40239377aa604cc529eecafc", size = 210074, upload-time = "2026-05-28T12:00:17.291Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/8b/609157d5a25d37d4f29f92840ba531f416907c34ae5c5739dd21fc2bef98/rpds_py-2026.5.1-cp313-cp313t-win_amd64.whl", hash = "sha256:e07be2a9d7122bd6e82dea89814ef8dc893feb1aae97fec1630f3263bbb30e55", size = 228635, upload-time = "2026-05-28T12:00:18.73Z" },
+    { url = "https://files.pythonhosted.org/packages/42/56/3fe0fb34820ff667be791b3a3c22b85e8bcba54e9c832f47438c191fa7be/rpds_py-2026.5.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:edf2765d84e42447f112ad877af8fe1db0089aaec5b28e88d6eab45e7fe99cea", size = 357151, upload-time = "2026-05-28T12:01:53.43Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/f2/3eb9ccdb9f143b8c9b003978898cb497f942a324c077401e6b8834238e63/rpds_py-2026.5.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:ad3773236e95f7f33991eb125224b7da66f206504d032a253a02da7e134519fb", size = 350195, upload-time = "2026-05-28T12:01:54.901Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/24/dbda232bc4f3ed732120692ab0d2c8402cb020516556d8bee622dcef2413/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a04df86b3f0fade39ec8fd0e0aab089b1da9fbd2b48df778a57ef96f5e7d38df", size = 381850, upload-time = "2026-05-28T12:01:56.601Z" },
+    { url = "https://files.pythonhosted.org/packages/40/30/32e769839a358f78810c234f160f2cc21d1e4e47e1c0e0e0d535be5a0219/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6142dbd80c4df62a5d899f0d616d417f84e0bc8d32526c8e5589019d75d028a7", size = 387899, upload-time = "2026-05-28T12:01:58.212Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/86/ec84d243aadb3b34b71dd26a010d0930b2d284ff5fc9a69fec53810ee6fd/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0b35217adefe87f2fe4db7e9766cabe84744bfe9616d9667be18988928c7f2dc", size = 501618, upload-time = "2026-05-28T12:01:59.888Z" },
+    { url = "https://files.pythonhosted.org/packages/74/25/b60e52686bbff777a64f9e4f4d3dd57980dc846913777177a2c92e4937aa/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b95d5e11fc712b752081183a55a244c03cd00570489edd7014d8899f8ceb8162", size = 394003, upload-time = "2026-05-28T12:02:01.482Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/c7/b3a6a588cc2219510ef3f42e207483a93950bedd1e3a0fd4015c95cff9e5/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:141c9498daf2ace9eda35d2b0e376f9ea8b058d84f2aef4f96fccfd449a2f251", size = 379778, upload-time = "2026-05-28T12:02:03.197Z" },
+    { url = "https://files.pythonhosted.org/packages/31/00/c7dba3fc8a3da8cb3f6db1eb3386be4d79c2e97c6890d20eb9ac66ae8c43/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_31_riscv64.whl", hash = "sha256:6f249f8b860a200ad35193af961183ebe9132710484e6f6ce0cf89fd83c63a9a", size = 392359, upload-time = "2026-05-28T12:02:04.817Z" },
+    { url = "https://files.pythonhosted.org/packages/93/dd/472ba494c70753f93745992c99855bee0636daf74e6984e5e003f150316f/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:e4abbf391a70be864920858bf360f4fb380577c9a0f732438a1996726e2c195b", size = 412820, upload-time = "2026-05-28T12:02:06.401Z" },
+    { url = "https://files.pythonhosted.org/packages/1d/6f/93831a3bfe789542ed0c1d0d74b78b440f055d6dc3ea4640eba2d95e6e23/rpds_py-2026.5.1-pp311-pypy311_pp73-musllinux_1_2_aarch64.whl", hash = "sha256:c74005a7bb87752acf351c93897ec63ad77a07a0da7ecad9c050e32e7286ba34", size = 557243, upload-time = "2026-05-28T12:02:08.013Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/ff/0b3d604614ffc77522c6b288fdbce68957eb583da1002aa65ba38ac0ee40/rpds_py-2026.5.1-pp311-pypy311_pp73-musllinux_1_2_i686.whl", hash = "sha256:8213afbe8a3a906fb9acb2014423fe3359ee783d0bf90995f70623a3217bfa6c", size = 623541, upload-time = "2026-05-28T12:02:09.661Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/ea/e7b0251441da9adfeaebcf29601d10f2a1455fcf0772fae9e7e19032bd96/rpds_py-2026.5.1-pp311-pypy311_pp73-musllinux_1_2_x86_64.whl", hash = "sha256:8c43a8a973270fd173bf48cdf80bbe66312421cba68d40845034f174f2389049", size = 586326, upload-time = "2026-05-28T12:02:11.47Z" },
+]
+
 [[package]]
 name = "ruff"
 version = "0.15.17"
@@ -1071,6 +2056,24 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2d/c7/c53e8dbff9c9dc4b7928773421ae294a5d28fcb8dcda1a089579d3a7e510/ruff-0.15.17-py3-none-win_arm64.whl", hash = "sha256:f3be1fbb34bcdfd146240d8fb92a709d4c2c8191348580a3c044ec60fa0b4456", size = 11355275, upload-time = "2026-06-11T17:54:43.635Z" },
 ]
 
+[[package]]
+name = "send2trash"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c5/f0/184b4b5f8d00f2a92cf96eec8967a3d550b52cf94362dad1100df9e48d57/send2trash-2.1.0.tar.gz", hash = "sha256:1c72b39f09457db3c05ce1d19158c2cbef4c32b8bedd02c155e49282b7ea7459", size = 17255, upload-time = "2026-01-14T06:27:36.056Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1c/78/504fdd027da3b84ff1aecd9f6957e65f35134534ccc6da8628eb71e76d3f/send2trash-2.1.0-py3-none-any.whl", hash = "sha256:0da2f112e6d6bb22de6aa6daa7e144831a4febf2a87261451c4ad849fe9a873c", size = 17610, upload-time = "2026-01-14T06:27:35.218Z" },
+]
+
+[[package]]
+name = "setuptools"
+version = "82.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4f/db/cfac1baf10650ab4d1c111714410d2fbb77ac5a616db26775db562c8fab2/setuptools-82.0.1.tar.gz", hash = "sha256:7d872682c5d01cfde07da7bccc7b65469d3dca203318515ada1de5eda35efbf9", size = 1152316, upload-time = "2026-03-09T12:47:17.221Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9d/76/f789f7a86709c6b087c5a2f52f911838cad707cc613162401badc665acfe/setuptools-82.0.1-py3-none-any.whl", hash = "sha256:a59e362652f08dcd477c78bb6e7bd9d80a7995bc73ce773050228a348ce2e5bb", size = 1006223, upload-time = "2026-03-09T12:47:15.026Z" },
+]
+
 [[package]]
 name = "six"
 version = "1.17.0"
@@ -1134,6 +2137,9 @@ dev = [
     { name = "types-requests" },
     { name = "types-toml" },
 ]
+jupyter = [
+    { name = "notebook" },
+]
 pyspark = [
     { name = "pyspark" },
 ]
@@ -1146,6 +2152,7 @@ requires-dist = [
     { name = "furo", marker = "extra == 'dev'" },
     { name = "loguru", specifier = ">=0.7.2" },
     { name = "myst-parser", marker = "extra == 'dev'" },
+    { name = "notebook", marker = "extra == 'jupyter'" },
     { name = "prek", marker = "extra == 'dev'", specifier = ">=0.2,<1" },
     { name = "psutil" },
     { name = "pydantic", specifier = ">=2.7,<3" },
@@ -1168,7 +2175,7 @@ requires-dist = [
     { name = "types-requests", marker = "extra == 'dev'" },
     { name = "types-toml", marker = "extra == 'dev'" },
 ]
-provides-extras = ["pyspark", "dev"]
+provides-extras = ["pyspark", "jupyter", "dev"]
 
 [[package]]
 name = "sphinx"
@@ -1317,6 +2324,20 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/52/a7/d2782e4e3f77c8450f727ba74a8f12756d5ba823d81b941f1b04da9d033a/sphinxcontrib_serializinghtml-2.0.0-py3-none-any.whl", hash = "sha256:6e2cb0eef194e10c27ec0023bfeb25badbbb5868244cf5bc5bdc04e4464bf331", size = 92072, upload-time = "2024-07-29T01:10:08.203Z" },
 ]
 
+[[package]]
+name = "stack-data"
+version = "0.6.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "asttokens" },
+    { name = "executing" },
+    { name = "pure-eval" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/28/e3/55dcc2cfbc3ca9c29519eb6884dd1415ecb53b0e934862d3559ddcb7e20b/stack_data-0.6.3.tar.gz", hash = "sha256:836a778de4fec4dcd1dcd89ed8abff8a221f58308462e1c4aa2a3cf30148f0b9", size = 44707, upload-time = "2023-09-30T13:58:05.479Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f1/7b/ce1eafaf1a76852e2ec9b22edecf1daa58175c090266e9f6c64afcd81d91/stack_data-0.6.3-py3-none-any.whl", hash = "sha256:d5558e0c25a4cb0853cddad3d77da9891a08cb85dd9f9f91b9f8cd66e511e695", size = 24521, upload-time = "2023-09-30T13:58:03.53Z" },
+]
+
 [[package]]
 name = "tenacity"
 version = "9.1.2"
@@ -1326,6 +2347,32 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/e5/30/643397144bfbfec6f6ef821f36f33e57d35946c44a2352d3c9f0ae847619/tenacity-9.1.2-py3-none-any.whl", hash = "sha256:f77bf36710d8b73a50b2dd155c97b870017ad21afe6ab300326b0371b3b05138", size = 28248, upload-time = "2025-04-02T08:25:07.678Z" },
 ]
 
+[[package]]
+name = "terminado"
+version = "0.18.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "ptyprocess", marker = "os_name != 'nt'" },
+    { name = "pywinpty", marker = "os_name == 'nt'" },
+    { name = "tornado" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/8a/11/965c6fd8e5cc254f1fe142d547387da17a8ebfd75a3455f637c663fb38a0/terminado-0.18.1.tar.gz", hash = "sha256:de09f2c4b85de4765f7714688fff57d3e75bad1f909b589fde880460c753fd2e", size = 32701, upload-time = "2024-03-12T14:34:39.026Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/6a/9e/2064975477fdc887e47ad42157e214526dcad8f317a948dee17e1659a62f/terminado-0.18.1-py3-none-any.whl", hash = "sha256:a4468e1b37bb318f8a86514f65814e1afc977cf29b3992a4500d9dd305dcceb0", size = 14154, upload-time = "2024-03-12T14:34:36.569Z" },
+]
+
+[[package]]
+name = "tinycss2"
+version = "1.5.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "webencodings" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a3/ae/2ca4913e5c0f09781d75482874c3a95db9105462a92ddd303c7d285d3df2/tinycss2-1.5.1.tar.gz", hash = "sha256:d339d2b616ba90ccce58da8495a78f46e55d4d25f9fd71dfd526f07e7d53f957", size = 88195, upload-time = "2025-11-23T10:29:10.082Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/60/45/c7b5c3168458db837e8ceab06dc77824e18202679d0463f0e8f002143a97/tinycss2-1.5.1-py3-none-any.whl", hash = "sha256:3415ba0f5839c062696996998176c4a3751d18b7edaaeeb658c9ce21ec150661", size = 28404, upload-time = "2025-11-23T10:29:08.676Z" },
+]
+
 [[package]]
 name = "toml"
 version = "0.10.2"
@@ -1371,6 +2418,32 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/23/d1/136eb2cb77520a31e1f64cbae9d33ec6df0d78bdf4160398e86eec8a8754/tomli-2.4.0-py3-none-any.whl", hash = "sha256:1f776e7d669ebceb01dee46484485f43a4048746235e683bcdffacdf1fb4785a", size = 14477, upload-time = "2026-01-11T11:22:37.446Z" },
 ]
 
+[[package]]
+name = "tornado"
+version = "6.5.7"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/64/24/95ec527ad67b76d59299e5465b3935d05e4294b7e0290a3924b7487df30b/tornado-6.5.7.tar.gz", hash = "sha256:66c513a76cda70d53907bc27cf1447557699c2e95aa48ba27a442ff61c3ddfc2", size = 519252, upload-time = "2026-06-08T17:34:51.232Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/02/dc/c7043cab6fed8ae159fc1923ce829ada35c4dbd797d408a43858ffaf9639/tornado-6.5.7-cp39-abi3-macosx_10_9_universal2.whl", hash = "sha256:148b2eb15c2c765a50796172c1e499649b35f30d2e3c3d3e15913cfa56bfb163", size = 448543, upload-time = "2026-06-08T17:34:38.052Z" },
+    { url = "https://files.pythonhosted.org/packages/92/4f/090b1431e5a43df696feceffc268c5383cc079ecb5f08ce58f917109aafe/tornado-6.5.7-cp39-abi3-macosx_10_9_x86_64.whl", hash = "sha256:9da38de27f1da3b78a966f0dae12b5a1ea9afe72ca805d84ff06508272ddf100", size = 446707, upload-time = "2026-06-08T17:34:39.594Z" },
+    { url = "https://files.pythonhosted.org/packages/37/d8/ef374952fd5da67d4463122c2b8e5a96536ec10b4b339254c6dcde81d01c/tornado-6.5.7-cp39-abi3-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:8d759e71906ee783f8867b93bf26a265743da4c1e2f4a018464c1ba019862972", size = 449774, upload-time = "2026-06-08T17:34:41.204Z" },
+    { url = "https://files.pythonhosted.org/packages/35/37/d434c73f4c6e014b745b9b37085f34f40c022f007efff3d7fe65991899f3/tornado-6.5.7-cp39-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8a46347a18f23fb92b396beebe0fb78f61dda0cc302445202c16203d8a18848b", size = 450745, upload-time = "2026-06-08T17:34:42.531Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/2b/56b9aff361d7f1ab728a805ec7d7ea835f8807afa9f5cc690ea0e630efb9/tornado-6.5.7-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:7778b30bef919231265e91c69963ce0f49a1e9c07ac900bbe75b19ce2575ba92", size = 450578, upload-time = "2026-06-08T17:34:43.787Z" },
+    { url = "https://files.pythonhosted.org/packages/02/30/a7444fb23aa76860a14198fab96ac79f1866b0a6e19e26c4381b0938e50f/tornado-6.5.7-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:e726f0c75da7726eec023aa62751ff8878bd2737e34fbdd33b1ae5897d2200f5", size = 449985, upload-time = "2026-06-08T17:34:45.326Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/42/5f0e56c01e8d9d36f4e23f367b85ae6cae0c1ecddd5e6977d8388ad27488/tornado-6.5.7-cp39-abi3-win32.whl", hash = "sha256:f8de3bf12d3efdd0cbe7c8887868198f8a91415e3f29fcf258d9b8eb7b1d9ae4", size = 451047, upload-time = "2026-06-08T17:34:46.784Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/a4/b393076ffb21b469eec5b328a0534cf03a3b90bfc6b1f09507cdd075d938/tornado-6.5.7-cp39-abi3-win_amd64.whl", hash = "sha256:de942f843533a039ef9fa3d9c88c7cd8a7c94553fb5ad0154270989b3d99a2c4", size = 451485, upload-time = "2026-06-08T17:34:48.248Z" },
+    { url = "https://files.pythonhosted.org/packages/71/2e/7b1c769803121b809112cf9a00681c472eae1d80e32d7ec0e0bd61d0d0e1/tornado-6.5.7-cp39-abi3-win_arm64.whl", hash = "sha256:ff934fce95643af5f11efdae618eaa73d469dc588641e5c8d19295a0c65c4796", size = 450506, upload-time = "2026-06-08T17:34:49.702Z" },
+]
+
+[[package]]
+name = "traitlets"
+version = "5.15.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/57/a9/a2584b8313b89f94869ddb3c4074617a691de1812a614d2d50e32ca5a7a6/traitlets-5.15.1.tar.gz", hash = "sha256:7b1c07854fe25acb39e009bae49f11b79ff6cbb2f27999104e9110e7a6b53722", size = 163344, upload-time = "2026-06-03T12:26:06.181Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/96/8d/1080ee4c231f361b6ce4470d556c8c435b67c7e0753aaa641497ee92f88b/traitlets-5.15.1-py3-none-any.whl", hash = "sha256:770a53705f84b81ac107e83a1b3328ff2dae16094d8fc3cfc004e4b22dfd8e92", size = 85858, upload-time = "2026-06-03T12:26:04.395Z" },
+]
+
 [[package]]
 name = "ty"
 version = "0.0.49"
@@ -1456,6 +2529,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c7/b0/003792df09decd6849a5e39c28b513c06e84436a54440380862b5aeff25d/tzdata-2025.3-py2.py3-none-any.whl", hash = "sha256:06a47e5700f3081aab02b2e513160914ff0694bce9947d6b76ebd6bf57cfc5d1", size = 348521, upload-time = "2025-12-13T17:45:33.889Z" },
 ]
 
+[[package]]
+name = "uri-template"
+version = "1.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/31/c7/0336f2bd0bcbada6ccef7aaa25e443c118a704f828a0620c6fa0207c1b64/uri-template-1.3.0.tar.gz", hash = "sha256:0e00f8eb65e18c7de20d595a14336e9f337ead580c70934141624b6d1ffdacc7", size = 21678, upload-time = "2023-06-21T01:49:05.374Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e7/00/3fca040d7cf8a32776d3d81a00c8ee7457e00f80c649f1e4a863c8321ae9/uri_template-1.3.0-py3-none-any.whl", hash = "sha256:a44a133ea12d44a0c0f06d7d42a52d71282e77e2f937d8abd5655b8d56fc1363", size = 11140, upload-time = "2023-06-21T01:49:03.467Z" },
+]
+
 [[package]]
 name = "urllib3"
 version = "2.6.3"
@@ -1465,6 +2547,42 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/39/08/aaaad47bc4e9dc8c725e68f9d04865dbcb2052843ff09c97b08904852d84/urllib3-2.6.3-py3-none-any.whl", hash = "sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4", size = 131584, upload-time = "2026-01-07T16:24:42.685Z" },
 ]
 
+[[package]]
+name = "wcwidth"
+version = "0.8.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/49/b4/51fe890511f0f242d07cb1ebe6a5b6db417262b9d2568b460347c57d95cc/wcwidth-0.8.1.tar.gz", hash = "sha256:faf5b4a5366a72dc49cad48cdf21f52bdf63bdda995178e483ba247ff79089b9", size = 1466072, upload-time = "2026-06-08T05:57:23.146Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/bd/6e/95b0e537de1f4d4301f76f944642c6da50d1511cc7b3d64dc418a66c7509/wcwidth-0.8.1-py3-none-any.whl", hash = "sha256:f453740b1e4a4f3291faa37944c555d71056c4da08d59809b307ef4feba695c8", size = 323092, upload-time = "2026-06-08T05:57:21.413Z" },
+]
+
+[[package]]
+name = "webcolors"
+version = "25.10.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1d/7a/eb316761ec35664ea5174709a68bbd3389de60d4a1ebab8808bfc264ed67/webcolors-25.10.0.tar.gz", hash = "sha256:62abae86504f66d0f6364c2a8520de4a0c47b80c03fc3a5f1815fedbef7c19bf", size = 53491, upload-time = "2025-10-31T07:51:03.977Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e2/cc/e097523dd85c9cf5d354f78310927f1656c422bd7b2613b2db3e3f9a0f2c/webcolors-25.10.0-py3-none-any.whl", hash = "sha256:032c727334856fc0b968f63daa252a1ac93d33db2f5267756623c210e57a4f1d", size = 14905, upload-time = "2025-10-31T07:51:01.778Z" },
+]
+
+[[package]]
+name = "webencodings"
+version = "0.5.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0b/02/ae6ceac1baeda530866a85075641cec12989bd8d31af6d5ab4a3e8c92f47/webencodings-0.5.1.tar.gz", hash = "sha256:b36a1c245f2d304965eb4e0a82848379241dc04b865afcc4aab16748587e1923", size = 9721, upload-time = "2017-04-05T20:21:34.189Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/24/2a3e3df732393fed8b3ebf2ec078f05546de641fe1b667ee316ec1dcf3b7/webencodings-0.5.1-py2.py3-none-any.whl", hash = "sha256:a0af1213f3c2226497a97e2b3aa01a7e4bee4f403f95be16fc9acd2947514a78", size = 11774, upload-time = "2017-04-05T20:21:32.581Z" },
+]
+
+[[package]]
+name = "websocket-client"
+version = "1.9.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/2c/41/aa4bf9664e4cda14c3b39865b12251e8e7d239f4cd0e3cc1b6c2ccde25c1/websocket_client-1.9.0.tar.gz", hash = "sha256:9e813624b6eb619999a97dc7958469217c3176312b3a16a4bd1bc7e08a46ec98", size = 70576, upload-time = "2025-10-07T21:16:36.495Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/34/db/b10e48aa8fff7407e67470363eac595018441cf32d5e1001567a7aeba5d2/websocket_client-1.9.0-py3-none-any.whl", hash = "sha256:af248a825037ef591efbf6ed20cc5faa03d3b47b9e5a2230a529eeee1c1fc3ef", size = 82616, upload-time = "2025-10-07T21:16:34.951Z" },
+]
+
 [[package]]
 name = "win32-setctime"
 version = "1.2.0"

From ec1fff43a0027a56301bfbba5cd0476ea6cc0d7d Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 10:15:56 -0600
Subject: [PATCH 10/24] Document that sparkctl clean deletes the spark_scratch
 directory

Per review discussion, keep clean() deleting the configured scratch
directory (which may intentionally live outside the base directory, e.g.
a dedicated scratch filesystem) and instead document that spark_scratch
should be a dedicated directory.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 src/sparkctl/cli/sparkctl.py | 6 +++++-
 src/sparkctl/models.py       | 3 ++-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/sparkctl/cli/sparkctl.py b/src/sparkctl/cli/sparkctl.py
index 0140471..e490ea0 100644
--- a/src/sparkctl/cli/sparkctl.py
+++ b/src/sparkctl/cli/sparkctl.py
@@ -643,7 +643,11 @@ def stop(ctx: click.Context, directory: Path) -> None:
 @click.argument("directory", type=click.Path(path_type=Path))
 @click.pass_context
 def clean(ctx: click.Context, directory: Path) -> None:
-    """Delete all Spark runtime files in the directory."""
+    """Delete all Spark runtime files in the directory.
+
+    This also deletes the configured spark_scratch directory recursively, even when it is located
+    outside the base configuration directory. Point spark_scratch at a dedicated directory.
+    """
     setup_logging(
         filename="sparkctl.log",
         console_level=ctx.find_root().params["console_level"],
diff --git a/src/sparkctl/models.py b/src/sparkctl/models.py
index eac7fa5..d4c84d3 100644
--- a/src/sparkctl/models.py
+++ b/src/sparkctl/models.py
@@ -225,7 +225,8 @@ class RuntimeDirectories(SparkctlBaseModel):
     )
     spark_scratch: Path = Field(
         default=Path("spark_scratch"),
-        description="Directory to use for shuffle data.",
+        description="Directory to use for shuffle data. Use a dedicated directory: `sparkctl clean` "
+        "deletes it recursively, even when it is outside the base configuration directory.",
     )
     metastore_dir: Path = Field(
         default=Path(), description="Set a custom directory for the metastore and warehouse."

From 730c7599d0e64cd4572c4454293d744f134bf6a6 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 10:52:57 -0600
Subject: [PATCH 11/24] Make `sparkctl clean` refuse to run while a cluster is
 running

Running clean on an active cluster deletes the state needed to stop it
(config.json, status.json, srun_workers.pid, jupyter.pid, the conf and
scratch dirs), orphaning the Spark/Jupyter processes.

clean() now checks status.json and raises if any tracked process is
recorded as running, directing the user to run `sparkctl stop` first.
A --force flag overrides the guard, and the CLI reports the error cleanly
instead of a traceback.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 src/sparkctl/cli/sparkctl.py    | 18 +++++++++++++++---
 src/sparkctl/cluster_manager.py | 18 ++++++++++++++++--
 src/sparkctl/models.py          |  4 ++++
 tests/test_cluster_manager.py   | 27 +++++++++++++++++++++++++++
 4 files changed, 62 insertions(+), 5 deletions(-)

diff --git a/src/sparkctl/cli/sparkctl.py b/src/sparkctl/cli/sparkctl.py
index e490ea0..2d66d18 100644
--- a/src/sparkctl/cli/sparkctl.py
+++ b/src/sparkctl/cli/sparkctl.py
@@ -641,10 +641,21 @@ def stop(ctx: click.Context, directory: Path) -> None:
 
 @click.command()
 @click.argument("directory", type=click.Path(path_type=Path))
+@click.option(
+    "--force/--no-force",
+    is_flag=True,
+    default=False,
+    show_default=True,
+    help="Clean even if a cluster appears to be running. By default clean refuses in that case "
+    "because it would delete the files needed to stop the cluster.",
+)
 @click.pass_context
-def clean(ctx: click.Context, directory: Path) -> None:
+def clean(ctx: click.Context, directory: Path, force: bool) -> None:
     """Delete all Spark runtime files in the directory.
 
+    Stop the cluster before cleaning. By default this refuses to run while a cluster appears to be
+    running, since it deletes the state needed to stop it; pass --force to override.
+
     This also deletes the configured spark_scratch directory recursively, even when it is located
     outside the base configuration directory. Point spark_scratch at a dedicated directory.
     """
@@ -654,8 +665,9 @@ def clean(ctx: click.Context, directory: Path) -> None:
         file_level=ctx.find_root().params["file_level"],
         mode="a",
     )
-    mgr = ClusterManager.load(directory)
-    mgr.clean()
+    res = handle_sparkctl_exception(ctx, lambda: ClusterManager.load(directory).clean(force=force))
+    if res[1] != 0:
+        ctx.exit(res[1])
 
 
 def handle_sparkctl_exception(ctx: click.Context, func, *args, **kwargs) -> Any:
diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index d095255..0d93c52 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -109,8 +109,22 @@ def load(cls, directory: Path | str | None = None) -> Self:
             status = None
         return cls(config, status=status)
 
-    def clean(self) -> None:
-        """Delete all Spark runtime files generated by sparkctl in the base directory."""
+    def clean(self, force: bool = False) -> None:
+        """Delete all Spark runtime files generated by sparkctl in the base directory.
+
+        Parameters
+        ----------
+        force
+            Clean even when a cluster appears to be running. By default ``clean`` refuses in that
+            case because deleting the runtime files removes the state needed to stop the cluster.
+        """
+        if not force and self._status is not None and self._status.is_any_running():
+            msg = (
+                "A Spark cluster appears to be running (per status.json). Run `sparkctl stop` "
+                "before cleaning, otherwise the files needed to stop the cluster are deleted and "
+                "the processes are orphaned. Pass --force to clean anyway."
+            )
+            raise InvalidConfiguration(msg)
         base = self._config.directories.base
         directories = [
             self._config.directories.get_spark_conf_dir(),
diff --git a/src/sparkctl/models.py b/src/sparkctl/models.py
index d4c84d3..d2abf09 100644
--- a/src/sparkctl/models.py
+++ b/src/sparkctl/models.py
@@ -389,3 +389,7 @@ class StatusTracker(SparkctlBaseModel):
     started_thrift_server: bool = False
     started_jupyter: bool = False
     started_postgres: bool = False
+
+    def is_any_running(self) -> bool:
+        """Return True if any tracked process is recorded as running."""
+        return any(self.model_dump().values())
diff --git a/tests/test_cluster_manager.py b/tests/test_cluster_manager.py
index a54257a..0db0d0b 100644
--- a/tests/test_cluster_manager.py
+++ b/tests/test_cluster_manager.py
@@ -10,6 +10,7 @@
     SparkConfig,
 )
 from sparkctl.exceptions import InvalidConfiguration
+from sparkctl.models import StatusTracker
 
 
 def test_cluster_manager_workers(setup_local_env: tuple[SparkConfig, Path]):
@@ -23,6 +24,32 @@ def test_cluster_manager_workers(setup_local_env: tuple[SparkConfig, Path]):
     assert mgr.get_workers() == new_workers
 
 
+def test_clean_refuses_while_running(setup_local_env: tuple[SparkConfig, Path]):
+    config, tmp_path = setup_local_env
+    config.directories.base = tmp_path
+    config.directories.spark_scratch = tmp_path / "spark_scratch"
+    scratch = config.directories.spark_scratch
+    scratch.mkdir()
+    mgr = ClusterManager(config, status=StatusTracker(started_master=True))
+    with pytest.raises(InvalidConfiguration):
+        mgr.clean()
+    # The guard must not delete anything before raising.
+    assert scratch.exists()
+    # --force overrides the guard.
+    mgr.clean(force=True)
+    assert not scratch.exists()
+
+
+def test_clean_when_stopped(setup_local_env: tuple[SparkConfig, Path]):
+    config, tmp_path = setup_local_env
+    config.directories.base = tmp_path
+    config.directories.spark_scratch = tmp_path / "spark_scratch"
+    config.directories.spark_scratch.mkdir()
+    mgr = ClusterManager(config, status=StatusTracker())
+    mgr.clean()
+    assert not config.directories.spark_scratch.exists()
+
+
 def test_configure_reverse_proxy_and_prometheus(setup_local_env: tuple[SparkConfig, Path]):
     config, tmp_path = setup_local_env
     config.directories.spark_scratch = tmp_path / "spark_scratch"

From 571cf61a9a18287e1b0b87679ba4bf4f2e807d50 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 10:56:09 -0600
Subject: [PATCH 12/24] Address Copilot round 2: tar filter compat and portable
 stat in docs

- hive.py: guard the tar extraction `filter="data"` argument (PEP 706)
  behind a `tarfile.data_filter` capability check so enabling the Postgres
  Hive metastore does not TypeError on Python 3.11 patch releases before
  3.11.4, which this project still supports.
- docs/debugging: replace the GNU-only `find ... -exec stat -c` with a
  portable `ls -lt | head` that also works on macOS/BSD.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/debugging/index.md | 5 +++--
 src/sparkctl/hive.py            | 9 ++++++++-
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/docs/how_tos/debugging/index.md b/docs/how_tos/debugging/index.md
index ec5274f..0e021e2 100644
--- a/docs/how_tos/debugging/index.md
+++ b/docs/how_tos/debugging/index.md
@@ -47,9 +47,10 @@ you can tail the `stderr` files to see what is happening:
 $ tail -f spark_scratch/workers/*/*/stderr
 ```
 
-If you have many executors, you may want to tail only the most recent ones. Identify them with
+If you have many executors, you may want to tail only the most recent ones. List the `stderr`
+files newest-first with (works on both Linux and macOS):
 ```console
-$ find spark_scratch -type f -name stderr -exec stat -c '%Y %y %n' {} + 2>/dev/null | sort -n
+$ ls -lt spark_scratch/workers/*/*/stderr | head
 ```
 
 ## Spark shuffle partitions
diff --git a/src/sparkctl/hive.py b/src/sparkctl/hive.py
index 2d903c1..2df6331 100644
--- a/src/sparkctl/hive.py
+++ b/src/sparkctl/hive.py
@@ -46,7 +46,14 @@ def init_hive(config: SparkConfig):
     if hive_home.exists():
         shutil.rmtree(hive_home)
     with tarfile.open(config.binaries.hive_tarball, "r:gz") as tar:
-        tar.extractall(path=config.directories.base, filter="data")
+        # The extraction `filter` argument (PEP 706) is present on 3.12+ and on later 3.11 patch
+        # releases (3.11.4+), but not on the earliest 3.11 versions this project supports.
+        # `tarfile.data_filter` exists exactly when the argument does, so use the safe "data"
+        # filter when available; the tarball is a trusted Apache release otherwise.
+        if hasattr(tarfile, "data_filter"):
+            tar.extractall(path=config.directories.base, filter="data")
+        else:
+            tar.extractall(path=config.directories.base)
     hive_conf = hive_home / "conf"
 
     shutil.copyfile(

From a5065892ab92fff006616de80cd3175b5f81e434 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 11:05:15 -0600
Subject: [PATCH 13/24] Fix Jupyter connectivity and reduce log noise

The Jupyter server was running but unreachable: the 127.0.0.1 default
(from the earlier security fix) does not work with the standard HPC
pattern of tunneling to the compute node's hostname through a login node.

- Default jupyter_ip back to 0.0.0.0 (keep --jupyter-ip 127.0.0.1 as an
  opt-in for the bind-to-localhost workflow). Access stays protected by
  Jupyter's token.
- After startup, detect the access URL from the log and print a clean,
  copy-pasteable SSH tunnel command and token URL, so connecting does not
  depend on reading past the log noise.
- Pass --LanguageServerManager.autodetect=False to stop jupyter_lsp from
  flooding the log with tracebacks for uninstalled language servers.
- Document that the residual Node/yarn error comes from a jupyterlab
  package in the environment and is harmless (the jupyter extra installs
  only the classic notebook).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/applications/jupyter.md | 44 ++++++++++++---------
 src/sparkctl/models.py               |  9 +++--
 src/sparkctl/spark_process_runner.py | 59 ++++++++++++++++++++++++----
 tests/test_spark_process_runner.py   | 36 +++++++++++++++++
 4 files changed, 117 insertions(+), 31 deletions(-)

diff --git a/docs/how_tos/applications/jupyter.md b/docs/how_tos/applications/jupyter.md
index 67e3780..dbe595d 100644
--- a/docs/how_tos/applications/jupyter.md
+++ b/docs/how_tos/applications/jupyter.md
@@ -36,34 +36,40 @@ spark = SparkSession.builder.getOrCreate()
 spark.createDataFrame([(1, 2), (3, 4)], ["a", "b"]).show()
 ```
 
-## Find the access URL
+## Connect to the server
 
-The Jupyter access URL, including its login token, is written to `jupyter.log` in the cluster base
-directory:
+When the server starts, sparkctl logs the node it is running on, a ready-to-use SSH tunnel
+command, and the access URL (with token). It looks like:
 
-```console
-$ grep -m1 'http' jupyter.log
 ```
-
-Jupyter listens on `127.0.0.1:8889` by default. Binding to localhost keeps the server off the
-cluster network; reach it with an SSH tunnel. From your laptop, forward the port to the master node
-(use `-J <hpc-login-host>` to hop through the login node, and replace `master-node` with the node
-running the server):
-
-```console
-$ ssh -J <hpc-login-host> -L 8889:localhost:8889 master-node
+Jupyter is running on x1000c0s0b0n0 (port 8889). From your laptop, open an SSH tunnel:
+    ssh -L 8889:x1000c0s0b0n0:8889 <your-hpc-login-host>
+then browse to:
+    http://localhost:8889/tree?token=<token>
 ```
 
-Then open the URL from `jupyter.log`, replacing the host with `localhost`. Change the port with
-`--jupyter-port`.
+Run the `ssh` command from your laptop (replacing `<your-hpc-login-host>` with your cluster's login
+host), then open the `http://localhost:8889/...` URL in your browser. The same information is always
+available in `jupyter.log` in the cluster base directory. Change the port with `--jupyter-port`.
+
+Jupyter listens on all interfaces (`0.0.0.0`) by default so it is reachable by tunneling to the
+compute node's hostname through a login node, which is the portable HPC pattern. Access is protected
+by Jupyter's token.
 
 ```{eval-rst}
-.. note:: If you cannot reach the master node directly, ``--jupyter-ip 0.0.0.0`` makes Jupyter
-   listen on all interfaces so you can tunnel through the login node to the master's hostname. This
-   exposes the server to the cluster network (it is still protected by Jupyter's access token), so
-   prefer the localhost default when possible.
+.. note:: To bind to localhost only, pass ``--jupyter-ip 127.0.0.1``. The server is then off the
+   cluster network, but you must tunnel directly into the compute node, e.g.
+   ``ssh -J <hpc-login-host> -L 8889:localhost:8889 <node>``.
 ```
 
+## Reducing log noise
+
+If `jupyter.log` is noisy, note that the most verbose tracebacks come from optional integrations,
+not from sparkctl: language-server probing is disabled automatically, but a `jupyterlab` package
+installed in your environment runs a build check at startup that can log a Node/yarn error. It is
+harmless. Installing only the classic notebook (`pip install "sparkctl[jupyter]"`, without
+`jupyterlab`) avoids it.
+
 ## Stopping
 
 `sparkctl stop` shuts the Jupyter server down along with the rest of the cluster.
diff --git a/src/sparkctl/models.py b/src/sparkctl/models.py
index d2abf09..f1ec9ee 100644
--- a/src/sparkctl/models.py
+++ b/src/sparkctl/models.py
@@ -112,10 +112,11 @@ class SparkRuntimeParams(SparkctlBaseModel):
         "Defaults to the classic 'notebook'; use 'lab' for JupyterLab.",
     )
     jupyter_ip: str = Field(
-        default="127.0.0.1",
-        description="IP address the Jupyter server binds to. Defaults to localhost, which is "
-        "secure and works with an SSH tunnel to the master node. Set to 0.0.0.0 to listen on all "
-        "interfaces (only if you understand the exposure).",
+        default="0.0.0.0",
+        description="IP address the Jupyter server binds to. Defaults to all interfaces so it can "
+        "be reached by tunneling to the compute node's hostname through a login node (the common "
+        "HPC pattern); access is protected by Jupyter's token. Set to 127.0.0.1 to bind to "
+        "localhost only, which requires tunneling directly into the compute node.",
     )
     jupyter_port: int = Field(
         default=8889,
diff --git a/src/sparkctl/spark_process_runner.py b/src/sparkctl/spark_process_runner.py
index 6a71eec..5cdaeef 100644
--- a/src/sparkctl/spark_process_runner.py
+++ b/src/sparkctl/spark_process_runner.py
@@ -1,4 +1,5 @@
 import os
+import re
 import shlex
 import shutil
 import signal
@@ -7,6 +8,7 @@
 import time
 from concurrent.futures import ThreadPoolExecutor, as_completed
 from pathlib import Path
+from socket import gethostname
 from typing import Any
 
 from loguru import logger
@@ -90,6 +92,10 @@ def start_jupyter_server(self) -> None:
             f"--port={port}",
             f"--ip={self._config.runtime.jupyter_ip}",
             f"--notebook-dir={self._config.directories.base}",
+            # Stop jupyter_lsp from probing for language servers that are not installed, which
+            # otherwise floods the log with tracebacks. Passed as config (dotted form) so it is
+            # ignored harmlessly when jupyter_lsp is not present.
+            "--LanguageServerManager.autodetect=False",
         ]
         logger.info("Start Jupyter server: {}", " ".join(cmd))
         with open(log_file, "w", encoding="utf-8") as f_out:
@@ -101,17 +107,54 @@ def start_jupyter_server(self) -> None:
                 start_new_session=True,
                 env=env,
             )
-        time.sleep(1)
-        ret = proc.poll()
-        if ret is not None:
-            msg = f"The Jupyter server exited immediately with return code {ret}. See {log_file}."
-            raise ExecutionError(msg)
+        url = self._wait_for_jupyter_url(proc, log_file)
         pid_file.write_text(f"{proc.pid}\n", encoding="utf-8")
+        self._log_jupyter_access(url, port, log_file)
+
+    def _wait_for_jupyter_url(self, proc: "subprocess.Popen[bytes]", log_file: Path) -> str | None:
+        """Wait for the server to report its access URL, returning it (or None on timeout).
+
+        Also fails fast if the process exits before it is ready.
+        """
+        url_regex = re.compile(r"https?://\S+/(?:tree|lab)\?token=\w+")
+        for _ in range(40):  # up to ~20 seconds
+            ret = proc.poll()
+            if ret is not None:
+                msg = f"The Jupyter server exited with return code {ret}. See {log_file}."
+                raise ExecutionError(msg)
+            if log_file.exists():
+                match = url_regex.search(log_file.read_text(encoding="utf-8"))
+                if match:
+                    return match.group(0)
+            time.sleep(0.5)
+        return None
+
+    def _log_jupyter_access(self, url: str | None, port: int, log_file: Path) -> None:
+        if url is None:
+            logger.warning(
+                "Started the Jupyter server, but did not detect its access URL within the timeout. "
+                "Find the URL (with token) in {}.",
+                log_file,
+            )
+            return
+
+        host = gethostname()
+        token_match = re.search(r"token=(\w+)", url)
+        token = f"?token={token_match.group(1)}" if token_match else ""
+        path = "lab" if self._config.runtime.jupyter_command == "lab" else "tree"
         logger.info(
-            "Started Jupyter server with pid {} on port {}. The access URL (with token) is in {}.",
-            proc.pid,
+            "Jupyter is running on {} (port {}). From your laptop, open an SSH tunnel:\n"
+            "    ssh -L {}:{}:{} <your-hpc-login-host>\n"
+            "then browse to:\n"
+            "    http://localhost:{}/{}{}",
+            host,
+            port,
+            port,
+            host,
+            port,
             port,
-            log_file,
+            path,
+            token,
         )
 
     def stop_jupyter_server(self) -> int:
diff --git a/tests/test_spark_process_runner.py b/tests/test_spark_process_runner.py
index 3e5df61..8f9afef 100644
--- a/tests/test_spark_process_runner.py
+++ b/tests/test_spark_process_runner.py
@@ -1,4 +1,5 @@
 import os
+import shutil
 import signal
 import subprocess
 import time
@@ -49,6 +50,41 @@ def no_sleep(monkeypatch):
     monkeypatch.setattr(time, "sleep", lambda _: None)
 
 
+def test_start_jupyter_server(tmp_path, monkeypatch, no_sleep):
+    config = make_config(tmp_path, ComputeEnvironment.NATIVE)
+    config.runtime.start_jupyter = True
+    config.runtime.jupyter_port = 9999
+    log_file = config.directories.base / "jupyter.log"
+    captured = {}
+
+    def fake_popen(cmd, **kwargs):
+        captured["cmd"] = cmd
+        # Simulate the server writing its startup banner to the redirected log.
+        log_file.write_text("http://127.0.0.1:9999/tree?token=abc123\n", encoding="utf-8")
+        return FakePopen(cmd, **kwargs)
+
+    monkeypatch.setattr(shutil, "which", lambda name: "/usr/bin/jupyter")
+    monkeypatch.setattr(subprocess, "Popen", fake_popen)
+    runner = SparkProcessRunner(config, SPARK_URL)
+    runner.start_jupyter_server()
+
+    cmd = captured["cmd"]
+    assert cmd[:2] == ["/usr/bin/jupyter", "notebook"]
+    # The default binds to all interfaces so the node is reachable through a login-node tunnel.
+    assert "--ip=0.0.0.0" in cmd
+    assert "--port=9999" in cmd
+    assert "--LanguageServerManager.autodetect=False" in cmd
+    assert (config.directories.base / "jupyter.pid").read_text(encoding="utf-8").strip() == "12345"
+
+
+def test_start_jupyter_server_not_installed(tmp_path, monkeypatch):
+    config = make_config(tmp_path, ComputeEnvironment.NATIVE)
+    monkeypatch.setattr(shutil, "which", lambda name: None)
+    runner = SparkProcessRunner(config, SPARK_URL)
+    with pytest.raises(ExecutionError):
+        runner.start_jupyter_server()
+
+
 def test_start_worker_processes_srun(tmp_path, monkeypatch, no_sleep):
     config = make_config(tmp_path, ComputeEnvironment.SLURM)
     captured = {}

From 2057c18b65cff66852d35242ada359cb4017966a Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 11:24:41 -0600
Subject: [PATCH 14/24] Improve Jupyter user documentation

- Add "Working in the notebook" (kernel environment, where notebooks are
  saved) and a "Troubleshooting" section to the Jupyter how-to, and link
  to the Spark Connect tutorial.
- Surface Jupyter in the tutorials decision guide so users looking for an
  interactive/notebook workflow can find it.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/applications/jupyter.md | 21 +++++++++++++++++++++
 docs/tutorials/index.md              |  1 +
 2 files changed, 22 insertions(+)

diff --git a/docs/how_tos/applications/jupyter.md b/docs/how_tos/applications/jupyter.md
index dbe595d..7f673f7 100644
--- a/docs/how_tos/applications/jupyter.md
+++ b/docs/how_tos/applications/jupyter.md
@@ -62,6 +62,27 @@ by Jupyter's token.
    ``ssh -J <hpc-login-host> -L 8889:localhost:8889 <node>``.
 ```
 
+## Working in the notebook
+
+The notebook server runs in the same environment as sparkctl, so its Python kernel already has
+`pyspark-client` available. With the Connect server enabled, every notebook connects to the cluster
+through `SPARK_REMOTE` — just call `SparkSession.builder.getOrCreate()` as shown above. See the
+[Spark Connect tutorial](../../tutorials/run_python_spark_jobs_spark_connect.md) for more on what
+the Connect client supports.
+
+Notebooks are served from the cluster base directory, so any notebooks you create are saved there
+and persist after the cluster stops.
+
+## Troubleshooting
+
+- **The browser cannot connect.** Confirm the SSH tunnel from the startup banner is running, and
+  that you opened the URL with its `?token=...` (copy it from the banner or `jupyter.log`). If you
+  set `--jupyter-ip 127.0.0.1`, the tunnel must terminate on the compute node itself.
+- **`Address already in use`.** Another process holds the port; choose a different one with
+  `--jupyter-port`.
+- **`SparkSession` cannot reach the cluster.** Make sure you configured with `--connect-server`;
+  without it `SPARK_REMOTE` is not set and the notebook will not auto-connect.
+
 ## Reducing log noise
 
 If `jupyter.log` is noisy, note that the most verbose tracebacks come from optional integrations,
diff --git a/docs/tutorials/index.md b/docs/tutorials/index.md
index c9e4b2f..4da0bdf 100644
--- a/docs/tutorials/index.md
+++ b/docs/tutorials/index.md
@@ -21,6 +21,7 @@ These tutorials guide you through running Spark jobs on HPC clusters using spark
 
 - **"I want to control the cluster from Python code"** → [Python Library](run_python_spark_jobs_script.md)
 - **"I want to explore data interactively"** → [Interactive Development](run_python_spark_jobs_interactively.md)
+- **"I want to work in Jupyter notebooks"** → [Run a Jupyter notebook](../how_tos/applications/jupyter.md)
 - **"I use Ibis and want portable dataframe code"** → [Ibis](run_ibis_spark_jobs.md)
 - **"I want a minimal client installation"** → [Spark Connect CLI](run_python_spark_jobs_spark_connect.md)
 - **"I want to submit batch jobs"** → [spark-submit / pyspark](run_spark_jobs.md)

From d08c1a8c071f92ed67680acd0886f4d9d3028eda Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 14:05:46 -0600
Subject: [PATCH 15/24] Address Copilot round 3 and expand GPU docs

- Fix wrong config key in gpus.md (spark.task.resource.gpu.amount).
- GPU discovery script now prefers CUDA_VISIBLE_DEVICES (correct on
  Slurm and works when nvidia-smi is unavailable in executors), falls
  back to nvidia-smi, and fails fast if neither is available.
- Document what applications must do for RAPIDS vs. custom GPU code, and
  when GPUs are advantageous over CPUs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/configuration/gpus.md | 82 +++++++++++++++++++++++++++++-
 src/sparkctl/cluster_manager.py    | 20 ++++++--
 2 files changed, 98 insertions(+), 4 deletions(-)

diff --git a/docs/how_tos/configuration/gpus.md b/docs/how_tos/configuration/gpus.md
index 133493c..d858240 100644
--- a/docs/how_tos/configuration/gpus.md
+++ b/docs/how_tos/configuration/gpus.md
@@ -31,7 +31,7 @@ This generates a GPU discovery script in the cluster's `conf` directory and writ
 - `spark.task.resource.gpu.amount`
 
 By default each executor is assigned one GPU and tasks share that GPU
-(`task.resource.gpu.amount = executor_gpu_amount / executor_cores`). Tune these through your
+(`spark.task.resource.gpu.amount = executor_gpu_amount / executor_cores`). Tune these through your
 settings file:
 
 ```toml
@@ -70,3 +70,83 @@ enables `spark.rapids.sql.enabled`.
 .. note:: ``spark.jars`` is used instead of ``spark.{driver,executor}.extraClassPath`` so the
    RAPIDS jar does not conflict with the classpath entries the PostgreSQL Hive metastore sets.
 ```
+
+## What your application needs to do
+
+What you change in your application depends on *how* you intend to use the GPUs.
+
+### SQL / DataFrame workloads with RAPIDS
+
+For SQL and DataFrame queries, the RAPIDS Accelerator is mostly transparent: once the plugin is
+enabled (above), supported operators run on the GPU with no code changes. The important caveat is
+that **not every operator is GPU-accelerated** — unsupported expressions, data types, and many
+Python/Scala UDFs silently fall back to the CPU, and a query that bounces between CPU and GPU can be
+slower than staying on the CPU.
+
+Before assuming a query is GPU-accelerated, ask RAPIDS what it actually placed on the GPU:
+
+```python
+spark.conf.set("spark.rapids.sql.explain", "NOT_ON_GPU")  # log every operator that fell back
+df.explain()  # "GPU" nodes ran on the GPU; "Project"/"Filter" without "Gpu" fell back to CPU
+```
+
+Useful tuning knobs (set in your settings file's `spark_defaults` or at runtime):
+
+- `spark.rapids.sql.concurrentGpuTasks` (sparkctl defaults to `1`) — how many tasks share a GPU at
+  once. Raising it to `2`–`4` can improve throughput if GPU memory allows.
+- `spark.sql.files.maxPartitionBytes` — larger partitions (e.g. `512m`) give the GPU more work per
+  task, which it prefers over many tiny tasks.
+- Keep Adaptive Query Execution on (`spark.sql.adaptive.enabled true`, the Spark default).
+
+### Custom GPU code (no RAPIDS)
+
+If you call GPU libraries directly (e.g. CuPy, PyTorch, RAPIDS cuDF, or XGBoost) inside your tasks,
+RAPIDS does not apply. You still enable GPU-aware scheduling with `--gpus` so Spark assigns GPUs to
+tasks, then read the assigned GPU address from the task context and pin your library to it:
+
+```python
+from pyspark import TaskContext
+
+def run_on_gpu(rows):
+    ctx = TaskContext.get()
+    gpu = ctx.resources()["gpu"].addresses[0]  # address(es) assigned to this task
+    import cupy
+    with cupy.cuda.Device(int(gpu)):
+        ...  # your GPU work here
+
+rdd.mapPartitions(run_on_gpu).collect()
+```
+
+Pinning to the assigned address is what keeps two tasks on the same node from fighting over the same
+device. The `spark.task.resource.gpu.amount` value sparkctl writes controls how many tasks Spark
+will co-schedule on each GPU.
+
+## When are GPUs worth it?
+
+GPUs are not a blanket speedup for Spark — they help some workloads dramatically and slow others
+down. Reach for GPUs when most of these hold:
+
+- **Large data and heavy compute.** Multi-GB-to-TB scans with joins, aggregations, sorts, window
+  functions, or `expand`/`hash` heavy plans. The GPU's advantage grows with data volume; small jobs
+  are dominated by launch and transfer overhead.
+- **Columnar formats.** Parquet/ORC/CSV at scale, where RAPIDS can read and process columns
+  directly on the GPU.
+- **Operations RAPIDS supports.** Standard SQL/DataFrame expressions and supported types. Check with
+  `spark.rapids.sql.explain` (above) — a plan full of CPU fallbacks will not benefit.
+- **ML training/inference** with GPU-native libraries (XGBoost, deep learning, RAPIDS cuML).
+
+GPUs usually do **not** help, and can be slower or more expensive per result, when:
+
+- The dataset is small or the job is short — fixed GPU overhead dominates.
+- The work is dominated by **Python/Scala UDFs**, complex regex, or other operators that fall back
+  to the CPU (data must round-trip between CPU and GPU memory).
+- The job is I/O- or shuffle-network-bound rather than compute-bound.
+- Per-partition working sets exceed GPU memory, forcing spills.
+
+```{eval-rst}
+.. tip:: Before committing a workload to GPUs, run NVIDIA's
+   `Spark RAPIDS qualification tool <https://docs.nvidia.com/spark-rapids/user-guide/latest/qualification/quickstart.html>`_
+   against the CPU run's event logs. It estimates the speedup (and flags unsupported operators)
+   from a real run, which is more reliable than guessing — especially given that GPU support in
+   sparkctl is still experimental and unvalidated.
+```
diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index 0d93c52..adc857b 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -713,9 +713,23 @@ def _write_gpu_discovery_script(self) -> Path:
         # addresses. This mirrors Spark's example getGpusResources.sh.
         script.write_text(
             """#!/usr/bin/env bash
-# Generated by sparkctl. Reports the GPUs visible to Spark in the format it expects.
-ADDRS=$(nvidia-smi --query-gpu=index --format=csv,noheader | sed -e ':a' -e 'N' -e '$!ba' \\
-    -e 's/\\n/","/g')
+# Generated by sparkctl. Reports the GPUs visible to Spark in the format it expects:
+# {"name": "gpu", "addresses": ["0", "1", ...]}.
+#
+# Prefer CUDA_VISIBLE_DEVICES when it is set: on Slurm clusters it reflects exactly the GPUs
+# allocated to the job, and nvidia-smi may be unavailable in the executor environment (e.g.
+# containerized executors). Fall back to nvidia-smi otherwise, and fail fast if neither source
+# of GPU information is available.
+set -euo pipefail
+if [[ -n "${CUDA_VISIBLE_DEVICES:-}" ]]; then
+    ADDRS=$(echo "$CUDA_VISIBLE_DEVICES" | sed -e 's/,/","/g')
+elif command -v nvidia-smi >/dev/null 2>&1; then
+    ADDRS=$(nvidia-smi --query-gpu=index --format=csv,noheader | sed -e ':a' -e 'N' -e '$!ba' \\
+        -e 's/\\n/","/g')
+else
+    echo "GPU discovery failed: neither CUDA_VISIBLE_DEVICES nor nvidia-smi is available" >&2
+    exit 1
+fi
 echo "{\\"name\\": \\"gpu\\", \\"addresses\\": [\\"$ADDRS\\"]}"
 """,
             encoding="utf-8",

From 60164f27fcaf52bde4ea2bea4ac63777089932bf Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 15:40:19 -0600
Subject: [PATCH 16/24] Fail fast when executor_cores exceeds available worker
 CPUs

Previously, configuring an executor with more cores than the worker
node provides (e.g. a GPU allocation that grants GPUs but only one CPU)
produced a config that Spark could never schedule: jobs hung forever
with "Initial job has not accepted any resources". Mirror the existing
executor-memory check and raise InvalidConfiguration at configure time
with guidance to request more CPUs or lower executor_cores.

Also document this and the related "worker advertises no GPUs after
enabling --gpus without a restart" case in the debugging guide.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/debugging/index.md | 27 +++++++++++++++++++++++++++
 src/sparkctl/cluster_manager.py | 17 ++++++++++++++---
 tests/test_cluster_manager.py   | 14 ++++++++++++++
 3 files changed, 55 insertions(+), 3 deletions(-)

diff --git a/docs/how_tos/debugging/index.md b/docs/how_tos/debugging/index.md
index 0e021e2..14c473d 100644
--- a/docs/how_tos/debugging/index.md
+++ b/docs/how_tos/debugging/index.md
@@ -53,6 +53,33 @@ files newest-first with (works on both Linux and macOS):
 $ ls -lt spark_scratch/workers/*/*/stderr | head
 ```
 
+## Jobs hang with "Initial job has not accepted any resources"
+If a job never starts and the driver repeatedly logs
+
+```console
+WARN TaskSchedulerImpl: Initial job has not accepted any resources; check your cluster UI to
+ensure that workers are registered and have sufficient resources
+```
+
+then the driver registered with the master but no executor could be launched. Open the master web
+UI on port 8080 (see [above](#spark-web-ui)) and check the workers. Common causes:
+
+- **The node has fewer CPUs than `executor_cores`.** An executor must fit on a single worker, so if
+  the worker advertises fewer free cores than `executor_cores` (5 by default), no executor can be
+  scheduled and the job hangs forever. This frequently happens when a GPU allocation grants GPUs but
+  only one CPU. Check `echo $SLURM_CPUS_ON_NODE`; request more CPUs (e.g. the Slurm
+  `--cpus-per-task` option) or lower `executor_cores`, then reconfigure and restart. As of recent
+  versions sparkctl fails fast at `configure` time when `executor_cores` exceeds the available CPUs
+  rather than letting the job hang.
+- **Executor memory exceeds what the worker offers** — lower `--executor-memory-gb` (or
+  `executor_cores`).
+- **GPU scheduling was enabled but the worker advertises no GPUs.** If you ran `sparkctl configure
+  --gpus` while the cluster was already running, the worker is still advertising zero GPUs, so an
+  executor that requests a GPU can never be placed. Restart the cluster (`sparkctl stop && sparkctl
+  start`) so the worker re-runs GPU discovery. Confirm the worker's `resources` in the master UI
+  lists the expected GPU addresses, and that `conf/get_gpus_resources.sh` prints them when run in
+  the allocation.
+
 ## Spark shuffle partitions
 A common performance issue when running complex queries is due to a non-ideal setting for
 `spark.sql.shuffle.partitions`. The default Spark value is 200. Some online sources recommend
diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index adc857b..cfbb530 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -519,9 +519,20 @@ def _config_executors(self, defaults_file: Path) -> None:
         # Leave one CPU for OS and management software.
         worker_num_cpus -= 1
 
-        # Use at least one executor per node even when the node has fewer CPUs than
-        # executor_cores (e.g. a small CI runner or laptop), which would otherwise divide by zero.
-        min_executors_per_node = max(1, worker_num_cpus // self._config.runtime.executor_cores)
+        executor_cores = self._config.runtime.executor_cores
+        if worker_num_cpus < executor_cores:
+            msg = (
+                f"Each worker node has {self._intf.get_worker_num_cpus()} CPU(s) "
+                f"({worker_num_cpus} after reserving one for the OS), which is fewer than "
+                f"executor_cores ({executor_cores}). Spark cannot launch an executor that does "
+                "not fit on a single worker, so jobs would hang indefinitely with 'Initial job "
+                "has not accepted any resources'. Request more CPUs in the allocation (e.g. the "
+                "Slurm --cpus-per-task option) or lower runtime.executor_cores."
+            )
+            raise InvalidConfiguration(msg)
+
+        # The guard above ensures worker_num_cpus >= executor_cores, so this is always >= 1.
+        min_executors_per_node = worker_num_cpus // executor_cores
         if self._config.runtime.executor_memory_gb is None:
             executor_memory_gb = worker_memory_gb // min_executors_per_node
         else:
diff --git a/tests/test_cluster_manager.py b/tests/test_cluster_manager.py
index 0db0d0b..61ac590 100644
--- a/tests/test_cluster_manager.py
+++ b/tests/test_cluster_manager.py
@@ -122,6 +122,20 @@ def test_configure_gpus_with_override(setup_local_env: tuple[SparkConfig, Path])
     assert discovery_script.stat().st_mode & 0o100  # owner-executable
 
 
+def test_configure_executor_cores_exceed_worker_cpus_fails(
+    setup_local_env: tuple[SparkConfig, Path],
+):
+    config, tmp_path = setup_local_env
+    config.directories.spark_scratch = tmp_path / "spark_scratch"
+    # FakeCompute reports 12 CPUs (11 usable after reserving one for the OS). An executor that
+    # needs more cores than that can never be scheduled, so configure must fail fast rather than
+    # emit a config that hangs with "Initial job has not accepted any resources".
+    config.runtime.executor_cores = 16
+    mgr = ClusterManager.from_config(config)
+    with pytest.raises(InvalidConfiguration, match="executor_cores"):
+        mgr.configure()
+
+
 def test_configure_rapids_without_jar_fails(setup_local_env: tuple[SparkConfig, Path]):
     config, tmp_path = setup_local_env
     config.directories.spark_scratch = tmp_path / "spark_scratch"

From c0f44890cf7f766423b34b03090453f90f54bb17 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 15:47:17 -0600
Subject: [PATCH 17/24] Document monitoring GPU usage with NVIDIA tools

sparkctl's resource monitor does not capture GPU utilization, so add a
section to the GPU how-to covering nvidia-smi / dmon / nvtop, attaching
to the worker nodes in the allocation, CSV logging, multi-node
monitoring, and how to read utilization to confirm work is on the GPU.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/configuration/gpus.md | 37 ++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/docs/how_tos/configuration/gpus.md b/docs/how_tos/configuration/gpus.md
index d858240..cdd45fa 100644
--- a/docs/how_tos/configuration/gpus.md
+++ b/docs/how_tos/configuration/gpus.md
@@ -121,6 +121,43 @@ Pinning to the assigned address is what keeps two tasks on the same node from fi
 device. The `spark.task.resource.gpu.amount` value sparkctl writes controls how many tasks Spark
 will co-schedule on each GPU.
 
+## Monitor GPU usage while a job runs
+
+sparkctl's built-in resource monitor (`--resource-monitor`) only collects CPU, memory, disk, and
+network stats — **it does not capture GPU utilization**. Use NVIDIA's tools directly.
+
+GPU work happens on the **worker/executor nodes**, so monitor there, not on the node where you
+launched the driver. From a login node, attach a second shell to the same Slurm allocation:
+
+```console
+$ srun --overlap --jobid=$SLURM_JOB_ID --nodes=1 --pty bash
+```
+
+Then use any of:
+
+```console
+$ nvidia-smi -l 1                     # full table, refreshed every second
+$ nvidia-smi dmon -s pucvmet -d 1     # scrolling per-GPU metrics; best for watching a live job
+$ nvtop                               # htop-style TUI, incl. per-process GPU memory (if available)
+```
+
+To log the whole run to a CSV for later analysis:
+
+```console
+$ nvidia-smi --query-gpu=timestamp,index,utilization.gpu,utilization.memory,memory.used,power.draw \
+    --format=csv -l 1 > gpu_$(hostname).csv
+```
+
+To watch every node at once on a multi-node cluster (node names are in `conf/workers`):
+
+```console
+$ srun --overlap --jobid=$SLURM_JOB_ID --ntasks-per-node=1 nvidia-smi dmon -c 120 -d 1
+```
+
+Watch `utilization.gpu` while a query runs. Sustained high utilization means operators really are
+executing on the GPU; near-zero utilization while CPUs are busy means the work is falling back to
+the CPU — cross-check with `spark.rapids.sql.explain` (see above).
+
 ## When are GPUs worth it?
 
 GPUs are not a blanket speedup for Spark — they help some workloads dramatically and slow others

From dfc6780d9c70314331f1b921060f952a0dad673b Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 16:18:01 -0600
Subject: [PATCH 18/24] Drop experimental/untested labels from GPU features

GPU-aware scheduling and RAPIDS acceleration have now been validated on
a real GPU cluster, so remove the "EXPERIMENTAL (untested)" prefixes
from the config field descriptions (which feed the CLI help) and the
configure log messages, the warning admonition and "(experimental)"
title in the GPU how-to, and the matching caveat in the qualification
tool tip.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/configuration/gpus.md | 12 ++----------
 src/sparkctl/cluster_manager.py    |  8 ++------
 src/sparkctl/models.py             | 12 ++++++------
 3 files changed, 10 insertions(+), 22 deletions(-)

diff --git a/docs/how_tos/configuration/gpus.md b/docs/how_tos/configuration/gpus.md
index cdd45fa..8d7cc72 100644
--- a/docs/how_tos/configuration/gpus.md
+++ b/docs/how_tos/configuration/gpus.md
@@ -1,11 +1,4 @@
-# How to enable GPU acceleration (experimental)
-
-```{eval-rst}
-.. warning:: GPU support is **experimental and untested**. The options below configure Spark's
-   GPU-aware scheduling and, optionally, the NVIDIA RAPIDS Accelerator, but they have not been
-   validated on a real GPU cluster. Treat the generated settings as a starting point and expect to
-   tune them for your site.
-```
+# How to enable GPU acceleration
 
 ## GPU-aware scheduling
 
@@ -184,6 +177,5 @@ GPUs usually do **not** help, and can be slower or more expensive per result, wh
 .. tip:: Before committing a workload to GPUs, run NVIDIA's
    `Spark RAPIDS qualification tool <https://docs.nvidia.com/spark-rapids/user-guide/latest/qualification/quickstart.html>`_
    against the CPU run's event logs. It estimates the speedup (and flags unsupported operators)
-   from a real run, which is more reliable than guessing — especially given that GPU support in
-   sparkctl is still experimental and unvalidated.
+   from a real run, which is more reliable than guessing.
 ```
diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index cfbb530..4716168 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -714,9 +714,7 @@ def _enable_gpus(self, defaults_file: Path) -> None:
 spark.task.resource.gpu.amount {task_gpu_amount}
 """
             )
-        logger.warning(
-            "Enabled EXPERIMENTAL (untested) GPU scheduling with {} GPU(s) per node.", num_gpus
-        )
+        logger.warning("Enabled GPU scheduling with {} GPU(s) per node.", num_gpus)
 
     def _write_gpu_discovery_script(self) -> Path:
         script = self._config.directories.get_gpu_discovery_script_file()
@@ -772,9 +770,7 @@ def _enable_rapids(self, defaults_file: Path) -> None:
 spark.rapids.sql.concurrentGpuTasks 1
 """
             )
-        logger.warning(
-            "Enabled EXPERIMENTAL (untested) RAPIDS GPU acceleration using {}", rapids_jar
-        )
+        logger.warning("Enabled RAPIDS GPU acceleration using {}", rapids_jar)
 
     def _get_runtime_spark_driver_memory_gb(self) -> int:
         # Note that spark-defaults.conf takes precedence over our config.json.
diff --git a/src/sparkctl/models.py b/src/sparkctl/models.py
index f1ec9ee..97fbf4b 100644
--- a/src/sparkctl/models.py
+++ b/src/sparkctl/models.py
@@ -42,7 +42,7 @@ class BinaryLocations(SparkctlBaseModel):
     rapids_jar_file: Path | None = Field(
         default=None,
         description="Path to the NVIDIA RAPIDS Accelerator for Apache Spark jar file. Only "
-        "required to enable RAPIDS GPU acceleration (experimental).",
+        "required to enable RAPIDS GPU acceleration.",
     )
 
     @field_validator(
@@ -150,26 +150,26 @@ class SparkRuntimeParams(SparkctlBaseModel):
     )
     enable_gpus: bool = Field(
         default=False,
-        description="EXPERIMENTAL (untested): Enable GPU-aware scheduling. Spark workers advertise "
+        description="Enable GPU-aware scheduling. Spark workers advertise "
         "GPUs and executors/tasks request them. Requires GPUs on the worker nodes.",
     )
     gpus_per_node: int | None = Field(
         default=None,
-        description="EXPERIMENTAL (untested): Number of GPUs available on each worker node. "
+        description="Number of GPUs available on each worker node. "
         "Auto-detected from the compute environment by default.",
     )
     executor_gpu_amount: int = Field(
         default=1,
-        description="EXPERIMENTAL (untested): Number of GPUs assigned to each executor.",
+        description="Number of GPUs assigned to each executor.",
     )
     task_gpu_amount: float | None = Field(
         default=None,
-        description="EXPERIMENTAL (untested): GPUs assigned to each task. Defaults to "
+        description="GPUs assigned to each task. Defaults to "
         "executor_gpu_amount / executor_cores so that concurrent tasks share an executor's GPUs.",
     )
     enable_rapids: bool = Field(
         default=False,
-        description="EXPERIMENTAL (untested): Enable the NVIDIA RAPIDS Accelerator for Apache "
+        description="Enable the NVIDIA RAPIDS Accelerator for Apache "
         "Spark to offload SQL/DataFrame operations to GPUs. Implies enable_gpus and requires "
         "binaries.rapids_jar_file.",
     )

From 4b5c53b631c84ed23610ce7c0a6717ebfeaed501 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 16:23:07 -0600
Subject: [PATCH 19/24] Downgrade Spark/PySpark from 4.1.2 to 4.1.1 for RAPIDS
 support

The RAPIDS Accelerator supports Apache Spark up to 4.1.1 (with Scala
2.13); 4.1.2 is not a supported shim target. Pin pyspark/pyspark-client
to 4.1.1, regenerate the lockfile, update the test download URLs, and
update the deployment/tutorial/reference docs and CLI examples to 4.1.1.

Also make the .gitignore Spark pattern version-agnostic
(spark-*-bin-hadoop3*) so a version bump no longer un-ignores the
previously extracted test-data directory.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .gitignore                                      |  2 +-
 docs/faq.md                                     |  2 +-
 docs/how_tos/configuration/spark_log_level.md   |  2 +-
 docs/how_tos/getting_started/deploy_sparkctl.md |  8 ++++----
 docs/how_tos/getting_started/installation.md    |  2 +-
 docs/reference/hpc/kestrel.md                   |  4 ++--
 docs/tutorials/run_ibis_spark_jobs.md           |  4 ++--
 hpc/environment_module/sparkctl.toml            |  2 +-
 pyproject.toml                                  |  4 ++--
 src/sparkctl/cli/sparkctl.py                    |  4 ++--
 tests/conftest.py                               |  4 ++--
 uv.lock                                         | 12 ++++++------
 12 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/.gitignore b/.gitignore
index 8062556..8ae83f1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -133,7 +133,7 @@ dmypy.json
 .vscode
 
 tests/data/apache-hive-4.0.1-bin*
-tests/data/spark-4.1.2-bin-hadoop3*
+tests/data/spark-*-bin-hadoop3*
 tests/data/postgresql*
 tests/data/jdk-21.0.7.jdk*
 conf
diff --git a/docs/faq.md b/docs/faq.md
index 5497f83..cfa1b0e 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -70,7 +70,7 @@ export the relevant variables yourself, for example through `spark-env.sh` in th
 
 If you are running pyspark/spark-submit after installing via `pip install sparkctl[pyspark]`,
 your version of pyspark must match the cluster version exactly. Client version 4.1.3 is
-incompatible with cluster version 4.1.2.
+incompatible with cluster version 4.1.1.
 
 ### Why can't my workers connect to the master?
 
diff --git a/docs/how_tos/configuration/spark_log_level.md b/docs/how_tos/configuration/spark_log_level.md
index 6fbf449..02291b7 100644
--- a/docs/how_tos/configuration/spark_log_level.md
+++ b/docs/how_tos/configuration/spark_log_level.md
@@ -39,7 +39,7 @@ The `--spark-log-level` option accepts these values:
 
 With `INFO` (default), you'll see messages like:
 ```
-INFO SparkContext: Running Spark version 4.1.2
+INFO SparkContext: Running Spark version 4.1.1
 INFO ResourceUtils: Resources for spark.driver: ...
 INFO SparkContext: Submitted application: My Job
 INFO Executor: Starting executor ID driver on host ...
diff --git a/docs/how_tos/getting_started/deploy_sparkctl.md b/docs/how_tos/getting_started/deploy_sparkctl.md
index 7bad1ba..8c0fbed 100644
--- a/docs/how_tos/getting_started/deploy_sparkctl.md
+++ b/docs/how_tos/getting_started/deploy_sparkctl.md
@@ -23,14 +23,14 @@ Here is an example filesystem layout:
 ├── hadoop-3.4.1/
 ├── jdk-21.0.7/
 ├── postgresql-42.7.4.jar
-├── spark-4.1.2-bin-hadoop3/
+├── spark-4.1.1-bin-hadoop3/
 ```
 
 ## URLs
 Download locations will vary over time. Here is a set of permanent links to the specific software
-versions tested with Apache Spark v4.1.2:
+versions tested with Apache Spark v4.1.1:
 
-- https://archive.apache.org/dist/spark/spark-4.1.2/spark-4.1.2-bin-hadoop3.tgz
+- https://archive.apache.org/dist/spark/spark-4.1.1/spark-4.1.1-bin-hadoop3.tgz
 - https://download.oracle.com/java/21/archive/jdk-21.0.7_linux-x64_bin.tar.gz
 - https://archive.apache.org/dist/hadoop/common/hadoop-3.4.1/hadoop-3.4.1.tar.gz
 - https://archive.apache.org/dist/hive/hive-4.2.0/apache-hive-4.2.0-bin.tar.gz
@@ -46,7 +46,7 @@ published.
 This command will create a default sparkctl configuration file given this filesystem layout:
 ```console
 $ sparkctl default-config \
-    /datasets/images/apache_spark/spark-4.1.2-bin-hadoop3 \
+    /datasets/images/apache_spark/spark-4.1.1-bin-hadoop3 \
     /datasets/images/apache_spark/jdk-21.0.7 \
     --hadoop-path /datasets/images/apache_spark/hadoop-3.4.1 \
     --hive-tarball /datasets/images/apache_spark/apache-hive-4.2.0-bin.tar.gz \
diff --git a/docs/how_tos/getting_started/installation.md b/docs/how_tos/getting_started/installation.md
index 8d1947e..6a16ffd 100644
--- a/docs/how_tos/getting_started/installation.md
+++ b/docs/how_tos/getting_started/installation.md
@@ -114,7 +114,7 @@
 
    ```bash
    $ sparkctl default-config \
-       /datasets/images/apache_spark/spark-4.1.2-bin-hadoop3 \
+       /datasets/images/apache_spark/spark-4.1.1-bin-hadoop3 \
        /datasets/images/apache_spark/jdk-21.0.7 \
        --compute-environment slurm
    ```
diff --git a/docs/reference/hpc/kestrel.md b/docs/reference/hpc/kestrel.md
index 12f7c2d..814277b 100644
--- a/docs/reference/hpc/kestrel.md
+++ b/docs/reference/hpc/kestrel.md
@@ -11,12 +11,12 @@ Spark is installed on Kestrel. Use these locations when your configure your envi
 ├── hadoop-3.4.1/
 ├── jdk-21.0.7/
 ├── postgresql-42.7.4.jar
-├── spark-4.1.2-bin-hadoop3/
+├── spark-4.1.1-bin-hadoop3/
 ```
 
 ```console
 $ sparkctl default-config \
-    /datasets/images/apache_spark/spark-4.1.2-bin-hadoop3 \
+    /datasets/images/apache_spark/spark-4.1.1-bin-hadoop3 \
     /datasets/images/apache_spark/jdk-21.0.7 \
     --hadoop-path /datasets/images/apache_spark/hadoop-3.4.1 \
     --hive-tarball /datasets/images/apache_spark/apache-hive-4.2.0-bin.tar.gz \
diff --git a/docs/tutorials/run_ibis_spark_jobs.md b/docs/tutorials/run_ibis_spark_jobs.md
index ab5c5b3..a6db61c 100644
--- a/docs/tutorials/run_ibis_spark_jobs.md
+++ b/docs/tutorials/run_ibis_spark_jobs.md
@@ -13,10 +13,10 @@ This tutorial covers three approaches:
 ## Prerequisites
 
 Install Ibis with the PySpark backend in your Python environment. You must pin `pyspark` to
-version 4.1.2 to match sparkctl's requirements:
+version 4.1.1 to match sparkctl's requirements:
 
 ```console
-$ pip install 'ibis-framework[pyspark]' 'pyspark==4.1.2'
+$ pip install 'ibis-framework[pyspark]' 'pyspark==4.1.1'
 ```
 
 This installs Ibis with PySpark support at the version compatible with sparkctl.
diff --git a/hpc/environment_module/sparkctl.toml b/hpc/environment_module/sparkctl.toml
index 753b72f..4ba213a 100644
--- a/hpc/environment_module/sparkctl.toml
+++ b/hpc/environment_module/sparkctl.toml
@@ -14,7 +14,7 @@
 
 [binaries]
 # Required.
-spark_path = "/datasets/images/spark/spark-4.1.2-bin-hadoop3"
+spark_path = "/datasets/images/spark/spark-4.1.1-bin-hadoop3"
 java_path = "/datasets/images/spark/jdk-21.0.7+6"
 # Optional. Remove or leave commented if not deployed.
 # hadoop_path = "/datasets/images/spark/hadoop-3.4.1"
diff --git a/pyproject.toml b/pyproject.toml
index 6bdac24..de637c1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -28,7 +28,7 @@ dependencies = [
     "loguru >= 0.7.2",
     "psutil",
     "pydantic >= 2.7, < 3",
-    "pyspark-client == 4.1.2",
+    "pyspark-client == 4.1.1",
     "rich_click",
     "rmon >= 0.4.0",
     "toml",
@@ -37,7 +37,7 @@ dependencies = [
 
 [project.optional-dependencies]
 pyspark = [
-    "pyspark == 4.1.2",
+    "pyspark == 4.1.1",
 ]
 # Optional notebook frontend for `sparkctl configure --jupyter`. Installs the classic notebook
 # (the default frontend); install jupyterlab separately to use `--jupyter-command lab`.
diff --git a/src/sparkctl/cli/sparkctl.py b/src/sparkctl/cli/sparkctl.py
index 2d66d18..47b928c 100644
--- a/src/sparkctl/cli/sparkctl.py
+++ b/src/sparkctl/cli/sparkctl.py
@@ -59,10 +59,10 @@ def cli(ctx: click.Context, console_level: str, file_level: str, reraise_excepti
 \b
 Examples:\n
 $ sparkctl default-config \\ \n
-    /datasets/images/apache-spark/spark-4.1.2-bin-hadoop3 \\ \n
+    /datasets/images/apache-spark/spark-4.1.1-bin-hadoop3 \\ \n
     /datasets/images/apache-spark/jdk-21.0.7 \\ \n
     -e slurm \\ \n
-$ sparkctl default-config ~/apache-spark/spark-4.1.2-bin-hadoop3 ~/jdk-21.0.8 -e native\n
+$ sparkctl default-config ~/apache-spark/spark-4.1.1-bin-hadoop3 ~/jdk-21.0.8 -e native\n
 """
 
 
diff --git a/tests/conftest.py b/tests/conftest.py
index 7c1f02f..4092250 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -14,9 +14,9 @@
 from sparkctl.models import ComputeEnvironment
 
 
-SPARK_DIR_NAME = "spark-4.1.2-bin-hadoop3"
+SPARK_DIR_NAME = "spark-4.1.1-bin-hadoop3"
 SPARK_GZ_NAME = f"{SPARK_DIR_NAME}.tgz"
-SPARK_URL = f"https://archive.apache.org/dist/spark/spark-4.1.2/{SPARK_GZ_NAME}"
+SPARK_URL = f"https://archive.apache.org/dist/spark/spark-4.1.1/{SPARK_GZ_NAME}"
 SPARK_DIR_GZ = Path("tests") / "data" / SPARK_GZ_NAME
 SPARK_DIR = Path("tests") / "data" / SPARK_DIR_NAME
 
diff --git a/uv.lock b/uv.lock
index 18e8548..2519aee 100644
--- a/uv.lock
+++ b/uv.lock
@@ -1619,16 +1619,16 @@ wheels = [
 
 [[package]]
 name = "pyspark"
-version = "4.1.2"
+version = "4.1.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "py4j" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/5e/71/4dd20c69332a2a4bf7ece8a655c9da98e4bd9b6bcea235349c1a00399d57/pyspark-4.1.2.tar.gz", hash = "sha256:fa5d6159f700d0990a07f4f62df1b7449401dccee9cd7d5d6df8957530841602", size = 455428043, upload-time = "2026-05-21T14:49:21.785Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/19/bf/58ee13add151469c25825b7125bbf62c3bdcec05eec4d458fcb5c5516066/pyspark-4.1.1.tar.gz", hash = "sha256:77f78984aa84fbe865c717dd37b49913b4e5c97d76ef6824f932f1aefa6621ec", size = 455359625, upload-time = "2026-01-09T09:38:38.28Z" }
 
 [[package]]
 name = "pyspark-client"
-version = "4.1.2"
+version = "4.1.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "googleapis-common-protos" },
@@ -1640,7 +1640,7 @@ dependencies = [
     { name = "pyyaml" },
     { name = "zstandard" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/f4/47/57c1234c69fb87234b8d080c64775eb5a088cfbb9fe419b190cb7d7ca40e/pyspark_client-4.1.2.tar.gz", hash = "sha256:4e5ac863064c3bd6c288da7e3932c72b491cd90e294e5e91aec37e1fa1c870f5", size = 1601811, upload-time = "2026-05-21T14:49:42.352Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/41/b0/fde39357666529049f2f71235d7126c7b2d5b4c5e20c072dccf845e9a09d/pyspark_client-4.1.1.tar.gz", hash = "sha256:23bd428d1f96c7196ae8ba29facca7eb56f66b3c380294385101ec8f1872a44a", size = 1600762, upload-time = "2026-01-09T09:38:50.679Z" }
 
 [[package]]
 name = "pytest"
@@ -2156,8 +2156,8 @@ requires-dist = [
     { name = "prek", marker = "extra == 'dev'", specifier = ">=0.2,<1" },
     { name = "psutil" },
     { name = "pydantic", specifier = ">=2.7,<3" },
-    { name = "pyspark", marker = "extra == 'pyspark'", specifier = "==4.1.2" },
-    { name = "pyspark-client", specifier = "==4.1.2" },
+    { name = "pyspark", marker = "extra == 'pyspark'", specifier = "==4.1.1" },
+    { name = "pyspark-client", specifier = "==4.1.1" },
     { name = "pytest", marker = "extra == 'dev'" },
     { name = "pytest-cov", marker = "extra == 'dev'" },
     { name = "requests", marker = "extra == 'dev'" },

From 97c4d212a900b81ce642bf9fb39e1d54838ba630 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 17:10:58 -0600
Subject: [PATCH 20/24] Auto-size one executor per GPU when GPUs are enabled

The executor count was derived purely from CPU cores and memory, so a
GPU node whose core count did not divide evenly by executor_cores could
leave GPUs idle (e.g. 4 GPUs but only 3 executors fit -> 1 GPU unused).

Make executor_cores default to None (auto). When GPUs are enabled and
the user has not set it explicitly, target NVIDIA's recommended layout
of one executor per GPU by dividing the node's usable cores evenly among
the GPUs. Also cap the executor count at the GPU count so executors are
not left unschedulable for lack of a GPU, and warn when CPUs/memory
allow fewer executors than there are GPUs (some GPUs would sit idle). An
explicit executor_cores still overrides the auto sizing.

Document the behavior in the GPU how-to and update the debugging guide.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/configuration/gpus.md | 17 ++++++-
 docs/how_tos/debugging/index.md    | 11 ++--
 src/sparkctl/cli/sparkctl.py       |  3 +-
 src/sparkctl/cluster_manager.py    | 82 +++++++++++++++++++++++-------
 src/sparkctl/models.py             |  8 +--
 tests/test_cluster_manager.py      | 34 +++++++++++++
 6 files changed, 124 insertions(+), 31 deletions(-)

diff --git a/docs/how_tos/configuration/gpus.md b/docs/how_tos/configuration/gpus.md
index 8d7cc72..c9ded24 100644
--- a/docs/how_tos/configuration/gpus.md
+++ b/docs/how_tos/configuration/gpus.md
@@ -24,8 +24,20 @@ This generates a GPU discovery script in the cluster's `conf` directory and writ
 - `spark.task.resource.gpu.amount`
 
 By default each executor is assigned one GPU and tasks share that GPU
-(`spark.task.resource.gpu.amount = executor_gpu_amount / executor_cores`). Tune these through your
-settings file:
+(`spark.task.resource.gpu.amount = executor_gpu_amount / executor_cores`).
+
+### Executor sizing
+
+When GPUs are enabled and you do not set `executor_cores`, sparkctl follows NVIDIA's recommended
+layout: **one executor per GPU**, with the node's usable cores divided evenly among them. For
+example, on a node with 4 GPUs and 64 cores you get 4 executors with ~15 cores each, so every GPU is
+used and each has a healthy pool of CPU cores to feed it (I/O, decompression, shuffle). To use all
+*N* GPUs you therefore need at least *N* cores in the allocation; request cores generously (e.g.
+Slurm `--cpus-per-task` or `--exclusive`). If CPUs or memory only allow fewer executors than there
+are GPUs, sparkctl logs a warning that some GPUs will sit idle.
+
+Setting `executor_cores` explicitly overrides this and is honored as-is. Tune the GPU assignment
+through your settings file:
 
 ```toml
 [runtime]
@@ -33,6 +45,7 @@ enable_gpus = true
 gpus_per_node = 4
 executor_gpu_amount = 1
 task_gpu_amount = 0.25
+# executor_cores = 16   # optional; omit to auto-size one executor per GPU
 ```
 
 ## RAPIDS Accelerator
diff --git a/docs/how_tos/debugging/index.md b/docs/how_tos/debugging/index.md
index 14c473d..10b060e 100644
--- a/docs/how_tos/debugging/index.md
+++ b/docs/how_tos/debugging/index.md
@@ -65,12 +65,11 @@ then the driver registered with the master but no executor could be launched. Op
 UI on port 8080 (see [above](#spark-web-ui)) and check the workers. Common causes:
 
 - **The node has fewer CPUs than `executor_cores`.** An executor must fit on a single worker, so if
-  the worker advertises fewer free cores than `executor_cores` (5 by default), no executor can be
-  scheduled and the job hangs forever. This frequently happens when a GPU allocation grants GPUs but
-  only one CPU. Check `echo $SLURM_CPUS_ON_NODE`; request more CPUs (e.g. the Slurm
-  `--cpus-per-task` option) or lower `executor_cores`, then reconfigure and restart. As of recent
-  versions sparkctl fails fast at `configure` time when `executor_cores` exceeds the available CPUs
-  rather than letting the job hang.
+  the worker advertises fewer free cores than `executor_cores`, no executor can be scheduled and the
+  job hangs forever. This frequently happens when a GPU allocation grants GPUs but only one CPU.
+  Check `echo $SLURM_CPUS_ON_NODE`; request more CPUs (e.g. the Slurm `--cpus-per-task` option) or
+  lower `executor_cores`, then reconfigure and restart. As of recent versions sparkctl fails fast at
+  `configure` time when `executor_cores` exceeds the available CPUs rather than letting the job hang.
 - **Executor memory exceeds what the worker offers** — lower `--executor-memory-gb` (or
   `executor_cores`).
 - **GPU scheduling was enabled but the worker advertises no GPUs.** If you ran `sparkctl configure
diff --git a/src/sparkctl/cli/sparkctl.py b/src/sparkctl/cli/sparkctl.py
index 47b928c..60abf01 100644
--- a/src/sparkctl/cli/sparkctl.py
+++ b/src/sparkctl/cli/sparkctl.py
@@ -191,6 +191,7 @@ def _create_default_config(
     "-e",
     "--executor-cores",
     default=sparkctl_settings.runtime.get("executor_cores"),
+    type=int,
     show_default=True,
     help=SparkRuntimeParams.model_fields["executor_cores"].description,
 )
@@ -448,7 +449,7 @@ def configure(
     start: bool,
     directory: Path,
     spark_scratch: Path,
-    executor_cores: int,
+    executor_cores: int | None,
     executor_memory_gb: int,
     driver_memory_gb: int,
     node_memory_overhead_gb: int,
diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index 4716168..83f1c36 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -28,6 +28,7 @@ class ClusterManager:
 
     CONFIG_FILENAME = "config.json"
     STATUS_FILENAME = "status.json"
+    DEFAULT_EXECUTOR_CORES = 5
 
     def __init__(self, config: SparkConfig, status: StatusTracker | None = None) -> None:
         self._config = config
@@ -512,14 +513,40 @@ def _enable_dynamic_allocation(self, defaults_file: Path) -> None:
 
         logger.info("Enabled dynamic allocation")
 
+    def _get_num_gpus(self) -> int:
+        """Return the number of GPUs per worker node, from the override or auto-detection."""
+        num_gpus = self._config.runtime.gpus_per_node
+        if num_gpus is None:
+            num_gpus = self._intf.get_worker_num_gpus()
+        return num_gpus
+
+    def _resolve_executor_cores(self) -> int:
+        """Return the cores per executor, resolving the auto (None) default.
+
+        When GPUs are enabled and the user has not set executor_cores explicitly, target one
+        executor per GPU by dividing the node's usable cores evenly among the GPUs (the
+        NVIDIA-recommended layout). Otherwise fall back to the standard default.
+        """
+        rt = self._config.runtime
+        if rt.executor_cores is not None:
+            return rt.executor_cores
+        if rt.enable_gpus or rt.enable_rapids:
+            num_gpus = self._get_num_gpus()
+            if num_gpus > 0:
+                # Reserve one CPU for the OS, matching _config_executors.
+                usable_cpus = self._intf.get_worker_num_cpus() - 1
+                return max(1, usable_cpus // num_gpus)
+        return self.DEFAULT_EXECUTOR_CORES
+
     def _config_executors(self, defaults_file: Path) -> None:
+        rt = self._config.runtime
         num_workers = self._intf.get_num_workers()
-        worker_memory_gb = self._get_worker_memory_gb(self._config.runtime.driver_memory_gb)
+        worker_memory_gb = self._get_worker_memory_gb(rt.driver_memory_gb)
         worker_num_cpus = self._intf.get_worker_num_cpus()
         # Leave one CPU for OS and management software.
         worker_num_cpus -= 1
 
-        executor_cores = self._config.runtime.executor_cores
+        executor_cores = self._resolve_executor_cores()
         if worker_num_cpus < executor_cores:
             msg = (
                 f"Each worker node has {self._intf.get_worker_num_cpus()} CPU(s) "
@@ -532,11 +559,11 @@ def _config_executors(self, defaults_file: Path) -> None:
             raise InvalidConfiguration(msg)
 
         # The guard above ensures worker_num_cpus >= executor_cores, so this is always >= 1.
-        min_executors_per_node = worker_num_cpus // executor_cores
-        if self._config.runtime.executor_memory_gb is None:
-            executor_memory_gb = worker_memory_gb // min_executors_per_node
+        executors_by_cpu = worker_num_cpus // executor_cores
+        if rt.executor_memory_gb is None:
+            executor_memory_gb = worker_memory_gb // executors_by_cpu
         else:
-            executor_memory_gb = self._config.runtime.executor_memory_gb
+            executor_memory_gb = rt.executor_memory_gb
         if executor_memory_gb > worker_memory_gb:
             msg = (
                 f"{executor_memory_gb=} cannot be more than {worker_memory_gb=}. "
@@ -544,19 +571,38 @@ def _config_executors(self, defaults_file: Path) -> None:
             )
             raise InvalidConfiguration(msg)
         executors_by_mem = worker_memory_gb // executor_memory_gb
-        executors_by_cpu = min_executors_per_node
-        if executors_by_cpu <= executors_by_mem:
-            executors_per_node = executors_by_cpu
-        else:
-            executors_per_node = executors_by_mem
-
-        total_num_cpus = executors_per_node * self._config.runtime.executor_cores * num_workers
+        executors_per_node = min(executors_by_cpu, executors_by_mem)
+
+        # With GPU scheduling each executor claims executor_gpu_amount GPU(s), so a node can run at
+        # most one executor per that many GPUs. Cap the count so executors are not left
+        # unschedulable for lack of a GPU, and warn when CPUs/memory leave GPUs idle. The auto
+        # value of executor_cores already targets one executor per GPU.
+        if rt.enable_gpus or rt.enable_rapids:
+            num_gpus = self._get_num_gpus()
+            if num_gpus > 0:
+                max_executors_by_gpu = max(1, num_gpus // rt.executor_gpu_amount)
+                if executors_per_node > max_executors_by_gpu:
+                    executors_per_node = max_executors_by_gpu
+                elif executors_per_node < max_executors_by_gpu:
+                    idle_gpus = (
+                        max_executors_by_gpu - executors_per_node
+                    ) * rt.executor_gpu_amount
+                    logger.warning(
+                        "Only {} executor(s) fit per node (limited by CPUs/memory) but {} GPU(s) "
+                        "are available, so {} GPU(s) will sit idle. Lower executor_cores or "
+                        "allocate more CPUs/memory so one executor runs per GPU.",
+                        executors_per_node,
+                        num_gpus,
+                        idle_gpus,
+                    )
+
+        total_num_cpus = executors_per_node * executor_cores * num_workers
         total_num_executors = executors_per_node * num_workers
-        partitions = total_num_cpus * self._config.runtime.shuffle_partition_multiplier
+        partitions = total_num_cpus * rt.shuffle_partition_multiplier
         with open(defaults_file, "a") as f_out:
             f_out.write(
                 f"""
-spark.executor.cores {self._config.runtime.executor_cores}
+spark.executor.cores {executor_cores}
 spark.sql.shuffle.partitions {partitions}
 spark.executor.memory {executor_memory_gb}g
 """
@@ -681,9 +727,7 @@ def _configure_metrics(self, defaults_file: Path) -> None:
 
     def _enable_gpus(self, defaults_file: Path) -> None:
         rt_params = self._config.runtime
-        num_gpus = rt_params.gpus_per_node
-        if num_gpus is None:
-            num_gpus = self._intf.get_worker_num_gpus()
+        num_gpus = self._get_num_gpus()
         if num_gpus <= 0:
             msg = (
                 "GPU scheduling was enabled but no GPUs were detected on the worker nodes. "
@@ -703,7 +747,7 @@ def _enable_gpus(self, defaults_file: Path) -> None:
             task_gpu_amount = rt_params.task_gpu_amount
         else:
             # Let the cores in an executor share that executor's GPU(s) by default.
-            task_gpu_amount = executor_gpu_amount / rt_params.executor_cores
+            task_gpu_amount = executor_gpu_amount / self._resolve_executor_cores()
         with open(defaults_file, "a") as f_out:
             f_out.write(
                 f"""
diff --git a/src/sparkctl/models.py b/src/sparkctl/models.py
index 97fbf4b..62d6ab9 100644
--- a/src/sparkctl/models.py
+++ b/src/sparkctl/models.py
@@ -63,9 +63,11 @@ def make_absolute(cls, val: Path | None) -> Path | None:
 class SparkRuntimeParams(SparkctlBaseModel):
     """Controls Spark runtime parameters."""
 
-    executor_cores: int = Field(
-        default=5,
-        description="Number of cores per executor",
+    executor_cores: int | None = Field(
+        default=None,
+        description="Number of cores per executor. By default this is auto-determined: when GPUs "
+        "are enabled, sparkctl runs one executor per GPU and divides the node's cores evenly "
+        "among them (the NVIDIA-recommended layout); otherwise it defaults to 5.",
     )
     executor_memory_gb: int | None = Field(
         default=None,
diff --git a/tests/test_cluster_manager.py b/tests/test_cluster_manager.py
index 61ac590..28be38f 100644
--- a/tests/test_cluster_manager.py
+++ b/tests/test_cluster_manager.py
@@ -122,6 +122,40 @@ def test_configure_gpus_with_override(setup_local_env: tuple[SparkConfig, Path])
     assert discovery_script.stat().st_mode & 0o100  # owner-executable
 
 
+def test_configure_gpus_auto_sizes_one_executor_per_gpu(
+    setup_local_env: tuple[SparkConfig, Path],
+):
+    config, tmp_path = setup_local_env
+    config.directories.spark_scratch = tmp_path / "spark_scratch"
+    config.runtime.enable_gpus = True
+    config.runtime.gpus_per_node = 4
+    # executor_cores is left at its auto (None) default. FakeCompute reports 12 CPUs (11 usable),
+    # so one executor per GPU -> 11 // 4 = 2 cores each, and task gpu amount = 1 / 2 = 0.5.
+    assert config.runtime.executor_cores is None
+    mgr = ClusterManager.from_config(config)
+    mgr.configure()
+    defaults = config.directories.get_spark_defaults_file().read_text(encoding="utf-8")
+    assert "spark.executor.cores 2" in defaults
+    assert "spark.executor.resource.gpu.amount 1" in defaults
+    assert "spark.task.resource.gpu.amount 0.5" in defaults
+
+
+def test_configure_explicit_executor_cores_overrides_gpu_sizing(
+    setup_local_env: tuple[SparkConfig, Path],
+):
+    config, tmp_path = setup_local_env
+    config.directories.spark_scratch = tmp_path / "spark_scratch"
+    config.runtime.enable_gpus = True
+    config.runtime.gpus_per_node = 4
+    # An explicit value wins over the auto one-executor-per-GPU sizing. 11 usable CPUs // 3 = 3
+    # executors, fewer than the 4 GPUs, so one GPU is left idle (logged as a warning).
+    config.runtime.executor_cores = 3
+    mgr = ClusterManager.from_config(config)
+    mgr.configure()
+    defaults = config.directories.get_spark_defaults_file().read_text(encoding="utf-8")
+    assert "spark.executor.cores 3" in defaults
+
+
 def test_configure_executor_cores_exceed_worker_cpus_fails(
     setup_local_env: tuple[SparkConfig, Path],
 ):

From 9c6e6ff5ea3108dbfca844be861b99b4b7141507 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 17:41:14 -0600
Subject: [PATCH 21/24] Fail fast on uneven multi-node GPU allocations

sparkctl writes a single spark.worker.resource.gpu.amount for every
worker, equal to the GPU count detected where configure runs. When GPUs
are requested as a job-wide total (Slurm --gpus) instead of per node
(--gpus-per-node), Slurm can split them unevenly, so a worker with fewer
GPUs than declared silently fails to start and the job hangs with
"Initial job has not accepted any resources".

Add ComputeInterface.check_gpu_allocation() (no-op by default) and a
SlurmCompute implementation that raises InvalidConfiguration at
configure time when a multi-node job's per-node GPU count does not divide
the job-wide total evenly. A per-node request (--gpus-per-node) short
-circuits the check since it guarantees uniformity. Called from
_enable_gpus, with a note in the GPU how-to.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/how_tos/configuration/gpus.md |  8 ++++++
 src/sparkctl/cluster_manager.py    |  4 +++
 src/sparkctl/compute_interface.py  |  7 +++++
 src/sparkctl/slurm_compute.py      | 38 ++++++++++++++++++++++++++
 tests/test_slurm_compute.py        | 43 ++++++++++++++++++++++++++++++
 5 files changed, 100 insertions(+)

diff --git a/docs/how_tos/configuration/gpus.md b/docs/how_tos/configuration/gpus.md
index c9ded24..3ef95fe 100644
--- a/docs/how_tos/configuration/gpus.md
+++ b/docs/how_tos/configuration/gpus.md
@@ -26,6 +26,14 @@ This generates a GPU discovery script in the cluster's `conf` directory and writ
 By default each executor is assigned one GPU and tasks share that GPU
 (`spark.task.resource.gpu.amount = executor_gpu_amount / executor_cores`).
 
+```{eval-rst}
+.. note:: On a multi-node Slurm job every worker node must have the **same** number of GPUs, because
+   sparkctl writes a single ``spark.worker.resource.gpu.amount`` for all workers. Request GPUs
+   per node (``--gpus-per-node=4``) rather than as a job-wide total (``--gpus=4``), which Slurm can
+   split unevenly across nodes. ``sparkctl configure`` fails fast if it detects a non-uniform
+   distribution.
+```
+
 ### Executor sizing
 
 When GPUs are enabled and you do not set `executor_cores`, sparkctl follows NVIDIA's recommended
diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index 83f1c36..4c78bac 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -735,6 +735,10 @@ def _enable_gpus(self, defaults_file: Path) -> None:
             )
             raise InvalidConfiguration(msg)
 
+        # Fail fast if the allocation cannot put num_gpus on every worker (e.g. an uneven Slurm
+        # --gpus split), which would otherwise leave a worker unable to start.
+        self._intf.check_gpu_allocation()
+
         discovery_script = self._write_gpu_discovery_script()
         executor_gpu_amount = rt_params.executor_gpu_amount
         if executor_gpu_amount > num_gpus:
diff --git a/src/sparkctl/compute_interface.py b/src/sparkctl/compute_interface.py
index c5c0197..6bdfef4 100644
--- a/src/sparkctl/compute_interface.py
+++ b/src/sparkctl/compute_interface.py
@@ -55,3 +55,10 @@ def is_worker_node(self, node_name: str) -> bool:
     @abc.abstractmethod
     def run_checks(self) -> None:
         """Run checks on Slurm environment variables."""
+
+    def check_gpu_allocation(self) -> None:
+        """Validate that GPU scheduling can succeed on every worker node.
+
+        The default implementation performs no checks. Environments where worker nodes can end up
+        with differing GPU counts (e.g. Slurm) override this to fail fast.
+        """
diff --git a/src/sparkctl/slurm_compute.py b/src/sparkctl/slurm_compute.py
index 9dc877a..f976a3c 100644
--- a/src/sparkctl/slurm_compute.py
+++ b/src/sparkctl/slurm_compute.py
@@ -5,6 +5,7 @@
 from socket import gethostname
 
 from sparkctl.compute_interface import ComputeInterface
+from sparkctl.exceptions import InvalidConfiguration
 from sparkctl.models import SparkConfig
 
 
@@ -101,6 +102,43 @@ def get_worker_num_gpus(self) -> int:
             return len([x for x in visible.split(",") if x.strip()])
         return 0
 
+    def check_gpu_allocation(self) -> None:
+        # sparkctl writes a single spark.worker.resource.gpu.amount for every worker, equal to the
+        # GPU count detected on the node where `configure` runs. If the GPUs were requested as a
+        # job-wide total (Slurm --gpus) rather than per node (--gpus-per-node), Slurm can split
+        # them unevenly across nodes, leaving a worker with fewer GPUs than declared. That worker
+        # then fails to start and jobs hang with "Initial job has not accepted any resources".
+        # Fail fast when we can detect a non-uniform distribution.
+        num_workers = self.get_num_workers()
+        if num_workers <= 1:
+            return
+        num_gpus_per_node = self.get_worker_num_gpus()
+        if num_gpus_per_node <= 0:
+            return
+
+        het = self.is_heterogeneous_slurm_job()
+        # A per-node request (--gpus-per-node) guarantees the same count on every node.
+        per_node_var = "SLURM_GPUS_PER_NODE_HET_GROUP_1" if het else "SLURM_GPUS_PER_NODE"
+        if os.getenv(per_node_var) is not None:
+            return
+        if het:
+            # SLURM_GPUS would include the driver group's GPUs, so the arithmetic below is not
+            # reliable. Heterogeneous jobs normally set the per-node variable handled above.
+            return
+
+        total_gpus = _parse_slurm_gpu_count(os.getenv("SLURM_GPUS"))
+        if total_gpus is not None and total_gpus != num_gpus_per_node * num_workers:
+            msg = (
+                f"GPUs are not evenly distributed across the {num_workers} worker nodes: this node "
+                f"has {num_gpus_per_node} GPU(s) but the job was allocated {total_gpus} GPU(s) "
+                f"total ({num_gpus_per_node} x {num_workers} != {total_gpus}). sparkctl applies one "
+                "spark.worker.resource.gpu.amount to every worker, so any node with fewer GPUs will "
+                "fail to start and the job will hang with 'Initial job has not accepted any "
+                "resources'. Request a uniform per-node count with the Slurm --gpus-per-node option "
+                "(e.g. --gpus-per-node=4) instead of --gpus."
+            )
+            raise InvalidConfiguration(msg)
+
     def is_heterogeneous_slurm_job(self) -> bool:
         return "SLURM_HET_SIZE" in os.environ
 
diff --git a/tests/test_slurm_compute.py b/tests/test_slurm_compute.py
index e81815d..6cfa9f8 100644
--- a/tests/test_slurm_compute.py
+++ b/tests/test_slurm_compute.py
@@ -3,6 +3,7 @@
 
 import pytest
 
+from sparkctl.exceptions import InvalidConfiguration
 from sparkctl.models import BinaryLocations, ComputeEnvironment, ComputeParams, SparkConfig
 from sparkctl.slurm_compute import SlurmCompute
 
@@ -61,4 +62,46 @@ def test_slurm_get_worker_num_cpus_het(slurm_compute):
                 os.environ[key] = orig_val
 
 
+def test_check_gpu_allocation_uneven_raises(slurm_compute, monkeypatch):
+    # 2 worker nodes, this node has 3 GPUs, but the job total is 4 -> 3 * 2 != 4, so the GPUs were
+    # split unevenly (e.g. salloc --gpus=4 -N2 giving 3 + 1).
+    monkeypatch.setattr(slurm_compute, "get_num_workers", lambda: 2)
+    monkeypatch.setattr(slurm_compute, "get_worker_num_gpus", lambda: 3)
+    monkeypatch.delenv("SLURM_HET_SIZE", raising=False)
+    monkeypatch.delenv("SLURM_GPUS_PER_NODE", raising=False)
+    monkeypatch.setenv("SLURM_GPUS", "4")
+    with pytest.raises(InvalidConfiguration, match="evenly distributed"):
+        slurm_compute.check_gpu_allocation()
+
+
+def test_check_gpu_allocation_even_ok(slurm_compute, monkeypatch):
+    # 2 worker nodes, 4 GPUs each, job total 8 -> evenly distributed.
+    monkeypatch.setattr(slurm_compute, "get_num_workers", lambda: 2)
+    monkeypatch.setattr(slurm_compute, "get_worker_num_gpus", lambda: 4)
+    monkeypatch.delenv("SLURM_HET_SIZE", raising=False)
+    monkeypatch.delenv("SLURM_GPUS_PER_NODE", raising=False)
+    monkeypatch.setenv("SLURM_GPUS", "8")
+    slurm_compute.check_gpu_allocation()
+
+
+def test_check_gpu_allocation_per_node_request_skips_check(slurm_compute, monkeypatch):
+    # --gpus-per-node guarantees a uniform count, so the arithmetic check is skipped even when
+    # SLURM_GPUS would not divide evenly.
+    monkeypatch.setattr(slurm_compute, "get_num_workers", lambda: 2)
+    monkeypatch.setattr(slurm_compute, "get_worker_num_gpus", lambda: 4)
+    monkeypatch.delenv("SLURM_HET_SIZE", raising=False)
+    monkeypatch.setenv("SLURM_GPUS_PER_NODE", "4")
+    monkeypatch.setenv("SLURM_GPUS", "4")
+    slurm_compute.check_gpu_allocation()
+
+
+def test_check_gpu_allocation_single_node_ok(slurm_compute, monkeypatch):
+    # A single worker node cannot be uneven, so no check applies.
+    monkeypatch.setattr(slurm_compute, "get_num_workers", lambda: 1)
+    monkeypatch.setattr(slurm_compute, "get_worker_num_gpus", lambda: 3)
+    monkeypatch.delenv("SLURM_GPUS_PER_NODE", raising=False)
+    monkeypatch.setenv("SLURM_GPUS", "4")
+    slurm_compute.check_gpu_allocation()
+
+
 # TODO: get_node_names

From 06ab7bee34efe70abf765073d13cb42b96f44d23 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 17:53:30 -0600
Subject: [PATCH 22/24] Print SPARK_HOME and an interactive connect command on
 start

The startup message listed SPARK_CONF_DIR and JAVA_HOME but not
SPARK_HOME. Since sparkctl depends on pyspark-client (which bundles no
Spark distribution), an interactive `pyspark`/`spark-submit` fails with
"Could not find valid SPARK_HOME" unless SPARK_HOME points at the Spark
distribution. Add SPARK_HOME (from binaries.spark_path) to the message
plus a ready-to-paste example that adds Spark to PATH and connects a
client to the master URL.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 src/sparkctl/cluster_manager.py | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index 4c78bac..1aa2916 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -259,7 +259,10 @@ def start(self, print_env_paths: bool = True) -> None:
 
         if print_env_paths:
             _print_env_paths_msg(
-                self._config.directories.get_spark_conf_dir(), self._config.binaries.java_path
+                self._config.directories.get_spark_conf_dir(),
+                self._config.binaries.java_path,
+                self._config.binaries.spark_path,
+                url,
             )
         status_file = self._config.directories.base / self.STATUS_FILENAME
         with open(status_file, "w", encoding="utf-8") as f_out:
@@ -895,16 +898,22 @@ def _read_workers(self) -> list[str]:
         return [x for x in workers_file.read_text(encoding="utf-8").splitlines() if x]
 
 
-def _print_env_paths_msg(conf_dir: Path, java_dir: Path) -> None:
+def _print_env_paths_msg(conf_dir: Path, java_dir: Path, spark_dir: Path, url: str) -> None:
     print(
         f"""
 ###############################################################################
 
 Set these environment variables to use the Spark configuration:
 
+export SPARK_HOME={spark_dir}
 export SPARK_CONF_DIR={conf_dir}
 export JAVA_HOME={java_dir}
 
+To connect interactively, add Spark to your PATH and point a client at the master, e.g.:
+
+export PATH="$SPARK_HOME/bin:$PATH"
+pyspark --master {url}
+
 ###############################################################################
 """,
         file=sys.stderr,

From 2058030f3844049480104ac61af24cb3345bf653 Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 17:56:24 -0600
Subject: [PATCH 23/24] Set SPARK_HOME automatically alongside
 JAVA_HOME/SPARK_CONF_DIR

start() already exports SPARK_CONF_DIR and JAVA_HOME into the current
process so in-process Spark usage works; add SPARK_HOME (from
binaries.spark_path) for consistency, so a caller that shells out to
spark-submit/pyspark or builds a classic session in the same process
finds the Spark distribution. managed_cluster clears it on exit like the
others. The yielded managed_cluster session uses Spark Connect, which
does not need it, so this is purely additive.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 src/sparkctl/cluster_manager.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index 1aa2916..41c6c92 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -236,8 +236,8 @@ def get_workers(self) -> list[str]:
     def start(self, print_env_paths: bool = True) -> None:
         """Start the Spark cluster. The caller must have called :meth:`configure` beforehand.
 
-        The environment variables `SPARK_CONF_DIR` and `JAVA_HOME` are set to correct values for
-        the current process.
+        The environment variables `SPARK_HOME`, `SPARK_CONF_DIR`, and `JAVA_HOME` are set to correct
+        values for the current process.
 
         Examples
         --------
@@ -268,6 +268,7 @@ def start(self, print_env_paths: bool = True) -> None:
         with open(status_file, "w", encoding="utf-8") as f_out:
             f_out.write(tracker.model_dump_json(indent=2))
 
+        os.environ["SPARK_HOME"] = str(self._config.binaries.spark_path)
         os.environ["SPARK_CONF_DIR"] = str(self._config.directories.get_spark_conf_dir())
         os.environ["JAVA_HOME"] = str(self._config.binaries.java_path)
 
@@ -299,8 +300,8 @@ def managed_cluster(self) -> Generator[SparkSession, None, None]:
         """Configure and start the Spark cluster, yield a SparkSession in a context manager,
         stop the cluster after exit.
 
-        The environment variables `SPARK_CONF_DIR` and `JAVA_HOME` are set to correct values for
-        the current process while the context is active and cleared when complete.
+        The environment variables `SPARK_HOME`, `SPARK_CONF_DIR`, and `JAVA_HOME` are set to correct
+        values for the current process while the context is active and cleared when complete.
 
         Examples
         --------
@@ -322,6 +323,7 @@ def managed_cluster(self) -> Generator[SparkSession, None, None]:
             self.stop()
             logger.info("Stopped Spark cluster processes and SparkSession")
             # Clear the environment variables set by start()
+            os.environ.pop("SPARK_HOME", None)
             os.environ.pop("SPARK_CONF_DIR", None)
             os.environ.pop("JAVA_HOME", None)
 

From 0454775d9f979566e8dcb6d0a472a25be3b334cc Mon Sep 17 00:00:00 2001
From: Daniel Thom <daniel.thom@nlr.gov>
Date: Sat, 13 Jun 2026 18:05:06 -0600
Subject: [PATCH 24/24] Simplify connect hint and lower GPU enable logs to INFO

Drop the PATH export from the start message: sparkctl installs
pyspark-client, so the pyspark launcher is already on PATH and only needs
SPARK_HOME (shown above); prepending $SPARK_HOME/bin could shadow it with
the distribution's own launcher.

Also lower the "Enabled GPU scheduling" and "Enabled RAPIDS GPU
acceleration" messages from warning to info now that GPU/RAPIDS support
is tested and no longer experimental. The idle-GPU message stays a
warning since it flags a real misconfiguration.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 src/sparkctl/cluster_manager.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/src/sparkctl/cluster_manager.py b/src/sparkctl/cluster_manager.py
index 41c6c92..29bd4dc 100644
--- a/src/sparkctl/cluster_manager.py
+++ b/src/sparkctl/cluster_manager.py
@@ -767,7 +767,7 @@ def _enable_gpus(self, defaults_file: Path) -> None:
 spark.task.resource.gpu.amount {task_gpu_amount}
 """
             )
-        logger.warning("Enabled GPU scheduling with {} GPU(s) per node.", num_gpus)
+        logger.info("Enabled GPU scheduling with {} GPU(s) per node.", num_gpus)
 
     def _write_gpu_discovery_script(self) -> Path:
         script = self._config.directories.get_gpu_discovery_script_file()
@@ -823,7 +823,7 @@ def _enable_rapids(self, defaults_file: Path) -> None:
 spark.rapids.sql.concurrentGpuTasks 1
 """
             )
-        logger.warning("Enabled RAPIDS GPU acceleration using {}", rapids_jar)
+        logger.info("Enabled RAPIDS GPU acceleration using {}", rapids_jar)
 
     def _get_runtime_spark_driver_memory_gb(self) -> int:
         # Note that spark-defaults.conf takes precedence over our config.json.
@@ -911,9 +911,8 @@ def _print_env_paths_msg(conf_dir: Path, java_dir: Path, spark_dir: Path, url: s
 export SPARK_CONF_DIR={conf_dir}
 export JAVA_HOME={java_dir}
 
-To connect interactively, add Spark to your PATH and point a client at the master, e.g.:
+Then connect a client to the master, e.g.:
 
-export PATH="$SPARK_HOME/bin:$PATH"
 pyspark --master {url}
 
 ###############################################################################