validio-cli 10.0.7__tar.gz → 10.2.0__tar.gz

{validio_cli-10.0.7 → validio_cli-10.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: validio-cli
-Version: 10.0.7
+Version: 10.2.0
 Summary: CLI tool to interact with the Validio platform
 Author: Validio
 Author-email: Validio <support@validio.io>

{validio_cli-10.0.7 → validio_cli-10.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "validio-cli"
-version = "10.0.7"
+version = "10.2.0"
 description = "CLI tool to interact with the Validio platform"
 requires-python = ">=3.10,<4"
 readme = "README_PUBLIC.md"
@@ -39,7 +39,7 @@ dev = [
     "ruff==0.16.1",
     "mypy>=1.2.0,<2",
     "licensecheck>=2025.1.0,<2026",
-    "pytest>=9.0.3,<10",
+    "pytest>=9.1.1,<10",
     "flameprof>=0.4,<0.5",
     "validio-sdk",
 ]
@@ -107,5 +107,5 @@ ignore_packages = ["MYPY-EXTENSIONS"]
 zero = true
 
 [build-system]
-requires = ["uv_build>=0.12.1,<0.13.0"]
+requires = ["uv_build>=0.12.3,<0.13.0"]
 build-backend = "uv_build"

{validio_cli-10.0.7 → validio_cli-10.2.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "validio-cli"
-version = "10.0.7"
+version = "10.2.0"
 description = "CLI tool to interact with the Validio platform"
 authors = [{ name = "Validio", email = "support@validio.io" }]
 requires-python = ">=3.10,<4"
@@ -36,7 +36,7 @@ dev = [
     "ruff==0.16.1",
     "mypy>=1.2.0,<2",
     "licensecheck>=2025.1.0,<2026",
-    "pytest>=9.0.3,<10",
+    "pytest>=9.1.1,<10",
     "flameprof>=0.4,<0.5",
     "validio-sdk",
 ]
@@ -52,7 +52,7 @@ module-name = ["validio_cli"]
 module-root = ""
 
 [build-system]
-requires = ["uv_build>=0.12.1,<0.13.0"]
+requires = ["uv_build>=0.12.3,<0.13.0"]
 build-backend = "uv_build"
 
 [tool.ruff]

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/__init__.py

@@ -2,7 +2,7 @@ import asyncio
 import contextlib
 import json
 import sys
-from collections.abc import Callable
+from collections.abc import Callable, Coroutine
 from dataclasses import dataclass
 from datetime import datetime, timezone
 from enum import Enum
@@ -19,12 +19,14 @@ from validio_sdk import config
 from validio_sdk._api.api import APIClient
 from validio_sdk.client import USER_AGENT as SDK_USER_AGENT
 from validio_sdk.config import Config, ValidioConfig
+from validio_sdk.exception import ResourceNotFoundError
 from validio_sdk.features import Feature, all_features, set_enabled
 from validio_sdk.util import ClassJSONEncoder
 
 from validio_cli.metadata import version as cli_version
 
 F = TypeVar("F", bound=Callable[..., Any])
+R = TypeVar("R")
 T = TypeVar("T", bound="OutputSettings")
 
 DEFAULT_NAMESPACE: str = "default"
@@ -132,6 +134,16 @@ def get_client(
     return APIClient(config=cfg, user_agent=user_agent, headers=headers), cfg
 
 
+async def none_if_404(
+    lookup: Coroutine[Any, Any, R],
+) -> R | None:
+    """Return None if response is a 404."""
+    try:
+        return await lookup
+    except ResourceNotFoundError:
+        return None
+
+
 @dataclass
 class OutputSettings:
     attribute_name: str | None = None

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/bin/entities/channels.py

@@ -15,6 +15,7 @@ from validio_cli import (
     ValidioConfig,
     _single_resource_if_specified,
     get_client,
+    none_if_404,
     output_json,
     output_ok_or_error,
     output_text,
@@ -105,9 +106,11 @@ async def get_channel_id(
     if identifier.startswith(prefix):
         return identifier
 
-    resource = await vc.get_channels(
-        channel_id=identifier,
-        namespace_id=get_namespace(namespace, cfg),
+    resource = await none_if_404(
+        vc.get_channels(
+            channel_id=identifier,
+            namespace_id=get_namespace(namespace, cfg),
+        )
     )
 
     if resource is None:

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/bin/entities/code.py

@@ -209,6 +209,7 @@ async def plan(
     segmentation: list[str] = target_option("segmentation"),
     source: list[str] = target_option("source"),
     validator: list[str] = target_option("validator"),
+    validator_debug_query: list[str] = target_option("validator-debug-query"),
     window: list[str] = target_option("window"),
     progress: bool = show_progress_option,
 ) -> None:
@@ -243,6 +244,7 @@ async def plan(
             segmentations=set(segmentation),
             sources=set(source),
             validators=set(validator),
+            validator_debug_queries=set(validator_debug_query),
             windows=set(window),
         ),
         show_progress=progress,
@@ -273,6 +275,7 @@ async def apply(
     segmentation: list[str] = target_option("segmentation"),
     source: list[str] = target_option("source"),
     validator: list[str] = target_option("validator"),
+    validator_debug_query: list[str] = target_option("validator-debug-query"),
     window: list[str] = target_option("window"),
     progress: bool = show_progress_option,
     test_credentials: bool = typer.Option(
@@ -319,6 +322,7 @@ async def apply(
             segmentations=set(segmentation),
             sources=set(source),
             validators=set(validator),
+            validator_debug_queries=set(validator_debug_query),
             windows=set(window),
         ),
         show_progress=progress,
@@ -450,7 +454,7 @@ async def _import(
         tags_ctx=plan_result.tags_context,
         include_schema=include_schema,
     )
-    output.write_text(s)
+    output.write_text(s, encoding="utf-8")
     print(f"Generated file {output.absolute()}")
 
 

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/bin/entities/filters.py

@@ -14,6 +14,7 @@ from validio_cli import (
     OutputSettings,
     ValidioConfig,
     get_client,
+    none_if_404,
     output_json,
     output_ok_or_error,
     output_text,
@@ -113,9 +114,11 @@ async def get_filter_id(
     if identifier.startswith(prefix):
         return identifier
 
-    resource = await vc.get_filters(
-        filter_id=identifier,
-        namespace_id=get_namespace(namespace, cfg),
+    resource = await none_if_404(
+        vc.get_filters(
+            filter_id=identifier,
+            namespace_id=get_namespace(namespace, cfg),
+        )
     )
 
     if resource is None:

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/bin/entities/integrations.py

@@ -13,6 +13,7 @@ from validio_cli import (
     OutputSettings,
     _single_resource_if_specified,
     get_client,
+    none_if_404,
     output_json,
     output_ok_or_error,
     output_text,
@@ -93,7 +94,7 @@ async def get_integration_id(vc: APIClient, identifier: str) -> str | None:
     if identifier.startswith(prefix):
         return identifier
 
-    resource = await vc.get_integrations(integration_id=identifier)
+    resource = await none_if_404(vc.get_integrations(integration_id=identifier))
 
     if resource is None:
         print(f"No {identifier_type} with name or id {identifier} found")

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/bin/entities/notification_rules.py

@@ -15,6 +15,7 @@ from validio_cli import (
     OutputSettings,
     _single_resource_if_specified,
     get_client,
+    none_if_404,
     output_json,
     output_ok_or_error,
     output_text,
@@ -110,9 +111,11 @@ async def get_notification_rule_id(
     if identifier.startswith(prefix):
         return identifier
 
-    resource = await vc.get_notification_rules(
-        notification_rule_id=identifier,
-        namespace_id=get_namespace(namespace, cfg),
+    resource = await none_if_404(
+        vc.get_notification_rules(
+            notification_rule_id=identifier,
+            namespace_id=get_namespace(namespace, cfg),
+        )
     )
 
     if resource is None:

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/bin/entities/resources.py

@@ -113,7 +113,7 @@ def _read_resource_file(file: pathlib.Path) -> dict:
     if not file.is_file():
         raise ValidioError(f"'{file.absolute()}' is not a file")
 
-    obj = json.loads(file.read_text())
+    obj = json.loads(file.read_text(encoding="utf-8"))
     if not isinstance(obj, dict):
         raise ValidioError(f"expected json object in resource file: got {type(obj)}")
 

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/bin/entities/segmentations.py

@@ -14,6 +14,7 @@ from validio_cli import (
     OutputFormatOption,
     OutputSettings,
     get_client,
+    none_if_404,
     output_json,
     output_ok_or_error,
     output_text,
@@ -114,9 +115,11 @@ async def get_segmentation_id(
     if identifier.startswith(prefix):
         return identifier
 
-    resource = await vc.get_segmentations(
-        segmentation_id=identifier,
-        namespace_id=get_namespace(namespace, cfg),
+    resource = await none_if_404(
+        vc.get_segmentations(
+            segmentation_id=identifier,
+            namespace_id=get_namespace(namespace, cfg),
+        )
     )
 
     if resource is None:

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/bin/entities/sources.py

@@ -31,6 +31,7 @@ from validio_cli import (
     components,
     format_text,
     get_client,
+    none_if_404,
     output_json,
     output_ok_or_error,
     output_text,
@@ -953,7 +954,7 @@ async def _infer_schema_bigquery(
 
 
 def _write_schema(filename: Path, schema: Any) -> None:
-    filename.write_text(json.dumps(schema, indent=2))
+    filename.write_text(json.dumps(schema, indent=2), encoding="utf-8")
 
     print(f"Schema written to {filename}")
 
@@ -997,10 +998,12 @@ async def _get_source_id(
     if identifier.startswith(prefix):
         return identifier
 
-    resource = await get_sources(
-        session,
-        source_id=identifier,
-        namespace_id=get_namespace(namespace, cfg),
+    resource = await none_if_404(
+        get_sources(
+            session,
+            source_id=identifier,
+            namespace_id=get_namespace(namespace, cfg),
+        )
     )
 
     if resource is None:

validio_cli-10.2.0/validio_cli/bin/entities/validator_debug_queries.py

@@ -0,0 +1,133 @@
+import typer
+from validio_sdk._api.api import APIClient
+from validio_sdk.config import ValidioConfig
+from validio_sdk.exception import ValidioError
+
+from validio_cli import (
+    AsyncTyper,
+    ConfigDir,
+    Identifier,
+    Identifiers,
+    Namespace,
+    OutputFormat,
+    OutputFormatOption,
+    OutputSettings,
+    get_client,
+    none_if_404,
+    output_json,
+    output_ok_or_error,
+    output_text,
+)
+from validio_cli.bin.entities.validators import get_validator_id
+from validio_cli.namespace import get_namespace
+
+app = AsyncTyper(help="Debug queries saved on validators")
+
+
+@app.async_command(help="List validator debug queries")
+async def get(
+    config_dir: str = ConfigDir,
+    output_format: OutputFormat = OutputFormatOption,
+    namespace: str = Namespace(),
+    identifier: str = Identifier,
+    validator: str = typer.Option(
+        None, help="List debug queries for this Validator (name or ID)"
+    ),
+) -> None:
+    if identifier and validator:
+        raise ValidioError("--validator can't be used together with an identifier")
+
+    vc, cfg = get_client(config_dir)
+
+    validator_id = (
+        await get_validator_id(vc, cfg, validator, namespace) if validator else None
+    )
+
+    debug_queries = await vc.get_validator_debug_queries(
+        validator_debug_query_id=identifier,
+        validator_id=validator_id,
+        namespace_id=get_namespace(namespace, cfg),
+    )
+
+    if output_format == OutputFormat.JSON:
+        return output_json(debug_queries, identifier)
+
+    return output_text(
+        debug_queries,
+        fields={
+            "name": OutputSettings(attribute_name="resourceName"),
+            "validator": OutputSettings(
+                reformat=lambda validator: validator["resourceName"]
+            ),
+            "default": OutputSettings(attribute_name="defaultQuery"),
+            "age": OutputSettings.string_as_datetime(attribute_name="createdAt"),
+        },
+    )
+
+
+@app.async_command(help="Delete validator debug query")
+async def delete(
+    config_dir: str = ConfigDir,
+    output_format: OutputFormat = OutputFormatOption,
+    namespace: str = Namespace(),
+    identifiers: list[str] = Identifiers,
+) -> None:
+    if not identifiers:
+        raise ValidioError("no identifiers are provided")
+
+    vc, cfg = get_client(config_dir)
+
+    debug_query_ids = [
+        debug_query_id
+        for debug_query_id in [
+            await get_validator_debug_query_id(vc, cfg, identifier, namespace)
+            for identifier in identifiers
+        ]
+        if debug_query_id
+    ]
+
+    result = await vc.delete_validator_debug_queries(debug_query_ids)
+
+    if output_format == OutputFormat.JSON:
+        return output_json(result)
+
+    return output_ok_or_error(result)
+
+
+async def get_validator_debug_query_id(
+    vc: APIClient, cfg: ValidioConfig, identifier: str, namespace: 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 = "validator debug query"
+    prefix = "VDQ_"
+
+    if not identifier:
+        print(f"Missing {identifier_type} id or name")
+        return None
+
+    if identifier.startswith(prefix):
+        return identifier
+
+    resource = await none_if_404(
+        vc.get_validator_debug_queries(
+            validator_debug_query_id=identifier,
+            namespace_id=get_namespace(namespace, cfg),
+        )
+    )
+
+    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 validator debug query id")
+
+    return resource["id"]
+
+
+if __name__ == "__main__":
+    app()

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/bin/entities/validators.py

@@ -14,6 +14,7 @@ from validio_cli import (
     OutputFormatOption,
     OutputSettings,
     get_client,
+    none_if_404,
     output_json,
     output_ok_or_error,
     output_text,
@@ -125,9 +126,11 @@ async def get_validator_id(
     if identifier.startswith(prefix):
         return identifier
 
-    resource = await vc.get_validators(
-        validator_id=identifier,
-        namespace_id=get_namespace(namespace, cfg),
+    resource = await none_if_404(
+        vc.get_validators(
+            validator_id=identifier,
+            namespace_id=get_namespace(namespace, cfg),
+        )
     )
 
     if resource is None:

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/bin/entities/windows.py

@@ -15,6 +15,7 @@ from validio_cli import (
     OutputFormatOption,
     OutputSettings,
     get_client,
+    none_if_404,
     output_json,
     output_ok_or_error,
     output_text,
@@ -118,9 +119,11 @@ async def get_window_id(
     if identifier.startswith(prefix):
         return identifier
 
-    resource = await vc.get_windows(
-        window_id=identifier,
-        namespace_id=get_namespace(namespace, cfg),
+    resource = await none_if_404(
+        vc.get_windows(
+            window_id=identifier,
+            namespace_id=get_namespace(namespace, cfg),
+        )
     )
 
     if resource is None:

{validio_cli-10.0.7 → validio_cli-10.2.0}/validio_cli/bin/main.py

@@ -30,6 +30,7 @@ from validio_cli.bin.entities import (
     segments,
     sources,
     users,
+    validator_debug_queries,
     validators,
     windows,
 )
@@ -78,6 +79,11 @@ app.add_typer(segments.app, no_args_is_help=True, name="segments")
 app.add_typer(sources.app, no_args_is_help=True, name="sources")
 app.add_typer(users.app, no_args_is_help=True, name="users")
 app.add_typer(validators.app, no_args_is_help=True, name="validators")
+app.add_typer(
+    validator_debug_queries.app,
+    no_args_is_help=True,
+    name="validator-debug-queries",
+)
 app.add_typer(windows.app, no_args_is_help=True, name="windows")