pentool 0.1.0__tar.gz

pentool-0.1.0/LICENSE

@@ -0,0 +1,34 @@
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (C) 2026 Pentool Project
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+---
+
+Additional Terms:
+
+This software is dual-licensed:
+
+1. Community Edition: AGPL-3.0 (this license)
+   - Free for personal and open-source use
+   - Source code modifications must be shared
+
+2. Commercial/PRO Edition: Commercial License
+   - Contact: sales@pentool.dev
+   - For proprietary/closed-source use
+   - Includes enterprise features and support
+
+For commercial licensing inquiries, please contact: sales@pentool.dev

pentool-0.1.0/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: pentool
+Version: 0.1.0
+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*

pentool-0.1.0/README.md

@@ -0,0 +1,188 @@
+# 🔐 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*

pentool-0.1.0/pentool/__init__.py

@@ -0,0 +1,4 @@
+"""Pentool — консольный аналог Burp Suite с TUI на Textual."""
+
+__version__ = "0.1.0"
+__author__ = "pentool"

pentool-0.1.0/pentool/__main__.py

@@ -0,0 +1,16 @@
+"""Точка входа: без аргументов — TUI, с аргументами — CLI."""
+
+import sys
+
+
+def main() -> None:
+    if len(sys.argv) > 1:
+        from pentool.cli.main import cli
+        cli()
+    else:
+        from pentool.tui.app import PentoolApp
+        PentoolApp().run()
+
+
+if __name__ == "__main__":
+    main()

pentool-0.1.0/pentool/api/__init__.py

@@ -0,0 +1,41 @@
+"""API-слой pentool — публичный интерфейс между modules/ и TUI/CLI."""
+
+from pentool.api.proxy_api     import ProxyAPI, InterceptedRequest, MatchReplaceRule
+from pentool.api.repeater_api  import RepeaterAPI
+from pentool.api.scanner_api   import ScannerAPI
+from pentool.api.intruder_api  import IntruderAPI, IntruderConfig, IntruderAttack
+from pentool.api.spider_api    import SpiderAPI
+from pentool.api.target_api    import TargetAPI
+# Decoder/Comparer/Sequencer — функциональные API без класса-обёртки
+from pentool.api.decoder_api   import (  # noqa: F401
+    OPERATIONS, OP_LABELS, DecoderChain,
+    decode_op, decode_smart, encode_op, run_chain,
+)
+from pentool.api.comparer_api  import (  # noqa: F401
+    compare, compare_lines, CompareStats, DiffLine, DiffResult,
+)
+from pentool.api.sequencer_api import (  # noqa: F401
+    Sequencer, SequencerReport, token_entropy, charset_size,
+)
+
+__all__ = [
+    # Proxy
+    "ProxyAPI", "InterceptedRequest", "MatchReplaceRule",
+    # Repeater
+    "RepeaterAPI",
+    # Scanner
+    "ScannerAPI",
+    # Intruder
+    "IntruderAPI", "IntruderConfig", "IntruderAttack",
+    # Spider
+    "SpiderAPI",
+    # Target
+    "TargetAPI",
+    # Decoder
+    "OPERATIONS", "OP_LABELS", "DecoderChain",
+    "decode_op", "decode_smart", "encode_op", "run_chain",
+    # Comparer
+    "compare", "compare_lines", "CompareStats", "DiffLine", "DiffResult",
+    # Sequencer
+    "Sequencer", "SequencerReport", "token_entropy", "charset_size",
+]

pentool-0.1.0/pentool/api/base_api.py

@@ -0,0 +1,48 @@
+"""ExportableAPI — base mixin for API classes supporting project persistence."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+
+
+class ExportableAPI(ABC):
+    """Mixin for API classes that support project data export/import.
+
+    Subclasses must implement export_project_data and import_project_data.
+    These methods are called by core.project.save_project/load_project.
+
+    Usage::
+
+        class MyAPI(ExportableAPI):
+            def export_project_data(self) -> dict:
+                return {"my_data": [...]}
+
+            def import_project_data(self, data: dict) -> int:
+                items = data.get("my_data", [])
+                # restore items
+                return len(items)
+    """
+
+    @abstractmethod
+    def export_project_data(self) -> dict:
+        """Export module state to a serializable dict.
+
+        Returns:
+            dict: Module-specific data structure (e.g., {"results": [...]}).
+                  Must be JSON-serializable (no datetime, use .isoformat()).
+        """
+        raise NotImplementedError
+
+    @abstractmethod
+    def import_project_data(self, data: dict) -> int | tuple[int, str]:
+        """Import module state from a loaded project dict.
+
+        Args:
+            data: The module's block from project.json (e.g., data["intruder"]).
+
+        Returns:
+            int: Number of items loaded successfully.
+            OR
+            tuple[int, str]: (count, error_message) — empty string if OK.
+        """
+        raise NotImplementedError

pentool-0.1.0/pentool/api/comparer_api.py

@@ -0,0 +1,19 @@
+"""ComparerAPI — публичный интерфейс Comparer для TUI."""
+
+from __future__ import annotations
+
+from pentool.modules.comparer import (  # noqa: F401
+    compare,
+    compare_lines,
+    CompareStats,
+    DiffLine,
+    DiffResult,
+)
+
+__all__ = [
+    "compare",
+    "compare_lines",
+    "CompareStats",
+    "DiffLine",
+    "DiffResult",
+]

pentool-0.1.0/pentool/api/decoder_api.py

@@ -0,0 +1,24 @@
+"""DecoderAPI — публичный интерфейс Decoder/Encoder для TUI."""
+
+from __future__ import annotations
+
+# Реэкспорт всего публичного из modules/decoder
+from pentool.modules.decoder import (  # noqa: F401
+    OPERATIONS,
+    OP_LABELS,
+    DecoderChain,
+    decode_op,
+    decode_smart,
+    encode_op,
+    run_chain,
+)
+
+__all__ = [
+    "OPERATIONS",
+    "OP_LABELS",
+    "DecoderChain",
+    "decode_op",
+    "decode_smart",
+    "encode_op",
+    "run_chain",
+]