Metadata-Version: 2.4
Name: pypricktools
Version: 8826.1.0
Summary: Мощный инструмент для анализа исходного кода, байткода и бинарных файлов без сторонних зависимостей.
Author-email: CharmLxt <reception.mailspypi@gmail.com>
License: MIT
Project-URL: Homepage, https://pypi.org/project/pypricktools/
Keywords: ast,binary,reverse-engineering,pe-file,sandbox,lint,architecture,charmpkk
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Disassemblers
Classifier: Topic :: Security
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: charm
Requires-Dist: CharmPkk>=28.10.26b2; extra == "charm"

PyprickTools. Версия 8826.1.0. Автор CharmLxt (PyPI: CharmLxt, email: reception.mailspypi@gmail.com).



PyprickTools — это библиотека-швейцарский нож для разработчиков, специалистов по безопасности и исследователей данных. Она предназначена для глубокого анализа исходного кода, байткода, бинарных файлов (включая .exe) и архитектуры проектов. Библиотека не требует установки сторонних зависимостей, используя только стандартную библиотеку Python. Главная особенность — мягкая интеграция с CharmPkk: если он установлен, все таблицы и отчеты автоматически отрисовываются в красивом цветном виде прямо в консоли.



Установка производится командой pip install pypricktools. Для интеграции с красивым интерфейсом используйте pip install "pypricktools\[charm]". Библиотека не имеет интерактивного меню, все функции доступны для прямого импорта.



Модуль ast\_tools позволяет анализировать исходный код без его запуска. С его помощью можно найти мертвый код (функции, которые нигде не вызываются), построить карту импортов проекта, найти оставленные комментарии TODO или FIXME, а также вычислить цикломатическую сложность функций для поиска мест, требующих рефакторинга. Модуль health проводит аудит кода: проверяет покрытие докстрингами, ищет опасные вызовы (вроде eval или exec), находит захардкоженные пароли или токены и проверяет базовую орфографию в комментариях.



Модуль architecture позволяет контролировать чистоту архитектуры в больших проектах. Вы можете задать правила импортов, и библиотека найдет нарушения. Также она умеет находить циклические импорты и определять нарушения слоев (например, когда интерфейс пользователя начинает напрямую импортировать модули базы данных). Модуль graph может сгенерировать код на языке Graphviz (DOT), который визуализирует граф зависимостей вашего проекта.



Модуль memory помогает бороться с утечками памяти. С его помощью можно найти циклические ссылки объектов, которые не собираются сборщиком мусора, и отследить потребление памяти конкретными функциями с помощью декоратора track\_memory\_usage.



Модуль binary предназначен для хирургии бинарных файлов. Он умеет искать последовательности байтов (паттерны) в файлах, безопасно заменять байты по смещению (создавая резервную копию перед изменением) и генерировать красивый Hex-дамп любого файла. Модуль bytecode позволяет заглянуть внутрь скомпилированных .pyc файлов без наличия исходников: он дизассемблирует байткод и извлекает все строки (URL, названия функций и т.д.).



Модуль pe содержит парсер исполняемых файлов Windows (.exe, .dll), написанный на чистом Python. Он извлекает архитектуру, точку входа, секции и импортируемые библиотеки. Это позволяет быстро понять поведение программы (например, если она импортирует сетевые библиотеки или библиотеки для работы с реестром) и проверить, упакован ли файл. Модуль entropy вычисляет энтропию Шеннона для поиска скрытых архивов, шифрованных данных или сжатых картинок внутри файлов.



Модуль filetype определяет реальный тип файла по его сигнатуре (Magic Bytes), даже если расширение было изменено. Он также умеет извлекать читаемые строки из любого бинарника и находить встроенные архивы (ZIP, GZIP) внутри других файлов.



Модуль sandbox предназначен для безопасного запуска незнакомого Python-кода. Он блокирует опасные операции вроде удаления файлов, сетевых запросов или запуска других процессов, выполняя код в изолированной среде. Это идеально подходит для тестирования скриптов, скачанных из интернета.



Связь с автором: reception.mailspypi@gmail.com.

