aws-cost-calculator-cli 1.5.2__py3-none-any.whl → 2.4.0__py3-none-any.whl

{aws_cost_calculator_cli-1.5.2.dist-info → aws_cost_calculator_cli-2.4.0.dist-info}/METADATA

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: aws-cost-calculator-cli
-Version: 1.5.2
+Version: 2.4.0
 Summary: AWS Cost Calculator CLI - Calculate daily and annual AWS costs across multiple accounts
-Home-page: https://github.com/yourusername/cost-calculator
+Home-page: https://github.com/trilogy-group/aws-cost-calculator
 Author: Cost Optimization Team
 Author-email: 
-Project-URL: Documentation, https://github.com/yourusername/cost-calculator/blob/main/README.md
+Project-URL: Documentation, https://github.com/trilogy-group/aws-cost-calculator/blob/main/README.md
 Keywords: aws cost calculator billing optimization cloud
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -43,66 +43,209 @@ A CLI tool to quickly calculate AWS costs across multiple accounts.
 ## Installation
 
 ```bash
-cd ~/cost-calculator
-pip install -e .
+pip install aws-cost-calculator-cli
+```
+
+Or upgrade to the latest version:
+```bash
+pip install --upgrade aws-cost-calculator-cli
 ```
 
 ## Quick Start
 
-### 1. Login to AWS SSO
+### Authentication Methods
+
+The CLI supports three authentication methods:
 
+#### 1. SSO (Recommended)
 ```bash
-aws sso login --profile my_aws_profile
+# The CLI will automatically trigger SSO login if needed
+cc calculate --profile myprofile --sso my_sso_profile
 ```
 
-**Note:** You need to do this before running cost calculations. The SSO session typically lasts 8-12 hours.
-
-### 2. Initialize a profile
+#### 2. Static Credentials
+```bash
+cc calculate --profile myprofile \
+  --access-key-id ASIA... \
+  --secret-access-key ... \
+  --session-token ...
+```
 
+#### 3. Environment Variables
 ```bash
-cc init --profile myprofile \
-  --aws-profile my_aws_profile \
-  --accounts "123456789012,234567890123,345678901234"
+# For SSO
+export AWS_PROFILE=my_sso_profile
+cc calculate --profile myprofile
+
+# For static credentials
+export AWS_ACCESS_KEY_ID=ASIA...
+export AWS_SECRET_ACCESS_KEY=...
+export AWS_SESSION_TOKEN=...
+cc calculate --profile myprofile
 ```
 
-### 3. Calculate costs
+### Basic Usage
 
 ```bash
 # Default: Today minus 2 days, going back 30 days
-cc calculate --profile myprofile
+cc calculate --profile myprofile --sso my_sso_profile
 
 # Specific start date
-cc calculate --profile myprofile --start-date 2025-11-04
+cc calculate --profile myprofile --sso my_sso_profile --start-date 2025-11-04
 
 # Custom offset and window
-cc calculate --profile myprofile --offset 2 --window 30
+cc calculate --profile myprofile --sso my_sso_profile --offset 2 --window 30
 
 # JSON output
-cc calculate --profile myprofile --json-output
+cc calculate --profile myprofile --sso my_sso_profile --json-output
 ```
 
 ### 4. Analyze cost trends
 
+All commands support the same authentication options:
+
 ```bash
-# Analyze last 3 weeks (default)
+# With SSO
+cc trends --profile myprofile --sso my_sso_profile
+
+# With static credentials
+cc trends --profile myprofile --access-key-id ASIA... --secret-access-key ... --session-token ...
+
+# With environment variables
+export AWS_PROFILE=my_sso_profile
 cc trends --profile myprofile
 
 # Analyze more weeks
-cc trends --profile myprofile --weeks 5
+cc trends --profile myprofile --sso my_sso_profile --weeks 5
 
 # Custom output file
-cc trends --profile myprofile --output weekly_trends.md
+cc trends --profile myprofile --sso my_sso_profile --output weekly_trends.md
 
 # JSON output
-cc trends --profile myprofile --json-output
+cc trends --profile myprofile --sso my_sso_profile --json-output
+```
+
+### 5. Monthly and drill-down analysis
+
+```bash
+# Monthly trends
+cc monthly --profile myprofile --sso my_sso_profile
+
+# Drill down by service
+cc drill --profile myprofile --sso my_sso_profile --service "EC2 - Other"
+
+# Drill down by account
+cc drill --profile myprofile --sso my_sso_profile --account 123456789012
 ```
 
-### 5. List profiles
+### 6. List profiles
 
 ```bash
 cc list-profiles
 ```
 
+## Authentication
+
+### Overview
+
+The CLI supports three authentication methods, all of which work with every command (`calculate`, `trends`, `monthly`, `drill`):
+
+### Method 1: SSO (Recommended)
+
+The CLI automatically handles SSO login if your session has expired:
+
+```bash
+cc calculate --profile myprofile --sso my_sso_profile
+```
+
+**How it works:**
+1. CLI checks if SSO session is valid using `aws sts get-caller-identity`
+2. If expired, automatically runs `aws sso login --profile my_sso_profile`
+3. Opens browser for authentication
+4. Proceeds with cost calculation once authenticated
+
+**Benefits:**
+- No manual SSO login required
+- Automatic session refresh
+- Most secure method
+- Works with AWS IAM Identity Center
+
+### Method 2: Static Credentials
+
+Pass temporary credentials directly via CLI flags:
+
+```bash
+cc calculate --profile myprofile \
+  --access-key-id ASIA... \
+  --secret-access-key ... \
+  --session-token ...
+```
+
+**Use cases:**
+- CI/CD pipelines
+- Temporary credentials from STS
+- Automated scripts
+- When SSO is not available
+
+### Method 3: Environment Variables
+
+Set credentials in your shell environment:
+
+```bash
+# For SSO
+export AWS_PROFILE=my_sso_profile
+cc calculate --profile myprofile
+
+# For static credentials
+export AWS_ACCESS_KEY_ID=ASIA...
+export AWS_SECRET_ACCESS_KEY=...
+export AWS_SESSION_TOKEN=...
+cc calculate --profile myprofile
+```
+
+**Benefits:**
+- No need to pass credentials with each command
+- Works with existing AWS CLI configuration
+- Can be set in shell profile (~/.zshrc, ~/.bashrc)
+
+### Profile Configuration
+
+**v2.3.0+: API-Only Architecture**
+
+All profiles are now managed via backend API (DynamoDB). No local profile files are used.
+
+**Setup:**
+```bash
+# Configure API secret (one-time setup)
+cc configure --api-secret YOUR_SECRET
+
+# Or set environment variable
+export COST_API_SECRET=your_secret_here
+```
+
+**List available profiles:**
+```bash
+cc list-profiles
+```
+
+**How it works:**
+1. CLI gets AWS credentials from SSO/environment
+2. CLI sends request to `https://api.costcop.cloudfix.dev` with:
+   - Profile name (e.g., "khoros")
+   - Your AWS credentials
+3. Backend Lambda loads profile from DynamoDB (accounts, exclusions, Athena config)
+4. Backend executes AWS API calls using your credentials
+5. Results returned to CLI for formatting
+
+**Benefits:**
+- No local configuration files to maintain
+- Centralized profile management
+- Automatic exclusions (Tax, Support, etc.)
+- Profile updates apply immediately to all users
+- Athena CUR configuration managed centrally
+
+The CLI will automatically fetch profile configuration from the backend if `COST_API_SECRET` is set.
+
 ## How It Works
 
 ### Date Calculation
@@ -240,11 +383,13 @@ The `drill` command allows you to investigate cost changes at different levels o
 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
+4. **Resource-level:** `cc drill --service "EC2 - Other" --account 123 --resources` → See individual instance IDs
 
 **Features:**
 - **Week-over-week cost analysis**: Compare costs between consecutive weeks
 - **Month-over-month cost analysis**: Compare costs between consecutive months
 - **Drill-down analysis**: Analyze costs by service, account, or usage type
+- **Resource-level analysis**: See individual resource IDs and costs using CUR data (NEW in v1.7.0)
 - **Pandas aggregations**: Time series analysis with sum, avg, std across all weeks
 - **Volatility detection**: Identify services with high cost variability and outliers
 - **Trend detection**: Auto-detect increasing/decreasing cost patterns
@@ -262,7 +407,7 @@ 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)
+  Top: 123456789012 (+$450.23)
 ```
 
 The report is saved to `drill_down.md` by default.

aws_cost_calculator_cli-2.4.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+aws_cost_calculator_cli-2.4.0.dist-info/licenses/LICENSE,sha256=cYtmQZHNGGTXOtg3T7LHDRneleaH0dHXHfxFV3WR50Y,1079
+cost_calculator/__init__.py,sha256=PJeIqvWh5AYJVrJxPPkI4pJnAt37rIjasrNS0I87kaM,52
+cost_calculator/api_client.py,sha256=UN_dKo8OYWVN905xZAn8pLlHMBSFR_EJWCUq21K8IKg,2204
+cost_calculator/cli.py,sha256=eFk3sjNBdupZHlivhWSpxAWZluDyzX-OHM_EycfJrbk,98144
+cost_calculator/cur.py,sha256=QaZ_nyDSw5_cti-h5Ho6eYLbqzY5TWoub24DpyzIiSs,9502
+cost_calculator/dimensions.py,sha256=cTpdYm-w88IgqlcB4ObhUsvGREBMrMSZx0d2PyehI6M,4478
+cost_calculator/drill.py,sha256=hGi-prLgZDvNMMICQc4fl3LenM7YaZ3To_Ei4LKwrdc,10543
+cost_calculator/executor.py,sha256=vwp4SoZfTobUeTKPujRzZzkO7tjOG8_LEGxgtraOZAQ,9348
+cost_calculator/forensics.py,sha256=uhRo3I_zOeMEaBENHfgq65URga31W0Z4vzS2UN6VmTY,12819
+cost_calculator/monthly.py,sha256=6k9F8S7djhX1wGV3-T1MZP7CvWbbfhSTEaddwCfVu5M,7932
+cost_calculator/trends.py,sha256=k_s4ylBX50sqoiM_fwepi58HW01zz767FMJhQUPDznk,12246
+aws_cost_calculator_cli-2.4.0.dist-info/METADATA,sha256=CF6_PkZ3eigTW-F6uKHaCtztSCqu_tnKN8Z9FzSTVS4,12160
+aws_cost_calculator_cli-2.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aws_cost_calculator_cli-2.4.0.dist-info/entry_points.txt,sha256=_5Qy4EcHbYVYrdgOu1E48faMHb9fLUl5VJ3djDHuJBo,47
+aws_cost_calculator_cli-2.4.0.dist-info/top_level.txt,sha256=PRwGPPlNqASfyhGHDjSfyl4SXeE7GF3OVTu1tY1Uqyc,16
+aws_cost_calculator_cli-2.4.0.dist-info/RECORD,,

{aws_cost_calculator_cli-1.5.2.dist-info → aws_cost_calculator_cli-2.4.0.dist-info}/WHEEL

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

cost_calculator/api_client.py

@@ -23,14 +23,15 @@ def get_api_config():
     return None
 
 
-def call_lambda_api(endpoint, credentials, accounts, **kwargs):
+def call_lambda_api(endpoint, credentials, accounts=None, profile=None, **kwargs):
     """
-    Call Lambda API endpoint.
+    Call unified API Gateway endpoint.
     
     Args:
-        endpoint: API endpoint name ('trends', 'monthly', 'drill')
+        endpoint: API endpoint name ('calculate', 'trends', 'monthly', 'drill', 'query', etc.)
         credentials: dict with AWS credentials
-        accounts: list of account IDs
+        accounts: list of account IDs (deprecated - use profile instead)
+        profile: profile name (preferred over accounts)
         **kwargs: additional parameters for the specific endpoint
     
     Returns:
@@ -44,25 +45,22 @@ def call_lambda_api(endpoint, credentials, accounts, **kwargs):
     if not api_config:
         raise Exception("API not configured. Set COST_API_SECRET environment variable.")
     
-    # Map endpoint names to Lambda URLs
-    endpoint_urls = {
-        'trends': 'https://pq3mqntc6vuwi4zw5flulsoleq0yiqtl.lambda-url.us-east-1.on.aws/',
-        'monthly': 'https://6aueebodw6q4zdeu3aaexb6tle0fqhhr.lambda-url.us-east-1.on.aws/',
-        'drill': 'https://3ncm2gzxrsyptrhud3ua3x5lju0akvsr.lambda-url.us-east-1.on.aws/',
-        'analyze': 'https://y6npmidtxwzg62nrqzkbacfs5q0edwgs.lambda-url.us-east-1.on.aws/',
-        'profiles': 'https://64g7jq7sjygec2zmll5lsghrpi0txrzo.lambda-url.us-east-1.on.aws/'
-    }
-    
-    url = endpoint_urls.get(endpoint)
-    
-    if not url:
-        raise Exception(f"Unknown endpoint: {endpoint}")
+    # Get base URL from environment or use default
+    base_url = os.environ.get('COST_CALCULATOR_API_URL', 'https://api.costcop.cloudfix.dev')
+    url = f"{base_url}/{endpoint}"
     
     # Build request payload
     payload = {
-        'credentials': credentials,
-        'accounts': accounts
+        'credentials': credentials
     }
+    
+    # Add profile or accounts
+    if profile:
+        payload['profile'] = profile
+    elif accounts:
+        payload['accounts'] = accounts
+    
+    # Add additional parameters
     payload.update(kwargs)
     
     # Make API call
@@ -71,7 +69,7 @@ def call_lambda_api(endpoint, credentials, accounts, **kwargs):
         'Content-Type': 'application/json'
     }
     
-    response = requests.post(url, headers=headers, json=payload, timeout=300)
+    response = requests.post(url, headers=headers, json=payload, timeout=900)  # 15 min timeout
     
     if response.status_code != 200:
         raise Exception(f"API call failed: {response.status_code} - {response.text}")