cloudsmith-cli 1.20.2__tar.gz → 1.21.0__tar.gz

{cloudsmith_cli-1.20.2/cloudsmith_cli.egg-info → cloudsmith_cli-1.21.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloudsmith-cli
-Version: 1.20.2
+Version: 1.21.0
 Summary: Cloudsmith Command-Line Interface (CLI)
 Author-email: Cloudsmith Ltd <support@cloudsmith.io>
 License-Expression: Apache-2.0

{cloudsmith_cli-1.20.2 → cloudsmith_cli-1.21.0}/cloudsmith_cli/cli/commands/credential_helper/__init__.py

@@ -10,6 +10,7 @@ import click
 
 from ..main import main
 from .docker import docker as docker_cmd
+from .generic import generic as generic_cmd
 from .manage import install_cmd, list_cmd, uninstall_cmd
 
 
@@ -32,6 +33,7 @@ def credential_helper():
 
 
 credential_helper.add_command(docker_cmd, name="docker")
+credential_helper.add_command(generic_cmd, name="generic")
 credential_helper.add_command(install_cmd, name="install")
 credential_helper.add_command(uninstall_cmd, name="uninstall")
 credential_helper.add_command(list_cmd, name="list")

cloudsmith_cli-1.21.0/cloudsmith_cli/cli/commands/credential_helper/generic.py

@@ -0,0 +1,62 @@
+# Copyright 2026 Cloudsmith Ltd
+"""
+Generic credential helper command.
+
+Emits a versioned JSON credential document.
+"""
+
+import sys
+
+import click
+
+from ....credential_helpers.generic import execute
+from ...decorators import (
+    common_api_auth_options,
+    common_cli_config_options,
+    resolve_credentials,
+)
+
+
+@click.command()
+@common_cli_config_options
+@common_api_auth_options
+@resolve_credentials
+def generic(opts):
+    """
+    Emit a Cloudsmith credential as JSON.
+
+    Resolves a credential through the full provider chain and writes a
+    versioned JSON document to stdout.  Takes no arguments: a Cloudsmith token
+    is organisation-wide, so the host it will be used against does not change
+    which credential resolves.
+
+    \b
+    Output (stdout):
+        JSON: {"version": 1, "username": "token", "password": "<token>"}
+
+    \b
+    Exit codes:
+        0: Success
+        1: No credential could be resolved
+
+    Examples:
+
+    \b
+        # Resolve a credential
+        $ cloudsmith credential-helper generic
+
+    \b
+        # Extract just the token
+        $ cloudsmith credential-helper generic | jq -r .password
+
+    \b
+    Environment variables:
+        CLOUDSMITH_API_KEY: API key for authentication (optional)
+    """
+    exit_code, stdout, stderr = execute(credential=opts.credential)
+
+    if stdout is not None:
+        click.echo(stdout)
+    if stderr is not None:
+        click.echo(stderr, err=True)
+    sys.exit(exit_code)

cloudsmith_cli-1.21.0/cloudsmith_cli/credential_helpers/generic.py

@@ -0,0 +1,63 @@
+# Copyright 2026 Cloudsmith Ltd
+"""
+Generic credential helper runtime.
+
+Emits a versioned JSON credential document.
+"""
+
+import json
+import logging
+
+logger = logging.getLogger(__name__)
+
+PROTOCOL_VERSION = 1
+
+_REFUSAL_MESSAGE = (
+    "Error: Unable to retrieve credentials. "
+    "Provide credentials via the CLOUDSMITH_API_KEY environment variable, "
+    "credentials.ini, the system keyring, or an OIDC service. "
+    "Verify current authentication with `cloudsmith whoami --verbose`."
+)
+
+
+def build_response(credential):
+    """
+    Build the versioned credential document.
+
+    Args:
+        credential: Pre-resolved CredentialResult from the provider chain
+
+    Returns:
+        dict: The credential document, or None when no credential is available
+    """
+    if not credential or not credential.api_key:
+        return None
+
+    return {
+        "version": PROTOCOL_VERSION,
+        "username": "token",
+        "password": credential.api_key,
+    }
+
+
+def execute(credential=None) -> tuple[int, str | None, str | None]:
+    """
+    Resolve a credential into a versioned JSON document.
+
+    Args:
+        credential: Pre-resolved CredentialResult from the provider chain
+
+    Returns:
+        A (exit_code, stdout_text, stderr_text) tuple.  Either text value may
+        be None if there is nothing to write to that stream.  The document is
+        serialised in one step, so a partial document can never be emitted.
+    """
+    try:
+        response = build_response(credential)
+        if response is None:
+            return (1, None, _REFUSAL_MESSAGE)
+
+        return (0, json.dumps(response), None)
+    except Exception as exc:  # pylint: disable=broad-except
+        logger.debug("generic credential-helper failed: %s", exc, exc_info=True)
+        return (1, None, _REFUSAL_MESSAGE)

cloudsmith_cli-1.21.0/cloudsmith_cli/data/VERSION

@@ -0,0 +1 @@
+1.21.0

{cloudsmith_cli-1.20.2 → cloudsmith_cli-1.21.0/cloudsmith_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloudsmith-cli
-Version: 1.20.2
+Version: 1.21.0
 Summary: Cloudsmith Command-Line Interface (CLI)
 Author-email: Cloudsmith Ltd <support@cloudsmith.io>
 License-Expression: Apache-2.0

{cloudsmith_cli-1.20.2 → cloudsmith_cli-1.21.0}/cloudsmith_cli.egg-info/SOURCES.txt

@@ -51,6 +51,7 @@ cloudsmith_cli/cli/commands/vulnerabilities.py
 cloudsmith_cli/cli/commands/whoami.py
 cloudsmith_cli/cli/commands/credential_helper/__init__.py
 cloudsmith_cli/cli/commands/credential_helper/docker.py
+cloudsmith_cli/cli/commands/credential_helper/generic.py
 cloudsmith_cli/cli/commands/credential_helper/manage.py
 cloudsmith_cli/cli/commands/metrics/__init__.py
 cloudsmith_cli/cli/commands/metrics/command.py
@@ -122,6 +123,7 @@ cloudsmith_cli/credential_helpers/__init__.py
 cloudsmith_cli/credential_helpers/backends.py
 cloudsmith_cli/credential_helpers/common.py
 cloudsmith_cli/credential_helpers/custom_domains.py
+cloudsmith_cli/credential_helpers/generic.py
 cloudsmith_cli/credential_helpers/launchers.py
 cloudsmith_cli/credential_helpers/docker/__init__.py
 cloudsmith_cli/credential_helpers/docker/installer.py

cloudsmith_cli-1.20.2/cloudsmith_cli/data/VERSION

@@ -1 +0,0 @@
-1.20.2