validio-cli 10.0.6__tar.gz → 10.1.0__tar.gz

{validio_cli-10.0.6 → validio_cli-10.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: validio-cli
-Version: 10.0.6
+Version: 10.1.0
 Summary: CLI tool to interact with the Validio platform
 Author: Validio
 Author-email: Validio <support@validio.io>
@@ -11,9 +11,9 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Dist: camel-converter>=3.0.0,<4
+Requires-Dist: camel-converter>=5.1.0,<6
 Requires-Dist: classdiff>=0.5.2,<0.6
-Requires-Dist: typer[all]>=0.8.0,<0.16.0
+Requires-Dist: typer>=0.27.0,<0.28.0
 Requires-Dist: prompt-toolkit>=3.0.38,<4
 Requires-Dist: tabulate>=0.9.0,<0.11
 Requires-Dist: types-tabulate>=0.9.0.2,<0.11

validio_cli-10.1.0/pyproject.toml

@@ -0,0 +1,111 @@
+[project]
+name = "validio-cli"
+version = "10.1.0"
+description = "CLI tool to interact with the Validio platform"
+requires-python = ">=3.10,<4"
+readme = "README_PUBLIC.md"
+license = "Apache-2.0"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+    "camel-converter>=5.1.0,<6",
+    "classdiff>=0.5.2,<0.6",
+    "typer>=0.27.0,<0.28.0",
+    "prompt-toolkit>=3.0.38,<4",
+    "tabulate>=0.9.0,<0.11",
+    "types-tabulate>=0.9.0.2,<0.11",
+    "validio-sdk",
+]
+
+[[project.authors]]
+name = "Validio"
+email = "support@validio.io"
+
+[project.urls]
+Homepage = "https://validio.io/"
+Documentation = "https://docs.validio.io/"
+
+[project.scripts]
+validio = "validio_cli.bin.main:main"
+
+[dependency-groups]
+dev = [
+    "ruff==0.16.1",
+    "mypy>=1.2.0,<2",
+    "licensecheck>=2025.1.0,<2026",
+    "pytest>=9.0.3,<10",
+    "flameprof>=0.4,<0.5",
+    "validio-sdk",
+]
+
+[tool.uv]
+default-groups = "all"
+
+[tool.uv.sources.validio-sdk]
+workspace = true
+
+[tool.uv.build-backend]
+module-name = ["validio_cli"]
+module-root = ""
+
+[tool.ruff]
+fix = true
+
+[tool.ruff.lint]
+select = [
+    "ARG",
+    "C4",
+    "D",
+    "E",
+    "F",
+    "I",
+    "N",
+    "PIE",
+    "PL",
+    "PT",
+    "PTH",
+    "RET",
+    "RUF",
+    "SIM",
+    "UP",
+    "W",
+]
+ignore = [
+    "D203",
+    "D212",
+    "PLR0913",
+    "PLR0917",
+    "PLC0415",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["D"]
+"*/bin/*.py" = [
+    "D",
+    "UP007",
+    "UP045",
+]
+"examples/*.py" = ["D"]
+
+[tool.mypy]
+ignore_missing_imports = true
+disallow_untyped_calls = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+
+[tool.licensecheck]
+license = "Apache-2.0"
+ignore_packages = ["MYPY-EXTENSIONS"]
+zero = true
+
+[build-system]
+requires = ["uv_build>=0.12.3,<0.13.0"]
+build-backend = "uv_build"

validio_cli-10.0.6/pyproject.toml → validio_cli-10.1.0/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "validio-cli"
-version = "10.0.6"
+version = "10.1.0"
 description = "CLI tool to interact with the Validio platform"
 authors = [{ name = "Validio", email = "support@validio.io" }]
 requires-python = ">=3.10,<4"
@@ -15,9 +15,9 @@ classifiers = [
     "Programming Language :: Python :: 3.14",
 ]
 dependencies = [
-    "camel-converter>=3.0.0,<4",
+    "camel-converter>=5.1.0,<6",
     "classdiff>=0.5.2,<0.6",
-    "typer[all]>=0.8.0,<0.16.0",
+    "typer>=0.27.0,<0.28.0",
     "prompt-toolkit>=3.0.38,<4",
     "tabulate>=0.9.0,<0.11",
     "types-tabulate>=0.9.0.2,<0.11",
@@ -33,10 +33,10 @@ validio = "validio_cli.bin.main:main"
 
 [dependency-groups]
 dev = [
-    "ruff==0.15.22",
+    "ruff==0.16.1",
     "mypy>=1.2.0,<2",
     "licensecheck>=2025.1.0,<2026",
-    "pytest>=7.4.3,<8",
+    "pytest>=9.0.3,<10",
     "flameprof>=0.4,<0.5",
     "validio-sdk",
 ]
@@ -52,7 +52,7 @@ module-name = ["validio_cli"]
 module-root = ""
 
 [build-system]
-requires = ["uv_build>=0.9.5,<0.10.0"]
+requires = ["uv_build>=0.12.3,<0.13.0"]
 build-backend = "uv_build"
 
 [tool.ruff]
@@ -82,6 +82,7 @@ ignore = [
     "D203",    # `one-blank-line-before-class` Incompatible with D211
     "D212",    # `multi-line-summary-first-line` Incompatible with D213
     "PLR0913", # `too-many-arguments` - Not relevant with only 6
+    "PLR0917", # `too-many-positional-arguments` - Same as PLR0913
     "PLC0415", # Imports are intentionally lazy (circular dependencies / startup perf)
 ]
 

{validio_cli-10.0.6 → validio_cli-10.1.0}/validio_cli/__init__.py

@@ -11,10 +11,10 @@ from pathlib import Path
 from types import EllipsisType
 from typing import Any, TypeVar
 
-import click
 import typer
 from camel_converter import to_snake
 from tabulate import tabulate
+from typer._click.globals import get_current_context
 from validio_sdk import config
 from validio_sdk._api.api import APIClient
 from validio_sdk.client import USER_AGENT as SDK_USER_AGENT
@@ -108,7 +108,7 @@ def _cli_headers(iac: bool = False) -> dict[str, str]:
     """
     headers: dict[str, str] = {}
 
-    ctx = click.get_current_context(silent=True)
+    ctx = get_current_context(silent=True)
     if ctx is not None:
         # `command_path` is e.g. "validio channels get",
         # drop the program name to get the command itself.

{validio_cli-10.0.6 → validio_cli-10.1.0}/validio_cli/bin/entities/code.py

@@ -20,7 +20,10 @@ from validio_sdk.resource._resource import (
     ResourceDeprecation,
     ResourceFeatureNotice,
 )
-from validio_sdk.resource._util import SourceSchemaReinference
+from validio_sdk.resource._util import (
+    SourceSchemaInferenceSkip,
+    SourceSchemaReinference,
+)
 from validio_sdk.resource.replacement import (
     ImmutableFieldReplacementReason,
     RecreateOnChangeReplacementReason,
@@ -130,6 +133,26 @@ update_all_schemas_option = typer.Option(
     ),
 )
 
+skip_schema_inference_option = typer.Option(
+    [],
+    help=(
+        f"{BETA_BANNER} "
+        "Specify a Source name to create without inferring its schema. This will"
+        " fallback to the corresponding schema in the Validio catalog. You can use"
+        " --skip-schema-inference src1 --skip-schema-inference src2 to specify"
+        " multiple Sources."
+    ),
+)
+
+skip_all_schema_inference_option = typer.Option(
+    False,
+    help=(
+        f"{BETA_BANNER} "
+        "Similar to --skip-schema-inference. Skips schema inference for all Sources"
+        " being created"
+    ),
+)
+
 show_progress_option = typer.Option(
     sys.stdout.isatty(),
     help=(
@@ -172,6 +195,8 @@ async def plan(
     config_dir: str = ConfigDir,
     update_schema: list[str] = update_schema_option,
     update_all_schemas: bool = update_all_schemas_option,
+    skip_schema_inference: list[str] = skip_schema_inference_option,
+    skip_all_schema_inference: bool = skip_all_schema_inference_option,
     show_schema: bool = show_schema_option,
     diff_output: DiffOutput = diff_option,
     destroy: bool = destroy_option,
@@ -184,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:
@@ -193,6 +219,9 @@ async def plan(
     schema_reinference = create_source_schema_reinference(
         update_schema, update_all_schemas
     )
+    schema_inference_skip = create_source_schema_inference_skip(
+        skip_schema_inference, skip_all_schema_inference
+    )
 
     namespace = get_namespace(dir_path)
     await _plan(
@@ -200,6 +229,7 @@ async def plan(
         client=client,
         directory=dir_path,
         schema_reinference=schema_reinference,
+        schema_inference_skip=schema_inference_skip,
         destroy=destroy,
         no_capture=no_capture,
         color=color,
@@ -214,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,
@@ -230,6 +261,8 @@ async def apply(
     config_dir: str = ConfigDir,
     update_schema: list[str] = update_schema_option,
     update_all_schemas: bool = update_all_schemas_option,
+    skip_schema_inference: list[str] = skip_schema_inference_option,
+    skip_all_schema_inference: bool = skip_all_schema_inference_option,
     show_schema: bool = show_schema_option,
     diff_output: DiffOutput = diff_option,
     destroy: bool = destroy_option,
@@ -242,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(
@@ -263,6 +297,9 @@ async def apply(
     schema_reinference = create_source_schema_reinference(
         update_schema, update_all_schemas
     )
+    schema_inference_skip = create_source_schema_inference_skip(
+        skip_schema_inference, skip_all_schema_inference
+    )
 
     namespace = get_namespace(dir_path)
     plan_result = await _plan(
@@ -270,6 +307,7 @@ async def apply(
         client=client,
         directory=dir_path,
         schema_reinference=schema_reinference,
+        schema_inference_skip=schema_inference_skip,
         destroy=destroy,
         no_capture=no_capture,
         color=color,
@@ -284,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,
@@ -308,6 +347,7 @@ async def apply(
         show_progress=progress,
         dry_run_sql=dry_run_sql,
         test_credentials=test_credentials,
+        schema_inference_skip=schema_inference_skip,
     )
 
     print(
@@ -414,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()}")
 
 
@@ -435,6 +475,7 @@ async def _plan(
     destroy: bool,
     no_capture: bool,
     color: bool,
+    schema_inference_skip: SourceSchemaInferenceSkip = SourceSchemaInferenceSkip(),
     show_schema: bool = False,
     diff_output: DiffOutput = DiffOutput.FULL,
     show_secrets: bool = False,
@@ -447,6 +488,7 @@ async def _plan(
         client=client,
         directory=directory,
         schema_reinference=schema_reinference,
+        schema_inference_skip=schema_inference_skip,
         destroy=destroy,
         no_capture=no_capture,
         show_secrets=show_secrets,
@@ -741,6 +783,20 @@ def create_source_schema_reinference(
     )
 
 
+def create_source_schema_inference_skip(
+    sources_to_skip: list[str], skip_all: bool
+) -> SourceSchemaInferenceSkip:
+    source_names = None
+    if skip_all:
+        source_names = []
+    elif len(sources_to_skip) > 0:
+        source_names = sources_to_skip
+
+    return SourceSchemaInferenceSkip(
+        set(source_names) if source_names is not None else None
+    )
+
+
 def _print_no_changes() -> None:
     print("No changes. The configuration is up-to-date!")
 

{validio_cli-10.0.6 → validio_cli-10.1.0}/validio_cli/bin/entities/namespaces.py

@@ -1,6 +1,5 @@
 from typing import Any, Optional
 
-import click
 import typer
 from validio_sdk import ValidioError
 
@@ -15,21 +14,7 @@ from validio_cli import (
     output_text,
 )
 
-
-class RoleSuggestion(click.ParamType):
-    name = "role"
-
-    def get_metavar(self, _: click.Parameter) -> str | None:
-        return "[Admin|Editor|Viewer|<Custom>]"
-
-    def convert(
-        self,
-        value: Any,
-        _param: click.Parameter | None,
-        _ctx: click.Context | None,
-    ) -> Any:
-        return value
-
+ROLE_METAVAR = "[Admin|Editor|Viewer|<Custom>]"
 
 app = AsyncTyper(help="Namespaces used to separate resources")
 
@@ -63,7 +48,7 @@ async def create(
     identifier: str = typer.Argument(..., help="Namespace name"),
     role: str = typer.Option(
         None,
-        click_type=RoleSuggestion(),
+        metavar=ROLE_METAVAR,
         help="The role (name or id) to assign --api-key and --member",
     ),
     api_key: list[str] = typer.Option(
@@ -134,7 +119,7 @@ async def update(
     identifier: str = typer.Argument(..., help="Namespace name"),
     role: str = typer.Option(
         None,
-        click_type=RoleSuggestion(),
+        metavar=ROLE_METAVAR,
         help="The role (name or id) to assign --api-key and --member",
     ),
     api_key: list[str] = typer.Option(

{validio_cli-10.0.6 → validio_cli-10.1.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.6 → validio_cli-10.1.0}/validio_cli/bin/entities/sources.py

@@ -4,7 +4,6 @@ import uuid
 from pathlib import Path
 from typing import Any, Optional, cast
 
-import click
 import typer
 from prompt_toolkit import PromptSession
 from prompt_toolkit.completion import WordCompleter
@@ -283,6 +282,7 @@ async def reset(
 
 @infer_schema_app.callback(invoke_without_command=True)
 def main(
+    ctx: typer.Context,
     interactive: bool = typer.Option(
         False, "--interactive", "-i", help="Infer schema with an interactive prompt"
     ),
@@ -290,8 +290,6 @@ def main(
     filename: Path = schema_filename_option("schema"),
     namespace: str = Namespace(),
 ) -> None:
-    ctx = click.get_current_context()
-
     # A subcommand was run prior to this, nothing todo
     if ctx.invoked_subcommand is not None:
         return None
@@ -302,7 +300,7 @@ def main(
 
     # A flag for this command was used but not interactive, print the help as if
     # no command was given
-    click.echo(ctx.get_help())
+    typer.echo(ctx.get_help())
 
     return None
 
@@ -955,7 +953,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}")
 

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

@@ -0,0 +1,130 @@
+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,
+    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 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.6 → validio_cli-10.1.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")