Metadata-Version: 2.4
Name: deburger
Version: 1.0.1
Summary: Catch expensive cloud code before it ships detects costly patterns and estimates your monthly bill impact
Home-page: https://github.com/sahilnyk/deburger
Author: Sahil Nayak
Author-email: Sahil Nayak <sahilnayak2056@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/sahilnyk/deburger
Project-URL: Bug Tracker, https://github.com/sahilnyk/deburger/issues
Project-URL: Source Code, https://github.com/sahilnyk/deburger
Keywords: cloud,cost-optimization,aws,gcp,azure,finops,devops
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.7.0
Requires-Dist: PyYAML>=6.0.1
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# deburger

[![PyPI version](https://img.shields.io/pypi/v/deburger.svg)](https://pypi.org/project/deburger/)
[![Python](https://img.shields.io/pypi/pyversions/deburger.svg)](https://pypi.org/project/deburger/)
[![License](https://img.shields.io/pypi/l/deburger.svg)](https://pypi.org/project/deburger/)
[![Downloads](https://img.shields.io/pypi/dm/deburger.svg)](https://pypi.org/project/deburger/)

Catch expensive cloud code before it ships. Static analysis for your cloud bill.

## Install

```bash
pip install deburger
```

## Examples

**Scan your project:**

```bash
deburger init --provider aws
deburger check .
```

<placeholder for images>

**Compare cost between branches:**

```bash
deburger diff main..feature-branch
```

**Block expensive commits with a git hook:**

```bash
deburger hook --install
git commit -m "Add feature"
# Commit blocked if expensive patterns found
```

**CI/CD integration:**

```yaml
- name: Cost Analysis
  run: |
    pip install deburger
    deburger check . --json > cost-report.json
    deburger check . || exit 1
```

**Get optimization suggestions:**

```bash
deburger optimize app.py
```

## Features

- Detects S3/storage calls in loops, missing connection pools, unbounded queries, cold start issues, sequential async, expensive logging
- Estimates monthly cost impact based on your traffic config
- Supports Python (AST) and JavaScript/TypeScript (pattern detection)
- Works with AWS, GCP, and Azure
- Git hook and CI/CD integration
- JSON output for automation (`--json`)
- Inline suppression with `deburger:ignore`
- No cloud credentials needed, runs entirely local
