aws-cost-calculator-cli 1.3.0__py3-none-any.whl

aws_cost_calculator_cli-1.3.0.dist-info/METADATA

@@ -0,0 +1,287 @@
+Metadata-Version: 2.4
+Name: aws-cost-calculator-cli
+Version: 1.3.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
+Author-email: 
+Project-URL: Documentation, https://github.com/yourusername/cost-calculator/blob/main/README.md
+Keywords: aws cost calculator billing optimization cloud
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Utilities
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: boto3>=1.26.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# AWS Cost Calculator (cc)
+
+A CLI tool to quickly calculate AWS costs across multiple accounts.
+
+## Installation
+
+```bash
+cd ~/cost-calculator
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Login to AWS SSO
+
+```bash
+aws sso login --profile my_aws_profile
+```
+
+**Note:** You need to do this before running cost calculations. The SSO session typically lasts 8-12 hours.
+
+### 2. Initialize a profile
+
+```bash
+cc init --profile myprofile \
+  --aws-profile my_aws_profile \
+  --accounts "123456789012,234567890123,345678901234"
+```
+
+### 3. Calculate costs
+
+```bash
+# Default: Today minus 2 days, going back 30 days
+cc calculate --profile myprofile
+
+# Specific start date
+cc calculate --profile myprofile --start-date 2025-11-04
+
+# Custom offset and window
+cc calculate --profile myprofile --offset 2 --window 30
+
+# JSON output
+cc calculate --profile myprofile --json-output
+```
+
+### 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
+```
+
+## How It Works
+
+### Date Calculation
+- **Start Date**: Defaults to today, or specify with `--start-date`
+- **Offset**: Days to go back from start date (default: 2)
+- **Window**: Number of days to analyze (default: 30)
+
+Example: If today is Nov 4, 2025:
+- With offset=2, window=30: Analyzes Oct 3 - Nov 2 (30 days)
+
+### Cost Calculation
+1. **Operational Costs**: Sum of daily costs ÷ window days
+2. **Support Allocation**: 
+   - Gets support cost from the analysis month
+   - Divides by 2 (50% allocation)
+   - Divides by days in that month
+3. **Daily Rate**: Operational + Support per day
+4. **Annual Projection**: Daily rate × 365
+
+### Filters Applied
+- **Billing Entity**: AWS only (excludes marketplace)
+- **Excluded**: Tax, Support (calculated separately)
+- **Metric**: Net Amortized Cost
+
+## Configuration
+
+Profiles are stored in: `~/.config/cost-calculator/profiles.json`
+
+Example:
+```json
+{
+  "myprofile": {
+    "aws_profile": "my_aws_profile",
+    "accounts": ["123456789012", "234567890123", "345678901234"]
+  }
+}
+```
+
+## Examples
+
+```bash
+# Quick daily check
+cc calculate --profile myprofile
+
+# Historical analysis
+cc calculate --profile myprofile --start-date 2025-10-01
+
+# Export to JSON for processing
+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
+
+# Drill down into specific service
+cc drill --profile myprofile --service "EC2 - Other"
+
+# Drill down into specific account
+cc drill --profile myprofile --account 123456789012
+
+# Drill down into service within account
+cc drill --profile myprofile --service "EC2 - Other" --account 123456789012
+```
+
+## 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.
+
+## Drill-Down Analysis
+
+The `drill` command allows you to investigate cost changes at different levels of detail:
+
+**Funnel Approach:**
+1. **Start broad:** `cc trends` → See EC2 costs up $1000
+2. **Drill by service:** `cc drill --service "EC2 - Other"` → See which accounts
+3. **Drill deeper:** `cc drill --service "EC2 - Other" --account 123` → See usage types
+
+**Features:**
+- **Automatic grouping**: Shows the next level of detail based on your filters
+  - No filters → Shows services
+  - Service only → Shows accounts using that service
+  - Account only → Shows services in that account
+  - Service + Account → Shows usage types
+- **Top 10 Increases/Decreases**: For each week comparison
+- **Total rows**: Sum of top 10 changes
+- **Filters**: Only shows changes >$10 and >5%
+
+Example output:
+```
+# Drill by service
+cc drill --profile myprofile --service "EC2 - Other"
+
+Showing top accounts:
+Week of Oct 19 → Week of Oct 26
+  Increases: 3, Decreases: 2
+  Top: 887649220066 (+$450.23)
+```
+
+The report is saved to `drill_down.md` by default.
+
+## Output
+
+```
+Analyzing: 2025-10-03 to 2025-11-02 (30 days)
+AWS Profile: my_aws_profile
+Accounts: 3
+
+Fetching cost data...
+Fetching support costs...
+============================================================
+Period: 2025-10-03 to 2025-11-02
+Days analyzed: 30
+============================================================
+Total operational cost: $450,000.00
+Daily operational: $14,516.13
+Support (month): $15,000.00
+Support per day (÷2÷days): $241.94
+============================================================
+DAILY RATE: $14,758.07
+ANNUAL PROJECTION: $5,386,695
+============================================================
+```

aws_cost_calculator_cli-1.3.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+aws_cost_calculator_cli-1.3.0.dist-info/licenses/LICENSE,sha256=cYtmQZHNGGTXOtg3T7LHDRneleaH0dHXHfxFV3WR50Y,1079
+cost_calculator/__init__.py,sha256=PJeIqvWh5AYJVrJxPPkI4pJnAt37rIjasrNS0I87kaM,52
+cost_calculator/cli.py,sha256=YJOWA-uWSMEZc4QHof8DF_An6VpKmTsxh0X_G31y1SM,31018
+cost_calculator/drill.py,sha256=hGi-prLgZDvNMMICQc4fl3LenM7YaZ3To_Ei4LKwrdc,10543
+cost_calculator/monthly.py,sha256=6k9F8S7djhX1wGV3-T1MZP7CvWbbfhSTEaddwCfVu5M,7932
+cost_calculator/trends.py,sha256=k_s4ylBX50sqoiM_fwepi58HW01zz767FMJhQUPDznk,12246
+aws_cost_calculator_cli-1.3.0.dist-info/METADATA,sha256=jZYbRF46p0qvjkw4Dqwja-4cnOJv59i7zTzmFXxfCsw,7761
+aws_cost_calculator_cli-1.3.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+aws_cost_calculator_cli-1.3.0.dist-info/entry_points.txt,sha256=_5Qy4EcHbYVYrdgOu1E48faMHb9fLUl5VJ3djDHuJBo,47
+aws_cost_calculator_cli-1.3.0.dist-info/top_level.txt,sha256=PRwGPPlNqASfyhGHDjSfyl4SXeE7GF3OVTu1tY1Uqyc,16
+aws_cost_calculator_cli-1.3.0.dist-info/RECORD,,

aws_cost_calculator_cli-1.3.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.7.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

aws_cost_calculator_cli-1.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cc = cost_calculator.cli:cli

aws_cost_calculator_cli-1.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cost Optimization Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aws_cost_calculator_cli-1.3.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+cost_calculator

cost_calculator/__init__.py

@@ -0,0 +1,2 @@
+"""AWS Cost Calculator CLI"""
+__version__ = '1.0.0'