devops-aws-costlens 1.0.1__tar.gz

devops_aws_costlens-1.0.1/.gitignore

@@ -0,0 +1,117 @@
+# AWS CostLens - .gitignore
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.env.*
+!.env.example
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE / Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.project
+.pydevproject
+.settings/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# Output files generated by aws-costlens
+output/
+reports/
+*.pdf
+*.csv
+!requirements*.txt
+
+# AWS credentials (NEVER commit these)
+.aws/
+credentials
+config
+
+# OS files
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# Logs
+*.log
+logs/
+
+# Temporary files
+*.tmp
+*.temp
+.tmp/
+.temp/

devops_aws_costlens-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ernesto Calzadilla Martínez
+
+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.

devops_aws_costlens-1.0.1/PKG-INFO

@@ -0,0 +1,307 @@
+Metadata-Version: 2.4
+Name: devops-aws-costlens
+Version: 1.0.1
+Summary: AWS Cost Intelligence Tool - Terminal-based cost and resource dashboard.
+Project-URL: Homepage, https://github.com/Calza36/aws-costlens
+Project-URL: Source, https://github.com/Calza36/aws-costlens
+Author: Ernesto Calzadilla Martínez
+License: MIT
+License-File: LICENSE
+Keywords: aws,cli,cloud,cost,costlens,dashboard,finops
+Requires-Python: >=3.8
+Requires-Dist: boto3>=1.37.28
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: reportlab>=3.6.1
+Requires-Dist: rich>=14.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: hatch>=1.9.0; extra == 'dev'
+Requires-Dist: isort>=5.12.0; extra == 'dev'
+Requires-Dist: mypy>=1.5.1; extra == 'dev'
+Requires-Dist: types-boto3; extra == 'dev'
+Requires-Dist: types-pyyaml; extra == 'dev'
+Requires-Dist: types-reportlab; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# AWS CostLens
+
+**AWS Cost Intelligence Tool** - Terminal-based dashboard for AWS cost monitoring and resource scanning.
+
+```
+╔═══════════════════════════════════════════════╗
+║     AWS CostLens - Cost Intelligence Tool     ║
+╚═══════════════════════════════════════════════╝
+```
+
+## Features
+
+- 💵 **Cost Dashboard** - View current and previous period costs by service
+- 📈 **Cost History** - 6-month cost trend visualization with ASCII charts
+- 🔍 **Resource Scan** - Find stopped instances, unused volumes, unattached EIPs, untagged resources
+- 📄 **Export Reports** - PDF, CSV, JSON formats
+- ☁️ **S3 Upload** - Automatically upload reports to S3
+- 🔧 **Multi-Profile** - Support for multiple AWS CLI profiles
+- 📋 **YAML Config** - Configuration file support
+
+## Installation
+
+### From PyPI (Recommended)
+
+Install from PyPI using `pip`:
+
+```bash
+pip install devops-aws-costlens
+```
+
+Or using `pipx` for isolated installation:
+
+```bash
+pipx install devops-aws-costlens
+```
+
+After installation, the command is:
+
+```bash
+aws-costlens --help
+```
+
+### From Source
+
+If you want to install from source or contribute:
+
+```bash
+# Clone the repository
+git clone https://github.com/Calza36/aws-costlens.git
+cd aws-costlens
+
+# Install in development mode
+pip install -e .
+```
+
+### Using Docker
+
+```bash
+# Build the image
+docker build -t aws-costlens .
+
+# Run with AWS credentials mounted
+docker run -v ~/.aws:/root/.aws:ro aws-costlens cost --profiles default
+```
+
+## Quick Start
+
+```bash
+# Cost dashboard for default profile
+aws-costlens cost
+
+# Cost dashboard for specific profiles
+aws-costlens cost --profiles dev prod
+
+# All profiles merged
+aws-costlens cost --all-profiles --merge
+
+# 6-month cost history
+aws-costlens history --profiles prod
+
+# Resource scan
+aws-costlens scan --profiles prod
+
+# Generate PDF report
+aws-costlens export --profiles prod --format pdf
+```
+
+## Commands
+
+### `cost` - Cost Dashboard
+
+Display cost information for AWS accounts.
+
+```bash
+aws-costlens cost [options]
+
+Options:
+  --profiles, -p      AWS CLI profile names
+  --regions, -r       AWS regions to check
+  --all-profiles, -a  Process all available profiles
+  --merge             Merge results from multiple profiles of the same account
+  --time-range, -t    Time range (days or YYYY-MM-DD:YYYY-MM-DD)
+  --tag               Filter by tag (key=value)
+  --config, -c        Path to YAML config file
+```
+
+### `history` - Cost History
+
+Display 6-month cost history with ASCII visualization.
+
+```bash
+aws-costlens history [options]
+
+Options:
+  --profiles, -p      AWS CLI profile names
+  --all-profiles, -a  Process all available profiles
+  --config, -c        Path to YAML config file
+```
+
+### `scan` - Resource Scan
+
+Find unused and untagged resources.
+
+```bash
+aws-costlens scan [options]
+
+Options:
+  --profiles, -p      AWS CLI profile names
+  --regions, -r       AWS regions to check
+  --all-profiles, -a  Process all available profiles
+  --config, -c        Path to YAML config file
+```
+
+Scan checks:
+- ⏹️ Stopped EC2 instances
+- 💾 Unused EBS volumes
+- 🌐 Unattached Elastic IPs
+- 🏷️ Untagged resources (EC2, RDS, Lambda, ELBv2)
+
+### `export` - Generate Reports
+
+Generate and export reports in various formats.
+
+```bash
+aws-costlens export [options]
+
+Options:
+  --profiles, -p      AWS CLI profile names
+  --all-profiles, -a  Process all available profiles
+  --merge             Merge results from multiple profiles
+  --name, -n          Base name for report files
+  --format, -f        Export formats: pdf, csv, json
+  --dir, -d           Output directory
+  --bucket            S3 bucket for uploads
+  --s3-path           S3 path/prefix for reports
+  --scan              Include resource scan report
+  --history           Include cost history report
+  --config, -c        Path to YAML config file
+```
+
+## Configuration File
+
+Create a YAML config file for reusable settings. See `config.example.yaml` for a complete example.
+
+```yaml
+# costlens.yaml
+profiles:
+  - dev
+  - staging
+  - prod
+
+regions:
+  - us-east-1
+  - eu-west-1
+
+name: monthly_cost_report
+format:
+  - pdf
+  - csv
+
+bucket: my-reports-bucket
+s3_path: costlens/monthly
+```
+
+Use with:
+
+```bash
+aws-costlens cost --config costlens.yaml
+aws-costlens export --config costlens.yaml
+```
+
+## Docker Compose
+
+```bash
+# Run cost dashboard
+docker compose run costlens cost --profiles prod
+
+# Run scan
+docker compose run costlens scan --all-profiles
+
+# Generate reports
+docker compose run costlens export --all-profiles --format pdf csv
+```
+
+## AWS Permissions Required
+
+The following AWS permissions are required:
+
+```json
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Effect": "Allow",
+      "Action": [
+        "ce:GetCostAndUsage",
+        "budgets:DescribeBudgets",
+        "ec2:DescribeInstances",
+        "ec2:DescribeVolumes",
+        "ec2:DescribeAddresses",
+        "ec2:DescribeRegions",
+        "rds:DescribeDBInstances",
+        "rds:ListTagsForResource",
+        "lambda:ListFunctions",
+        "lambda:ListTags",
+        "elasticloadbalancing:DescribeLoadBalancers",
+        "elasticloadbalancing:DescribeTags",
+        "sts:GetCallerIdentity",
+        "s3:PutObject"
+      ],
+      "Resource": "*"
+    }
+  ]
+}
+```
+
+## Examples
+
+### Monthly Cost Report for All Profiles
+
+```bash
+aws-costlens export --all-profiles --merge --format pdf csv json \
+  --name monthly_$(date +%Y%m) \
+  --dir ./reports
+```
+
+### Scan with S3 Upload
+
+```bash
+aws-costlens export --profiles prod --scan \
+  --format pdf \
+  --bucket my-audit-bucket \
+  --s3-path scans/$(date +%Y/%m)
+```
+
+### Filter Costs by Tag
+
+```bash
+aws-costlens cost --profiles prod --tag Environment=production --tag Project=web
+```
+
+### Custom Time Range
+
+```bash
+# Last 7 days
+aws-costlens cost --profiles prod --time-range 7
+
+# Specific date range
+aws-costlens cost --profiles prod --time-range 2025-01-01:2025-01-31
+```
+
+## License
+
+MIT License - See [LICENSE](LICENSE) file.
+
+---
+
+**Author:** Ernesto Calzadilla Martínez
+
+---
+
+*Inspired by aws-finops-dashboard*

devops_aws_costlens-1.0.1/README.md

@@ -0,0 +1,282 @@
+# AWS CostLens
+
+**AWS Cost Intelligence Tool** - Terminal-based dashboard for AWS cost monitoring and resource scanning.
+
+```
+╔═══════════════════════════════════════════════╗
+║     AWS CostLens - Cost Intelligence Tool     ║
+╚═══════════════════════════════════════════════╝
+```
+
+## Features
+
+- 💵 **Cost Dashboard** - View current and previous period costs by service
+- 📈 **Cost History** - 6-month cost trend visualization with ASCII charts
+- 🔍 **Resource Scan** - Find stopped instances, unused volumes, unattached EIPs, untagged resources
+- 📄 **Export Reports** - PDF, CSV, JSON formats
+- ☁️ **S3 Upload** - Automatically upload reports to S3
+- 🔧 **Multi-Profile** - Support for multiple AWS CLI profiles
+- 📋 **YAML Config** - Configuration file support
+
+## Installation
+
+### From PyPI (Recommended)
+
+Install from PyPI using `pip`:
+
+```bash
+pip install devops-aws-costlens
+```
+
+Or using `pipx` for isolated installation:
+
+```bash
+pipx install devops-aws-costlens
+```
+
+After installation, the command is:
+
+```bash
+aws-costlens --help
+```
+
+### From Source
+
+If you want to install from source or contribute:
+
+```bash
+# Clone the repository
+git clone https://github.com/Calza36/aws-costlens.git
+cd aws-costlens
+
+# Install in development mode
+pip install -e .
+```
+
+### Using Docker
+
+```bash
+# Build the image
+docker build -t aws-costlens .
+
+# Run with AWS credentials mounted
+docker run -v ~/.aws:/root/.aws:ro aws-costlens cost --profiles default
+```
+
+## Quick Start
+
+```bash
+# Cost dashboard for default profile
+aws-costlens cost
+
+# Cost dashboard for specific profiles
+aws-costlens cost --profiles dev prod
+
+# All profiles merged
+aws-costlens cost --all-profiles --merge
+
+# 6-month cost history
+aws-costlens history --profiles prod
+
+# Resource scan
+aws-costlens scan --profiles prod
+
+# Generate PDF report
+aws-costlens export --profiles prod --format pdf
+```
+
+## Commands
+
+### `cost` - Cost Dashboard
+
+Display cost information for AWS accounts.
+
+```bash
+aws-costlens cost [options]
+
+Options:
+  --profiles, -p      AWS CLI profile names
+  --regions, -r       AWS regions to check
+  --all-profiles, -a  Process all available profiles
+  --merge             Merge results from multiple profiles of the same account
+  --time-range, -t    Time range (days or YYYY-MM-DD:YYYY-MM-DD)
+  --tag               Filter by tag (key=value)
+  --config, -c        Path to YAML config file
+```
+
+### `history` - Cost History
+
+Display 6-month cost history with ASCII visualization.
+
+```bash
+aws-costlens history [options]
+
+Options:
+  --profiles, -p      AWS CLI profile names
+  --all-profiles, -a  Process all available profiles
+  --config, -c        Path to YAML config file
+```
+
+### `scan` - Resource Scan
+
+Find unused and untagged resources.
+
+```bash
+aws-costlens scan [options]
+
+Options:
+  --profiles, -p      AWS CLI profile names
+  --regions, -r       AWS regions to check
+  --all-profiles, -a  Process all available profiles
+  --config, -c        Path to YAML config file
+```
+
+Scan checks:
+- ⏹️ Stopped EC2 instances
+- 💾 Unused EBS volumes
+- 🌐 Unattached Elastic IPs
+- 🏷️ Untagged resources (EC2, RDS, Lambda, ELBv2)
+
+### `export` - Generate Reports
+
+Generate and export reports in various formats.
+
+```bash
+aws-costlens export [options]
+
+Options:
+  --profiles, -p      AWS CLI profile names
+  --all-profiles, -a  Process all available profiles
+  --merge             Merge results from multiple profiles
+  --name, -n          Base name for report files
+  --format, -f        Export formats: pdf, csv, json
+  --dir, -d           Output directory
+  --bucket            S3 bucket for uploads
+  --s3-path           S3 path/prefix for reports
+  --scan              Include resource scan report
+  --history           Include cost history report
+  --config, -c        Path to YAML config file
+```
+
+## Configuration File
+
+Create a YAML config file for reusable settings. See `config.example.yaml` for a complete example.
+
+```yaml
+# costlens.yaml
+profiles:
+  - dev
+  - staging
+  - prod
+
+regions:
+  - us-east-1
+  - eu-west-1
+
+name: monthly_cost_report
+format:
+  - pdf
+  - csv
+
+bucket: my-reports-bucket
+s3_path: costlens/monthly
+```
+
+Use with:
+
+```bash
+aws-costlens cost --config costlens.yaml
+aws-costlens export --config costlens.yaml
+```
+
+## Docker Compose
+
+```bash
+# Run cost dashboard
+docker compose run costlens cost --profiles prod
+
+# Run scan
+docker compose run costlens scan --all-profiles
+
+# Generate reports
+docker compose run costlens export --all-profiles --format pdf csv
+```
+
+## AWS Permissions Required
+
+The following AWS permissions are required:
+
+```json
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Effect": "Allow",
+      "Action": [
+        "ce:GetCostAndUsage",
+        "budgets:DescribeBudgets",
+        "ec2:DescribeInstances",
+        "ec2:DescribeVolumes",
+        "ec2:DescribeAddresses",
+        "ec2:DescribeRegions",
+        "rds:DescribeDBInstances",
+        "rds:ListTagsForResource",
+        "lambda:ListFunctions",
+        "lambda:ListTags",
+        "elasticloadbalancing:DescribeLoadBalancers",
+        "elasticloadbalancing:DescribeTags",
+        "sts:GetCallerIdentity",
+        "s3:PutObject"
+      ],
+      "Resource": "*"
+    }
+  ]
+}
+```
+
+## Examples
+
+### Monthly Cost Report for All Profiles
+
+```bash
+aws-costlens export --all-profiles --merge --format pdf csv json \
+  --name monthly_$(date +%Y%m) \
+  --dir ./reports
+```
+
+### Scan with S3 Upload
+
+```bash
+aws-costlens export --profiles prod --scan \
+  --format pdf \
+  --bucket my-audit-bucket \
+  --s3-path scans/$(date +%Y/%m)
+```
+
+### Filter Costs by Tag
+
+```bash
+aws-costlens cost --profiles prod --tag Environment=production --tag Project=web
+```
+
+### Custom Time Range
+
+```bash
+# Last 7 days
+aws-costlens cost --profiles prod --time-range 7
+
+# Specific date range
+aws-costlens cost --profiles prod --time-range 2025-01-01:2025-01-31
+```
+
+## License
+
+MIT License - See [LICENSE](LICENSE) file.
+
+---
+
+**Author:** Ernesto Calzadilla Martínez
+
+---
+
+*Inspired by aws-finops-dashboard*

devops_aws_costlens-1.0.1/aws_costlens/__init__.py

@@ -0,0 +1,3 @@
+"""AWS CostLens - AWS Cost Intelligence Tool."""
+
+__version__ = "1.0.1"