Metadata-Version: 2.3
Name: costcutter
Version: 0.1.0
Summary: A kill-switch for AWS that automatically deletes resources when spending limits are breached.
Keywords: aws,budget,cost,cost-control,cleanup,devops,security,utilities
Author: hyperoot
Author-email: hyperoot <rajesh@hyperoot.dev>
License: MIT License
         
         Copyright (c) 2025 hyperoot.dev
         
         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.
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Classifier: Natural Language :: English
Requires-Dist: boto3>=1.40.1
Requires-Dist: pyfiglet>=1.0.3
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: rich>=14.1.0
Requires-Dist: typer>=0.16.0
Requires-Python: >=3.13
Project-URL: Homepage, https://github.com/HYP3R00T/costcutter
Project-URL: Issues, https://github.com/HYP3R00T/costcutter/issues
Project-URL: Repository, https://github.com/HYP3R00T/costcutter
Description-Content-Type: text/markdown

# CostCutter

> [!CAUTION]
> CostCutter will delete AWS resources aggressively and indiscriminately once triggered.
> This tool is designed for **students and experimenters** who are worried about accidental AWS costs.

CostCutter is an **automated kill-switch for AWS accounts**.
It monitors **AWS Budgets**, and when costs exceed predefined limits, it triggers automated cleanup of AWS resources to prevent unexpected charges.

## 🎯 Project Objectives

- **Primary Goal**: Prevent unexpected AWS bills by automatically cleaning up resources once a cost budget threshold is breached.
- **Approach**:
  - Monitor costs using AWS Budgets.
  - Trigger alerts via SNS when budget crosses threshold.
  - Automated cleanup using a Python-based AWS Lambda function (boto3).
  - Fully serverless & free-tier friendly (Lambda, SNS, Budgets only).
