aws-cost-calculator-cli 1.0.2__py3-none-any.whl → 1.2.0__py3-none-any.whl

{aws_cost_calculator_cli-1.0.2.dist-info → aws_cost_calculator_cli-1.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aws-cost-calculator-cli
-Version: 1.0.2
+Version: 1.2.0
 Summary: AWS Cost Calculator CLI - Calculate daily and annual AWS costs across multiple accounts
 Home-page: https://github.com/yourusername/cost-calculator
 Author: Cost Optimization Team
@@ -80,7 +80,23 @@ cc calculate --profile myprofile --offset 2 --window 30
 cc calculate --profile myprofile --json-output
 ```
 
-### 4. List profiles
+### 4. Analyze cost trends
+
+```bash
+# Analyze last 3 weeks (default)
+cc trends --profile myprofile
+
+# Analyze more weeks
+cc trends --profile myprofile --weeks 5
+
+# Custom output file
+cc trends --profile myprofile --output weekly_trends.md
+
+# JSON output
+cc trends --profile myprofile --json-output
+```
+
+### 5. List profiles
 
 ```bash
 cc list-profiles
@@ -138,8 +154,74 @@ cc calculate --profile myprofile --json-output > costs.json
 
 # Different window size
 cc calculate --profile myprofile --window 60
+
+# Weekly cost trends analysis
+cc trends --profile myprofile
+
+# Analyze last 8 weeks
+cc trends --profile myprofile --weeks 8
+
+# Monthly cost trends analysis
+cc monthly --profile myprofile
+
+# Analyze last 12 months
+cc monthly --profile myprofile --months 12
 ```
 
+## Trends Report
+
+The `trends` command generates a markdown report with **two types of analysis**:
+
+### 1. Week-over-Week (WoW)
+Compares each week to the previous week - good for catching immediate spikes and changes.
+
+### 2. Trailing 30-Day (T-30)
+Compares each week to the same week 4 weeks ago - filters out noise and shows sustained trends.
+
+**Features:**
+- **Service-level aggregation**: Shows total cost per service (not individual usage types)
+- **Top 10 Increases/Decreases**: For each comparison period
+- **Total rows**: Sum of top 10 changes for quick assessment
+- **Filters**: Only shows changes >$10 and >5%
+
+Example output:
+```
+Week of Oct 19 → Week of Oct 26 (WoW)
+  Increases: 4, Decreases: 10
+  Top: EC2 - Other (+$949.12)
+
+Week of Oct 26 vs Week of Sep 28 (T-30)
+  Increases: 10, Decreases: 10
+  Top: EC2 - Other (+$886.39)
+```
+
+The report is saved to `cost_trends.md` by default and includes:
+- Service name
+- Previous/baseline cost
+- Current cost
+- Change amount and percentage
+- Total of top 10 changes
+
+## Monthly Report
+
+The `monthly` command generates month-over-month cost comparisons:
+
+**Features:**
+- **Service-level aggregation**: Shows total cost per service
+- **Calendar month comparisons**: October vs September, September vs August, etc.
+- **Top 10 Increases/Decreases**: For each month comparison
+- **Total rows**: Sum of top 10 changes
+- **Filters**: Only shows changes >$50 and >5%
+
+Example output:
+```
+October 2025 → November 2025
+  Increases: 1, Decreases: 10
+  Top: Savings Plans for AWS Compute usage (+$231,161.46)
+```
+
+The report is saved to `monthly_trends.md` by default.
+
 ## Output
 
 ```

aws_cost_calculator_cli-1.2.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+aws_cost_calculator_cli-1.2.0.dist-info/licenses/LICENSE,sha256=cYtmQZHNGGTXOtg3T7LHDRneleaH0dHXHfxFV3WR50Y,1079
+cost_calculator/__init__.py,sha256=PJeIqvWh5AYJVrJxPPkI4pJnAt37rIjasrNS0I87kaM,52
+cost_calculator/cli.py,sha256=fQPSDb-vp6qEpCgNGiyEt2FXdFJE6wtjRg5r67hLYDU,26639
+cost_calculator/monthly.py,sha256=6k9F8S7djhX1wGV3-T1MZP7CvWbbfhSTEaddwCfVu5M,7932
+cost_calculator/trends.py,sha256=k_s4ylBX50sqoiM_fwepi58HW01zz767FMJhQUPDznk,12246
+aws_cost_calculator_cli-1.2.0.dist-info/METADATA,sha256=dEgROlV7F3TkZkQEFAE_Ppw_0htCkHQ2vhk6Zh31BUA,6406
+aws_cost_calculator_cli-1.2.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+aws_cost_calculator_cli-1.2.0.dist-info/entry_points.txt,sha256=_5Qy4EcHbYVYrdgOu1E48faMHb9fLUl5VJ3djDHuJBo,47
+aws_cost_calculator_cli-1.2.0.dist-info/top_level.txt,sha256=PRwGPPlNqASfyhGHDjSfyl4SXeE7GF3OVTu1tY1Uqyc,16
+aws_cost_calculator_cli-1.2.0.dist-info/RECORD,,

cost_calculator/cli.py

@@ -13,6 +13,8 @@ import boto3
 import json
 from datetime import datetime, timedelta
 from pathlib import Path
+from cost_calculator.trends import analyze_trends, format_trends_markdown
+from cost_calculator.monthly import analyze_monthly_trends, format_monthly_markdown
 
 
 def load_profile(profile_name):
@@ -395,6 +397,77 @@ def list_profiles():
         click.echo("")
 
 
+@cli.command()
+def setup():
+    """Show setup instructions for manual profile configuration"""
+    import platform
+    
+    system = platform.system()
+    
+    if system == "Windows":
+        config_path = "%USERPROFILE%\\.config\\cost-calculator\\profiles.json"
+        config_path_example = "C:\\Users\\YourName\\.config\\cost-calculator\\profiles.json"
+        mkdir_cmd = "mkdir %USERPROFILE%\\.config\\cost-calculator"
+        edit_cmd = "notepad %USERPROFILE%\\.config\\cost-calculator\\profiles.json"
+    else:  # macOS/Linux
+        config_path = "~/.config/cost-calculator/profiles.json"
+        config_path_example = "/Users/yourname/.config/cost-calculator/profiles.json"
+        mkdir_cmd = "mkdir -p ~/.config/cost-calculator"
+        edit_cmd = "nano ~/.config/cost-calculator/profiles.json"
+    
+    click.echo("=" * 70)
+    click.echo("AWS Cost Calculator - Manual Profile Setup")
+    click.echo("=" * 70)
+    click.echo("")
+    click.echo(f"Platform: {system}")
+    click.echo(f"Config location: {config_path}")
+    click.echo("")
+    click.echo("Step 1: Create the config directory")
+    click.echo(f"  {mkdir_cmd}")
+    click.echo("")
+    click.echo("Step 2: Create the profiles.json file")
+    click.echo(f"  {edit_cmd}")
+    click.echo("")
+    click.echo("Step 3: Add your profile configuration (JSON format):")
+    click.echo("")
+    click.echo('  {')
+    click.echo('    "myprofile": {')
+    click.echo('      "aws_profile": "my_aws_profile",')
+    click.echo('      "accounts": [')
+    click.echo('        "123456789012",')
+    click.echo('        "234567890123",')
+    click.echo('        "345678901234"')
+    click.echo('      ]')
+    click.echo('    }')
+    click.echo('  }')
+    click.echo("")
+    click.echo("Step 4: Save the file")
+    click.echo("")
+    click.echo("Step 5: Verify it works")
+    click.echo("  cc list-profiles")
+    click.echo("")
+    click.echo("Step 6: Configure AWS credentials")
+    click.echo("  Option A (SSO):")
+    click.echo("    aws sso login --profile my_aws_profile")
+    click.echo("    cc calculate --profile myprofile")
+    click.echo("")
+    click.echo("  Option B (Static credentials):")
+    click.echo("    cc configure --profile myprofile")
+    click.echo("    cc calculate --profile myprofile")
+    click.echo("")
+    click.echo("=" * 70)
+    click.echo("")
+    click.echo("For multiple profiles, add more entries to the JSON:")
+    click.echo("")
+    click.echo('  {')
+    click.echo('    "profile1": { ... },')
+    click.echo('    "profile2": { ... }')
+    click.echo('  }')
+    click.echo("")
+    click.echo(f"Full path example: {config_path_example}")
+    click.echo("=" * 70)
+
+
 @cli.command()
 @click.option('--profile', required=True, help='Profile name to configure')
 @click.option('--access-key-id', prompt=True, hide_input=False, help='AWS Access Key ID')
@@ -468,5 +541,195 @@ def configure(profile, access_key_id, secret_access_key, session_token, region):
     click.echo("      you'll need to reconfigure when they expire.")
 
 
+@cli.command()
+@click.option('--profile', required=True, help='Profile name')
+@click.option('--weeks', default=3, help='Number of weeks to analyze (default: 3)')
+@click.option('--output', default='cost_trends.md', help='Output markdown file (default: cost_trends.md)')
+@click.option('--json-output', is_flag=True, help='Output as JSON instead of markdown')
+def trends(profile, weeks, output, json_output):
+    """Analyze cost trends with Week-over-Week and Trailing 30-Day comparisons"""
+    
+    # Load profile configuration
+    config = load_profile(profile)
+    
+    # Initialize boto3 client
+    try:
+        if 'aws_profile' in config:
+            aws_profile = config['aws_profile']
+            click.echo(f"AWS Profile: {aws_profile} (SSO)")
+            session = boto3.Session(profile_name=aws_profile)
+            ce_client = session.client('ce', region_name='us-east-1')
+        else:
+            creds = config['credentials']
+            click.echo(f"AWS Credentials: Static")
+            
+            session_kwargs = {
+                'aws_access_key_id': creds['aws_access_key_id'],
+                'aws_secret_access_key': creds['aws_secret_access_key'],
+                'region_name': creds.get('region', 'us-east-1')
+            }
+            
+            if 'aws_session_token' in creds:
+                session_kwargs['aws_session_token'] = creds['aws_session_token']
+            
+            session = boto3.Session(**session_kwargs)
+            ce_client = session.client('ce')
+            
+    except Exception as e:
+        if 'Token has expired' in str(e) or 'sso' in str(e).lower():
+            if 'aws_profile' in config:
+                raise click.ClickException(
+                    f"AWS SSO session expired or not initialized.\n"
+                    f"Run: aws sso login --profile {config['aws_profile']}"
+                )
+            else:
+                raise click.ClickException(
+                    f"AWS credentials expired.\n"
+                    f"Run: cc configure --profile {profile}"
+                )
+        raise
+    
+    click.echo(f"Analyzing last {weeks} weeks...")
+    click.echo("")
+    
+    # Analyze trends
+    trends_data = analyze_trends(ce_client, config['accounts'], num_weeks=weeks)
+    
+    if json_output:
+        # Output as JSON
+        import json
+        click.echo(json.dumps(trends_data, indent=2, default=str))
+    else:
+        # Generate markdown report
+        markdown = format_trends_markdown(trends_data)
+        
+        # Save to file
+        with open(output, 'w') as f:
+            f.write(markdown)
+        
+        click.echo(f"✓ Trends report saved to {output}")
+        click.echo("")
+        
+        # Show summary
+        click.echo("WEEK-OVER-WEEK:")
+        for comparison in trends_data['wow_comparisons']:
+            prev_week = comparison['prev_week']['label']
+            curr_week = comparison['curr_week']['label']
+            num_increases = len(comparison['increases'])
+            num_decreases = len(comparison['decreases'])
+            
+            click.echo(f"  {prev_week} → {curr_week}")
+            click.echo(f"    Increases: {num_increases}, Decreases: {num_decreases}")
+            
+            if comparison['increases']:
+                top = comparison['increases'][0]
+                click.echo(f"    Top: {top['service']} (+${top['change']:,.2f})")
+            
+            click.echo("")
+        
+        click.echo("TRAILING 30-DAY (T-30):")
+        for comparison in trends_data['t30_comparisons']:
+            baseline_week = comparison['baseline_week']['label']
+            curr_week = comparison['curr_week']['label']
+            num_increases = len(comparison['increases'])
+            num_decreases = len(comparison['decreases'])
+            
+            click.echo(f"  {curr_week} vs {baseline_week}")
+            click.echo(f"    Increases: {num_increases}, Decreases: {num_decreases}")
+            
+            if comparison['increases']:
+                top = comparison['increases'][0]
+                click.echo(f"    Top: {top['service']} (+${top['change']:,.2f})")
+            
+            click.echo("")
+
+
+@cli.command()
+@click.option('--profile', required=True, help='Profile name')
+@click.option('--months', default=6, help='Number of months to analyze (default: 6)')
+@click.option('--output', default='monthly_trends.md', help='Output markdown file (default: monthly_trends.md)')
+@click.option('--json-output', is_flag=True, help='Output as JSON instead of markdown')
+def monthly(profile, months, output, json_output):
+    """Analyze month-over-month cost trends at service level"""
+    
+    # Load profile configuration
+    config = load_profile(profile)
+    
+    # Initialize boto3 client
+    try:
+        if 'aws_profile' in config:
+            aws_profile = config['aws_profile']
+            click.echo(f"AWS Profile: {aws_profile} (SSO)")
+            session = boto3.Session(profile_name=aws_profile)
+        else:
+            # Use static credentials
+            creds = config['credentials']
+            click.echo("AWS Credentials: Static")
+            session = boto3.Session(
+                aws_access_key_id=creds['aws_access_key_id'],
+                aws_secret_access_key=creds['aws_secret_access_key'],
+                aws_session_token=creds.get('aws_session_token')
+            )
+        
+        ce_client = session.client('ce', region_name='us-east-1')
+    except Exception as e:
+        raise click.ClickException(f"Failed to initialize AWS session: {str(e)}")
+    
+    # Get account list
+    accounts = config['accounts']
+    
+    click.echo(f"Analyzing last {months} months...")
+    click.echo("")
+    
+    # Analyze monthly trends
+    monthly_data = analyze_monthly_trends(ce_client, accounts, months)
+    
+    if json_output:
+        # Output as JSON
+        output_data = {
+            'generated': datetime.now().isoformat(),
+            'months': months,
+            'comparisons': []
+        }
+        
+        for comparison in monthly_data['comparisons']:
+            output_data['comparisons'].append({
+                'prev_month': comparison['prev_month']['label'],
+                'curr_month': comparison['curr_month']['label'],
+                'increases': comparison['increases'],
+                'decreases': comparison['decreases'],
+                'total_increase': comparison['total_increase'],
+                'total_decrease': comparison['total_decrease']
+            })
+        
+        click.echo(json.dumps(output_data, indent=2))
+    else:
+        # Generate markdown report
+        markdown = format_monthly_markdown(monthly_data)
+        
+        # Save to file
+        with open(output, 'w') as f:
+            f.write(markdown)
+        
+        click.echo(f"✓ Monthly trends report saved to {output}")
+        click.echo("")
+        
+        # Show summary
+        for comparison in monthly_data['comparisons']:
+            prev_month = comparison['prev_month']['label']
+            curr_month = comparison['curr_month']['label']
+            num_increases = len(comparison['increases'])
+            num_decreases = len(comparison['decreases'])
+            
+            click.echo(f"{prev_month} → {curr_month}")
+            click.echo(f"  Increases: {num_increases}, Decreases: {num_decreases}")
+            
+            if comparison['increases']:
+                top = comparison['increases'][0]
+                click.echo(f"  Top: {top['service']} (+${top['change']:,.2f})")
+            
+            click.echo("")
+
+
 if __name__ == '__main__':
     cli()

cost_calculator/monthly.py

@@ -0,0 +1,242 @@
+"""
+Monthly cost trend analysis module.
+Analyzes month-over-month cost changes at the service level.
+"""
+from datetime import datetime, timedelta
+from collections import defaultdict
+
+
+def get_month_costs(ce_client, accounts, month_start, month_end):
+    """
+    Get costs for a specific month grouped by service.
+    
+    Args:
+        ce_client: boto3 Cost Explorer client
+        accounts: List of account IDs
+        month_start: datetime for start of month
+        month_end: datetime for end of month
+    
+    Returns:
+        dict: {service: total_cost}
+    """
+    response = ce_client.get_cost_and_usage(
+        TimePeriod={
+            'Start': month_start.strftime('%Y-%m-%d'),
+            'End': month_end.strftime('%Y-%m-%d')
+        },
+        Granularity='MONTHLY',
+        Filter={
+            "Dimensions": {
+                "Key": "LINKED_ACCOUNT",
+                "Values": accounts
+            }
+        },
+        Metrics=['NetAmortizedCost'],
+        GroupBy=[
+            {'Type': 'DIMENSION', 'Key': 'SERVICE'}
+        ]
+    )
+    
+    costs = defaultdict(float)
+    for result in response['ResultsByTime']:
+        for group in result['Groups']:
+            service = group['Keys'][0]
+            cost = float(group['Metrics']['NetAmortizedCost']['Amount'])
+            costs[service] += cost
+    
+    return costs
+
+
+def compare_months(prev_month_costs, curr_month_costs):
+    """
+    Compare two months and find increases/decreases at service level.
+    
+    Returns:
+        list of dicts with service, prev_cost, curr_cost, change, pct_change
+    """
+    changes = []
+    
+    # Get all services from both months
+    all_services = set(prev_month_costs.keys()) | set(curr_month_costs.keys())
+    
+    for service in all_services:
+        prev_cost = prev_month_costs.get(service, 0)
+        curr_cost = curr_month_costs.get(service, 0)
+        
+        change = curr_cost - prev_cost
+        pct_change = (change / prev_cost * 100) if prev_cost > 0 else (100 if curr_cost > 0 else 0)
+        
+        # Only include if change is significant (>$50 and >5%)
+        if abs(change) > 50 and abs(pct_change) > 5:
+            changes.append({
+                'service': service,
+                'prev_cost': prev_cost,
+                'curr_cost': curr_cost,
+                'change': change,
+                'pct_change': pct_change
+            })
+    
+    return changes
+
+
+def analyze_monthly_trends(ce_client, accounts, num_months=6):
+    """
+    Analyze cost trends over the last N months.
+    
+    Args:
+        ce_client: boto3 Cost Explorer client
+        accounts: List of account IDs
+        num_months: Number of months to analyze (default: 6)
+    
+    Returns:
+        dict with monthly comparisons
+    """
+    today = datetime.now()
+    
+    # Calculate month boundaries
+    months = []
+    for i in range(num_months):
+        # Go back i months from today
+        if today.month - i <= 0:
+            year = today.year - 1
+            month = 12 + (today.month - i)
+        else:
+            year = today.year
+            month = today.month - i
+        
+        # First day of month
+        month_start = datetime(year, month, 1)
+        
+        # First day of next month
+        if month == 12:
+            month_end = datetime(year + 1, 1, 1)
+        else:
+            month_end = datetime(year, month + 1, 1)
+        
+        months.append({
+            'start': month_start,
+            'end': month_end,
+            'label': month_start.strftime('%B %Y')
+        })
+    
+    # Reverse so oldest is first
+    months.reverse()
+    
+    # Get costs for each month
+    monthly_costs = []
+    for month in months:
+        costs = get_month_costs(ce_client, accounts, month['start'], month['end'])
+        monthly_costs.append({
+            'month': month,
+            'costs': costs
+        })
+    
+    # Compare consecutive months
+    comparisons = []
+    for i in range(1, len(monthly_costs)):
+        prev = monthly_costs[i-1]
+        curr = monthly_costs[i]
+        
+        changes = compare_months(prev['costs'], curr['costs'])
+        
+        # Sort by absolute change
+        changes.sort(key=lambda x: abs(x['change']), reverse=True)
+        increases = [c for c in changes if c['change'] > 0][:10]
+        decreases = [c for c in changes if c['change'] < 0][:10]
+        
+        comparisons.append({
+            'prev_month': prev['month'],
+            'curr_month': curr['month'],
+            'increases': increases,
+            'decreases': decreases,
+            'total_increase': sum(c['change'] for c in increases),
+            'total_decrease': sum(c['change'] for c in decreases)
+        })
+    
+    # Reverse so most recent is first
+    comparisons.reverse()
+    
+    return {
+        'months': months,
+        'comparisons': comparisons
+    }
+
+
+def format_monthly_markdown(monthly_data):
+    """
+    Format monthly trends data as markdown.
+    
+    Returns:
+        str: Markdown formatted report
+    """
+    lines = []
+    lines.append("# AWS Monthly Cost Trends Report (Service Level)")
+    lines.append(f"**Generated:** {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+    lines.append("")
+    lines.append("## Methodology")
+    lines.append("")
+    lines.append("This report shows month-over-month cost changes at the service level:")
+    lines.append("")
+    lines.append("- Compares consecutive calendar months")
+    lines.append("- Shows total cost per service (aggregated across all usage types)")
+    lines.append("- Filters out noise (>$50 and >5% change)")
+    lines.append("- Most recent comparisons first")
+    lines.append("")
+    lines.append("---")
+    lines.append("")
+    
+    for comparison in monthly_data['comparisons']:
+        prev_month = comparison['prev_month']
+        curr_month = comparison['curr_month']
+        
+        lines.append(f"## {prev_month['label']} → {curr_month['label']}")
+        lines.append("")
+        
+        # Top increases
+        if comparison['increases']:
+            lines.append("### 🔴 Top 10 Increases")
+            lines.append("")
+            lines.append("| Service | Previous Month | Current Month | Change | % |")
+            lines.append("|---------|----------------|---------------|--------|---|")
+            
+            for item in comparison['increases']:
+                service = item['service'][:60]
+                prev = f"${item['prev_cost']:,.2f}"
+                curr = f"${item['curr_cost']:,.2f}"
+                change = f"${item['change']:,.2f}"
+                pct = f"{item['pct_change']:+.1f}%"
+                
+                lines.append(f"| {service} | {prev} | {curr} | {change} | {pct} |")
+            
+            # Add total row
+            total_increase = comparison.get('total_increase', 0)
+            lines.append(f"| **TOTAL** | | | **${total_increase:,.2f}** | |")
+            
+            lines.append("")
+        
+        # Top decreases
+        if comparison['decreases']:
+            lines.append("### 🟢 Top 10 Decreases")
+            lines.append("")
+            lines.append("| Service | Previous Month | Current Month | Change | % |")
+            lines.append("|---------|----------------|---------------|--------|---|")
+            
+            for item in comparison['decreases']:
+                service = item['service'][:60]
+                prev = f"${item['prev_cost']:,.2f}"
+                curr = f"${item['curr_cost']:,.2f}"
+                change = f"${item['change']:,.2f}"
+                pct = f"{item['pct_change']:+.1f}%"
+                
+                lines.append(f"| {service} | {prev} | {curr} | {change} | {pct} |")
+            
+            # Add total row
+            total_decrease = comparison.get('total_decrease', 0)
+            lines.append(f"| **TOTAL** | | | **${total_decrease:,.2f}** | |")
+            
+            lines.append("")
+        
+        lines.append("---")
+        lines.append("")
+    
+    return "\n".join(lines)

cost_calculator/trends.py

@@ -0,0 +1,353 @@
+#!/usr/bin/env python3
+"""
+Cost trends analysis module
+"""
+
+import boto3
+from datetime import datetime, timedelta
+from collections import defaultdict
+
+
+def get_week_costs(ce_client, accounts, week_start, week_end):
+    """
+    Get costs for a specific week, grouped by service and usage type.
+    
+    Args:
+        ce_client: boto3 Cost Explorer client
+        accounts: List of account IDs
+        week_start: Start date (datetime)
+        week_end: End date (datetime)
+    
+    Returns:
+        dict: {service: {usage_type: cost}}
+    """
+    cost_filter = {
+        "And": [
+            {
+                "Dimensions": {
+                    "Key": "LINKED_ACCOUNT",
+                    "Values": accounts
+                }
+            },
+            {
+                "Dimensions": {
+                    "Key": "BILLING_ENTITY",
+                    "Values": ["AWS"]
+                }
+            },
+            {
+                "Not": {
+                    "Dimensions": {
+                        "Key": "RECORD_TYPE",
+                        "Values": ["Tax", "Support"]
+                    }
+                }
+            }
+        ]
+    }
+    
+    response = ce_client.get_cost_and_usage(
+        TimePeriod={
+            'Start': week_start.strftime('%Y-%m-%d'),
+            'End': week_end.strftime('%Y-%m-%d')
+        },
+        Granularity='DAILY',
+        Metrics=['NetAmortizedCost'],
+        GroupBy=[
+            {'Type': 'DIMENSION', 'Key': 'SERVICE'},
+            {'Type': 'DIMENSION', 'Key': 'USAGE_TYPE'}
+        ],
+        Filter=cost_filter
+    )
+    
+    # Aggregate by service and usage type
+    costs = defaultdict(lambda: defaultdict(float))
+    
+    for day in response['ResultsByTime']:
+        for group in day.get('Groups', []):
+            service = group['Keys'][0]
+            usage_type = group['Keys'][1]
+            cost = float(group['Metrics']['NetAmortizedCost']['Amount'])
+            costs[service][usage_type] += cost
+    
+    return costs
+
+
+def compare_weeks(prev_week_costs, curr_week_costs):
+    """
+    Compare two weeks and find increases/decreases at service level.
+    
+    Returns:
+        list of dicts with service, prev_cost, curr_cost, change, pct_change
+    """
+    changes = []
+    
+    # Get all services from both weeks
+    all_services = set(prev_week_costs.keys()) | set(curr_week_costs.keys())
+    
+    for service in all_services:
+        prev_service = prev_week_costs.get(service, {})
+        curr_service = curr_week_costs.get(service, {})
+        
+        # Sum all usage types for this service
+        prev_cost = sum(prev_service.values())
+        curr_cost = sum(curr_service.values())
+        
+        change = curr_cost - prev_cost
+        pct_change = (change / prev_cost * 100) if prev_cost > 0 else (100 if curr_cost > 0 else 0)
+        
+        # Only include if change is significant (>$10 and >5%)
+        if abs(change) > 10 and abs(pct_change) > 5:
+            changes.append({
+                'service': service,
+                'prev_cost': prev_cost,
+                'curr_cost': curr_cost,
+                'change': change,
+                'pct_change': pct_change
+            })
+    
+    return changes
+
+
+def analyze_trends(ce_client, accounts, num_weeks=3):
+    """
+    Analyze cost trends over the last N weeks.
+    
+    Args:
+        ce_client: boto3 Cost Explorer client
+        accounts: List of account IDs
+        num_weeks: Number of weeks to analyze (default: 3)
+    
+    Returns:
+        dict with weekly comparisons
+    """
+    today = datetime.now()
+    
+    # Calculate week boundaries (Monday to Sunday)
+    # Go back to most recent Sunday
+    days_since_sunday = (today.weekday() + 1) % 7
+    most_recent_sunday = today - timedelta(days=days_since_sunday)
+    
+    weeks = []
+    for i in range(num_weeks):
+        week_end = most_recent_sunday - timedelta(weeks=i)
+        week_start = week_end - timedelta(days=7)
+        weeks.append({
+            'start': week_start,
+            'end': week_end,
+            'label': f"Week of {week_start.strftime('%b %d')}"
+        })
+    
+    # Reverse so oldest is first
+    weeks.reverse()
+    
+    # Get costs for each week
+    weekly_costs = []
+    for week in weeks:
+        costs = get_week_costs(ce_client, accounts, week['start'], week['end'])
+        weekly_costs.append({
+            'week': week,
+            'costs': costs
+        })
+    
+    # Compare consecutive weeks (week-over-week)
+    wow_comparisons = []
+    for i in range(1, len(weekly_costs)):
+        prev = weekly_costs[i-1]
+        curr = weekly_costs[i]
+        
+        changes = compare_weeks(prev['costs'], curr['costs'])
+        
+        # Sort by absolute change
+        changes.sort(key=lambda x: abs(x['change']), reverse=True)
+        increases = [c for c in changes if c['change'] > 0][:10]
+        decreases = [c for c in changes if c['change'] < 0][:10]
+        
+        wow_comparisons.append({
+            'prev_week': prev['week'],
+            'curr_week': curr['week'],
+            'increases': increases,
+            'decreases': decreases,
+            'total_increase': sum(c['change'] for c in increases),
+            'total_decrease': sum(c['change'] for c in decreases)
+        })
+    
+    # Compare to 30 days ago (T-30)
+    t30_comparisons = []
+    for i in range(len(weekly_costs)):
+        curr = weekly_costs[i]
+        # Find week from ~30 days ago (4-5 weeks back)
+        baseline_idx = i - 4 if i >= 4 else None
+        
+        if baseline_idx is not None and baseline_idx >= 0:
+            baseline = weekly_costs[baseline_idx]
+            
+            changes = compare_weeks(baseline['costs'], curr['costs'])
+            
+            # Sort by absolute change
+            changes.sort(key=lambda x: abs(x['change']), reverse=True)
+            increases = [c for c in changes if c['change'] > 0][:10]
+            decreases = [c for c in changes if c['change'] < 0][:10]
+            
+            t30_comparisons.append({
+                'baseline_week': baseline['week'],
+                'curr_week': curr['week'],
+                'increases': increases,
+                'decreases': decreases,
+                'total_increase': sum(c['change'] for c in increases),
+                'total_decrease': sum(c['change'] for c in decreases)
+            })
+    
+    # Reverse so most recent is first
+    wow_comparisons.reverse()
+    t30_comparisons.reverse()
+    
+    return {
+        'weeks': weeks,
+        'wow_comparisons': wow_comparisons,
+        't30_comparisons': t30_comparisons
+    }
+
+
+def format_trends_markdown(trends_data):
+    """
+    Format trends data as markdown.
+    
+    Returns:
+        str: Markdown formatted report
+    """
+    lines = []
+    lines.append("# AWS Cost Trends Report (Service Level)")
+    lines.append(f"**Generated:** {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+    lines.append("")
+    lines.append("## Methodology")
+    lines.append("")
+    lines.append("This report shows two types of comparisons:")
+    lines.append("")
+    lines.append("1. **Week-over-Week (WoW)**: Compares each week to the previous week")
+    lines.append("   - Good for catching immediate changes and spikes")
+    lines.append("   - Shows short-term volatility")
+    lines.append("")
+    lines.append("2. **Trailing 30-Day (T-30)**: Compares each week to the same week 4 weeks ago")
+    lines.append("   - Filters out weekly noise")
+    lines.append("   - Shows sustained trends and real cost changes")
+    lines.append("")
+    lines.append("---")
+    lines.append("")
+    lines.append("# Week-over-Week Changes")
+    lines.append("")
+    
+    for comparison in trends_data['wow_comparisons']:
+        prev_week = comparison['prev_week']
+        curr_week = comparison['curr_week']
+        
+        lines.append(f"## {prev_week['label']} → {curr_week['label']}")
+        lines.append("")
+        
+        # Top increases
+        if comparison['increases']:
+            lines.append("### 🔴 Top 10 Increases")
+            lines.append("")
+            lines.append("| Service | Previous | Current | Change | % |")
+            lines.append("|---------|----------|---------|--------|---|")
+            
+            for item in comparison['increases']:
+                service = item['service'][:60]
+                prev = f"${item['prev_cost']:,.2f}"
+                curr = f"${item['curr_cost']:,.2f}"
+                change = f"${item['change']:,.2f}"
+                pct = f"{item['pct_change']:+.1f}%"
+                
+                lines.append(f"| {service} | {prev} | {curr} | {change} | {pct} |")
+            
+            # Add total row
+            total_increase = comparison.get('total_increase', 0)
+            lines.append(f"| **TOTAL** | | | **${total_increase:,.2f}** | |")
+            
+            lines.append("")
+        
+        # Top decreases
+        if comparison['decreases']:
+            lines.append("### 🟢 Top 10 Decreases")
+            lines.append("")
+            lines.append("| Service | Previous | Current | Change | % |")
+            lines.append("|---------|----------|---------|--------|---|")
+            
+            for item in comparison['decreases']:
+                service = item['service'][:60]
+                prev = f"${item['prev_cost']:,.2f}"
+                curr = f"${item['curr_cost']:,.2f}"
+                change = f"${item['change']:,.2f}"
+                pct = f"{item['pct_change']:+.1f}%"
+                
+                lines.append(f"| {service} | {prev} | {curr} | {change} | {pct} |")
+            
+            # Add total row
+            total_decrease = comparison.get('total_decrease', 0)
+            lines.append(f"| **TOTAL** | | | **${total_decrease:,.2f}** | |")
+            
+            lines.append("")
+        
+        lines.append("---")
+        lines.append("")
+    
+    # Add T-30 comparisons section
+    lines.append("")
+    lines.append("# Trailing 30-Day Comparisons (T-30)")
+    lines.append("")
+    
+    for comparison in trends_data['t30_comparisons']:
+        baseline_week = comparison['baseline_week']
+        curr_week = comparison['curr_week']
+        
+        lines.append(f"## {curr_week['label']} vs {baseline_week['label']} (30 days ago)")
+        lines.append("")
+        
+        # Top increases
+        if comparison['increases']:
+            lines.append("### 🔴 Top 10 Increases (vs 30 days ago)")
+            lines.append("")
+            lines.append("| Service | 30 Days Ago | Current | Change | % |")
+            lines.append("|---------|-------------|---------|--------|---|")
+            
+            for item in comparison['increases']:
+                service = item['service'][:60]
+                prev = f"${item['prev_cost']:,.2f}"
+                curr = f"${item['curr_cost']:,.2f}"
+                change = f"${item['change']:,.2f}"
+                pct = f"{item['pct_change']:+.1f}%"
+                
+                lines.append(f"| {service} | {prev} | {curr} | {change} | {pct} |")
+            
+            # Add total row
+            total_increase = comparison.get('total_increase', 0)
+            lines.append(f"| **TOTAL** | | | **${total_increase:,.2f}** | |")
+            
+            lines.append("")
+        
+        # Top decreases
+        if comparison['decreases']:
+            lines.append("### 🟢 Top 10 Decreases (vs 30 days ago)")
+            lines.append("")
+            lines.append("| Service | 30 Days Ago | Current | Change | % |")
+            lines.append("|---------|-------------|---------|--------|---|")
+            
+            for item in comparison['decreases']:
+                service = item['service'][:60]
+                prev = f"${item['prev_cost']:,.2f}"
+                curr = f"${item['curr_cost']:,.2f}"
+                change = f"${item['change']:,.2f}"
+                pct = f"{item['pct_change']:+.1f}%"
+                
+                lines.append(f"| {service} | {prev} | {curr} | {change} | {pct} |")
+            
+            # Add total row
+            total_decrease = comparison.get('total_decrease', 0)
+            lines.append(f"| **TOTAL** | | | **${total_decrease:,.2f}** | |")
+            
+            lines.append("")
+        
+        lines.append("---")
+        lines.append("")
+    
+    return "\n".join(lines)

aws_cost_calculator_cli-1.0.2.dist-info/RECORD

@@ -1,8 +0,0 @@
-aws_cost_calculator_cli-1.0.2.dist-info/licenses/LICENSE,sha256=cYtmQZHNGGTXOtg3T7LHDRneleaH0dHXHfxFV3WR50Y,1079
-cost_calculator/__init__.py,sha256=PJeIqvWh5AYJVrJxPPkI4pJnAt37rIjasrNS0I87kaM,52
-cost_calculator/cli.py,sha256=HsVEZhasXTK1fyeStdJFEng7Dj5l5JK9aMfQxOL6N5I,16320
-aws_cost_calculator_cli-1.0.2.dist-info/METADATA,sha256=ZF9eEr4PJEPlKOeV3wMV56nnZnBAGIdeJpaL821X5QE,4227
-aws_cost_calculator_cli-1.0.2.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-aws_cost_calculator_cli-1.0.2.dist-info/entry_points.txt,sha256=_5Qy4EcHbYVYrdgOu1E48faMHb9fLUl5VJ3djDHuJBo,47
-aws_cost_calculator_cli-1.0.2.dist-info/top_level.txt,sha256=PRwGPPlNqASfyhGHDjSfyl4SXeE7GF3OVTu1tY1Uqyc,16
-aws_cost_calculator_cli-1.0.2.dist-info/RECORD,,