Metadata-Version: 2.4
Name: pentool
Version: 0.1.1
Summary: Modern Web Pentesting TUI - Professional security testing tool
Author-email: Pentool Team <dev@pentool.dev>
License: AGPL-3.0
Project-URL: Homepage, https://github.com/docxqwerty/pentool
Project-URL: Repository, https://github.com/docxqwerty/pentool
Project-URL: Issues, https://github.com/docxqwerty/pentool/issues
Project-URL: Changelog, https://github.com/docxqwerty/pentool/blob/main/CHANGELOG.md
Keywords: pentesting,security,burp,proxy,scanner,intruder
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Security
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual>=0.40.0
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: aiosqlite>=0.19.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: click>=8.1.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: pytest-timeout>=2.1.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.5.0; extra == "dev"
Requires-Dist: pre-commit>=3.4.0; extra == "dev"
Dynamic: license-file

# 🔐 PENTOOL — Modern Web Pentesting TUI

**Версия:** 1.0 (Pre-release)  
**Статус:** 87% готовности к релизу  
**Автор:** @sudores (DoctorX)

Современный инструмент для тестирования безопасности веб-приложений с интуитивным TUI интерфейсом.

---

## 🚀 Быстрый старт

```bash
# Установка
pip install pentool

# Запуск
pentool

# Или из исходников
git clone https://github.com/pentool/pentool.git
cd pentool
pip install -e .
pentool
```

---

## ✨ Ключевые возможности

### Основные инструменты (Free)
- **Proxy** — HTTP/HTTPS перехват с SSL
- **Repeater** — модификация и повтор запросов
- **Intruder** — автоматизированные атаки с payloads
- **Decoder** — кодирование/декодирование
- **Comparer** — сравнение запросов/ответов
- **HTTPQL** — мощная фильтрация истории

### PRO возможности
- **Turbo Mode Intruder** 🚀 — 10x ускорение (100-200 req/sec)
- **Scanner** — автоматическое обнаружение уязвимостей (23 проверки)
- **Spider** — автоматическое сканирование сайтов
- **WebSocket** — перехват и модификация WS трафика
- **AI Analysis** — анализ уязвимостей с помощью GPT-4
- **Plugins** — система расширений

---

## 📦 Установка

### Требования
- Python 3.10+
- Linux / macOS / Windows

### Из PyPI
```bash
pip install pentool
```

### Из исходников
```bash
git clone https://github.com/pentool/pentool.git
cd pentool
python -m venv venv
source venv/bin/activate  # или venv\Scripts\activate на Windows
pip install -e ".[dev]"
```

---

## 📖 Документация

- **Quick Start:** `docs/QUICKSTART.md`
- **User Guide:** `docs/user/`
- **API Reference:** `docs/API_CONTRACTS.md`
- **Architecture:** `docs/ARCHITECTURE_AUDIT.md`

---

## 🧪 Тестирование

```bash
# Запустить все тесты
pytest tests/

# С coverage
pytest tests/ --cov=pentool --cov-report=html

# Только unit-тесты
pytest tests/unit/ -v
```

**Текущий статус:**
- Unit-тесты: 1348/1360 PASSED (99.1%)
- Coverage: 29%
- Integration: требуют отладки

---

## 🏗️ Архитектура

```
pentool/
├── core/              # Ядро: EventBus, license, features
├── modules/           # Логика: proxy, scanner, intruder
├── api/               # API фасады для модулей
├── services/          # Оркестрация бизнес-логики
├── storage/           # База данных (SQLite)
├── tui/               # TUI интерфейс (Textual)
├── cli/               # CLI команды
├── plugins/           # Система плагинов
└── utils/             # Вспомогательные утилиты
```

---

## 💰 Тарифные планы

| Plan | Цена | Инструменты | Лимиты |
|------|------|-------------|--------|
| **Free** | $0 | Proxy, Repeater, Intruder Basic, Decoder | 500 записей истории, 10 потоков |
| **Lite** | $29/мес | + Scanner, Spider, Match&Replace | 5K истории, 20 потоков |
| **Medium** | $99/мес | + WebSocket, Plugins, Turbo Mode | 50K истории, 50 потоков |
| **Full** | $299/мес | + AI Analysis, PRO Reports, API | Unlimited |

---

## 🚀 Killer Features

### Turbo Mode Intruder
10x ускорение через HTTP Keep-Alive и connection pooling:
- Обычный режим: ~10-20 req/sec
- Turbo режим: ~100-200 req/sec

```python
from pentool.api.intruder_api import IntruderAPI

api = IntruderAPI()
await api.start_attack(config, turbo_mode=True)  # 🚀
```

### Коммерческие планы
4 тарифа с автоматической проверкой лимитов:
```python
from pentool.core.features import has_feature, get_limit

if has_feature("turbo_mode", plan):
    max_threads = get_limit("intruder_max_threads", plan)
```

---

## 🤝 Contributing

Contributions приветствуются! Перед началом:
1. Прочитай `docs/ARCHITECTURE_AUDIT.md`
2. Проверь `MYPLANS/MASTER_PLAN.md` для актуальных задач
3. Запусти тесты перед PR

---

## 📄 License

- **Community Edition:** AGPL-3.0
- **PRO Edition:** Commercial license

---

## 🔗 Ссылки

- **GitHub:** https://github.com/pentool/pentool
- **Docs:** https://pentool.dev/docs
- **Discord:** https://discord.gg/pentool

---

## 📊 Статус проекта

- **Готовность:** 87%
- **Последнее обновление:** 2026-07-22
- **Тесты:** 99.1% проходят
- **Прогноз релиза:** 1-8 августа 2026

**Проект в активной разработке. Релиз 1.0 скоро!** 🚀

---

*Создано с помощью Claude Opus 4.8*
