aws-inventory-manager 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

{aws_inventory_manager-0.2.0.dist-info → aws_inventory_manager-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aws-inventory-manager
-Version: 0.2.0
+Version: 0.3.0
 Summary: AWS Resource Inventory Management & Delta Tracking CLI tool
 Author-email: Troy Larson <troy@calvinware.com>
 License: MIT
@@ -63,6 +63,7 @@ A Python CLI tool that captures point-in-time snapshots of AWS resources organiz
 
 - **📦 Inventory Management**: Organize snapshots into named inventories with optional tag-based filters
 - **📸 Resource Snapshots**: Capture complete inventory of AWS resources across multiple regions
+- **📋 Snapshot Reporting**: Generate comprehensive reports with filtering, detailed views, and export to JSON/CSV/TXT
 - **🔄 Delta Tracking**: Identify resources added, modified, or removed since a snapshot
 - **💰 Cost Analysis**: Analyze costs for resources within a specific inventory
 - **🔧 Resource Restoration**: Remove resources added since a snapshot to return to that state
@@ -109,13 +110,28 @@ This captures all resources in `us-east-1` and stores them in the `prod-baseline
 - Deploy new resources, update configurations, etc.
 - Then take another snapshot to track what changed
 
-**4. Compare snapshots** (see what changed)
+**4. View snapshot report** (see what's in your snapshot)
+```bash
+# Summary view with resource counts by service, region, and type
+awsinv snapshot report --inventory prod-baseline
+
+# Detailed view showing all resources with tags and metadata
+awsinv snapshot report --inventory prod-baseline --detailed
+
+# Filter by resource type
+awsinv snapshot report --inventory prod-baseline --resource-type ec2
+
+# Export to JSON, CSV, or TXT
+awsinv snapshot report --inventory prod-baseline --export report.json
+```
+
+**5. Compare snapshots** (see what changed)
 ```bash
 awsinv delta --snapshot initial --inventory prod-baseline
 ```
 This shows all resources added, removed, or modified since the `initial` snapshot.
 
-**5. Analyze costs**
+**6. Analyze costs**
 ```bash
 # Costs since snapshot was created
 awsinv cost --snapshot initial --inventory prod-baseline
@@ -125,7 +141,7 @@ awsinv cost --snapshot initial --inventory prod-baseline \
   --start-date 2025-01-01 --end-date 2025-01-31
 ```
 
-**6. List your resources**
+**7. List your resources**
 ```bash
 # List all inventories
 awsinv inventory list
@@ -456,6 +472,16 @@ awsinv snapshot create [name] \
   [--compress] \
   [--profile <aws-profile>]
 
+# Generate snapshot report
+awsinv snapshot report [snapshot-name] \
+  [--inventory <inventory-name>] \
+  [--resource-type <type>] \
+  [--region <region>] \
+  [--detailed] \
+  [--page-size <number>] \
+  [--export <file.json|file.csv|file.txt>] \
+  [--profile <aws-profile>]
+
 # List all snapshots
 awsinv snapshot list [--profile <aws-profile>]
 
@@ -503,6 +529,6 @@ MIT License - see LICENSE file for details
 
 ---
 
-**Version**: 0.2.0
+**Version**: 0.3.0
 **Status**: Alpha
 **Python**: 3.8 - 3.13

{aws_inventory_manager-0.2.0.dist-info → aws_inventory_manager-0.3.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-aws_inventory_manager-0.2.0.dist-info/licenses/LICENSE,sha256=-lY65BqqcGV9QVjIoTpYEB0Jaddm9j-cS5ICDRBRQo0,1071
+aws_inventory_manager-0.3.0.dist-info/licenses/LICENSE,sha256=-lY65BqqcGV9QVjIoTpYEB0Jaddm9j-cS5ICDRBRQo0,1071
 src/__init__.py,sha256=XRWrw_3Q5Lb1Kxh8DnBcuiOeNWsIamXW6pUN6tKiXyA,74
 src/aws/__init__.py,sha256=FcFY2cn8ZQCnActrZYH1hD0x4uFkM9bMBDOmuHA3_mw,253
 src/aws/client.py,sha256=6HKHoOwAjlxfT2gJoSAZnzLCv-hIlLxXtGHqW8qu4xo,4082
@@ -6,7 +6,7 @@ src/aws/credentials.py,sha256=mxj8lQf7TRG5dznQJ37rGQqfB-viHh_5VCt1C4xgqG0,6374
 src/aws/rate_limiter.py,sha256=b3dV4A9ftUsGgVMOQmv3IVO0Fkym2o1QDHKpFOdSYbg,5464
 src/cli/__init__.py,sha256=aqMdryo16KNn_92UfbL8Gn6C1kUJK2McWIt9PY7BrHQ,113
 src/cli/config.py,sha256=FMLDg5OrmFzBJR_jO5Qg5ery-E9oXt-VPbs_5M0KtVA,4280
-src/cli/main.py,sha256=DR4VjmpXIHSfhUyUPBz9CoZfpNBllMiW17XVFTn_wjs,57572
+src/cli/main.py,sha256=VJU79I-tN4iJ-jrfGykAijlv96cHWAYAI-0qT0Owcu0,71349
 src/cost/__init__.py,sha256=WpTwsWAm8wyCkB65gsCnzu89-r5G_hgrbL9zTqvQ8j8,122
 src/cost/analyzer.py,sha256=02WFkZErD-zfu1Jp8UDym3wTjuB0c3l5jadZmbGbBJk,10201
 src/cost/explorer.py,sha256=c4Yj7w5gmvoeD9iY7hseinj3Ij-g9Rh8YXWYZVkO6u4,6847
@@ -18,12 +18,15 @@ src/models/__init__.py,sha256=GPMBPxpV0-GAEZdCYbPn7p7t_ICSFfzDuu-aYSrQXs8,395
 src/models/cost_report.py,sha256=BzyWrMewHau7EpQyLm4WoesVY3WDPBOtGVdk_H8USuM,3079
 src/models/delta_report.py,sha256=IUY1ulWvwPzLyVcj3NKFrkHoiTQTilHsiMU8Oe4OyOk,4500
 src/models/inventory.py,sha256=x5rm9pjHryjsMvjNWY-I9MDNC7hSzs79zYriO9-K7dM,4840
+src/models/report.py,sha256=Ubd2OdBavCRA4LN8aJiLrjhDzPCcx4-US4cTkZII5SM,8853
 src/models/resource.py,sha256=6B7MQL_0mW2PKx0YvnAGjp0549vP8R61U9QZ-P0Zbj8,3192
 src/models/snapshot.py,sha256=JLZzS4toRDyEvFWefHZFhBbZBY4_eyOrlkSkqWcKPLY,4204
 src/snapshot/__init__.py,sha256=trHfRe_8jxjQVb48cDLVH3gs2Y7YQtsX2gFL4OB9qRc,237
 src/snapshot/capturer.py,sha256=YVeUHLSufuoZD49vTERPQGR95IZAZb0yqFZ6IGI1Urs,13059
 src/snapshot/filter.py,sha256=WjR96C5mpyjWvxyDcD9gniIYRgTCDRQTJZR0PedHQtU,8503
 src/snapshot/inventory_storage.py,sha256=Ocq9GfMb8e-E80rewmK1LPwYNfNxbO-tPg4p1LFnerE,9079
+src/snapshot/report_formatter.py,sha256=WR7Adqq5FjJqu3iIWAnOZ9yp6AuJH1kA6uKKpT7jrT4,8266
+src/snapshot/reporter.py,sha256=CZp5fj6RcHoD5a3-1unwq5KKIxrQA38rLWCjspnyvvI,6628
 src/snapshot/storage.py,sha256=MQZN2W4aBFG69NU-gwGw8LNvae0z6UMJPeL02qq-dYM,8466
 src/snapshot/resource_collectors/__init__.py,sha256=QSJiStvbmqd_uCI6c4T03-3PMb0UmxAROZwVHPk25gc,94
 src/snapshot/resource_collectors/apigateway.py,sha256=X916NdfRzUMNmMuyJdB_BrgTu1p7P7NwslPxWcPW4CU,4748
@@ -53,13 +56,14 @@ src/snapshot/resource_collectors/stepfunctions.py,sha256=I8TYniEzSX2jKZbSX6WI02e
 src/snapshot/resource_collectors/vpcendpoints.py,sha256=tclcLPRxFmE5vwQQPwFQv2nbOc-4qVFnUaSJ4oDMU7w,2994
 src/snapshot/resource_collectors/waf.py,sha256=HUNshQ_WHbIK3nAyNwhb21uHkMC7ywSOke28b-5ECRg,6461
 src/utils/__init__.py,sha256=1qjjL3wxB7ye6s3AT4h5hQ9Xgi7y0WllUMmTpiZWC54,284
-src/utils/export.py,sha256=FeD7Dg7gzTGHJQIA8zGNI64hrwbzQ2KwDMqI74fVgYM,2390
+src/utils/export.py,sha256=lBUxLGkvtdzTFq2VKRmHgf18ZROiorHGGHlbeG7ixxc,8929
 src/utils/hash.py,sha256=w6jJqNR64IEcgMIrIY-M1QXuo_CkH0sbT8I6JcFQJqo,1747
 src/utils/logging.py,sha256=D39u9xrDSr_HlqedKa2yz-vmbCKulNAkJNVfG571UXY,2558
+src/utils/pagination.py,sha256=BoMk2lP65-tGP1U6aUAuJPU7M-JroSvyfpScLKcGYxg,1153
 src/utils/paths.py,sha256=EgO41-XE1KOmF0drY2YlJkzNQIb3WPsrGtPvsc0hVqY,1607
 src/utils/progress.py,sha256=H8_6AtVsw-_-P40E57ECofkFw0v1Lq6uEVSofuxCXxY,936
-aws_inventory_manager-0.2.0.dist-info/METADATA,sha256=WmZP6ZJIn5zmUSpoO0WABgGCyHMaNs0M9CP-dRSY4pw,14427
-aws_inventory_manager-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aws_inventory_manager-0.2.0.dist-info/entry_points.txt,sha256=Ktdhto-PER5BtwWKYBtU_-FS3ngiGtAGGeoLzRW2qUw,44
-aws_inventory_manager-0.2.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-aws_inventory_manager-0.2.0.dist-info/RECORD,,
+aws_inventory_manager-0.3.0.dist-info/METADATA,sha256=3vuy5TJ4vheil4LsQtsmJQEQK7GIhNM2iNGIiB7Mxl8,15326
+aws_inventory_manager-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aws_inventory_manager-0.3.0.dist-info/entry_points.txt,sha256=Ktdhto-PER5BtwWKYBtU_-FS3ngiGtAGGeoLzRW2qUw,44
+aws_inventory_manager-0.3.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+aws_inventory_manager-0.3.0.dist-info/RECORD,,

src/cli/main.py

@@ -1127,6 +1127,279 @@ def snapshot_delete(
         raise typer.Exit(code=1)
 
 
+@snapshot_app.command("report")
+def snapshot_report(
+    snapshot_name: Optional[str] = typer.Argument(None, help="Snapshot name (default: active snapshot)"),
+    inventory: Optional[str] = typer.Option(None, "--inventory", help="Inventory name (required if multiple exist)"),
+    profile: Optional[str] = typer.Option(None, "--profile", help="AWS profile name"),
+    storage_path: Optional[str] = typer.Option(None, "--storage-path", help="Override storage location"),
+    resource_type: Optional[list[str]] = typer.Option(
+        None, "--resource-type", help="Filter by resource type (can specify multiple)"
+    ),
+    region: Optional[list[str]] = typer.Option(None, "--region", help="Filter by region (can specify multiple)"),
+    detailed: bool = typer.Option(
+        False, "--detailed", help="Show detailed resource information (ARN, tags, creation date)"
+    ),
+    page_size: int = typer.Option(100, "--page-size", help="Resources per page in detailed view (default: 100)"),
+    export: Optional[str] = typer.Option(
+        None, "--export", help="Export report to file (format detected from extension: .json, .csv, .txt)"
+    ),
+):
+    """Display resource summary report for a snapshot.
+
+    Shows aggregated resource counts by service, region, and type with
+    visual progress bars and formatted output. Can export to JSON, CSV, or TXT formats.
+
+    Snapshot Selection (in order of precedence):
+      1. Explicit snapshot name argument
+      2. Most recent snapshot from specified --inventory
+      3. Active snapshot (set via 'awsinv snapshot set-active')
+
+    Examples:
+        awsinv snapshot report                          # Report on active snapshot
+        awsinv snapshot report baseline-2025-01         # Report on specific snapshot
+        awsinv snapshot report --inventory prod         # Most recent snapshot from 'prod' inventory
+        awsinv snapshot report --resource-type ec2      # Filter by resource type
+        awsinv snapshot report --region us-east-1       # Filter by region
+        awsinv snapshot report --resource-type ec2 --resource-type lambda  # Multiple filters
+        awsinv snapshot report --export report.json     # Export full report to JSON
+        awsinv snapshot report --export resources.csv   # Export resources to CSV
+        awsinv snapshot report --export summary.txt     # Export summary to TXT
+        awsinv snapshot report --detailed --export details.json  # Export detailed view
+    """
+    from ..models.report import FilterCriteria
+    from ..snapshot.report_formatter import ReportFormatter
+    from ..snapshot.reporter import SnapshotReporter
+    from ..utils.export import detect_format, export_report_csv, export_report_json, export_report_txt
+
+    try:
+        # Use provided storage path or default from config
+        storage = SnapshotStorage(storage_path or config.storage_path)
+
+        # Determine which snapshot to load
+        target_snapshot_name: str
+        if snapshot_name:
+            # Explicit snapshot name provided
+            target_snapshot_name = snapshot_name
+        elif inventory:
+            # Inventory specified - find most recent snapshot from that inventory
+            from datetime import datetime as dt
+            from typing import TypedDict
+
+            class InventorySnapshot(TypedDict):
+                name: str
+                created_at: dt
+
+            all_snapshots = storage.list_snapshots()
+            inventory_snapshots: list[InventorySnapshot] = []
+
+            for snap_meta in all_snapshots:
+                try:
+                    snap = storage.load_snapshot(snap_meta["name"])
+                    if snap.inventory_name == inventory:
+                        inventory_snapshots.append(
+                            InventorySnapshot(
+                                name=snap.name,
+                                created_at=snap.created_at,
+                            )
+                        )
+                except Exception:
+                    continue
+
+            if not inventory_snapshots:
+                console.print(f"✗ No snapshots found for inventory '{inventory}'", style="bold red")
+                console.print("\nCreate a snapshot first:")
+                console.print(f"  awsinv snapshot create --inventory {inventory}")
+                raise typer.Exit(code=1)
+
+            # Sort by created_at and pick most recent
+            inventory_snapshots.sort(key=lambda x: x["created_at"], reverse=True)
+            target_snapshot_name = inventory_snapshots[0]["name"]
+            console.print(
+                f"ℹ Using most recent snapshot from inventory '{inventory}': {target_snapshot_name}", style="dim"
+            )
+        else:
+            # Try to get active snapshot
+            active_name = storage.get_active_snapshot_name()
+            if not active_name:
+                console.print("✗ No active snapshot found", style="bold red")
+                console.print("\nSet an active snapshot with:")
+                console.print("  awsinv snapshot set-active <name>")
+                console.print("\nOr specify a snapshot explicitly:")
+                console.print("  awsinv snapshot report <snapshot-name>")
+                console.print("\nOr specify an inventory to use the most recent snapshot:")
+                console.print("  awsinv snapshot report --inventory <inventory-name>")
+                raise typer.Exit(code=1)
+            target_snapshot_name = active_name
+
+        # Load the snapshot
+        try:
+            snapshot = storage.load_snapshot(target_snapshot_name)
+        except FileNotFoundError:
+            console.print(f"✗ Snapshot '{target_snapshot_name}' not found", style="bold red")
+
+            # Show available snapshots
+            try:
+                all_snapshots = storage.list_snapshots()
+                if all_snapshots:
+                    console.print("\nAvailable snapshots:")
+                    for snap_name in all_snapshots[:5]:
+                        console.print(f"  • {snap_name}")
+                    if len(all_snapshots) > 5:
+                        console.print(f"  ... and {len(all_snapshots) - 5} more")
+                    console.print("\nRun 'awsinv snapshot list' to see all snapshots.")
+            except Exception:
+                pass
+
+            raise typer.Exit(code=1)
+
+        # Handle empty snapshot
+        if snapshot.resource_count == 0:
+            console.print(f"⚠️  Warning: Snapshot '{snapshot.name}' contains 0 resources", style="yellow")
+            console.print("\nNo report to generate.")
+            raise typer.Exit(code=0)
+
+        # Create filter criteria if filters provided
+        has_filters = bool(resource_type or region)
+        criteria = None
+        if has_filters:
+            criteria = FilterCriteria(
+                resource_types=resource_type if resource_type else None,
+                regions=region if region else None,
+            )
+
+        # Generate report
+        reporter = SnapshotReporter(snapshot)
+        metadata = reporter._extract_metadata()
+
+        # Detailed view vs Summary view
+        if detailed:
+            # Get detailed resources (with optional filtering)
+            detailed_resources = list(reporter.get_detailed_resources(criteria))
+
+            # Export mode
+            if export:
+                try:
+                    # Detect format from file extension
+                    export_format = detect_format(export)
+
+                    # Export based on format
+                    if export_format == "json":
+                        # For JSON, export full report structure with detailed resources
+                        summary = (
+                            reporter.generate_filtered_summary(criteria) if criteria else reporter.generate_summary()
+                        )
+                        export_path = export_report_json(export, metadata, summary, detailed_resources)
+                        console.print(
+                            f"✓ Exported {len(detailed_resources):,} resources to JSON: {export_path}",
+                            style="bold green",
+                        )
+                    elif export_format == "csv":
+                        # For CSV, export detailed resources
+                        export_path = export_report_csv(export, detailed_resources)
+                        console.print(
+                            f"✓ Exported {len(detailed_resources):,} resources to CSV: {export_path}",
+                            style="bold green",
+                        )
+                    elif export_format == "txt":
+                        # For TXT, export summary (detailed view doesn't make sense for plain text)
+                        summary = (
+                            reporter.generate_filtered_summary(criteria) if criteria else reporter.generate_summary()
+                        )
+                        export_path = export_report_txt(export, metadata, summary)
+                        console.print(f"✓ Exported summary to TXT: {export_path}", style="bold green")
+                except FileExistsError as e:
+                    console.print(f"✗ {e}", style="bold red")
+                    console.print("\nUse a different filename or delete the existing file.", style="yellow")
+                    raise typer.Exit(code=1)
+                except FileNotFoundError as e:
+                    console.print(f"✗ {e}", style="bold red")
+                    raise typer.Exit(code=1)
+                except ValueError as e:
+                    console.print(f"✗ {e}", style="bold red")
+                    raise typer.Exit(code=1)
+            else:
+                # Display mode - show filter information if applied
+                if criteria:
+                    console.print("\n[bold cyan]Filters Applied:[/bold cyan]")
+                    if resource_type:
+                        console.print(f"  • Resource Types: {', '.join(resource_type)}")
+                    if region:
+                        console.print(f"  • Regions: {', '.join(region)}")
+                    console.print(
+                        f"  • Matching Resources: {len(detailed_resources):,} (of {snapshot.resource_count:,} total)\n"
+                    )
+
+                # Format and display detailed view
+                formatter = ReportFormatter(console)
+                formatter.format_detailed(metadata, detailed_resources, page_size=page_size)
+        else:
+            # Generate summary (filtered or full)
+            if criteria:
+                summary = reporter.generate_filtered_summary(criteria)
+            else:
+                summary = reporter.generate_summary()
+
+            # Export mode
+            if export:
+                try:
+                    # Detect format from file extension
+                    export_format = detect_format(export)
+
+                    # Export based on format
+                    if export_format == "json":
+                        # For JSON, export full report structure
+                        # Get all resources for complete export
+                        all_resources = list(reporter.get_detailed_resources(criteria))
+                        export_path = export_report_json(export, metadata, summary, all_resources)
+                        console.print(
+                            f"✓ Exported {summary.total_count:,} resources to JSON: {export_path}", style="bold green"
+                        )
+                    elif export_format == "csv":
+                        # For CSV, export resources
+                        all_resources = list(reporter.get_detailed_resources(criteria))
+                        export_path = export_report_csv(export, all_resources)
+                        console.print(
+                            f"✓ Exported {len(all_resources):,} resources to CSV: {export_path}", style="bold green"
+                        )
+                    elif export_format == "txt":
+                        # For TXT, export summary only
+                        export_path = export_report_txt(export, metadata, summary)
+                        console.print(f"✓ Exported summary to TXT: {export_path}", style="bold green")
+                except FileExistsError as e:
+                    console.print(f"✗ {e}", style="bold red")
+                    console.print("\nUse a different filename or delete the existing file.", style="yellow")
+                    raise typer.Exit(code=1)
+                except FileNotFoundError as e:
+                    console.print(f"✗ {e}", style="bold red")
+                    raise typer.Exit(code=1)
+                except ValueError as e:
+                    console.print(f"✗ {e}", style="bold red")
+                    raise typer.Exit(code=1)
+            else:
+                # Display mode - show filter information
+                if criteria:
+                    console.print("\n[bold cyan]Filters Applied:[/bold cyan]")
+                    if resource_type:
+                        console.print(f"  • Resource Types: {', '.join(resource_type)}")
+                    if region:
+                        console.print(f"  • Regions: {', '.join(region)}")
+                    console.print(
+                        f"  • Matching Resources: {summary.total_count:,} (of {snapshot.resource_count:,} total)\n"
+                    )
+
+                # Format and display summary report
+                formatter = ReportFormatter(console)
+                formatter.format_summary(metadata, summary, has_filters=has_filters)
+
+    except typer.Exit:
+        raise
+    except Exception as e:
+        console.print(f"✗ Error generating report: {e}", style="bold red")
+        logger.exception("Error in snapshot report command")
+        raise typer.Exit(code=2)
+
+
 @app.command()
 def delta(
     snapshot: Optional[str] = typer.Option(