helpers

🤖 AI-Generated Content

This documentation was generated with AI assistance and is still being audited. Some, or potentially a lot, of this information may be inaccurate. Learn more.

flavor.commands.helpers

Helper management commands for the flavor CLI.

Functions

helper_build

helper_build(lang: str, force: bool) -> None

Build helper binaries from source.

Source code in flavor/commands/helpers.py

@helper_group.command("build")
@click.option(
    "--lang",
    type=click.Choice(["go", "rust", "all"], case_sensitive=False),
    default="all",
    help="Language to build helpers for (default: all)",
)
@click.option(
    "--force",
    "-f",
    is_flag=True,
    help="Force rebuild even if binaries exist",
)
def helper_build(lang: str, force: bool) -> None:
    """Build helper binaries from source."""
    from flavor.helpers.manager import HelperManager

    manager = HelperManager()

    language = None if lang == "all" else lang

    pout(f"🔨 Building {lang} helpers...")

    built = manager.build_helpers(language=language, force=force)

    if built:
        pout(f"✅ Built {len(built)} helper(s):")
        for path in built:
            size_mb = path.stat().st_size / (1024 * 1024)
            pout(f"  • {path.name} ({size_mb:.1f} MB)")
    else:
        pout("⚠️  No helpers were built")
        pout("Make sure you have the required compilers installed:")
        pout("  • Go: go version")
        pout("  • Rust: cargo --version")

helper_clean

helper_clean(lang: str, yes: bool) -> None

Remove built helper binaries.

Source code in flavor/commands/helpers.py

@helper_group.command("clean")
@click.option(
    "--lang",
    type=click.Choice(["go", "rust", "all"], case_sensitive=False),
    default="all",
    help="Language to clean helpers for (default: all)",
)
@click.option(
    "--yes",
    "-y",
    is_flag=True,
    help="Skip confirmation prompt",
)
def helper_clean(lang: str, yes: bool) -> None:
    """Remove built helper binaries."""
    from flavor.helpers.manager import HelperManager

    manager = HelperManager()

    if not yes and not click.confirm(f"Remove {lang} helper binaries?"):
        pout("Aborted.")
        return

    language = None if lang == "all" else lang

    removed = manager.clean_helpers(language=language)

    if removed:
        pout(f"✅ Removed {len(removed)} helper(s):")
        for path in removed:
            pout(f"  • {path.name}")
    else:
        pout("No helpers to remove")

helper_group

helper_group() -> None

Manage Flavor helper binaries (launchers and builders).

Source code in flavor/commands/helpers.py

@click.group("helpers")
def helper_group() -> None:
    """Manage Flavor helper binaries (launchers and builders)."""

helper_info

helper_info(name: str) -> None

Show detailed information about a specific helper.

Source code in flavor/commands/helpers.py

@helper_group.command("info")
@click.argument("name")
def helper_info(name: str) -> None:
    """Show detailed information about a specific helper."""
    from flavor.helpers.manager import HelperManager

    manager = HelperManager()
    info = manager.get_helper_info(name)

    if not info:
        perr(f"❌ Helper '{name}' not found")
        return

    pout(f"🔧 Helper Information: {info.name}")
    pout("=" * 60)
    pout(f"Type: {info.type}")
    pout(f"Language: {info.language}")
    pout(f"Path: {info.path}")
    pout(f"Size: {info.size / (1024 * 1024):.1f} MB")

    if info.version:
        pout(f"Version: {info.version}")

    if info.checksum:
        pout(f"Checksum: {info.checksum}")

    if info.built_from:
        pout(f"Source: {info.built_from}")
        if info.built_from.exists():
            pout("  ✅ Source directory exists")
        else:
            pout("  ⚠️  Source directory not found")

    # Check if executable
    if info.path.exists():
        if os.access(info.path, os.X_OK):
            pass
        else:
            pout("Status: ❌ Not executable")
    else:
        pout("Status: ❌ File not found")

helper_list

helper_list(verbose: bool) -> None

List available helper binaries.

Source code in flavor/commands/helpers.py

@helper_group.command("list")
@click.option(
    "--verbose",
    "-v",
    is_flag=True,
    help="Show detailed information",
)
def helper_list(verbose: bool) -> None:
    """List available helper binaries."""
    from flavor.helpers.manager import HelperManager

    manager = HelperManager()
    helpers = manager.list_helpers()

    if not helpers["launchers"] and not helpers["builders"]:
        pout("No helpers found. Build them with: flavor helpers build")
        return

    pout("🔧 Available Flavor Helpers")
    pout("=" * 60)

    _display_helper_section("📦 Launchers:", helpers["launchers"], verbose)
    _display_helper_section("🔨 Builders:", helpers["builders"], verbose)

helper_test

helper_test(lang: str) -> None

Test helper binaries.

Source code in flavor/commands/helpers.py

@helper_group.command("test")
@click.option(
    "--lang",
    type=click.Choice(["go", "rust", "all"], case_sensitive=False),
    default="all",
    help="Language to test helpers for (default: all)",
)
def helper_test(lang: str) -> None:
    """Test helper binaries."""
    from flavor.helpers.manager import HelperManager

    manager = HelperManager()

    language = None if lang == "all" else lang

    pout(f"🧪 Testing {lang} helpers...")

    results = manager.test_helpers(language=language)

    # Show results
    if results["passed"]:
        pout(f"✅ Passed: {len(results['passed'])}")
        for name in results["passed"]:
            pout(f"  • {name}")

    if results["failed"]:
        perr(f"❌ Failed: {len(results['failed'])}")
        for failure in results["failed"]:
            pout(f"  • {failure['name']}: {failure['error']}")
            if failure.get("stderr"):
                pout(f"    {failure['stderr']}")

    if results["skipped"]:
        pout(f"⏭️  Skipped: {len(results['skipped'])}")
        for name in results["skipped"]:
            pout(f"  • {name}")

    # Overall status
    if results["failed"]:
        perr("\n❌ Some tests failed")
        raise click.Abort()
    elif results["passed"]:
        pout("\n✅ All tests passed")
    else:
        pout("\n⚠️  No tests were run")