algorithm-nexus 0.2.1__py3-none-any.whl

algorithm_nexus/__init__.py

@@ -0,0 +1,4 @@
+# Copyright IBM Corp. 2026
+# SPDX-License-Identifier: Apache-2.0
+
+"""Algorithm Nexus package."""

algorithm_nexus/cli.py

@@ -0,0 +1,101 @@
+# Copyright IBM Corp. 2026
+# SPDX-License-Identifier: Apache-2.0
+
+"""Command-line interface for Algorithm Nexus package validation."""
+
+from __future__ import annotations
+
+import sys
+
+try:
+    import typer
+    from rich.console import Console
+except ImportError:
+    print(
+        "Error: CLI dependencies are not installed.\n"
+        "Please install them with: pip install algorithm-nexus[cli]",
+        file=sys.stderr,
+    )
+    sys.exit(1)
+
+from algorithm_nexus.commands.get import get_benchmark_requirements
+from algorithm_nexus.commands.list import (
+    list_benchmark_experiments,
+    list_benchmark_packages,
+    list_packages,
+)
+from algorithm_nexus.commands.run import run_benchmarks
+from algorithm_nexus.commands.validate import (
+    validate_benchmarks,
+    validate_logical_benchmarks,
+    validate_package,
+)
+
+console = Console()
+
+app = typer.Typer(
+    help="Algorithm Nexus CLI - Tools for managing and validating Nexus packages.",
+    add_completion=False,
+    no_args_is_help=True,
+)
+
+# Create subcommand group for 'list'
+list_app = typer.Typer(
+    help="List various resources in Nexus packages.",
+    no_args_is_help=True,
+)
+app.add_typer(list_app, name="list")
+
+# Create subcommand group for 'get'
+get_app = typer.Typer(
+    help="Get specific information about Nexus packages.",
+    no_args_is_help=True,
+)
+app.add_typer(get_app, name="get")
+
+# Create subcommand group for 'run'
+run_app = typer.Typer(
+    help="Execute benchmarks and operations.",
+    no_args_is_help=True,
+)
+app.add_typer(run_app, name="run")
+
+# Create subcommand group for 'validate'
+validate_app = typer.Typer(
+    help="Validate various aspects of Nexus packages.",
+    no_args_is_help=True,
+)
+app.add_typer(validate_app, name="validate")
+
+
+@app.callback(invoke_without_command=True)
+def main_callback(ctx: typer.Context) -> None:
+    pass
+
+
+# Register list commands
+list_app.command(name="packages")(list_packages)
+list_app.command(name="benchmark-packages")(list_benchmark_packages)
+list_app.command(name="benchmark-experiments")(list_benchmark_experiments)
+
+# Register get commands
+get_app.command(name="benchmark-requirements")(get_benchmark_requirements)
+
+# Register run commands
+run_app.command(name="benchmarks")(run_benchmarks)
+
+# Register validate commands
+validate_app.command(name="package")(validate_package)
+validate_app.command(name="benchmarks")(validate_benchmarks)
+validate_app.command(name="logical-benchmarks")(validate_logical_benchmarks)
+
+
+def main() -> None:
+    """Entry point for the CLI application."""
+    app()
+
+
+if __name__ == "__main__":
+    main()
+
+# Made with Bob

algorithm_nexus/commands/__init__.py

@@ -0,0 +1,6 @@
+# Copyright IBM Corp. 2026
+# SPDX-License-Identifier: Apache-2.0
+
+"""Command implementations for Algorithm Nexus CLI."""
+
+# Made with Bob

algorithm_nexus/commands/ado_validator.py

@@ -0,0 +1,176 @@
+# Copyright IBM Corp. 2026
+# SPDX-License-Identifier: Apache-2.0
+
+"""ADO validation for benchmark instances."""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+import yaml
+
+try:
+    from ado.core.discoveryspace.config import DiscoverySpaceConfiguration
+    from pydantic import ValidationError
+    from rich.console import Console
+except ImportError:
+    print(
+        "Error: CLI dependencies are not installed.\n"
+        "Please install them with: pip install algorithm-nexus[cli]",
+        file=sys.stderr,
+    )
+    sys.exit(1)
+
+from algorithm_nexus.models import ValidationResult
+
+console = Console()
+
+
+def validate_space_yaml_syntax(base_path: Path, instance_path: str) -> ValidationResult:
+    """Validate space.yaml YAML syntax and basic structure using DiscoverySpaceConfiguration.
+
+    Args:
+        base_path: Base path (e.g., repo root or temp directory)
+        instance_path: Relative path to the benchmark instance from base_path
+
+    Returns:
+        ValidationResult with syntax validation results
+    """
+
+    # Construct full path to space.yaml
+    space_yaml_path = base_path / instance_path / "space.yaml"
+
+    # Check if file exists
+    if not space_yaml_path.is_file():
+        return ValidationResult(
+            success=False,
+            instance_path=instance_path,
+            errors=[f"File not found: {space_yaml_path}"],
+            warnings=[],
+        )
+
+    errors = []
+    warnings = []
+
+    space_config = None
+    try:
+        # Load and parse YAML
+        space_config_dict = yaml.safe_load(space_yaml_path.read_text())
+
+        # Validate using DiscoverySpaceConfiguration
+        space_config = DiscoverySpaceConfiguration.model_validate(space_config_dict)
+
+    except yaml.YAMLError as e:
+        errors.append(f"Invalid YAML syntax: {e}")
+    except ValidationError as e:
+        # Extract validation errors from Pydantic
+        for error in e.errors():
+            loc = " -> ".join(str(x) for x in error["loc"])
+            msg = error["msg"]
+            errors.append(f"Validation error at {loc}: {msg}")
+    except Exception as e:
+        errors.append(f"Unexpected error reading space.yaml: {e}")
+
+    # Check for optional but common sections using the validated model
+    if space_config:
+        space_config = space_config.convert_experiments_to_reference_list()
+        if not space_config.experiments:
+            warnings.append("No 'experiments' section found in space.yaml")
+
+        if not space_config.entitySpace:
+            warnings.append("No 'entitySpace' section found in space.yaml")
+
+    return ValidationResult(
+        success=len(errors) == 0,
+        instance_path=instance_path,
+        errors=errors,
+        warnings=warnings,
+    )
+
+
+def validate_with_ado(
+    base_path: Path,
+    instance_path: str,
+    venv_path: Path,
+) -> ValidationResult:
+    """Run ADO validation in isolated virtual environment.
+
+    Args:
+        base_path: Base path (e.g., repo root or temp directory)
+        instance_path: Relative path to the benchmark instance from base_path
+        venv_path: Path to virtual environment with ADO installed
+
+    Returns:
+        ValidationResult with ADO validation results
+    """
+    # First validate syntax
+    syntax_result = validate_space_yaml_syntax(base_path, instance_path)
+
+    if syntax_result.errors:
+        # Don't proceed with ADO validation if syntax is invalid
+        return syntax_result
+
+    # Start with syntax warnings for ADO validation
+    errors = []
+    warnings = syntax_result.warnings.copy()
+
+    # Check if ADO binary is available in the venv
+    ado_binary = venv_path / "bin" / "ado"
+    if not ado_binary.is_file():
+        errors.append(
+            "ADO binary not found in the virtual environment. "
+            "Make sure ado-core is installed."
+        )
+        return ValidationResult(
+            success=False,
+            instance_path=instance_path,
+            errors=errors,
+            warnings=warnings,
+        )
+
+    # Validate with ADO using dry-run mode
+    try:
+        # Construct full path to space.yaml
+        space_yaml_path = base_path / instance_path / "space.yaml"
+
+        # Use ado create space with --dry-run flag
+        # Run from the benchmark instance directory to support relative paths in space.yaml
+        result = subprocess.run(  # noqa: S603
+            [
+                str(ado_binary),
+                "create",
+                "space",
+                "-f",
+                str(space_yaml_path),
+                "--dry-run",
+            ],
+            capture_output=True,
+            text=True,
+            check=False,
+            timeout=30,  # 30 second timeout
+            cwd=space_yaml_path.parent,  # Run from benchmark instance directory
+        )
+
+        if result.returncode != 0:
+            # Parse error message for more details
+            error_msg = (
+                result.stderr.strip() if result.stderr else result.stdout.strip()
+            )
+            errors.append(f"ADO validation failed: {error_msg}")
+
+    except subprocess.TimeoutExpired:
+        errors.append("ADO validation timed out after 30 seconds")
+    except Exception as e:
+        errors.append(f"Failed to run ADO validation: {e}")
+
+    return ValidationResult(
+        success=len(errors) == 0,
+        instance_path=instance_path,
+        errors=errors,
+        warnings=warnings,
+    )
+
+
+# Made with Bob