Metadata-Version: 2.4
Name: cybersentry-saud
Version: 0.2.1
Summary: Developer-first Security Simulator + Defense Engine — 32 OWASP rules, 6 defence layers, 100% detection
Author: CyberSentry
Author-email: saudbb8 <your@email.com>
License: MIT
Project-URL: Homepage, https://github.com/saudbb8/cybersentry
Project-URL: Repository, https://github.com/saudbb8/cybersentry
Project-URL: Bug Tracker, https://github.com/saudbb8/cybersentry/issues
Keywords: security,owasp,waf,sqli,xss,cybersecurity,devsecops,fastapi
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Security
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: typer[all]>=0.9.0
Requires-Dist: rich>=13.7.1
Requires-Dist: fastapi>=0.111.0
Requires-Dist: uvicorn[standard]>=0.29.0
Requires-Dist: pydantic>=2.7.1
Requires-Dist: pydantic-settings>=2.2.1
Requires-Dist: sqlalchemy>=2.0.30
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: requests>=2.31.0
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: packaging>=24.0
Requires-Dist: tabulate>=0.9.0
Requires-Dist: jinja2>=3.1.4
Requires-Dist: starlette>=0.37.0
Dynamic: author
Dynamic: requires-python

# CyberSentry 🛡️

![CI](https://github.com/saudbb8/cybersentry/actions/workflows/cybersentry.yml/badge.svg)
![PyPI](https://img.shields.io/pypi/v/cybersentry-saud)
![Python](https://img.shields.io/pypi/pyversions/cybersentry-saud)

**Developer-first Security Simulator + Defense Engine**

> 100% detection rate · 32 OWASP rules · 6 defence layers · Zero false positives

## Install
```bash
pip install cybersentry-saud
```

## Quick start
```bash
cybersentry doctor
cybersentry scan .
cybersentry explain SQLI-001
cybersentry score --critical 0 --high 2 --medium 5
```

## 6 Defence Layers

| Layer | Protects Against |
|---|---|
| IP Reputation | Tor exits, Shodan, abusive ranges |
| Flood Guard | DDoS, slow loris, body bombs |
| Bot Fingerprinting | sqlmap, headless browsers, scrapers |
| OWASP Detection | SQLi, XSS, CMDi, SSRF, XXE, JWT, LDAP, GraphQL, NoSQL |
| Honeypot + Tarpit | /.env probes, auto-ban attackers |
| Security Headers | HSTS, X-Frame-Options, CSP |

## 32 Detection Rules

SQLi (6) · XSS (4) · CMDi (2) · Path Traversal (2) · SSRF (2) · SSTI (1) ·
Header (1) · XXE (3) · JWT (4) · LDAP (2) · GraphQL (3) · NoSQL (3)

## Benchmark
```
Total attacks tested : 43
Blocked              : 43  (100%)
False positives      : 0
```

## One-line middleware
```python
from fastapi import FastAPI
from cybersentry.middleware.fastapi_hardened import HardenedMiddleware

app = FastAPI()
app.add_middleware(HardenedMiddleware, block_tor=True, flood_rpm=300)
```

## CLI Commands

| Command | Description |
|---|---|
| `cybersentry scan .` | Scan for secrets + CVEs |
| `cybersentry attack <url>` | Simulate attacks |
| `cybersentry score` | Security score 0-100 |
| `cybersentry explain SQLI-001` | Learn + code fix |
| `cybersentry rules` | List all 32 rules |
| `cybersentry protect` | Middleware code |
| `cybersentry report` | Security report |
| `cybersentry doctor` | Check installation |

## License
MIT © 2026 saudbb8
