aws-cost-calculator-cli 1.6.0__py3-none-any.whl → 1.6.3__py3-none-any.whl

backend/algorithms/drill.py

@@ -0,0 +1,323 @@
+"""
+Drill-down cost analysis module.
+Allows filtering by service, account, and usage type for detailed cost investigation.
+"""
+from datetime import datetime, timedelta
+from collections import defaultdict
+
+
+def get_filtered_costs(ce_client, accounts, time_start, time_end, granularity='DAILY', 
+                       service_filter=None, account_filter=None, usage_type_filter=None):
+    """
+    Get costs with optional filters, grouped by the next level of detail.
+    
+    Args:
+        ce_client: boto3 Cost Explorer client
+        accounts: List of account IDs
+        time_start: datetime for start
+        time_end: datetime for end
+        granularity: 'WEEKLY' or 'MONTHLY'
+        service_filter: Optional service name to filter
+        account_filter: Optional account ID to filter
+        usage_type_filter: Optional usage type to filter
+    
+    Returns:
+        dict: {dimension_value: total_cost}
+    """
+    # Build filter
+    filters = []
+    
+    # Account filter (either from account_filter or all accounts)
+    if account_filter:
+        filters.append({
+            "Dimensions": {
+                "Key": "LINKED_ACCOUNT",
+                "Values": [account_filter]
+            }
+        })
+    else:
+        filters.append({
+            "Dimensions": {
+                "Key": "LINKED_ACCOUNT",
+                "Values": accounts
+            }
+        })
+    
+    # Service filter
+    if service_filter:
+        filters.append({
+            "Dimensions": {
+                "Key": "SERVICE",
+                "Values": [service_filter]
+            }
+        })
+    
+    # Usage type filter
+    if usage_type_filter:
+        filters.append({
+            "Dimensions": {
+                "Key": "USAGE_TYPE",
+                "Values": [usage_type_filter]
+            }
+        })
+    
+    # Determine what to group by (next level of detail)
+    if usage_type_filter:
+        # Already at usage type level, group by region
+        group_by_key = 'REGION'
+    elif service_filter and account_filter:
+        # Have service and account, show usage types
+        group_by_key = 'USAGE_TYPE'
+    elif service_filter:
+        # Have service, show accounts
+        group_by_key = 'LINKED_ACCOUNT'
+    elif account_filter:
+        # Have account, show services
+        group_by_key = 'SERVICE'
+    else:
+        # No filters, show services (same as trends)
+        group_by_key = 'SERVICE'
+    
+    # Build final filter
+    if len(filters) > 1:
+        final_filter = {"And": filters}
+    else:
+        final_filter = filters[0]
+    
+    response = ce_client.get_cost_and_usage(
+        TimePeriod={
+            'Start': time_start.strftime('%Y-%m-%d'),
+            'End': time_end.strftime('%Y-%m-%d')
+        },
+        Granularity=granularity,
+        Filter=final_filter,
+        Metrics=['NetAmortizedCost'],
+        GroupBy=[
+            {'Type': 'DIMENSION', 'Key': group_by_key}
+        ]
+    )
+    
+    costs = defaultdict(float)
+    for result in response['ResultsByTime']:
+        for group in result['Groups']:
+            dimension_value = group['Keys'][0]
+            cost = float(group['Metrics']['NetAmortizedCost']['Amount'])
+            costs[dimension_value] += cost
+    
+    return costs, group_by_key
+
+
+def compare_periods(prev_costs, curr_costs):
+    """
+    Compare two periods and find increases/decreases.
+    
+    Returns:
+        list of dicts with dimension, prev_cost, curr_cost, change, pct_change
+    """
+    changes = []
+    
+    # Get all dimensions from both periods
+    all_dimensions = set(prev_costs.keys()) | set(curr_costs.keys())
+    
+    for dimension in all_dimensions:
+        prev_cost = prev_costs.get(dimension, 0)
+        curr_cost = curr_costs.get(dimension, 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 (>$10 and >5%)
+        if abs(change) > 10 and abs(pct_change) > 5:
+            changes.append({
+                'dimension': dimension,
+                'prev_cost': prev_cost,
+                'curr_cost': curr_cost,
+                'change': change,
+                'pct_change': pct_change
+            })
+    
+    return changes
+
+
+def analyze_drill_down(ce_client, accounts, num_weeks=4, service_filter=None, 
+                       account_filter=None, usage_type_filter=None):
+    """
+    Analyze cost trends with drill-down filters.
+    
+    Args:
+        ce_client: boto3 Cost Explorer client
+        accounts: List of account IDs
+        num_weeks: Number of weeks to analyze (default: 4)
+        service_filter: Optional service name to filter
+        account_filter: Optional account ID to filter
+        usage_type_filter: Optional usage type to filter
+    
+    Returns:
+        dict with weekly comparisons and metadata
+    """
+    today = datetime.now()
+    
+    # Calculate week boundaries (Monday to 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 = []
+    group_by_key = None
+    for week in weeks:
+        costs, group_by_key = get_filtered_costs(
+            ce_client, accounts, week['start'], week['end'],
+            service_filter=service_filter,
+            account_filter=account_filter,
+            usage_type_filter=usage_type_filter
+        )
+        weekly_costs.append({
+            'week': week,
+            'costs': costs
+        })
+    
+    # Compare consecutive weeks
+    comparisons = []
+    for i in range(1, len(weekly_costs)):
+        prev = weekly_costs[i-1]
+        curr = weekly_costs[i]
+        
+        changes = compare_periods(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_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)
+        })
+    
+    # Reverse so most recent is first
+    comparisons.reverse()
+    
+    return {
+        'weeks': weeks,
+        'comparisons': comparisons,
+        'group_by': group_by_key,
+        'filters': {
+            'service': service_filter,
+            'account': account_filter,
+            'usage_type': usage_type_filter
+        }
+    }
+
+
+def format_drill_down_markdown(drill_data):
+    """
+    Format drill-down data as markdown.
+    
+    Returns:
+        str: Markdown formatted report
+    """
+    lines = []
+    lines.append("# AWS Cost Drill-Down Report")
+    lines.append(f"**Generated:** {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+    lines.append("")
+    
+    # Show active filters
+    filters = drill_data['filters']
+    lines.append("## Filters Applied")
+    lines.append("")
+    if filters['service']:
+        lines.append(f"- **Service:** {filters['service']}")
+    if filters['account']:
+        lines.append(f"- **Account:** {filters['account']}")
+    if filters['usage_type']:
+        lines.append(f"- **Usage Type:** {filters['usage_type']}")
+    if not any(filters.values()):
+        lines.append("- No filters (showing all services)")
+    lines.append("")
+    
+    # Show what dimension we're grouping by
+    group_by = drill_data['group_by']
+    dimension_label = {
+        'SERVICE': 'Service',
+        'LINKED_ACCOUNT': 'Account',
+        'USAGE_TYPE': 'Usage Type',
+        'REGION': 'Region'
+    }.get(group_by, group_by)
+    
+    lines.append(f"## Grouped By: {dimension_label}")
+    lines.append("")
+    lines.append("---")
+    lines.append("")
+    
+    for comparison in drill_data['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(f"| {dimension_label} | Previous | Current | Change | % |")
+            lines.append("|---------|----------|---------|--------|---|")
+            
+            for item in comparison['increases']:
+                dimension = item['dimension'][: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"| {dimension} | {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(f"| {dimension_label} | Previous | Current | Change | % |")
+            lines.append("|---------|----------|---------|--------|---|")
+            
+            for item in comparison['decreases']:
+                dimension = item['dimension'][: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"| {dimension} | {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)

backend/algorithms/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)