validio-cli 8.1.0__tar.gz → 9.0.1__tar.gz

{validio_cli-8.1.0 → validio_cli-9.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: validio-cli
-Version: 8.1.0
+Version: 9.0.1
 Summary: CLI tool to interact with the Validio platform
 License: Apache-2.0
 License-File: LICENSE

{validio_cli-8.1.0 → validio_cli-9.0.1}/pyproject.toml

@@ -3,7 +3,7 @@ name = "validio-cli"
 # This version does not represent the released version or any tag. For each
 # release we automatically bump this before building and publishing so this
 # should be kept at 0.0.1dev1
-version = "8.1.0"
+version = "9.0.1"
 description = "CLI tool to interact with the Validio platform"
 authors = ["Validio <support@validio.io>"]
 license = "Apache-2.0"

{validio_cli-8.1.0 → validio_cli-9.0.1}/validio_cli/__init__.py

@@ -17,6 +17,7 @@ from tabulate import tabulate
 from validio_sdk import config
 from validio_sdk._api.api import APIClient
 from validio_sdk.config import Config, ValidioConfig
+from validio_sdk.features import Feature, all_features, set_enabled
 from validio_sdk.util import ClassJSONEncoder
 
 F = TypeVar("F", bound=Callable[..., Any])
@@ -267,3 +268,22 @@ def _resource_filter(
 def _fixed_width(message: str, width: int = 25) -> str:
     message = f"{message}: "
     return f"{message:<{width}} "
+
+
+def _apply_feature_flags(feature: list[Feature], all_features_flag: bool) -> None:
+    """Apply feature-flag selection from CLI options.
+
+    Shared between the root callback and sub-app callbacks so users can pass
+    ``--feature`` / ``--all-features`` at any position. The helper only mutates
+    the env var when the current callback actually received flag values — this
+    way a root-level selection isn't clobbered by a downstream callback that
+    was invoked without flags.
+    """
+    if all_features_flag:
+        set_enabled(all_features())
+        return
+
+    if not feature:
+        return
+
+    set_enabled(frozenset(feature))

{validio_cli-8.1.0 → validio_cli-9.0.1}/validio_cli/bin/entities/code.py

@@ -12,8 +12,14 @@ from validio_sdk.code import _import as code_import
 from validio_sdk.code import apply as code_apply
 from validio_sdk.code import plan as code_plan
 from validio_sdk.code import scaffold
+from validio_sdk.features import Feature
 from validio_sdk.resource._diff import GraphDiff, ResourceUpdate
-from validio_sdk.resource._resource import DiffContext, Resource, ResourceDeprecation
+from validio_sdk.resource._resource import (
+    DiffContext,
+    Resource,
+    ResourceDeprecation,
+    ResourceFeatureNotice,
+)
 from validio_sdk.resource._util import SourceSchemaReinference
 from validio_sdk.resource.replacement import (
     ImmutableFieldReplacementReason,
@@ -21,7 +27,13 @@ from validio_sdk.resource.replacement import (
     ReplacementReason,
 )
 
-from validio_cli import AsyncTyper, ConfigDir, Namespace, get_client
+from validio_cli import (
+    AsyncTyper,
+    ConfigDir,
+    Namespace,
+    _apply_feature_flags,
+    get_client,
+)
 from validio_cli.bin.entities.resources import ResourceNamesToMove, do_move
 from validio_cli.components import BETA_BANNER, proceed_with_operation
 
@@ -31,6 +43,25 @@ MAX_DEPRECATIONS_TO_SHOW = 20
 app = AsyncTyper(help="Plan or apply your configuration")
 
 
+@app.callback()
+def _configure(
+    feature: list[Feature] = typer.Option(
+        [],
+        "--feature",
+        help=(
+            "Enable an opt-in feature. Repeatable. Features may change or be "
+            "removed at any time."
+        ),
+    ),
+    all_features_flag: bool = typer.Option(
+        False,
+        "--all-features",
+        help="Enable every opt-in feature.",
+    ),
+) -> None:
+    _apply_feature_flags(feature=feature, all_features_flag=all_features_flag)
+
+
 class DiffOutput(str, Enum):
     """Available output formats for the CLI"""
 
@@ -436,6 +467,7 @@ async def _plan(
             )
 
     _show_deprecations(plan_result.deprecations)
+    _show_feature_notices(plan_result.feature_notices)
 
     return plan_result
 
@@ -676,6 +708,25 @@ def _show_deprecations(deprecations: list[ResourceDeprecation]) -> None:
     print(footer, end="")
 
 
+def _show_feature_notices(notices: list[ResourceFeatureNotice]) -> None:
+    if not notices:
+        return
+
+    title = "⚠️ FEATURES IN USE"
+    footer = ""
+
+    if len(notices) > MAX_DEPRECATIONS_TO_SHOW:
+        footer = f"And {len(notices) - MAX_DEPRECATIONS_TO_SHOW} more...\n"
+        notices = notices[:MAX_DEPRECATIONS_TO_SHOW]
+
+    print()
+    print(f"\033[93m{title}\033[0m")
+    for i, message in enumerate(sorted(notices)):
+        print(f"\033[93m{i + 1:>2}. {message}\033[0m")
+
+    print(footer, end="")
+
+
 def create_source_schema_reinference(
     schemas_to_update: list[str], update_all_schemas: bool
 ) -> SourceSchemaReinference:

validio_cli-9.0.1/validio_cli/bin/entities/integrations.py

@@ -0,0 +1,109 @@
+import typer
+from camel_converter import to_snake
+from validio_sdk.exception import ValidioError
+
+from validio_cli import (
+    APIClient,
+    AsyncTyper,
+    ConfigDir,
+    Identifier,
+    Identifiers,
+    OutputFormat,
+    OutputFormatOption,
+    OutputSettings,
+    _single_resource_if_specified,
+    get_client,
+    output_json,
+    output_ok_or_error,
+    output_text,
+)
+
+app = AsyncTyper(help="Integrations")
+
+
+@app.async_command(help="Get integrations")
+async def get(
+    config_dir: str = ConfigDir,
+    output_format: OutputFormat = OutputFormatOption,
+    identifier: str = Identifier,
+) -> None:
+    client, _ = get_client(config_dir)
+
+    integrations = await client.get_integrations(integration_id=identifier)
+
+    if isinstance(integrations, list):
+        integrations = _single_resource_if_specified(integrations, identifier)
+
+    if output_format == OutputFormat.JSON:
+        return output_json(integrations, identifier)
+
+    return output_text(
+        integrations,
+        fields={
+            "name": OutputSettings(attribute_name="resourceName"),
+            "type": OutputSettings(
+                attribute_name="__typename",
+                reformat=lambda x: to_snake(x.removesuffix("Integration")).upper(),
+            ),
+            "age": OutputSettings.string_as_datetime("createdAt"),
+        },
+    )
+
+
+@app.async_command(help="Delete integration")
+async def delete(
+    config_dir: str = ConfigDir,
+    output_format: OutputFormat = OutputFormatOption,
+    identifiers: list[str] = Identifiers,
+) -> None:
+    if not identifiers:
+        raise ValidioError("no identifiers are provided")
+
+    vc, _ = get_client(config_dir)
+
+    integration_ids = [
+        integration_id
+        for integration_id in [
+            await get_integration_id(vc, identifier) for identifier in identifiers
+        ]
+        if integration_id
+    ]
+
+    result = await vc.delete_integrations(integration_ids)
+
+    if output_format == OutputFormat.JSON:
+        return output_json(result)
+
+    return output_ok_or_error(result)
+
+
+async def get_integration_id(vc: APIClient, identifier: str) -> str | None:
+    """
+    Ensure the identifier is a resource id.
+
+    If it doesn't have the expected prefix, do a resource lookup by name.
+    """
+    identifier_type = "integration"
+    prefix = "INT_"
+
+    if not identifier:
+        print(f"Missing {identifier_type} id or name")
+        return None
+
+    if identifier.startswith(prefix):
+        return identifier
+
+    resource = await vc.get_integrations(integration_id=identifier)
+
+    if resource is None:
+        print(f"No {identifier_type} with name or id {identifier} found")
+        return None
+
+    if not isinstance(resource, dict):
+        raise ValidioError("failed to get integration id")
+
+    return resource["id"]
+
+
+if __name__ == "__main__":
+    typer.run(app())

{validio_cli-8.1.0 → validio_cli-9.0.1}/validio_cli/bin/entities/namespaces.py

@@ -64,7 +64,7 @@ async def create(
     role: str = typer.Option(
         None,
         click_type=RoleSuggestion(),
-        help="The role to assign --api-key and --member",
+        help="The role (name or id) to assign --api-key and --member",
     ),
     api_key: list[str] = typer.Option(
         [],
@@ -113,6 +113,8 @@ async def create(
         api_keys=ns_api_keys,
     )
 
+    _raise_on_errors(namespaces)
+
     if output_format == OutputFormat.JSON:
         return output_json(namespaces, identifier)
 
@@ -133,7 +135,7 @@ async def update(
     role: str = typer.Option(
         None,
         click_type=RoleSuggestion(),
-        help="The role to assign --api-key and --member",
+        help="The role (name or id) to assign --api-key and --member",
     ),
     api_key: list[str] = typer.Option(
         [],
@@ -198,6 +200,8 @@ async def update(
         api_keys=api_keys,
     )
 
+    _raise_on_errors(namespaces)
+
     if output_format == OutputFormat.JSON:
         return output_json(namespaces, identifier)
 
@@ -234,11 +238,16 @@ async def remove(
 
 
 def _find_role_id(role_configs: list[dict[str, Any]], role_name: str) -> str:
+    # Accept either the role id or a case-insensitive role name — the server
+    # returns `role` as a scalar on existing members/apiKeys and the format is
+    # not guaranteed, so we tolerate both.
     for rc in role_configs:
-        if rc["name"].upper() == role_name.upper():
+        if rc["id"] == role_name or rc["name"].casefold() == role_name.casefold():
             return rc["id"]
 
-    raise ValidioError(f"role '{role_name}' not found")
+    available = ", ".join(sorted(rc["name"] for rc in role_configs))
+
+    raise ValidioError(f"role '{role_name}' not found. Available roles: {available}")
 
 
 def _find_admin_role_id(role_configs: list[dict[str, Any]]) -> str:
@@ -247,3 +256,18 @@ def _find_admin_role_id(role_configs: list[dict[str, Any]]) -> str:
             return rc["id"]
 
     raise ValidioError("could not find system Admin role for namespace")
+
+
+def _raise_on_errors(response: Any) -> None:
+    if not isinstance(response, dict):
+        return
+
+    errors = response.get("errors") or []
+    if not errors:
+        return
+
+    messages = "; ".join(
+        f"{e.get('code', 'UNKNOWN')}: {e.get('message', '')}" for e in errors
+    )
+
+    raise ValidioError(f"server returned errors: {messages}")

{validio_cli-8.1.0 → validio_cli-9.0.1}/validio_cli/bin/main.py

@@ -8,8 +8,10 @@ import validio_sdk.metadata
 from tabulate import tabulate
 from validio_sdk import ValidioError
 from validio_sdk.config import Config
+from validio_sdk.features import Feature
 
 import validio_cli.metadata
+from validio_cli import _apply_feature_flags
 from validio_cli.bin.entities import (
     channels,
     code,
@@ -18,6 +20,7 @@ from validio_cli.bin.entities import (
     dbt,
     filters,
     incidents,
+    integrations,
     metrics,
     namespaces,
     notification_rules,
@@ -37,6 +40,26 @@ app = typer.Typer(
     rich_markup_mode="rich",
 )
 
+
+@app.callback()
+def _configure(
+    feature: list[Feature] = typer.Option(
+        [],
+        "--feature",
+        help=(
+            "Enable an opt-in feature. Repeatable. Features may change or be "
+            "removed at any time."
+        ),
+    ),
+    all_features_flag: bool = typer.Option(
+        False,
+        "--all-features",
+        help="Enable every opt-in feature.",
+    ),
+) -> None:
+    _apply_feature_flags(feature=feature, all_features_flag=all_features_flag)
+
+
 app.add_typer(channels.app, no_args_is_help=True, name="channels")
 app.add_typer(code.app, no_args_is_help=True, name="code")
 app.add_typer(config.app, no_args_is_help=True, name="config")
@@ -44,6 +67,7 @@ app.add_typer(credentials.app, no_args_is_help=True, name="credentials")
 app.add_typer(dbt.app, no_args_is_help=True, name="dbt")
 app.add_typer(filters.app, no_args_is_help=True, name="filters")
 app.add_typer(incidents.app, no_args_is_help=True, name="incidents")
+app.add_typer(integrations.app, no_args_is_help=True, name="integrations")
 app.add_typer(metrics.app, no_args_is_help=True, name="metrics")
 app.add_typer(namespaces.app, no_args_is_help=True, name="namespaces")
 app.add_typer(resources.app, no_args_is_help=True, name="resources")