nextmv 0.39.0.dev0__py3-none-any.whl → 0.40.0__py3-none-any.whl

nextmv/__about__.py

@@ -1 +1 @@
-__version__ = "v0.39.0.dev0"
+__version__ = "v0.40.0"

nextmv/cli/community/clone.py

@@ -0,0 +1,270 @@
+"""
+This module defines the community clone command for the Nextmv CLI.
+"""
+
+import os
+import shutil
+import tarfile
+import tempfile
+from collections.abc import Callable
+from typing import Annotated
+
+import rich
+import typer
+
+from nextmv.cli.community.list import download_file, download_manifest, find_app, versions_table
+from nextmv.cli.error import error
+from nextmv.cli.options import ProfileOption
+
+# Set up subcommand application.
+app = typer.Typer()
+
+# Helpful constants.
+LATEST_VERSION = "latest"
+
+
+@app.command()
+def clone(
+    app: Annotated[
+        str,
+        typer.Option("--app", "-a", help="The name of the community app to clone.", metavar="COMMUNITY_APP"),
+    ],
+    directory: Annotated[
+        str | None,
+        typer.Option(
+            "--directory",
+            "-d",
+            help="The directory in which to clone the app. Default is the name of the app at current directory.",
+            metavar="DIRECTORY",
+        ),
+    ] = None,
+    version: Annotated[
+        str | None,
+        typer.Option(
+            "--version",
+            "-v",
+            help="The version of the community app to clone.",
+            metavar="VERSION",
+        ),
+    ] = LATEST_VERSION,
+    profile: ProfileOption = None,
+) -> None:
+    """
+    Clone a community app locally.
+
+    By default, the [magenta]latest[/magenta] version will be used. You can
+    specify a version with the [code]--version[/code] flag, and customize the
+    output directory with the [code]--directory[/code] flag. If you want to
+    list the available apps, use the [code]nextmv community list[/code] command.
+
+    [bold][underline]Examples[/underline][/bold]
+
+    - Clone the [magenta]go-nextroute[/magenta] community app (under the
+      [magenta]"go-nextroute"[/magenta] directory), using the [magenta]latest[/magenta] version.
+        $ [green]nextmv community clone --app go-nextroute[/green]
+
+    - Clone the [magenta]go-nextroute[/magenta] community app under the
+      [magenta]"~/sample/my_app"[/magenta] directory, using the [magenta]latest[/magenta] version.
+        $ [green]nextmv community clone --app go-nextroute --directory ~/sample/my_app[/green]
+
+    - Clone the [magenta]go-nextroute[/magenta] community app (under the
+      [magenta]"go-nextroute"[/magenta] directory), using version [magenta]v1.2.0[/magenta].
+        $ [green]nextmv community clone --app go-nextroute --version v1.2.0[/green]
+
+    - Clone the [magenta]go-nextroute[/magenta] community app (under the
+      [magenta]"go-nextroute"[/magenta] directory), using the [magenta]latest[/magenta] version
+      and a profile named [magenta]hare[/magenta].
+        $ [green]nextmv community clone --app go-nextroute --profile hare[/green]
+    """
+
+    manifest = download_manifest(profile=profile)
+    app_obj = find_app(manifest, app)
+
+    if version is not None and version == "":
+        error("The [code]--version[/code] flag cannot be an empty string.")
+
+    if not app_has_version(app_obj, version):
+        # We don't use error() here to allow printing something before exiting.
+        rich.print(
+            f"[red]Error:[/red] Version [magenta]{version}[/magenta] not found "
+            f"for community app [magenta]{app}[/magenta]. Available versions are:"
+        )
+        versions_table(manifest, app)
+
+        raise typer.Exit(code=1)
+
+    original_version = version
+    if version == LATEST_VERSION:
+        version = app_obj.get("latest_app_version")
+
+    destination = directory
+    if directory is None or directory == "":
+        destination = app
+
+    full_destination = get_valid_path(destination, os.stat)
+    os.makedirs(full_destination, exist_ok=True)
+
+    tarball = f"{app}_{version}.tar.gz"
+    s3_file_path = f"{app}/{version}/{tarball}"
+    downloaded_object = download_object(
+        file=s3_file_path,
+        path="community-apps",
+        output_dir=full_destination,
+        output_file=tarball,
+        profile=profile,
+    )
+
+    # Extract the tarball to a temporary directory to handle nested structure
+    with tempfile.TemporaryDirectory() as temp_dir:
+        with tarfile.open(downloaded_object, "r:gz") as tar:
+            tar.extractall(path=temp_dir)
+
+        # Find the extracted directory (typically the app name)
+        extracted_items = os.listdir(temp_dir)
+        if len(extracted_items) == 1 and os.path.isdir(os.path.join(temp_dir, extracted_items[0])):
+            # Move contents from the extracted directory to full_destination
+            extracted_dir = os.path.join(temp_dir, extracted_items[0])
+            for item in os.listdir(extracted_dir):
+                shutil.move(os.path.join(extracted_dir, item), full_destination)
+        else:
+            # If structure is unexpected, move everything directly
+            for item in extracted_items:
+                shutil.move(os.path.join(temp_dir, item), full_destination)
+
+    # Remove the tarball after extraction
+    os.remove(downloaded_object)
+
+    rich.print(
+        f":white_check_mark: Successfully cloned the [magenta]{app}[/magenta] community app, "
+        f"using version [magenta]{original_version}[/magenta] in path: [magenta]{full_destination}[/magenta]."
+    )
+
+
+def app_has_version(app_obj: dict, version: str) -> bool:
+    """
+    Check if the given app object has the specified version.
+
+    Parameters
+    ----------
+    app_obj : dict
+        The community app object.
+    version : str
+        The version to check.
+
+    Returns
+    -------
+    bool
+        True if the app has the specified version, False otherwise.
+    """
+
+    if version == LATEST_VERSION:
+        version = app_obj.get("latest_app_version")
+
+    if version in app_obj.get("app_versions", []):
+        return True
+
+    return False
+
+
+def get_valid_path(path: str, stat_fn: Callable[[str], os.stat_result], ending: str = "") -> str:
+    """
+    Validates and returns a non-existing path. If the path exists,
+    it will append a number to the path and return it. If the path does not
+    exist, it will return the path as is.
+
+    The ending parameter is used to check if the path ends with a specific
+    string. This is useful to specify if it is a file (like foo.json, in which
+    case the next iteration is foo-1.json) or a directory (like foo, in which
+    case the next iteration is foo-1).
+
+    Parameters
+    ----------
+    path : str
+        The initial path to validate.
+    stat_fn : Callable[[str], os.stat_result]
+        A function that takes a path and returns its stat result.
+    ending : str, optional
+        The expected ending of the path (e.g., file extension), by default "".
+
+    Returns
+    -------
+    str
+        A valid, non-existing path.
+
+    Raises
+    ------
+    Exception
+        If an unexpected error occurs during path validation
+    """
+    base_name = os.path.basename(path)
+    name_without_ending = base_name.removesuffix(ending) if ending else base_name
+
+    while True:
+        try:
+            stat_fn(path)
+            # If we get here, the path exists
+            # Get folder/file name number, increase it and create new path
+            name = os.path.basename(path)
+
+            # Get folder/file name number
+            parts = name.split("-")
+            last = parts[-1].removesuffix(ending) if ending else parts[-1]
+
+            # Save last folder name index to be changed
+            i = path.rfind(name)
+
+            try:
+                num = int(last)
+                # Increase number and create new path
+                if ending:
+                    temp_path = path[:i] + f"{name_without_ending}-{num + 1}{ending}"
+                else:
+                    temp_path = path[:i] + f"{base_name}-{num + 1}"
+                path = temp_path
+            except ValueError:
+                # If there is no number, add it
+                if ending:
+                    temp_path = path[:i] + f"{name_without_ending}-1{ending}"
+                else:
+                    temp_path = path[:i] + f"{name}-1"
+                path = temp_path
+
+        except FileNotFoundError:
+            # Path doesn't exist, we can use it
+            return path
+        except Exception:
+            # Re-raise unexpected errors
+            error(f"An unexpected error occurred while validating the path: {path}")
+
+
+def download_object(file: str, path: str, output_dir: str, output_file: str, profile: str | None = None) -> str:
+    """
+    Downloads an object from the internal bucket and saves it to the specified
+    output directory.
+
+    Parameters
+    ----------
+    file : str
+        The name of the file to download.
+    path : str
+        The directory in the bucket where the file is located.
+    output_dir : str
+        The local directory where the file will be saved.
+    output_file : str
+        The name of the output file.
+    profile : str | None
+        The profile name to use. If None, the default profile is used.
+
+    Returns
+    -------
+    str
+        The path to the downloaded file.
+    """
+
+    response = download_file(directory=path, file=file, profile=profile)
+    file_name = os.path.join(output_dir, output_file)
+
+    with open(file_name, "wb") as f:
+        f.write(response.content)
+
+    return file_name

nextmv/cli/community/community.py

@@ -0,0 +1,24 @@
+"""
+This module defines the community command tree for the Nextmv CLI.
+"""
+
+import typer
+
+from nextmv.cli.community.clone import app as clone_app
+from nextmv.cli.community.list import app as list_app
+
+# Set up subcommand application.
+app = typer.Typer()
+app.add_typer(list_app)
+app.add_typer(clone_app)
+
+
+@app.callback()
+def callback() -> None:
+    """
+    Interact with community apps, which are pre-built decision models.
+
+    Community apps are maintained in the following GitHub repository:
+    [link=https://github.com/nextmv-io/community-apps][bold]nextmv-io/community-apps[/bold][/link].
+    """
+    pass

nextmv/cli/community/list.py

@@ -0,0 +1,265 @@
+"""
+This module defines the community list command for the Nextmv CLI.
+"""
+
+from typing import Annotated, Any
+
+import requests
+import rich
+import typer
+import yaml
+from rich.console import Console
+from rich.table import Table
+
+from nextmv.cli.configuration.config import build_client
+from nextmv.cli.error import error
+from nextmv.cli.options import ProfileOption
+
+# Set up subcommand application.
+app = typer.Typer()
+console = Console()
+
+
+@app.command()
+def list(
+    app: Annotated[
+        str | None,
+        typer.Option(
+            "--app",
+            "-a",
+            help="The community app to list versions for.",
+            metavar="COMMUNITY_APP",
+        ),
+    ] = None,
+    flat: Annotated[bool, typer.Option("--flat", "-f", help="Flatten the list output.")] = False,
+    profile: ProfileOption = None,
+) -> None:
+    """
+    List the available community apps
+
+    Use the [code]--app[/code] flag to list that app's versions. Use the
+    [code]--flat[/code] flag to flatten the list of names/versions. If you
+    want to clone a community app locally, use the [code]nextmv community clone[/code] command.
+
+    [bold][underline]Examples[/underline][/bold]
+
+    - List the available community apps.
+        $ [green]nextmv community list[/green]
+
+    - List the available versions of the [magenta]go-nextroute[/magenta] community app.
+        $ [green]nextmv community list --app go-nextroute[/green]
+
+    - List the names of the available community apps as a flat list.
+        $ [green]nextmv community list --flat[/green]
+
+    - List the available versions of the [magenta]go-nextroute[/magenta] community app as a flat list.
+        $ [green]nextmv community list --app go-nextroute --flat[/green]
+
+    - List the available community apps using a profile named [magenta]hare[/magenta].
+        $ [green]nextmv community list --profile hare[/green]
+    """
+
+    if app is not None and app == "":
+        error("The [code]--app[/code] flag cannot be an empty string.")
+
+    manifest = download_manifest(profile=profile)
+    if flat and app is None:
+        apps_list(manifest)
+        raise typer.Exit()
+    elif not flat and app is None:
+        apps_table(manifest)
+        raise typer.Exit()
+    elif flat and app is not None and app != "":
+        versions_list(manifest, app)
+        raise typer.Exit()
+    elif not flat and app is not None and app != "":
+        versions_table(manifest, app)
+        raise typer.Exit()
+
+
+def download_manifest(profile: str | None = None) -> dict:
+    """
+    Downloads and returns the community apps manifest.
+
+    Parameters
+    ----------
+    profile : str | None
+        The profile name to use. If None, the default profile is used.
+
+    Returns
+    -------
+    dict
+        The community apps manifest as a dictionary.
+
+    Raises
+    requests.HTTPError
+        If the response status code is not 2xx.
+    """
+
+    response = download_file(directory="community-apps", file="manifest.yml", profile=profile)
+    manifest = yaml.safe_load(response.text)
+
+    return manifest
+
+
+def apps_table(manifest: dict[str, Any]) -> None:
+    """
+    This function prints a table of community apps from the manifest.
+
+    Parameters
+    ----------
+    manifest : dict[str, Any]
+        The community apps manifest.
+    """
+
+    table = Table("Name", "Type", "Latest", "Description", border_style="cyan", header_style="cyan")
+    for app in manifest.get("apps", []):
+        table.add_row(
+            app.get("name", ""),
+            app.get("type", ""),
+            app.get("latest_app_version", ""),
+            app.get("description", ""),
+        )
+
+    console.print(table)
+
+
+def apps_list(manifest: dict[str, Any]) -> None:
+    """
+    This function prints a flat list of community app names from the manifest.
+
+    Parameters
+    ----------
+    manifest : dict[str, Any]
+        The community apps manifest.
+    """
+
+    names = [app.get("name", "") for app in manifest.get("apps", [])]
+    print("\n".join(names))
+
+
+def versions_table(manifest: dict[str, Any], app: str) -> None:
+    """
+    This function prints a table of versions for a specific community app.
+
+    Parameters
+    ----------
+    manifest : dict[str, Any]
+        The community apps manifest.
+    app : str
+        The name of the community app.
+    """
+
+    app_obj = find_app(manifest, app)
+    latest_version = app_obj.get("latest_app_version", "")
+
+    # Add the latest version with indicator
+    table = Table("Version", "Latest?", border_style="cyan", header_style="cyan")
+    table.add_row(f"[cyan underline]{latest_version}[/cyan underline]", "[cyan]<--[/cyan]")
+    table.add_row("", "")  # Empty row to separate latest from others.
+
+    # Add all other versions (excluding the latest)
+    versions = app_obj.get("app_versions", [])
+    for version in versions:
+        if version != latest_version:
+            table.add_row(version, "")
+
+    console.print(table)
+
+
+def versions_list(manifest: dict[str, Any], app: str) -> None:
+    """
+    This function prints a flat list of versions for a specific community app.
+
+    Parameters
+    ----------
+    manifest : dict[str, Any]
+        The community apps manifest.
+    app : str
+        The name of the community app.
+    """
+
+    app_obj = find_app(manifest, app)
+    versions = app_obj.get("app_versions", [])
+
+    versions_output = ""
+    for version in versions:
+        versions_output += f"{version}\n"
+
+    print("\n".join(app_obj.get("app_versions", [])))
+
+
+def download_file(
+    directory: str,
+    file: str,
+    profile: str | None = None,
+) -> requests.Response:
+    """
+    Gets a file from an internal bucket and return it.
+
+    Parameters
+    ----------
+    directory : str
+        The directory in the bucket where the file is located.
+    file : str
+        The name of the file to download.
+    profile : str | None
+        The profile name to use. If None, the default profile is used.
+
+    Returns
+    -------
+    requests.Response
+        The response object containing the file data.
+
+    Raises
+    requests.HTTPError
+        If the response status code is not 2xx.
+    """
+
+    client = build_client(profile)
+
+    # Request the download URL for the file.
+    response = client.request(
+        method="GET",
+        endpoint="v0/internal/tools",
+        headers=client.headers | {"request-source": "cli"},  # Pass `client.headers` to preserve auth.
+        query_params={"file": f"{directory}/{file}"},
+    )
+
+    # Use the URL obtained to download the file.
+    body = response.json()
+    download_response = client.request(
+        method="GET",
+        endpoint=body.get("url"),
+        headers={"Content-Type": "application/json"},
+    )
+
+    return download_response
+
+
+def find_app(manifest: dict[str, Any], app: str) -> dict[str, Any] | None:
+    """
+    Finds and returns a community app from the manifest by its name.
+
+    Parameters
+    ----------
+    manifest : dict[str, Any]
+        The community apps manifest.
+    app : str
+        The name of the community app to find.
+
+    Returns
+    -------
+    dict[str, Any] | None
+        The community app dictionary if found, otherwise None.
+    """
+
+    for manifest_app in manifest.get("apps", []):
+        if manifest_app.get("name", "") == app:
+            return manifest_app
+
+    # We don't use error() here to allow printing something before exiting.
+    rich.print(f"[red]Error:[/red] Community app [magenta]{app}[/magenta] was not found. Here are the available apps:")
+    apps_table(manifest)
+
+    raise typer.Exit(code=1)

nextmv/cli/configuration/config.py

@@ -0,0 +1,131 @@
+"""
+This module contains configuration utilities for the Nextmv CLI.
+"""
+
+from pathlib import Path
+from typing import Any
+
+import yaml
+
+from nextmv.cli.error import error
+from nextmv.cloud.client import Client
+
+# Some useful constants.
+CONFIG_DIR = Path.home() / ".nextmv"
+CONFIG_FILE = CONFIG_DIR / "config.yaml"
+API_KEY_KEY = "apikey"
+ENDPOINT_KEY = "endpoint"
+DEFAULT_ENDPOINT = "api.cloud.nextmv.io"
+GO_CLI_PATH = CONFIG_DIR / "nextmv"
+
+
+def load_config() -> dict[str, Any]:
+    """
+    Load the current configuration from the config file. Returns an empty
+    dictionary if no configuration file exists.
+
+    Returns
+    -------
+    dict[str, Any]
+        The current configuration as a dictionary.
+    """
+
+    if not CONFIG_FILE.exists():
+        return {}
+
+    with CONFIG_FILE.open() as file:
+        config = yaml.safe_load(file)
+
+    if config is None:
+        return {}
+    return config
+
+
+def save_config(config: dict[str, Any]) -> None:
+    """
+    Save the given configuration to the config file.
+
+    Parameters
+    ----------
+    config : dict[str, Any]
+        The configuration to save.
+    """
+
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+
+    with CONFIG_FILE.open("w") as file:
+        yaml.safe_dump(config, file)
+
+
+def build_client(profile: str | None = None) -> Client:
+    """
+    Builds a `cloud.Client` using the API key and endpoint for the given
+    profile. If no profile is given, the default profile is used. If either the
+    API key or endpoint is missing, an exception is raised. If the config is
+    not available, an exception is raised.
+
+    Parameters
+    ----------
+    profile : str | None
+        The profile name to use. If None, the default profile is used.
+
+    Returns
+    -------
+    Client
+        A client configured with the API key and endpoint for the selected
+        profile or the default configuration.
+
+    Raises
+    ------
+    typer.Exit
+        If no configuration is found, if the requested profile does not exist,
+        or if the API key or endpoint (for either the selected profile or the
+        default configuration) is not set or is empty.
+    """
+
+    config = load_config()
+    if config == {}:
+        error("No configuration found. Please run [code]nextmv configuration create[/code].")
+
+    if profile is not None:
+        if profile not in config:
+            error(f"Profile [bold magenta]{profile}[/bold magenta] does not exist.")
+
+        api_key = config[profile].get(API_KEY_KEY)
+        if api_key is None or api_key == "":
+            error(f"API key for profile [bold magenta]{profile}[/bold magenta] is not set or is empty.")
+
+        endpoint = config[profile].get(ENDPOINT_KEY)
+        if endpoint is None or endpoint == "":
+            error(f"Endpoint for profile [bold magenta]{profile}[/bold magenta] is not set or is empty.")
+    else:
+        api_key = config.get(API_KEY_KEY)
+        if api_key is None or api_key == "":
+            error("Default API key is not set or is empty.")
+
+        endpoint = config.get(ENDPOINT_KEY)
+        if endpoint is None or endpoint == "":
+            error("Default endpoint is not set or is empty.")
+
+    return Client(api_key=api_key, url=f"https://{endpoint}")
+
+
+def obscure_api_key(api_key: str) -> str:
+    """
+    Obscure an API key for display purposes.
+
+    Parameters
+    ----------
+    api_key : str
+        The API key to obscure.
+
+    Returns
+    -------
+    str
+        The obscured API key.
+    """
+
+    if len(api_key) <= 4:
+        return "*" * len(api_key)
+
+    return api_key[:2] + "*" * 4 + api_key[-2:]

nextmv/cli/configuration/configuration.py

@@ -0,0 +1,23 @@
+"""
+This module defines the configuration command tree for the Nextmv CLI.
+"""
+
+import typer
+
+from nextmv.cli.configuration.create import app as create_app
+from nextmv.cli.configuration.delete import app as delete_app
+from nextmv.cli.configuration.list import app as list_app
+
+# Set up subcommand application.
+app = typer.Typer()
+app.add_typer(create_app)
+app.add_typer(delete_app)
+app.add_typer(list_app)
+
+
+@app.callback()
+def callback() -> None:
+    """
+    Configure the CLI and manage profiles.
+    """
+    pass

nextmv/cli/configuration/create.py

@@ -0,0 +1,95 @@
+"""
+This module defines the configuration create command for the Nextmv CLI.
+"""
+
+from typing import Annotated
+
+import rich
+import typer
+
+from nextmv.cli.configuration.config import (
+    API_KEY_KEY,
+    DEFAULT_ENDPOINT,
+    ENDPOINT_KEY,
+    load_config,
+    obscure_api_key,
+    save_config,
+)
+from nextmv.cli.error import error
+
+# Set up subcommand application.
+app = typer.Typer()
+
+
+@app.command()
+def create(
+    api_key: Annotated[
+        str,
+        typer.Option(
+            "--api-key",
+            "-a",
+            help="A valid Nextmv Cloud API key. "
+            + "Get one from [link=https://cloud.nextmv.io][bold]https://cloud.nextmv.io[/bold][/link].",
+            envvar="NEXTMV_API_KEY",
+            metavar="NEXTMV_API_KEY",
+        ),
+    ],
+    profile: Annotated[  # Similar to nextmv.cli.options.ProfileOption but with different help text.
+        str | None,
+        typer.Option(
+            "--profile",
+            "-p",
+            help="Profile name to save the configuration under.",
+            envvar="NEXTMV_PROFILE",
+            metavar="PROFILE_NAME",
+        ),
+    ] = None,
+    endpoint: Annotated[  # Hidden because it is meant for internal use.
+        str | None,
+        typer.Option(
+            "--endpoint",
+            "-e",
+            hidden=True,
+        ),
+    ] = DEFAULT_ENDPOINT,
+) -> None:
+    """
+    Create a new configuration or update an existing one.
+
+    [bold][underline]Examples[/underline][/bold]
+
+    - Default configuration.
+        $ [green]nextmv configuration create --api-key NEXTMV_API_KEY[/green]
+
+    - Configure a profile named [italic]hare[/italic].
+        $ [green]nextmv configuration create --api-key NEXTMV_API_KEY --profile hare[/green]
+    """
+
+    if profile is not None and profile.strip().lower() == "default":
+        error("[code]default[/code] is a reserved profile name.")
+
+    endpoint = str(endpoint)
+    if endpoint.startswith("https://"):
+        endpoint = endpoint[len("https://") :]
+    elif endpoint.startswith("http://"):
+        endpoint = endpoint[len("http://") :]
+
+    config = load_config()
+
+    if profile is None:
+        config[API_KEY_KEY] = api_key
+        config[ENDPOINT_KEY] = endpoint
+    else:
+        if profile not in config:
+            config[profile] = {}
+
+        config[profile][API_KEY_KEY] = api_key
+        config[profile][ENDPOINT_KEY] = endpoint
+
+    save_config(config)
+
+    rich.print(":white_check_mark: Configuration saved successfully.")
+    rich.print(f"\t[bold]Profile[/bold]: {profile or 'Default'}")
+    rich.print(f"\t[bold]API Key[/bold]: {obscure_api_key(api_key)}")
+    if endpoint != DEFAULT_ENDPOINT:
+        rich.print(f"\t[bold]Endpoint[/bold]: {endpoint}")

nextmv/cli/configuration/delete.py

@@ -0,0 +1,55 @@
+"""
+This module defines the configuration delete command for the Nextmv CLI.
+"""
+
+from typing import Annotated
+
+import rich
+import typer
+from rich.prompt import Confirm
+
+from nextmv.cli.configuration.config import load_config, save_config
+from nextmv.cli.error import error
+
+# Set up subcommand application.
+app = typer.Typer()
+
+
+@app.command()
+def delete(
+    profile: Annotated[  # Similar to nextmv.cli.options.ProfileOption but with different help text.
+        str,
+        typer.Option(
+            "--profile",
+            "-p",
+            help="Profile name to delete.",
+            envvar="NEXTMV_PROFILE",
+            metavar="PROFILE_NAME",
+        ),
+    ],
+) -> None:
+    """
+    Delete a profile from the configuration.
+
+    [bold][underline]Examples[/underline][/bold]
+
+    - Delete a profile named [magenta]hare[/magenta].
+        $ [green]nextmv configuration delete --profile hare[/green]
+    """
+    config = load_config()
+    if profile not in config:
+        error(f"Profile [bold magenta]{profile}[/bold magenta] does not exist.")
+
+    confirm = Confirm.ask(
+        f"Are you sure you want to delete profile [bold magenta]{profile}[/bold magenta]? This action cannot be undone",
+        default=False,
+    )
+
+    if not confirm:
+        rich.print(f":bulb: Profile [bold magenta]{profile}[/bold magenta] will not be deleted.")
+        return
+
+    del config[profile]
+    save_config(config)
+
+    rich.print(f":white_check_mark: Profile [bold magenta]{profile}[/bold magenta] deleted successfully.")

nextmv/cli/configuration/list.py

@@ -0,0 +1,77 @@
+"""
+This module defines the configuration list command for the Nextmv CLI.
+"""
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from nextmv.cli.configuration.config import API_KEY_KEY, ENDPOINT_KEY, load_config, obscure_api_key
+from nextmv.cli.error import error
+
+# Set up subcommand application.
+app = typer.Typer()
+console = Console()
+
+
+@app.command()
+def list() -> None:
+    """
+    List the current configuration and all profiles.
+
+    [bold][underline]Examples[/underline][/bold]
+
+    - Show current configuration and all profiles.
+        $ [green]nextmv configuration list[/green]
+    """
+
+    config = load_config()
+    if config == {}:
+        error("No configuration found. Please run [code]nextmv configuration[/code].")
+
+    default = {
+        "api_key": config.get(API_KEY_KEY),
+        "endpoint": config.get(ENDPOINT_KEY),
+        "name": "Default",
+    }
+    profiles = [default]
+
+    for k, v in config.items():
+        # Skip default configuration.
+        if k in {API_KEY_KEY, ENDPOINT_KEY}:
+            continue
+
+        profile = {
+            "name": k,
+            "api_key": v.get(API_KEY_KEY),
+            "endpoint": v.get(ENDPOINT_KEY),
+        }
+        profiles.append(profile)
+
+    table = Table("Profile name", "API Key", "Endpoint")
+    not_set = "[italic]Not set[/italic]"
+    for profile in profiles:
+        if profile["name"] != "Default":
+            table.add_row(
+                profile["name"],
+                obscure_api_key(profile["api_key"]) if profile.get("api_key") is not None else not_set,
+                profile["endpoint"] if profile.get("endpoint") is not None else not_set,
+            )
+            continue
+
+        api_key = not_set
+        if profile.get("api_key") is not None:
+            api_key = obscure_api_key(profile["api_key"])
+
+        endpoint = not_set
+        if profile.get("endpoint") is not None:
+            endpoint = profile["endpoint"]
+
+        table.add_row(
+            f"[bold yellow]{profile['name']}[/bold yellow]",
+            f"[bold yellow]{api_key}[/bold yellow]",
+            f"[bold yellow]{endpoint}[/bold yellow]",
+        )
+        table.add_section()
+
+    console.print(table)

nextmv/cli/error.py

@@ -0,0 +1,22 @@
+import rich
+import typer
+
+
+def error(msg: str) -> None:
+    """
+    Pretty-print an error message and exit with code 1. Your message should end
+    with a period.
+
+    Parameters
+    ----------
+    msg : str
+        The error message to display.
+
+    Raises
+    ------
+    typer.Exit
+        Exits the program with code 1.
+    """
+
+    rich.print(f"[red]Error:[/red] {msg}")
+    raise typer.Exit(code=1)

nextmv/cli/main.py

@@ -1,11 +1,146 @@
+"""
+The Nextmv Command Line Interface (CLI).
+
+This module is the main entry point for the Nextmv CLI application. The Nextmv
+CLI is built with [Typer](https://typer.tiangolo.com/) and provides various
+commands to interact with Nextmv services. You should visit the "Learn" section
+of the Typer documentation to learn about the features that are used here.
+
+The Nextmv CLI also uses [Rich](https://rich.readthedocs.io/en/stable/) for
+rich text and formatting in the terminal. The command documentation is created
+using Rich markup. You should also visit the Rich documentation to learn more
+about the features used here. An example of Rich markup can be found in the
+epilog of the Typer application defined below.
+"""
+
+import os
+
+import rich
 import typer
+from rich.prompt import Confirm
 
+from nextmv.cli.community.community import app as community_app
+from nextmv.cli.configuration.config import CONFIG_DIR, GO_CLI_PATH, load_config
+from nextmv.cli.configuration.configuration import app as configuration_app
+from nextmv.cli.error import error
 from nextmv.cli.version import app as version_app
 
+# Main CLI application.
 app = typer.Typer(
     help="The Nextmv Command Line Interface (CLI).",
-    epilog="[italic]:rabbit: Made with :heart: by Nextmv.[/italic]",
+    epilog="[dim]\n---\n\n[italic]:rabbit: Made by Nextmv with :heart:[/italic][/dim]",
     rich_markup_mode="rich",
     context_settings={"help_option_names": ["--help", "-h"]},
+    no_args_is_help=True,
 )
+
+# Register subcommands. The `name` parameter is required when the subcommand
+# module has a callback function defined.
+app.add_typer(community_app, name="community")
+app.add_typer(configuration_app, name="configuration")
 app.add_typer(version_app)
+
+
+@app.callback()
+def callback(ctx: typer.Context) -> None:
+    """
+    Callback function that runs before any command. Useful for checks on the
+    environment.
+    """
+
+    handle_go_cli()
+    handle_config_existence(ctx)
+
+
+def handle_go_cli() -> None:
+    """
+    Handle the presence of the deprecated Go CLI by notifying the user.
+
+    This function checks if the Go CLI is installed and prompts the user to
+    remove it to avoid conflicts with the Python CLI.
+    """
+
+    exists = go_cli_exists()
+    if exists:
+        delete = Confirm.ask(
+            "Do you want to delete the [italic red]deprecated[/italic red] Nextmv CLI "
+            f"at [italic]{GO_CLI_PATH}[/italic] now?",
+            default=True,
+        )
+        if delete:
+            remove_go_cli()
+        else:
+            rich.print(
+                ":bulb: You can delete the [italic red]deprecated[/italic red] Nextmv CLI "
+                f"later by removing [italic]{GO_CLI_PATH}[/italic]. Make sure you also clean up your [code]PATH[/code]."
+            )
+
+
+def handle_config_existence(ctx: typer.Context) -> None:
+    """
+    Check if configuration exists and show an error if it does not.
+
+    Parameters
+    ----------
+    ctx : typer.Context
+        The Typer context object.
+    """
+
+    ignored_commands = {"configuration", "version"}
+    if ctx.invoked_subcommand in ignored_commands:
+        return
+
+    config = load_config()
+    if config == {}:
+        error("No configuration found. Please run [code]nextmv configuration create[/code].")
+
+
+def go_cli_exists() -> bool:
+    """
+    Check if the Go CLI is installed by looking for the 'nextmv' executable
+    under the config dir.
+
+    Returns
+    -------
+    bool
+        True if the Go CLI is installed, False otherwise.
+    """
+
+    # Check if the Go CLI executable exists
+    exists = GO_CLI_PATH.exists()
+    if exists:
+        rich.print(
+            ":construction: A [italic red]deprecated[/italic red] Nextmv CLI is installed at "
+            f"[italic]{GO_CLI_PATH}[/italic]. You must delete it to avoid conflicts."
+        )
+
+    check_config_in_path()
+
+    return exists
+
+
+def remove_go_cli() -> None:
+    """
+    Remove the Go CLI executable if it exists and notify about PATH cleanup.
+    """
+
+    if GO_CLI_PATH.exists():
+        GO_CLI_PATH.unlink()
+        rich.print(f":white_check_mark: Deleted deprecated {GO_CLI_PATH}.")
+
+    check_config_in_path()
+
+
+def check_config_in_path() -> None:
+    """
+    Check if the configuration directory is in the PATH and notify the user.
+    """
+
+    path_dirs = os.environ.get("PATH", "").split(os.pathsep)
+    config_dir_str = str(CONFIG_DIR)
+
+    if config_dir_str in path_dirs:
+        rich.print(
+            f":construction: [italic]{CONFIG_DIR}[/italic] was found in your [code]PATH[/code]. "
+            f"You should remove any entries related to [italic]{CONFIG_DIR}[/italic] from your [code]PATH[/code]."
+        )

nextmv/cli/options.py

@@ -0,0 +1,24 @@
+"""
+Shared CLI options for the Nextmv CLI.
+
+This module defines reusable option types that can be imported
+and used across all CLI commands.
+"""
+
+from typing import Annotated
+
+import typer
+
+# profile option - can be used in any command to specify which profile to use.
+# Define it as follows in commands or callbacks, as necessary:
+# profile: ProfileOption = None
+ProfileOption = Annotated[
+    str | None,
+    typer.Option(
+        "--profile",
+        "-p",
+        help="Profile to use for this action. Use [code]nextmv configuration[/code] to manage profiles.",
+        envvar="NEXTMV_PROFILE",
+        metavar="PROFILE_NAME",
+    ),
+]

nextmv/cli/version.py

@@ -1,14 +1,19 @@
+"""
+This module defines the version command for the Nextmv CLI.
+"""
+
 import typer
-from rich import print
 
 from nextmv.__about__ import __version__
 
+# Set up subcommand application.
 app = typer.Typer()
 
 
 @app.command()
-def version() -> str:
+def version() -> None:
     """
     Show the current version of the Nextmv CLI.
     """
+
     print(__version__)

{nextmv-0.39.0.dev0.dist-info → nextmv-0.40.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextmv
-Version: 0.39.0.dev0
+Version: 0.40.0
 Summary: The all-purpose Python SDK for Nextmv
 Project-URL: Homepage, https://www.nextmv.io
 Project-URL: Documentation, https://nextmv-py.docs.nextmv.io/en/latest/nextmv/

{nextmv-0.39.0.dev0.dist-info → nextmv-0.40.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-nextmv/__about__.py,sha256=VcVUeQ5_BqdMabUFhty-34HYbF_FhFvC5nTX1ZEjXYI,29
+nextmv/__about__.py,sha256=F4Lf3QJWmlBfnNtouk1QY7WHW34ubJX7Y9tFbAZdAU0,24
 nextmv/__entrypoint__.py,sha256=dA0iwwHtrq6Z9w9FxmxKLoBGLyhe7jWtUAU-Y3PEgHg,1094
 nextmv/__init__.py,sha256=mC-gAzCdoZJ0BOVe2fDzKNdBtbXzx8XOxHP_7DdPMdQ,3857
 nextmv/_serialization.py,sha256=jYitMS1MU8ldsmObT-K_8V8P2Wx69tnDiEHCCgPGun4,2834
@@ -15,8 +15,20 @@ nextmv/run.py,sha256=qeT3a0eqVHKvbQiFxmX_2epaj-rz2GyfpdZJ4ROFC4U,53135
 nextmv/safe.py,sha256=VAK4fGEurbLNji4Pg5Okga5XQSbI4aI9JJf95_68Z20,3867
 nextmv/status.py,sha256=SCDLhh2om3yeO5FxO0x-_RShQsZNXEpjHNdCGdb3VUI,2787
 nextmv/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nextmv/cli/main.py,sha256=WD6Zawsv-UQ_ZLHtO7nZGPJCGV5678ER4cdgG5aUcIM,326
-nextmv/cli/version.py,sha256=Fu__CpNhbl-ARan28V9HVJmfO-2fZKVBE6SgvB0dSb4,225
+nextmv/cli/error.py,sha256=NldsTMKOwkujz2lBuUy3phokexJjEHKcGZE41xfH9bY,404
+nextmv/cli/main.py,sha256=GH3mbC1AGdJgBw4vrRO7Qhx5zJmd2D18tp25mzqfc0Y,4570
+nextmv/cli/options.py,sha256=J_BMXuViOTpo8gqCYP3zHePIt36AUVM7dun1BeztW2Q,640
+nextmv/cli/version.py,sha256=xY2EV-L1Iz6TToCTOdUyskE7kQBzEikVM5jz3pNpQlQ,306
+nextmv/cli/community/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nextmv/cli/community/clone.py,sha256=eJWzFdLasZi4Igb588K-uBtfODdS1UmkJhNcvL0htyM,9165
+nextmv/cli/community/community.py,sha256=t2l6adm9Km6hSvSFzeKHTQzacVSnwjx4wpj2kqee5nM,612
+nextmv/cli/community/list.py,sha256=dAiPS54GMzHkLxT4i9fvCyLJ3ljTDQaGnOFm0aKdSzI,7497
+nextmv/cli/configuration/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nextmv/cli/configuration/config.py,sha256=d0fJn_SFzxJSQUykFC-vFn9bu9vwdwZCI1lgtuxJuzQ,3558
+nextmv/cli/configuration/configuration.py,sha256=7oryF4PKkORh8bcdgbN2k36rZrFpJsM7Xfq_J4-MkFs,516
+nextmv/cli/configuration/create.py,sha256=HRi7z1OH9i1TOl2TLyI-coOlQTKx9JXyarXhIc11QMA,2703
+nextmv/cli/configuration/delete.py,sha256=R10Q1D29-woaR_VFbLKB4c-rYZiyWdVSMG9yTjevinM,1523
+nextmv/cli/configuration/list.py,sha256=XN8dAO3Brbbj7PH_Hfgcl3GDNP4OmmDHt34u5Tq3LVA,2201
 nextmv/cloud/__init__.py,sha256=n8laWdl0BjKmJOgGdPLHYUY_eaqhmXlW0-421A3SfwM,5336
 nextmv/cloud/acceptance_test.py,sha256=fZdp4O6pZrl7TaiUrTFPp7O4VJt-4R_W2yo4s8UAS5I,27691
 nextmv/cloud/account.py,sha256=jIdGNyI3l3dVh2PuriAwAOrEuWRM150WgzxcBMVBNRw,6058
@@ -48,8 +60,7 @@ nextmv/local/geojson_handler.py,sha256=7FavJdkUonop-yskjis0x3qFGB8A5wZyoBUblw-bV
 nextmv/local/local.py,sha256=cp56UpI8h19Ob6Jvb_Ni0ceXH5Vv3ET_iPTDe6ftq3Y,2617
 nextmv/local/plotly_handler.py,sha256=bLb50e3AkVr_W-F6S7lXfeRdN60mG2jk3UElNmhoMWU,1930
 nextmv/local/runner.py,sha256=Fa-G4g5yaBgLeBfYU-ePs65Q3Ses_xYvXGhPtHpAkrU,8546
-nextmv-0.39.0.dev0.dist-info/METADATA,sha256=Q6oLECxuWxNrYR62UBqE5xpwUYmN5t8uWm3FeUMviQU,16024
-nextmv-0.39.0.dev0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-nextmv-0.39.0.dev0.dist-info/entry_points.txt,sha256=hDHAJq2svhL8KEGw0u9M-_MQ1XwQOIkZdVgpTtjKBsQ,47
-nextmv-0.39.0.dev0.dist-info/licenses/LICENSE,sha256=ZIbK-sSWA-OZprjNbmJAglYRtl5_K4l9UwAV3PGJAPc,11349
-nextmv-0.39.0.dev0.dist-info/RECORD,,
+nextmv-0.40.0.dist-info/METADATA,sha256=jWy5xVb-LxKndjc5n40ktK39Gct9cncz0-oH-0sqj2M,16019
+nextmv-0.40.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+nextmv-0.40.0.dist-info/licenses/LICENSE,sha256=ZIbK-sSWA-OZprjNbmJAglYRtl5_K4l9UwAV3PGJAPc,11349
+nextmv-0.40.0.dist-info/RECORD,,

nextmv-0.39.0.dev0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-nextmv = nextmv.cli.main:app