flwr-nightly 1.26.0.dev20260123__tar.gz → 1.26.0.dev20260126__tar.gz

{flwr_nightly-1.26.0.dev20260123 → flwr_nightly-1.26.0.dev20260126}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: flwr-nightly
-Version: 1.26.0.dev20260123
+Version: 1.26.0.dev20260126
 Summary: Flower: A Friendly Federated AI Framework
 License: Apache-2.0
 Keywords: Artificial Intelligence,Federated AI,Federated Analytics,Federated Evaluation,Federated Learning,Flower,Machine Learning

{flwr_nightly-1.26.0.dev20260123 → flwr_nightly-1.26.0.dev20260126}/py/flwr/cli/app_cmd/publish.py

@@ -19,6 +19,7 @@ from contextlib import ExitStack
 from pathlib import Path
 from typing import IO, Annotated
 
+import click
 import requests
 import typer
 from requests import Response
@@ -62,12 +63,7 @@ def publish(
     auth_plugin = load_cli_auth_plugin_from_connection(SUPERGRID_ADDRESS)
     auth_plugin.load_tokens()
     if not isinstance(auth_plugin, OidcCliPlugin) or not auth_plugin.access_token:
-        typer.secho(
-            "❌ Please log in before publishing app.",
-            fg=typer.colors.RED,
-            err=True,
-        )
-        raise typer.Exit(code=1)
+        raise click.ClickException("Please log in before publishing app.")
 
     # Load token from the plugin
     token = auth_plugin.access_token
@@ -82,19 +78,17 @@ def publish(
         try:
             resp = _post_files(files_param, token)
         except requests.RequestException as err:
-            typer.secho(f"❌ Network error: {err}", fg=typer.colors.RED, err=True)
-            raise typer.Exit(code=1) from err
+            raise click.ClickException(f"Network error: {err}") from err
 
     if resp.ok:
         typer.secho("🎊 Upload successful", fg=typer.colors.GREEN, bold=True)
         return  # success
 
     # Error path:
-    msg = f"❌ Upload failed with status {resp.status_code}"
+    msg = f"Upload failed with status {resp.status_code}"
     if resp.text:
         msg += f": {resp.text}"
-    typer.secho(msg, fg=typer.colors.RED, err=True)
-    raise typer.Exit(code=1)
+    raise click.ClickException(msg)
 
 
 def _depth_of(relative_path_to_root: Path) -> int:
@@ -138,14 +132,9 @@ def _collect_file_paths(root: Path) -> list[Path]:
 
         # Check max depth
         if _depth_of(relative_path) > MAX_DIR_DEPTH:
-            typer.secho(
-                f"Error: '{path}' "
-                f"exceeds the maximum directory depth "
-                f"of {MAX_DIR_DEPTH}.",
-                fg=typer.colors.RED,
-                err=True,
+            raise click.ClickException(
+                f"'{path}' exceeds the maximum directory depth of {MAX_DIR_DEPTH}."
             )
-            raise typer.Exit(code=2)
 
         file_paths.append(path)
 
@@ -160,21 +149,15 @@ def _validate_files(file_paths: list[Path]) -> None:
     Checks file count, individual file size, total size, and UTF-8 encoding.
     """
     if len(file_paths) == 0:
-        typer.secho(
+        raise click.ClickException(
             "Nothing to upload: no files matched after applying .gitignore and "
-            "allowed extensions.",
-            fg=typer.colors.RED,
-            err=True,
+            "allowed extensions."
         )
-        raise typer.Exit(code=2)
 
     if len(file_paths) > MAX_FILE_COUNT:
-        typer.secho(
-            f"Too many files: {len(file_paths)} > allowed maximum of {MAX_FILE_COUNT}.",
-            fg=typer.colors.RED,
-            err=True,
+        raise click.ClickException(
+            f"Too many files: {len(file_paths)} > allowed maximum of {MAX_FILE_COUNT}."
         )
-        raise typer.Exit(code=2)
 
     # Calculate files size
     total_size = 0
@@ -184,34 +167,25 @@ def _validate_files(file_paths: list[Path]) -> None:
 
         # Check single file size
         if file_size > MAX_FILE_BYTES:
-            typer.secho(
+            raise click.ClickException(
                 f"File too large: '{path.as_posix()}' is {file_size:,} bytes, "
-                f"exceeding the per-file limit of {MAX_FILE_BYTES:,} bytes.",
-                fg=typer.colors.RED,
-                err=True,
+                f"exceeding the per-file limit of {MAX_FILE_BYTES:,} bytes."
             )
-            raise typer.Exit(code=2)
 
         # Ensure we can decode as UTF-8.
         try:
             path.read_text(encoding=UTF8)
         except UnicodeDecodeError as err:
-            typer.secho(
-                f"Encoding error: '{path}' is not UTF-8 encoded.",
-                fg=typer.colors.RED,
-                err=True,
-            )
-            raise typer.Exit(code=2) from err
+            raise click.ClickException(
+                f"Encoding error: '{path}' is not UTF-8 encoded."
+            ) from err
 
     # Check total files size
     if total_size > MAX_TOTAL_BYTES:
-        typer.secho(
+        raise click.ClickException(
             "Total size of all files is too large: "
-            f"{total_size:,} bytes > {MAX_TOTAL_BYTES:,} bytes.",
-            fg=typer.colors.RED,
-            err=True,
+            f"{total_size:,} bytes > {MAX_TOTAL_BYTES:,} bytes."
         )
-        raise typer.Exit(code=2)
 
     # Print validation passed prompt
     typer.echo(typer.style("✅ Validation passed", fg=typer.colors.GREEN, bold=True))

{flwr_nightly-1.26.0.dev20260123 → flwr_nightly-1.26.0.dev20260126}/py/flwr/cli/app_cmd/review.py

@@ -21,6 +21,7 @@ import re
 from pathlib import Path
 from typing import Annotated
 
+import click
 import requests
 import typer
 from cryptography.exceptions import UnsupportedAlgorithm
@@ -60,12 +61,7 @@ def review(
 
     auth_plugin.load_tokens()
     if not isinstance(auth_plugin, OidcCliPlugin) or not auth_plugin.access_token:
-        typer.secho(
-            "❌ Please log in before reviewing app.",
-            fg=typer.colors.RED,
-            err=True,
-        )
-        raise typer.Exit(code=1)
+        raise click.ClickException("Please log in before reviewing app.")
 
     # Load token from the plugin
     token = auth_plugin.access_token
@@ -74,8 +70,7 @@ def review(
     try:
         app_id, app_version = parse_app_spec(app_spec)
     except ValueError as e:
-        typer.secho(f"❌ {e}", fg=typer.colors.RED, err=True)
-        raise typer.Exit(code=1) from e
+        raise click.ClickException(str(e)) from e
 
     # Download FAB
     typer.secho("Downloading FAB... ", fg=typer.colors.BLUE)
@@ -83,8 +78,7 @@ def review(
     try:
         presigned_url, _ = request_download_link(app_id, app_version, url, "fab_url")
     except ValueError as e:
-        typer.secho(f"❌ {e}", fg=typer.colors.RED, err=True)
-        raise typer.Exit(code=1) from e
+        raise click.ClickException(str(e)) from e
 
     fab_bytes = _download_fab(presigned_url)
 
@@ -170,12 +164,7 @@ def _download_fab(url: str) -> bytes:
         r = requests.get(url, timeout=60)
         r.raise_for_status()
     except requests.RequestException as e:
-        typer.secho(
-            f"❌ FAB download failed: {e}",
-            fg=typer.colors.RED,
-            err=True,
-        )
-        raise typer.Exit(code=1) from e
+        raise click.ClickException(f"FAB download failed: {e}") from e
     return r.content
 
 
@@ -209,20 +198,14 @@ def _submit_review(
     try:
         resp = requests.post(url, headers=headers, json=payload, timeout=120)
     except requests.RequestException as e:
-        typer.secho(
-            f"❌ Network error while submitting review: {e}",
-            fg=typer.colors.RED,
-            err=True,
-        )
-        raise typer.Exit(code=1) from e
+        raise click.ClickException(f"Network error while submitting review: {e}") from e
 
     if resp.ok:
         typer.secho("🎊 Review submitted", fg=typer.colors.GREEN, bold=True)
         return
 
     # Error path:
-    msg = f"❌ Review submission failed (HTTP {resp.status_code})"
+    msg = f"Review submission failed (HTTP {resp.status_code})"
     if resp.text:
         msg += f": {resp.text}"
-    typer.secho(msg, fg=typer.colors.RED, err=True)
-    raise typer.Exit(code=1)
+    raise click.ClickException(msg)

{flwr_nightly-1.26.0.dev20260123 → flwr_nightly-1.26.0.dev20260126}/py/flwr/cli/auth_plugin/oidc_cli_plugin.py

@@ -19,6 +19,7 @@ import time
 import webbrowser
 from collections.abc import Sequence
 
+import click
 import typer
 
 from flwr.cli.constant import (
@@ -137,13 +138,9 @@ class OidcCliPlugin(CliAuthPlugin):
     ) -> Sequence[tuple[str, str | bytes]]:
         """Write authentication tokens to the provided metadata."""
         if self.access_token is None or self.refresh_token is None:
-            typer.secho(
-                "❌ Missing authentication tokens. Please login first.",
-                fg=typer.colors.RED,
-                bold=True,
-                err=True,
+            raise click.ClickException(
+                "Missing authentication tokens. Please login first."
             )
-            raise typer.Exit(code=1)
 
         return list(metadata) + [
             (ACCESS_TOKEN_KEY, self.access_token),

{flwr_nightly-1.26.0.dev20260123 → flwr_nightly-1.26.0.dev20260126}/py/flwr/cli/build.py

@@ -21,6 +21,7 @@ from io import BytesIO
 from pathlib import Path
 from typing import Annotated, Any
 
+import click
 import pathspec
 import tomli
 import tomli_w
@@ -107,35 +108,23 @@ def build(
 
     app = app.resolve()
     if not app.is_dir():
-        typer.secho(
-            f"❌ The path {app} is not a valid path to a Flower app.",
-            fg=typer.colors.RED,
-            bold=True,
-            err=True,
+        raise click.ClickException(
+            f"The path {app} is not a valid path to a Flower app."
         )
-        raise typer.Exit(code=1)
 
     if not is_valid_project_name(app.name):
-        typer.secho(
-            f"❌ The project name {app.name} is invalid, "
+        raise click.ClickException(
+            f"The project name {app.name} is invalid, "
             "a valid project name must start with a letter, "
-            "and can only contain letters, digits, and hyphens.",
-            fg=typer.colors.RED,
-            bold=True,
-            err=True,
+            "and can only contain letters, digits, and hyphens."
         )
-        raise typer.Exit(code=1)
 
     config, errors, warnings = load_and_validate(app / "pyproject.toml")
     if config is None:
-        typer.secho(
+        raise click.ClickException(
             "Project configuration could not be loaded.\npyproject.toml is invalid:\n"
-            + "\n".join([f"- {line}" for line in errors]),
-            fg=typer.colors.RED,
-            bold=True,
-            err=True,
+            + "\n".join([f"- {line}" for line in errors])
         )
-        raise typer.Exit(code=1)
 
     if warnings:
         typer.secho(

{flwr_nightly-1.26.0.dev20260123 → flwr_nightly-1.26.0.dev20260126}/py/flwr/cli/config/ls.py

@@ -19,6 +19,7 @@ import io
 import json
 from typing import Annotated
 
+import click
 import typer
 from rich.console import Console
 
@@ -66,6 +67,8 @@ def ls(
             }
             Console().print_json(json.dumps(conn))
         else:
+            typer.secho("Flower Config file: ", fg=typer.colors.BLUE, nl=False)
+            typer.secho(f"{config_path}", fg=typer.colors.GREEN)
             typer.secho("SuperLink connections:", fg=typer.colors.BLUE)
             # List SuperLink connections and highlight default
             for k in connection_names:
@@ -77,26 +80,18 @@ def ls(
                         nl=False,
                     )
                 typer.echo()
-    except typer.Exit as err:
-        # log the error if json format requested
-        # else do nothing since it will be logged by typer
-        if suppress_output:
-            restore_output()
-            e_message = captured_output.getvalue()
-            print_json_error(e_message, err)
 
     except Exception as err:  # pylint: disable=broad-except
+        # log the error if json format requested
         if suppress_output:
             restore_output()
             e_message = captured_output.getvalue()
             print_json_error(e_message, err)
         else:
-            typer.secho(
-                f"❌ An unexpected error occurred while listing the SuperLink "
-                f"connections in the Flower configuration file ({config_path}): {err}",
-                fg=typer.colors.RED,
-                err=True,
-            )
+            raise click.ClickException(
+                f"An unexpected error occurred while listing the SuperLink "
+                f"connections in the Flower configuration file ({config_path}): {err}"
+            ) from err
 
     finally:
         if suppress_output:

{flwr_nightly-1.26.0.dev20260123 → flwr_nightly-1.26.0.dev20260126}/py/flwr/cli/config_utils.py

@@ -18,8 +18,8 @@
 from pathlib import Path
 from typing import Any
 
+import click
 import tomli
-import typer
 
 from flwr.cli.typing import SuperLinkConnection
 from flwr.common.config import (
@@ -137,22 +137,18 @@ def validate_federation_in_project_config(
 
     Raises
     ------
-    typer.Exit
+    click.ClickException
         If no federation name provided and no default found, or if federation
         doesn't exist in config.
     """
     federation = federation or config["tool"]["flwr"]["federations"].get("default")
 
     if federation is None:
-        typer.secho(
-            "❌ No federation name was provided and the project's `pyproject.toml` "
+        raise click.ClickException(
+            "No federation name was provided and the project's `pyproject.toml` "
             "doesn't declare a default federation (with an Control API address or an "
-            "`options.num-supernodes` value).",
-            fg=typer.colors.RED,
-            bold=True,
-            err=True,
+            "`options.num-supernodes` value)."
         )
-        raise typer.Exit(code=1)
 
     # Validate the federation exists in the configuration
     federation_config = config["tool"]["flwr"]["federations"].get(federation)
@@ -160,15 +156,11 @@ def validate_federation_in_project_config(
         available_feds = {
             fed for fed in config["tool"]["flwr"]["federations"] if fed != "default"
         }
-        typer.secho(
-            f"❌ There is no `{federation}` federation declared in the "
+        raise click.ClickException(
+            f"There is no `{federation}` federation declared in the "
             "`pyproject.toml`.\n The following federations were found:\n\n"
-            + "\n".join(available_feds),
-            fg=typer.colors.RED,
-            bold=True,
-            err=True,
+            + "\n".join(available_feds)
         )
-        raise typer.Exit(code=1)
 
     # Override the federation configuration if provided
     if overrides:
@@ -198,32 +190,24 @@ def load_certificate_in_connection(
     ------
     ValueError
         If required TLS settings are missing.
-    typer.Exit
+    click.ClickException
         If the configuration is invalid or the certificate file cannot be read.
     """
     # Process root certificates
     if root_certificates := connection.root_certificates:
         if connection.insecure:
-            typer.secho(
-                "❌ `root-certificates` were provided but the `insecure` parameter "
-                "is set to `True`.",
-                fg=typer.colors.RED,
-                bold=True,
-                err=True,
+            raise click.ClickException(
+                "`root-certificates` were provided but the `insecure` parameter "
+                "is set to `True`."
             )
-            raise typer.Exit(code=1)
 
         # TLS is enabled with self-signed certificates: attempt to read the file
         try:
             root_certificates_bytes = Path(root_certificates).read_bytes()
         except Exception as e:
-            typer.secho(
-                f"❌ Failed to read certificate file `{root_certificates}`: {e}",
-                fg=typer.colors.RED,
-                bold=True,
-                err=True,
-            )
-            raise typer.Exit(code=1) from e
+            raise click.ClickException(
+                f"Failed to read certificate file `{root_certificates}`: {e}"
+            ) from e
     else:
         root_certificates_bytes = None
 
@@ -245,7 +229,7 @@ def get_insecure_flag(federation_config: dict[str, Any]) -> bool:
 
     Raises
     ------
-    typer.Exit
+    click.ClickException
         If insecure value is not a boolean type.
     """
     insecure_value = federation_config.get("insecure")
@@ -255,11 +239,7 @@ def get_insecure_flag(federation_config: dict[str, Any]) -> bool:
         return False
     if isinstance(insecure_value, bool):
         return insecure_value
-    typer.secho(
-        "❌ Invalid type for `insecure`: expected a boolean if provided. "
-        "(`insecure = true` or `insecure = false`)",
-        fg=typer.colors.RED,
-        bold=True,
-        err=True,
+    raise click.ClickException(
+        "Invalid type for `insecure`: expected a boolean if provided. "
+        "(`insecure = true` or `insecure = false`)"
     )
-    raise typer.Exit(code=1)

{flwr_nightly-1.26.0.dev20260123 → flwr_nightly-1.26.0.dev20260126}/py/flwr/cli/federation/ls.py

@@ -18,6 +18,7 @@
 import io
 from typing import Annotated, Any
 
+import click
 import typer
 from rich.console import Console
 from rich.table import Table
@@ -112,18 +113,13 @@ def ls(  # pylint: disable=R0914, R0913, R0917, R0912
         finally:
             if channel:
                 channel.close()
-    except (typer.Exit, Exception) as err:  # pylint: disable=broad-except
+    except Exception as err:  # pylint: disable=broad-except
         if suppress_output:
             restore_output()
             e_message = captured_output.getvalue()
             print_json_error(e_message, err)
         else:
-            typer.secho(
-                f"{err}",
-                fg=typer.colors.RED,
-                bold=True,
-                err=True,
-            )
+            raise click.ClickException(str(err)) from None
     finally:
         if suppress_output:
             restore_output()

{flwr_nightly-1.26.0.dev20260123 → flwr_nightly-1.26.0.dev20260126}/py/flwr/cli/flower_config.py

@@ -19,6 +19,7 @@ import re
 from pathlib import Path
 from typing import Any, cast
 
+import click
 import tomli
 import tomli_w
 import typer
@@ -251,7 +252,7 @@ def read_superlink_connection(
 
     Raises
     ------
-    typer.Exit
+    click.ClickException
         Raised if the configuration file is corrupted, or if the requested
         connection (or default) cannot be found.
     """
@@ -266,56 +267,42 @@ def read_superlink_connection(
 
         # Exit when no connection name is available
         if connection_name is None:
-            typer.secho(
-                "❌ No SuperLink connection set. A SuperLink connection needs to be "
+            raise click.ClickException(
+                "No SuperLink connection set. A SuperLink connection needs to be "
                 "provided or one must be set as default in the Flower "
                 f"configuration file ({config_path}). Specify a default SuperLink "
                 "connection by adding: \n\n[superlink]\ndefault = 'connection_name'\n\n"
-                f"to the Flower configuration file ({config_path}).",
-                fg=typer.colors.RED,
-                err=True,
+                f"to the Flower configuration file ({config_path})."
             )
-            raise typer.Exit(code=1)
 
         # Try to find the connection with the given name
         if connection_name not in superlink_config:
-            typer.secho(
-                f"❌ SuperLink connection '{connection_name}' not found in the "
-                f"Flower configuration file ({config_path}).",
-                fg=typer.colors.RED,
-                err=True,
+            msg = (
+                f"SuperLink connection '{connection_name}' not found in the "
+                f"Flower configuration file ({config_path})."
             )
             # If default was used, show a specific error message
             if connection_name == superlink_config.get(
                 SuperLinkConnectionTomlKey.DEFAULT
             ):
-                typer.secho(
-                    f"Please check that the default connection '{connection_name}' "
-                    "is defined in the [superlink] section.",
-                    fg=typer.colors.RED,
-                    err=True,
+                msg += (
+                    f"\nPlease check that the default connection '{connection_name}' "
+                    "is defined in the [superlink] section."
                 )
-            raise typer.Exit(code=1)
+            raise click.ClickException(msg)
 
         conn_dict = superlink_config[connection_name]
         return parse_superlink_connection(conn_dict, connection_name)
 
     except ValueError as err:
-        typer.secho(
-            f"❌ Failed to parse the Flower configuration file ({config_path}). "
-            f"{err}",
-            fg=typer.colors.RED,
-            err=True,
-        )
-        raise typer.Exit(code=1) from err
+        raise click.ClickException(
+            f"Failed to parse the Flower configuration file ({config_path}). {err}"
+        ) from err
     except Exception as err:
-        typer.secho(
-            f"❌ An unexpected error occurred while reading the Flower configuration "
-            f"file ({config_path}). {err}",
-            fg=typer.colors.RED,
-            err=True,
-        )
-        raise typer.Exit(code=1) from err
+        raise click.ClickException(
+            f"An unexpected error occurred while reading the Flower configuration "
+            f"file ({config_path}). {err}"
+        ) from err
 
 
 def write_superlink_connection(connection: SuperLinkConnection) -> None:
@@ -328,7 +315,7 @@ def write_superlink_connection(connection: SuperLinkConnection) -> None:
 
     Raises
     ------
-    typer.Exit
+    click.ClickException
         Raised if the configuration file cannot be read or written.
     """
     toml_dict, _ = read_flower_config()
@@ -358,13 +345,10 @@ def set_default_superlink_connection(connection_name: str) -> None:
 
     # Check if the connection exists
     if connection_name not in superlink_config:
-        typer.secho(
-            f"❌ SuperLink connection '{connection_name}' not found in the Flower "
-            "configuration file. Cannot set as default.",
-            fg=typer.colors.RED,
-            err=True,
+        raise click.ClickException(
+            f"SuperLink connection '{connection_name}' not found in the Flower "
+            "configuration file. Cannot set as default."
         )
-        raise typer.Exit(code=1)
 
     # Set default connection
     superlink_config[SuperLinkConnectionTomlKey.DEFAULT] = connection_name
@@ -384,7 +368,7 @@ def read_flower_config() -> tuple[dict[str, Any], Path]:
 
     Raises
     ------
-    typer.Exit
+    click.ClickException
         Raised if the configuration file is corrupted.
     """
     init_flwr_config()
@@ -396,13 +380,10 @@ def read_flower_config() -> tuple[dict[str, Any], Path]:
             return tomli.load(file), config_path
 
     except tomli.TOMLDecodeError as err:
-        typer.secho(
-            f"❌ Failed to read the Flower configuration file ({config_path}). "
-            "Please ensure it is valid TOML.",
-            fg=typer.colors.RED,
-            err=True,
-        )
-        raise typer.Exit(code=1) from err
+        raise click.ClickException(
+            f"Failed to read the Flower configuration file ({config_path}). "
+            "Please ensure it is valid TOML."
+        ) from err
 
 
 # This function may be subject to change once we introduce more configuration