fixdoc 0.0.1__py3-none-any.whl

fixdoc/commands/capture_handlers.py

@@ -0,0 +1,298 @@
+"""Capture handlers for different input types."""
+
+from typing import Optional
+
+import click
+
+from ..models import Fix
+from ..parsers import (
+    detect_error_source,
+    detect_and_parse,
+    ErrorSource,
+    TerraformError,
+    KubernetesError,
+)
+
+
+def handle_piped_input(output: str, tags: Optional[str]) -> Optional[Fix]:
+    """
+    Handle piped input by detecting the source and routing appropriately.
+
+    This is the main entry point for piped input handling. It detects
+    whether the input is from Terraform, Kubernetes, or another source.
+    """
+    source = detect_error_source(output)
+
+    if source == ErrorSource.TERRAFORM:
+        return handle_terraform_capture(output, tags)
+    elif source in (ErrorSource.KUBERNETES, ErrorSource.HELM):
+        return handle_kubernetes_capture(output, tags)
+    else:
+        return handle_generic_piped_capture(output, tags)
+
+
+def handle_terraform_capture(output: str, tags: Optional[str]) -> Optional[Fix]:
+    """Handle Terraform output with multi-cloud support."""
+    errors = detect_and_parse(output)
+
+    if not errors:
+        click.echo("No Terraform errors found in input", err=True)
+        return None
+
+    # Use the first error (or could prompt to select)
+    err = errors[0]
+
+    # Display captured error info
+    click.echo("─" * 50)
+    click.echo("Captured from Terraform:\n")
+    click.echo(f"  Provider: {err.cloud_provider.value.upper()}")
+    click.echo(f"  Resource: {err.resource_address}")
+    if err.file:
+        click.echo(f"  File:     {err.file}:{err.line}")
+    if err.error_code:
+        click.echo(f"  Code:     {err.error_code}")
+    click.echo(f"  Error:    {err.short_error()}")
+
+    # Show suggestions if available
+    if err.suggestions:
+        click.echo("\n  Suggestions:")
+        for suggestion in err.suggestions[:3]:
+            click.echo(f"    • {suggestion}")
+
+    click.echo("─" * 50)
+
+    # If multiple errors, show count
+    if len(errors) > 1:
+        click.echo(f"\n  ({len(errors) - 1} additional error(s) not shown)\n")
+
+    # Prompt for resolution
+    resolution = click.prompt("\n What fixed this?")
+    issue = err.to_issue_string()
+
+    # Auto-generate tags
+    auto_tags = err.generate_tags()
+    if tags:
+        auto_tags = f"{auto_tags},{tags}"
+
+    final_tags = click.prompt("Tags", default=auto_tags, show_default=True)
+
+    # Optional notes
+    notes_default = ""
+    if err.file:
+        notes_default = f"File: {err.file}:{err.line}"
+    if err.suggestions:
+        notes_default += "\nSuggestions: " + "; ".join(err.suggestions[:2])
+
+    notes = click.prompt("Notes (optional)", default=notes_default, show_default=False)
+
+    return Fix(
+        issue=issue,
+        resolution=resolution,
+        error_excerpt=output[:2000],
+        tags=final_tags,
+        notes=notes or None,
+    )
+
+
+def handle_kubernetes_capture(output: str, tags: Optional[str]) -> Optional[Fix]:
+    """Handle Kubernetes (kubectl/Helm) output."""
+    errors = detect_and_parse(output)
+
+    if not errors:
+        click.echo("No Kubernetes errors found in input", err=True)
+        return None
+
+    err = errors[0]
+
+    # Display captured error info
+    click.echo("─" * 50)
+
+    # Determine source label
+    if hasattr(err, 'helm_release') and err.helm_release:
+        source_label = "Helm"
+    else:
+        source_label = "Kubernetes"
+
+    click.echo(f"Captured from {source_label}:\n")
+
+    if err.namespace:
+        click.echo(f"  Namespace: {err.namespace}")
+    if err.resource_type:
+        click.echo(f"  Resource:  {err.resource_type}/{err.resource_name or 'unknown'}")
+
+    # Kubernetes-specific fields
+    if isinstance(err, KubernetesError):
+        if err.helm_release:
+            click.echo(f"  Release:   {err.helm_release}")
+        if err.helm_chart:
+            click.echo(f"  Chart:     {err.helm_chart}")
+        if err.pod_name:
+            click.echo(f"  Pod:       {err.pod_name}")
+        if err.restart_count is not None:
+            click.echo(f"  Restarts:  {err.restart_count}")
+        if err.exit_code is not None:
+            click.echo(f"  Exit Code: {err.exit_code}")
+
+    if err.error_code:
+        click.echo(f"  Status:    {err.error_code}")
+    click.echo(f"  Error:     {err.short_error()}")
+
+    # Show suggestions if available
+    if err.suggestions:
+        click.echo("\n  Suggestions:")
+        for suggestion in err.suggestions[:3]:
+            click.echo(f"    • {suggestion}")
+
+    click.echo("─" * 50)
+
+    # If multiple errors, show count
+    if len(errors) > 1:
+        click.echo(f"\n  ({len(errors) - 1} additional error(s) not shown)\n")
+
+    # Prompt for resolution
+    resolution = click.prompt("\n What fixed this?")
+    issue = err.to_issue_string()
+
+    # Auto-generate tags
+    auto_tags = err.generate_tags()
+    if tags:
+        auto_tags = f"{auto_tags},{tags}"
+
+    final_tags = click.prompt("Tags", default=auto_tags, show_default=True)
+
+    # Optional notes with helpful context
+    notes_parts = []
+    if isinstance(err, KubernetesError):
+        if err.namespace:
+            notes_parts.append(f"Namespace: {err.namespace}")
+        if err.pod_name:
+            notes_parts.append(f"Pod: {err.pod_name}")
+    if err.suggestions:
+        notes_parts.append("Suggestions: " + "; ".join(err.suggestions[:2]))
+
+    notes_default = "\n".join(notes_parts)
+    notes = click.prompt("Notes (optional)", default=notes_default, show_default=False)
+
+    return Fix(
+        issue=issue,
+        resolution=resolution,
+        error_excerpt=output[:2000],
+        tags=final_tags,
+        notes=notes or None,
+    )
+
+
+def handle_generic_piped_capture(piped_input: str, tags: Optional[str]) -> Fix:
+    """Handle generic piped input - treat as error excerpt."""
+    click.echo("─" * 50)
+    click.echo("Captured generic input (unknown source)")
+    click.echo("─" * 50)
+    click.echo("\nPlease provide fix details:\n")
+
+    issue = click.prompt("What was the issue?")
+    resolution = click.prompt("How was it resolved?")
+
+    if not tags:
+        tags = click.prompt("Tags (optional)", default="", show_default=False)
+
+    notes = click.prompt("Notes (optional)", default="", show_default=False)
+
+    return Fix(
+        issue=issue,
+        resolution=resolution,
+        error_excerpt=piped_input[:2000],
+        tags=tags or None,
+        notes=notes or None,
+    )
+
+
+def handle_quick_capture(quick: str, tags: Optional[str]) -> Fix:
+    """Handle quick capture mode."""
+    if "|" in quick:
+        parts = quick.split("|", 1)
+        issue = parts[0].strip()
+        resolution = parts[1].strip()
+    else:
+        issue = quick.strip()
+        resolution = click.prompt("Resolution")
+
+    return Fix(issue=issue, resolution=resolution, tags=tags)
+
+
+def handle_interactive_capture(tags: Optional[str]) -> Fix:
+    """Handle interactive capture mode."""
+    click.echo("─" * 50)
+    click.echo("Capturing a new fix...")
+    click.echo("─" * 50)
+    click.echo()
+
+    issue = click.prompt("What was the issue?")
+    resolution = click.prompt("How was it resolved?")
+
+    error_excerpt = click.prompt(
+        "Error excerpt (optional)", default="", show_default=False
+    )
+
+    if not tags:
+        tags = click.prompt("Tags (optional)", default="", show_default=False)
+
+    notes = click.prompt("Notes (optional)", default="", show_default=False)
+
+    return Fix(
+        issue=issue,
+        resolution=resolution,
+        error_excerpt=error_excerpt or None,
+        tags=tags or None,
+        notes=notes or None,
+    )
+
+
+def handle_multi_error_capture(output: str, tags: Optional[str]) -> list[Fix]:
+    """
+    Handle output with multiple errors, creating a fix for each.
+
+    This is useful for batch processing multiple errors from a single
+    Terraform apply or kubectl operation.
+    """
+    errors = detect_and_parse(output)
+
+    if not errors:
+        click.echo("No errors found in input", err=True)
+        return []
+
+    fixes = []
+
+    click.echo(f"\nFound {len(errors)} error(s). Processing each:\n")
+
+    for i, err in enumerate(errors, 1):
+        click.echo("─" * 50)
+        click.echo(f"Error {i}/{len(errors)}:")
+        click.echo(f"  Resource: {err.resource_address or err.resource_name or 'unknown'}")
+        click.echo(f"  Error:    {err.short_error()}")
+        click.echo("─" * 50)
+
+        # Ask if user wants to create a fix for this error
+        create = click.confirm(f"Create fix for this error?", default=True)
+        if not create:
+            continue
+
+        resolution = click.prompt("What fixed this?")
+        issue = err.to_issue_string()
+
+        auto_tags = err.generate_tags()
+        if tags:
+            auto_tags = f"{auto_tags},{tags}"
+
+        final_tags = click.prompt("Tags", default=auto_tags, show_default=True)
+
+        fix = Fix(
+            issue=issue,
+            resolution=resolution,
+            error_excerpt=err.raw_output[:2000],
+            tags=final_tags,
+        )
+        fixes.append(fix)
+
+        click.echo(f"✓ Fix created\n")
+
+    return fixes

fixdoc/commands/delete.py

@@ -0,0 +1,72 @@
+"""Delete command for fixdoc CLI."""
+
+import click
+
+from ..storage import FixRepository
+
+
+def get_repo() -> FixRepository:
+    """Get the fix repository instance."""
+    return FixRepository()
+
+
+@click.command()
+@click.argument("fix_id", required=False)
+@click.option("--purge", is_flag=True, help="Delete all fixes")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+def delete(fix_id: str, purge: bool, yes: bool):
+    """
+    Delete a fix by ID, or purge all fixes.
+
+    \b
+    Examples:
+        fixdoc delete a1b2c3d4
+        fixdoc delete --purge
+        fixdoc delete --purge -y
+    """
+    repo = get_repo()
+
+    if purge:
+        _purge_all(repo, yes)
+    elif fix_id:
+        _delete_one(repo, fix_id, yes)
+    else:
+        click.echo("Provide a fix ID or use --purge to delete all.")
+        raise SystemExit(1)
+
+
+def _purge_all(repo: FixRepository, skip_confirm: bool):
+    """Delete all fixes."""
+    count = repo.count()
+
+    if count == 0:
+        click.echo("No fixes to delete.")
+        return
+
+    if not skip_confirm:
+        if not click.confirm(f"Delete all {count} fixes?"):
+            click.echo("Aborted.")
+            return
+
+    repo.purge()
+    click.echo(f"✓ Purged {count} fixes.")
+
+
+def _delete_one(repo: FixRepository, fix_id: str, skip_confirm: bool):
+    """Delete a single fix."""
+    fix = repo.get(fix_id)
+
+    if not fix:
+        click.echo(f"No fix found with ID starting with '{fix_id}'")
+        raise SystemExit(1)
+
+    if not skip_confirm:
+        if not click.confirm(f"Delete fix {fix.id[:8]}?"):
+            click.echo("Aborted.")
+            return
+
+    if repo.delete(fix_id):
+        click.echo(f"✓ Deleted fix: {fix.id[:8]}")
+    else:
+        click.echo("Failed to delete fix")
+        raise SystemExit(1)

fixdoc/commands/edit.py

@@ -0,0 +1,118 @@
+
+from typing import Optional
+
+import click
+
+from ..models import Fix
+from ..storage import FixRepository
+
+
+def get_repo() -> FixRepository:
+    return FixRepository()
+
+
+@click.command()
+@click.argument("fix_id")
+@click.option("--issue", "-i", type=str, help="Update the issue description")
+@click.option("--resolution", "-r", type=str, help="Update the resolution")
+@click.option("--tags", "-t", type=str, help="Update tags")
+@click.option("--notes", "-n", type=str, help="Update notes")
+@click.option("--error", "-e", type=str, help="Update error excerpt")
+@click.option("--interactive", "-I", is_flag=True, help="Edit all fields interactively")
+def edit(
+    fix_id: str,
+    issue: Optional[str],
+    resolution: Optional[str],
+    tags: Optional[str],
+    notes: Optional[str],
+    error: Optional[str],
+    interactive: bool,
+):
+    """
+    Edit an existing fix.
+
+    \b
+    Examples:
+        fixdoc edit a1b2c3d4 --resolution "New fix details"
+        fixdoc edit a1b2c3d4 --tags "storage,rbac,new_tag"
+        fixdoc edit a1b2c3d4 -I  # Interactive mode
+    """
+    repo = get_repo()
+
+    fix = repo.get(fix_id)
+    if not fix:
+        click.echo(f"No fix found with ID starting with '{fix_id}'")
+        raise SystemExit(1)
+
+    if interactive:
+        fix = _interactive_edit(fix)
+    else:
+        fix = _flag_edit(fix, issue, resolution, tags, notes, error)
+
+    if fix:
+        fix.touch()
+        repo.save(fix)
+        click.echo(f"✓ Updated fix: {fix.id[:8]}")
+
+
+def _interactive_edit(fix: Fix) -> Fix:
+    """Edit all fields interactively."""
+    click.echo(f"Editing fix: {fix.id[:8]}\n")
+    click.echo("Press Enter to keep current value.\n")
+
+    new_issue = click.prompt("Issue", default=fix.issue, show_default=True)
+    new_resolution = click.prompt("Resolution", default=fix.resolution, show_default=True)
+
+    new_error = click.prompt(
+        "Error excerpt",
+        default=fix.error_excerpt or "",
+        show_default=True if fix.error_excerpt else False,
+    )
+
+    new_tags = click.prompt(
+        "Tags",
+        default=fix.tags or "",
+        show_default=True if fix.tags else False,
+    )
+
+    new_notes = click.prompt(
+        "Notes",
+        default=fix.notes or "",
+        show_default=True if fix.notes else False,
+    )
+
+    fix.issue = new_issue
+    fix.resolution = new_resolution
+    fix.error_excerpt = new_error or None
+    fix.tags = new_tags or None
+    fix.notes = new_notes or None
+
+    return fix
+
+
+def _flag_edit(
+    fix: Fix,
+    issue: Optional[str],
+    resolution: Optional[str],
+    tags: Optional[str],
+    notes: Optional[str],
+    error: Optional[str],
+) -> Optional[Fix]:
+    """Edit specific fields via flags."""
+    if not any([issue, resolution, tags, notes, error]):
+        click.echo("No changes specified. Use flags or -I for interactive mode.")
+        click.echo("Run 'fixdoc edit --help' for options.")
+        return None
+
+    if issue:
+        fix.issue = issue
+    if resolution:
+        fix.resolution = resolution
+    if tags:
+        fix.tags = tags
+    if notes:
+        fix.notes = notes
+    if error:
+        fix.error_excerpt = error
+
+    return fix

fixdoc/commands/manage.py

@@ -0,0 +1,67 @@
+"""List and stats commands for fixdoc CLI."""
+
+import click
+
+from ..storage import FixRepository
+
+
+def get_repo() -> FixRepository:
+    """Get the fix repository instance."""
+    return FixRepository()
+
+
+@click.command(name="list")
+@click.option("--limit", "-l", type=int, default=20, help="Max fixes to show")
+def list_fixes(limit: int):
+    """
+    List all captured fixes.
+
+    Shows a summary of each fix, most recent first.
+    """
+    repo = get_repo()
+    fixes = repo.list_all()
+
+    if not fixes:
+        click.echo("No fixes captured yet. Run `fixdoc capture` to add one.")
+        return
+
+    fixes.sort(key=lambda f: f.created_at, reverse=True)
+
+    click.echo(f"Total fixes: {len(fixes)}\n")
+
+    for fix in fixes[:limit]:
+        click.echo(f"  {fix.summary()}")
+
+    if len(fixes) > limit:
+        click.echo(f"\n  ... and {len(fixes) - limit} more. Use --limit to see more.")
+
+
+@click.command()
+def stats():
+    """Show statistics about your fix database."""
+    repo = get_repo()
+    fixes = repo.list_all()
+
+    if not fixes:
+        click.echo("No fixes captured yet.")
+        return
+
+    all_tags = []
+    for fix in fixes:
+        if fix.tags:
+            all_tags.extend([t.strip() for t in fix.tags.split(",")])
+
+    tag_counts = {}
+    for tag in all_tags:
+        tag_counts[tag] = tag_counts.get(tag, 0) + 1
+
+    click.echo(" Fix Database Statistics\n")
+    click.echo(f"  Total fixes: {len(fixes)}")
+    click.echo(f"  Fixes with tags: {sum(1 for f in fixes if f.tags)}")
+    click.echo(f"  Fixes with error excerpts: {sum(1 for f in fixes if f.error_excerpt)}")
+
+    if tag_counts:
+        click.echo("\n  Top tags:")
+        sorted_tags = sorted(tag_counts.items(), key=lambda x: x[1], reverse=True)
+        for tag, count in sorted_tags[:10]:
+            click.echo(f"    {tag}: {count}")

fixdoc/commands/search.py

@@ -0,0 +1,65 @@
+"""Search command for fixdoc CLI."""
+
+import click
+
+from ..storage import FixRepository
+from ..formatter import fix_to_markdown
+
+
+def get_repo() -> FixRepository:
+    """Get the fix repository instance."""
+    return FixRepository()
+
+
+@click.command()
+@click.argument("query")
+@click.option("--limit", "-l", type=int, default=10, help="Max results to show")
+def search(query: str, limit: int):
+    """
+    Search your fixes by keyword.
+
+    Searches across issue, resolution, error excerpt, tags, and notes.
+
+    \b
+    Examples:
+        fixdoc search "storage account"
+        fixdoc search rbac
+    """
+    repo = get_repo()
+    results = repo.search(query)
+
+    if not results:
+        click.echo(f"No fixes found matching '{query}'")
+        return
+
+    click.echo(f"Found {len(results)} fix(es) matching '{query}':\n")
+
+    for fix in results[:limit]:
+        click.echo(f"  {fix.summary()}")
+
+    if len(results) > limit:
+        click.echo(f"\n  ... and {len(results) - limit} more. Use --limit to see more.")
+
+    click.echo(f"\nRun `fixdoc show <fix-id>` for full details.")
+
+
+@click.command()
+@click.argument("fix_id")
+def show(fix_id: str):
+    """
+    Show full details of a fix.
+
+    Accepts full or partial fix ID.
+
+    \b
+    Example:
+        fixdoc show a1b2c3d4
+    """
+    repo = get_repo()
+    fix = repo.get(fix_id)
+
+    if not fix:
+        click.echo(f"No fix found with ID: '{fix_id}'")
+        raise SystemExit(1)
+
+    click.echo(fix_to_markdown(fix))