workenv

🤖 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.workenv

Work environment management commands for the flavor CLI.

Functions

workenv_clean

workenv_clean(older_than: int | None, yes: bool) -> None

Clean the work environment cache.

Source code in flavor/commands/workenv.py

@workenv_group.command("clean")
@click.option(
    "--older-than",
    type=int,
    help="Remove packages older than N days",
)
@click.option(
    "--yes",
    "-y",
    is_flag=True,
    help="Skip confirmation prompt",
)
def workenv_clean(older_than: int | None, yes: bool) -> None:
    """Clean the work environment cache."""
    from flavor.cache import CacheManager

    manager = CacheManager()

    if not yes:
        if older_than:
            prompt = f"Remove cached packages older than {older_than} days?"
        else:
            prompt = "Remove all cached packages?"

        if not click.confirm(prompt):
            pout("Aborted.")
            return

    # Clean old packages
    removed = manager.clean(max_age_days=older_than)

    if removed:
        pout(f"✅ Removed {len(removed)} cached package(s)")
    else:
        pout("No packages to clean")

workenv_group

workenv_group() -> None

Manage the Flavor work environment cache.

Source code in flavor/commands/workenv.py

@click.group("workenv")
def workenv_group() -> None:
    """Manage the Flavor work environment cache."""

workenv_info

workenv_info() -> None

Show work environment cache information.

Source code in flavor/commands/workenv.py

@workenv_group.command("info")
def workenv_info() -> None:
    """Show work environment cache information."""
    from flavor.cache import CacheManager, get_cache_dir

    manager = CacheManager()
    cached = manager.list_cached()
    total_size = manager.get_cache_size()

    pout("📊 Cache Information")
    pout("=" * 40)
    pout(f"Cache directory: {get_cache_dir()}")
    pout(f"Total size: {total_size / (1024 * 1024):.1f} MB")
    pout(f"Number of packages: {len(cached)}")

workenv_inspect

workenv_inspect(package_id: str, output_json: bool) -> None

Inspect detailed metadata for a cached package extraction.

Source code in flavor/commands/workenv.py

@workenv_group.command("inspect")
@click.argument("package_id")
@click.option(
    "--json",
    "output_json",
    is_flag=True,
    help="Output as JSON format",
)
def workenv_inspect(package_id: str, output_json: bool) -> None:
    """Inspect detailed metadata for a cached package extraction."""
    from pathlib import Path

    from flavor.cache import CacheManager

    manager = CacheManager()
    info = manager.inspect_workenv(package_id)

    if not info.get("exists"):
        perr(f"❌ Package '{package_id}' not found")
        return

    if output_json:
        pout(json_dumps(info, indent=2, default=str))
        return

    # Human-readable output
    pout("=" * 60)
    pout(f"📦 Package: {package_id}")
    pout("-" * 60)

    _display_basic_info(info)

    # Index metadata from index.json
    if info.get("metadata_dir"):
        index_file = Path(info["metadata_dir"]) / "instance" / "index.json"
        if index_file.exists():
            try:
                index_data = read_json(index_file)
                _display_index_metadata(index_data)
            except Exception as e:
                pout(f"  ⚠️  Error reading index.json: {e}")

    if info.get("package_info"):
        _display_package_info(info["package_info"])

    pout("")

workenv_list

workenv_list() -> None

List cached package extractions.

Source code in flavor/commands/workenv.py

@workenv_group.command("list")
def workenv_list() -> None:
    """List cached package extractions."""
    from flavor.cache import CacheManager

    manager = CacheManager()
    cached = manager.list_cached()

    if not cached:
        pout("No cached packages found.")
        return

    pout("🗂️  Cached Packages:")
    pout("=" * 60)

    for pkg in cached:
        # Type check: size should be int or float from cache manager
        pkg_size = pkg["size"]
        size_mb = pkg_size / (1024 * 1024) if isinstance(pkg_size, (int, float)) else 0.0
        name = pkg.get("name", pkg["id"])
        version = pkg.get("version", "")

        if version:
            pout(f"\n📦 {name} v{version}")
        else:
            pout(f"\n📦 {name}")

        pout(f"   ID: {pkg['id']}")
        pout(f"   Size: {size_mb:.1f} MB")

        # Type check: modified should be a float timestamp
        modified_ts = pkg.get("modified", 0)
        if isinstance(modified_ts, (int, float)):
            modified = datetime.datetime.fromtimestamp(modified_ts)
        else:
            modified = datetime.datetime.now()
        pout(f"   Modified: {modified.strftime('%Y-%m-%d %H:%M:%S')}")

workenv_remove

workenv_remove(package_id: str, yes: bool) -> None

Remove a specific cached package extraction.

Source code in flavor/commands/workenv.py

@workenv_group.command("remove")
@click.argument("package_id")
@click.option(
    "--yes",
    "-y",
    is_flag=True,
    help="Skip confirmation prompt",
)
def workenv_remove(package_id: str, yes: bool) -> None:
    """Remove a specific cached package extraction."""
    from flavor.cache import CacheManager

    manager = CacheManager()

    if not yes:
        info = manager.inspect_workenv(package_id)
        if info and info.get("exists"):
            from pathlib import Path

            size_mb = manager._get_dir_size(Path(info["content_dir"])) / (1024 * 1024)
            name = info.get("package_info", {}).get("name", package_id)
            if not click.confirm(f"""Remove {name} ({size_mb:.1f} MB)?"""):
                pout("Aborted.")
                return

    if manager.remove(package_id):
        pass
    else:
        perr(f"❌ Package '{package_id}' not found")