Metadata-Version: 2.4
Name: firetower
Version: 0.1.0
Summary: Know what breaks before it breaks — audit third-party API deprecations.
Author: FiretowerHQ
License: MIT
Project-URL: Homepage, https://firetower.sh
Project-URL: Source, https://github.com/FiretowerHQ/firetower
Keywords: api,deprecation,sdk,dependencies,audit,breaking-changes
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# firetower (Python)

Know what breaks before it breaks. Audits the third-party APIs your project
depends on against Firetower's deprecation feed + live package registries.

This is a **thin client** — it sends your project files to the Firetower API,
which runs the audit and returns the findings. No engine, no dependencies
(stdlib only).

## Install

```bash
pip install firetower
```

## Use

Create an upload token in the dashboard (**Connect CI**) and export it:

```bash
export FIRETOWER_TOKEN=ft_…
firetower                 # audit the current directory
firetower path/to/project # audit elsewhere
firetower --json          # raw report JSON
```

Exit code is `1` when any finding is **critical**, so it drops into CI as a gate:

```yaml
- run: pip install firetower && firetower
  env:
    FIRETOWER_TOKEN: ${{ secrets.FIRETOWER_TOKEN }}
```

Set `FIRETOWER_API` to point at a self-hosted backend (default
`https://api.firetower.sh`).
