remandochka 0.0.1__tar.gz

remandochka-0.0.1/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.1
+Name: remandochka
+Version: 0.0.1
+Summary: RM (ReMandochka) — Высокопроизводительная библиотека хукинга, обхода защит ART/R8 и KDL v2 рантайма для плагинов exteraGram
+Author: swagnonher
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# RM (ReMandochka) v0.0.1 — Библиотека хукинга, обхода защит ART/R8 и KDL v2 рантайма
+### (PyPI: `ReMandochka` | Python import: `import rm`)
+
+**ReMandochka (RM)** — инструментальная библиотека для разработчиков плагинов **exteraGram**, решающая проблемы с защитами, барьерами Android Runtime (ART), компилятора R8, предоставляющая встроенный ультра-быстрый парсер документов **KDL v2 (2.0.0)** и безопасную Java-рефлексию.
+
+- **PyPI**: `ReMandochka` (установка: `pip install ReMandochka`).
+- **Импорт в плагинах**: `import rm` (краткое имя для удобства написания кода) или `import remandochka`.
+
+---
+
+## ⚡ Моментальный KDL v2/v1 парсер (`rm.kdl`)
+
+Пакет содержит оптимизированный парсер новейшей спецификации **KDL 2.0.0** с поддержкой:
+- Всех современных конструкций KDL v2 (`#true`, `#false`, `#null`, `#inf`, `#-inf`, `#nan`, шестнадцатеричные `0x...`, восьмеричные `0o...`, двоичные `0b...`, децимальные числа с экспонентой и разделителями `_`).
+- Многострочных строк `""" ... """` и `#""" ... """#` с автоматическим дедентированием по спецификации KDL v2.
+- Сырых строк `#"..."#`, `##"..."##`.
+- Эскейп-последовательностей (`\n`, `\r`, `\t`, `\s`, `\u{1F600}`, whitespace escapes `\`).
+- Комментариев `//`, вложенных блочных комментариев `/* /* ... */ */` и слешдаш-комментариев `/-` (для нод, аргументов, свойств и дочерних блоков).
+- Типовых аннотаций `(type)node` и `(type)value`.
+- Обратной совместимости с KDL v1 (`true`, `false`, `null`, `r"..."`).
+
+### Скорость парсинга
+Парсинг типового конфигурационного блока плагина занимает **~100 микросекунд** (0.0001 сек) на чистом Python 3.11 без внешних бинарных зависимостей, обеспечивая 100% совместимость с Android Chaquopy (`py3-none-any.whl`).
+
+### Использование KDL в коде:
+
+```python
+import rm
+
+# 1. Быстрый парсинг KDL-строки
+doc = rm.parse_kdl("""
+package name="ReMandochka" version="0.0.1" {
+    flags active=#true debug=#false test=#null
+    numbers hex=0xDEAD_BEEF dec=1_000_000
+    multiline \"\"\"
+        Привет, мир!
+        Вторая строка с отступом.
+        \"\"\"
+    raw #"C:\\Path\\Without\\Escapes"#
+    (role)node (u8)255 (date)"2026-10-26"
+}
+""")
+
+# 2. Доступ к узлам и свойствам
+pkg = doc["package"]
+print(pkg["name"])              # "ReMandochka"
+print(pkg.get("version"))        # "0.0.1"
+
+flags = pkg.child("flags")
+print(flags["active"])           # True
+
+# 3. Конвертация в словарь
+data_dict = doc.to_dict()
+
+# 4. Сериализация обратно в KDL
+kdl_text = rm.dumps_kdl(doc)
+```
+
+---
+
+## 🛡️ Модуль обхода блокировок ART/R8 (`rm.Bypass`)
+
+Архитектура типизирована по физическим барьерам ART/R8 и поддерживает моментальный прием правил конфигурации прямо из KDL-строк:
+
+```python
+from base_plugin import BasePlugin, MethodHook
+import rm
+
+class MyPlugin(BasePlugin):
+    def on_plugin_load(self):
+        self.bypass = rm.Bypass(self)
+
+        # Можно передать правила напрямую в KDL формате!
+        self.bypass.apply_kdl("""
+        class "InstallPluginBottomSheet" full_name="com.exteragram.messenger.plugins.ui.components.InstallPluginBottomSheet" {
+            method "<init>" routine="constructor_trap" {
+                pre_caller class="com.exteragram.messenger.plugins.PythonPluginsEngine" method="showInstallDialog"
+                post_lifecycle class="org.telegram.ui.ActionBar.BottomSheet" method="show" filter="InstallPluginBottomSheet"
+            }
+        }
+        """)
+
+        @self.bypass.hook("InstallPluginBottomSheet", "<init>")
+        class CtorHook(MethodHook):
+            def before_hooked_method(self, param):
+                # param.args[2] — PluginInstallParams
+                param.args[2].setTrusted(True)
+
+            def after_hooked_method(self, param):
+                sheet = param.thisObject # живой экземпляр шторки
+
+        @self.bypass.hook("InstallPluginBottomSheet", "applyButtonState")
+        class ButtonHook(MethodHook):
+            def after_hooked_method(self, param):
+                sheet = param.thisObject
+                # кастомизация кнопки
+
+        self.bypass.install()
+
+    def on_plugin_unload(self):
+        self.bypass.uninstall()
+```
+
+---
+
+## 🔇 Интеллектуальное логирование (Zero Log Spam)
+
+Библиотека не засоряет логи приложения:
+* Логи выводятся **ТОЛЬКО** тогда, когда в настройках плагин-системы включен **Режим разработчика (`rm.is_dev_mode() == True`)**.
+* При выключенном режиме разработчика библиотека работает в режиме **полной тишины**.
+
+---
+
+## 📦 Спецификация для плагинов exteraGram
+
+- В файлах `.plugin`:
+  ```python
+  __requirements__ = ["ReMandochka 0.0.1"]
+  ```
+- В архивах `.elyx` (`metainfo.json`):
+  ```json
+  "requirements": "ReMandochka 0.0.1"
+  ```

remandochka-0.0.1/README.md

@@ -0,0 +1,123 @@
+# RM (ReMandochka) v0.0.1 — Библиотека хукинга, обхода защит ART/R8 и KDL v2 рантайма
+### (PyPI: `ReMandochka` | Python import: `import rm`)
+
+**ReMandochka (RM)** — инструментальная библиотека для разработчиков плагинов **exteraGram**, решающая проблемы с защитами, барьерами Android Runtime (ART), компилятора R8, предоставляющая встроенный ультра-быстрый парсер документов **KDL v2 (2.0.0)** и безопасную Java-рефлексию.
+
+- **PyPI**: `ReMandochka` (установка: `pip install ReMandochka`).
+- **Импорт в плагинах**: `import rm` (краткое имя для удобства написания кода) или `import remandochka`.
+
+---
+
+## ⚡ Моментальный KDL v2/v1 парсер (`rm.kdl`)
+
+Пакет содержит оптимизированный парсер новейшей спецификации **KDL 2.0.0** с поддержкой:
+- Всех современных конструкций KDL v2 (`#true`, `#false`, `#null`, `#inf`, `#-inf`, `#nan`, шестнадцатеричные `0x...`, восьмеричные `0o...`, двоичные `0b...`, децимальные числа с экспонентой и разделителями `_`).
+- Многострочных строк `""" ... """` и `#""" ... """#` с автоматическим дедентированием по спецификации KDL v2.
+- Сырых строк `#"..."#`, `##"..."##`.
+- Эскейп-последовательностей (`\n`, `\r`, `\t`, `\s`, `\u{1F600}`, whitespace escapes `\`).
+- Комментариев `//`, вложенных блочных комментариев `/* /* ... */ */` и слешдаш-комментариев `/-` (для нод, аргументов, свойств и дочерних блоков).
+- Типовых аннотаций `(type)node` и `(type)value`.
+- Обратной совместимости с KDL v1 (`true`, `false`, `null`, `r"..."`).
+
+### Скорость парсинга
+Парсинг типового конфигурационного блока плагина занимает **~100 микросекунд** (0.0001 сек) на чистом Python 3.11 без внешних бинарных зависимостей, обеспечивая 100% совместимость с Android Chaquopy (`py3-none-any.whl`).
+
+### Использование KDL в коде:
+
+```python
+import rm
+
+# 1. Быстрый парсинг KDL-строки
+doc = rm.parse_kdl("""
+package name="ReMandochka" version="0.0.1" {
+    flags active=#true debug=#false test=#null
+    numbers hex=0xDEAD_BEEF dec=1_000_000
+    multiline \"\"\"
+        Привет, мир!
+        Вторая строка с отступом.
+        \"\"\"
+    raw #"C:\\Path\\Without\\Escapes"#
+    (role)node (u8)255 (date)"2026-10-26"
+}
+""")
+
+# 2. Доступ к узлам и свойствам
+pkg = doc["package"]
+print(pkg["name"])              # "ReMandochka"
+print(pkg.get("version"))        # "0.0.1"
+
+flags = pkg.child("flags")
+print(flags["active"])           # True
+
+# 3. Конвертация в словарь
+data_dict = doc.to_dict()
+
+# 4. Сериализация обратно в KDL
+kdl_text = rm.dumps_kdl(doc)
+```
+
+---
+
+## 🛡️ Модуль обхода блокировок ART/R8 (`rm.Bypass`)
+
+Архитектура типизирована по физическим барьерам ART/R8 и поддерживает моментальный прием правил конфигурации прямо из KDL-строк:
+
+```python
+from base_plugin import BasePlugin, MethodHook
+import rm
+
+class MyPlugin(BasePlugin):
+    def on_plugin_load(self):
+        self.bypass = rm.Bypass(self)
+
+        # Можно передать правила напрямую в KDL формате!
+        self.bypass.apply_kdl("""
+        class "InstallPluginBottomSheet" full_name="com.exteragram.messenger.plugins.ui.components.InstallPluginBottomSheet" {
+            method "<init>" routine="constructor_trap" {
+                pre_caller class="com.exteragram.messenger.plugins.PythonPluginsEngine" method="showInstallDialog"
+                post_lifecycle class="org.telegram.ui.ActionBar.BottomSheet" method="show" filter="InstallPluginBottomSheet"
+            }
+        }
+        """)
+
+        @self.bypass.hook("InstallPluginBottomSheet", "<init>")
+        class CtorHook(MethodHook):
+            def before_hooked_method(self, param):
+                # param.args[2] — PluginInstallParams
+                param.args[2].setTrusted(True)
+
+            def after_hooked_method(self, param):
+                sheet = param.thisObject # живой экземпляр шторки
+
+        @self.bypass.hook("InstallPluginBottomSheet", "applyButtonState")
+        class ButtonHook(MethodHook):
+            def after_hooked_method(self, param):
+                sheet = param.thisObject
+                # кастомизация кнопки
+
+        self.bypass.install()
+
+    def on_plugin_unload(self):
+        self.bypass.uninstall()
+```
+
+---
+
+## 🔇 Интеллектуальное логирование (Zero Log Spam)
+
+Библиотека не засоряет логи приложения:
+* Логи выводятся **ТОЛЬКО** тогда, когда в настройках плагин-системы включен **Режим разработчика (`rm.is_dev_mode() == True`)**.
+* При выключенном режиме разработчика библиотека работает в режиме **полной тишины**.
+
+---
+
+## 📦 Спецификация для плагинов exteraGram
+
+- В файлах `.plugin`:
+  ```python
+  __requirements__ = ["ReMandochka 0.0.1"]
+  ```
+- В архивах `.elyx` (`metainfo.json`):
+  ```json
+  "requirements": "ReMandochka 0.0.1"
+  ```

remandochka-0.0.1/pyproject.toml

@@ -0,0 +1,13 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "remandochka"
+version = "0.0.1"
+description = "RM (ReMandochka) — Высокопроизводительная библиотека хукинга, обхода защит ART/R8 и KDL v2 рантайма для плагинов exteraGram"
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [
+    { name = "swagnonher" }
+]

remandochka-0.0.1/remandochka/__init__.py

@@ -0,0 +1,25 @@
+"""
+ReMandochka (RM) — PyPI package alias for `rm`.
+"""
+
+from rm import *
+from rm import (
+    __version__,
+    bypass,
+    kdl,
+    reflection,
+    parse_kdl,
+    dumps_kdl,
+    loads_kdl,
+    is_dev_mode,
+    dev_log,
+    get_app_version,
+    Bypass,
+    get_field,
+    set_field,
+    get_java_class,
+    Document,
+    Node,
+    TaggedValue,
+    KDLParseError,
+)

remandochka-0.0.1/remandochka.egg-info/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.1
+Name: remandochka
+Version: 0.0.1
+Summary: RM (ReMandochka) — Высокопроизводительная библиотека хукинга, обхода защит ART/R8 и KDL v2 рантайма для плагинов exteraGram
+Author: swagnonher
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# RM (ReMandochka) v0.0.1 — Библиотека хукинга, обхода защит ART/R8 и KDL v2 рантайма
+### (PyPI: `ReMandochka` | Python import: `import rm`)
+
+**ReMandochka (RM)** — инструментальная библиотека для разработчиков плагинов **exteraGram**, решающая проблемы с защитами, барьерами Android Runtime (ART), компилятора R8, предоставляющая встроенный ультра-быстрый парсер документов **KDL v2 (2.0.0)** и безопасную Java-рефлексию.
+
+- **PyPI**: `ReMandochka` (установка: `pip install ReMandochka`).
+- **Импорт в плагинах**: `import rm` (краткое имя для удобства написания кода) или `import remandochka`.
+
+---
+
+## ⚡ Моментальный KDL v2/v1 парсер (`rm.kdl`)
+
+Пакет содержит оптимизированный парсер новейшей спецификации **KDL 2.0.0** с поддержкой:
+- Всех современных конструкций KDL v2 (`#true`, `#false`, `#null`, `#inf`, `#-inf`, `#nan`, шестнадцатеричные `0x...`, восьмеричные `0o...`, двоичные `0b...`, децимальные числа с экспонентой и разделителями `_`).
+- Многострочных строк `""" ... """` и `#""" ... """#` с автоматическим дедентированием по спецификации KDL v2.
+- Сырых строк `#"..."#`, `##"..."##`.
+- Эскейп-последовательностей (`\n`, `\r`, `\t`, `\s`, `\u{1F600}`, whitespace escapes `\`).
+- Комментариев `//`, вложенных блочных комментариев `/* /* ... */ */` и слешдаш-комментариев `/-` (для нод, аргументов, свойств и дочерних блоков).
+- Типовых аннотаций `(type)node` и `(type)value`.
+- Обратной совместимости с KDL v1 (`true`, `false`, `null`, `r"..."`).
+
+### Скорость парсинга
+Парсинг типового конфигурационного блока плагина занимает **~100 микросекунд** (0.0001 сек) на чистом Python 3.11 без внешних бинарных зависимостей, обеспечивая 100% совместимость с Android Chaquopy (`py3-none-any.whl`).
+
+### Использование KDL в коде:
+
+```python
+import rm
+
+# 1. Быстрый парсинг KDL-строки
+doc = rm.parse_kdl("""
+package name="ReMandochka" version="0.0.1" {
+    flags active=#true debug=#false test=#null
+    numbers hex=0xDEAD_BEEF dec=1_000_000
+    multiline \"\"\"
+        Привет, мир!
+        Вторая строка с отступом.
+        \"\"\"
+    raw #"C:\\Path\\Without\\Escapes"#
+    (role)node (u8)255 (date)"2026-10-26"
+}
+""")
+
+# 2. Доступ к узлам и свойствам
+pkg = doc["package"]
+print(pkg["name"])              # "ReMandochka"
+print(pkg.get("version"))        # "0.0.1"
+
+flags = pkg.child("flags")
+print(flags["active"])           # True
+
+# 3. Конвертация в словарь
+data_dict = doc.to_dict()
+
+# 4. Сериализация обратно в KDL
+kdl_text = rm.dumps_kdl(doc)
+```
+
+---
+
+## 🛡️ Модуль обхода блокировок ART/R8 (`rm.Bypass`)
+
+Архитектура типизирована по физическим барьерам ART/R8 и поддерживает моментальный прием правил конфигурации прямо из KDL-строк:
+
+```python
+from base_plugin import BasePlugin, MethodHook
+import rm
+
+class MyPlugin(BasePlugin):
+    def on_plugin_load(self):
+        self.bypass = rm.Bypass(self)
+
+        # Можно передать правила напрямую в KDL формате!
+        self.bypass.apply_kdl("""
+        class "InstallPluginBottomSheet" full_name="com.exteragram.messenger.plugins.ui.components.InstallPluginBottomSheet" {
+            method "<init>" routine="constructor_trap" {
+                pre_caller class="com.exteragram.messenger.plugins.PythonPluginsEngine" method="showInstallDialog"
+                post_lifecycle class="org.telegram.ui.ActionBar.BottomSheet" method="show" filter="InstallPluginBottomSheet"
+            }
+        }
+        """)
+
+        @self.bypass.hook("InstallPluginBottomSheet", "<init>")
+        class CtorHook(MethodHook):
+            def before_hooked_method(self, param):
+                # param.args[2] — PluginInstallParams
+                param.args[2].setTrusted(True)
+
+            def after_hooked_method(self, param):
+                sheet = param.thisObject # живой экземпляр шторки
+
+        @self.bypass.hook("InstallPluginBottomSheet", "applyButtonState")
+        class ButtonHook(MethodHook):
+            def after_hooked_method(self, param):
+                sheet = param.thisObject
+                # кастомизация кнопки
+
+        self.bypass.install()
+
+    def on_plugin_unload(self):
+        self.bypass.uninstall()
+```
+
+---
+
+## 🔇 Интеллектуальное логирование (Zero Log Spam)
+
+Библиотека не засоряет логи приложения:
+* Логи выводятся **ТОЛЬКО** тогда, когда в настройках плагин-системы включен **Режим разработчика (`rm.is_dev_mode() == True`)**.
+* При выключенном режиме разработчика библиотека работает в режиме **полной тишины**.
+
+---
+
+## 📦 Спецификация для плагинов exteraGram
+
+- В файлах `.plugin`:
+  ```python
+  __requirements__ = ["ReMandochka 0.0.1"]
+  ```
+- В архивах `.elyx` (`metainfo.json`):
+  ```json
+  "requirements": "ReMandochka 0.0.1"
+  ```

remandochka-0.0.1/remandochka.egg-info/SOURCES.txt

@@ -0,0 +1,26 @@
+README.md
+pyproject.toml
+setup.py
+remandochka/__init__.py
+remandochka.egg-info/PKG-INFO
+remandochka.egg-info/SOURCES.txt
+remandochka.egg-info/dependency_links.txt
+remandochka.egg-info/top_level.txt
+rm/__init__.py
+rm/bypass/__init__.py
+rm/bypass/bypass.py
+rm/bypass/engine.py
+rm/bypass/rules.jsonl
+rm/bypass/rules.kdl
+rm/bypass/routines/__init__.py
+rm/bypass/routines/base.py
+rm/bypass/routines/constructor_trap.py
+rm/bypass/routines/final_devirtualized.py
+rm/bypass/routines/inlined_method.py
+rm/kdl/__init__.py
+rm/kdl/document.py
+rm/kdl/exceptions.py
+rm/kdl/formatter.py
+rm/kdl/node.py
+rm/kdl/parser.py
+rm/reflection/__init__.py

remandochka-0.0.1/remandochka.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

remandochka-0.0.1/remandochka.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+remandochka
+rm

remandochka-0.0.1/rm/__init__.py

@@ -0,0 +1,85 @@
+"""
+RM (ReMandochka) — Инструментальная библиотека для разработчиков плагинов exteraGram:
+- Обход барьеров ART/R8 и хукинг (rm.bypass, rm.Bypass)
+- Моментальный парсер KDL v2/v1 (rm.kdl, rm.parse_kdl)
+- Безопасная Java-рефлексия с автоприведением типов (rm.reflection)
+- Zero-Spam логирование и определение окружения (rm.is_dev_mode, rm.get_app_version, rm.dev_log)
+"""
+
+try:
+    from hook_utils import find_class
+except ImportError:
+    def find_class(_):
+        return None
+
+
+def is_dev_mode() -> bool:
+    """Проверяет режим разработчика плагинов в настройках exteraGram."""
+    try:
+        c = find_class("com.exteragram.messenger.ExteraConfig")
+        return bool(c.getPluginsDevMode()) if c and hasattr(c, "getPluginsDevMode") else False
+    except Exception:
+        return False
+
+
+def dev_log(plugin, msg: str):
+    """Zero Log Spam: логирует ТОЛЬКО при включенном режиме разработчика."""
+    if is_dev_mode():
+        t = f"[RM] {msg}"
+        if plugin and hasattr(plugin, "log"):
+            try:
+                return plugin.log(t)
+            except Exception:
+                pass
+        print(t)
+
+
+def get_app_version() -> str:
+    """Определяет версию клиента exteraGram."""
+    try:
+        bv = find_class("org.telegram.messenger.BuildVars")
+        if bv and hasattr(bv, "BUILD_VERSION_STRING"):
+            return str(bv.BUILD_VERSION_STRING)
+    except Exception:
+        pass
+    return "13.1.1"
+
+
+__version__ = "0.0.1"
+
+from . import bypass, kdl, reflection
+from .bypass import Bypass, ProtectionEngine
+from .kdl import Document, KDLParseError, Node, TaggedValue, dump, dumps, load, loads, parse
+from .reflection import get_field, get_java_class, set_field
+
+# Top-level convenience functions
+parse_kdl = parse
+dumps_kdl = dumps
+loads_kdl = loads
+
+__all__ = [
+    "__version__",
+    "is_dev_mode",
+    "dev_log",
+    "get_app_version",
+    "bypass",
+    "Bypass",
+    "ProtectionEngine",
+    "kdl",
+    "reflection",
+    "get_java_class",
+    "get_field",
+    "set_field",
+    "Document",
+    "Node",
+    "TaggedValue",
+    "KDLParseError",
+    "parse",
+    "loads",
+    "load",
+    "dumps",
+    "dump",
+    "parse_kdl",
+    "dumps_kdl",
+    "loads_kdl",
+]

remandochka-0.0.1/rm/bypass/__init__.py

@@ -0,0 +1,8 @@
+"""
+RM (ReMandochka) Bypass: Advanced ART/R8 protection bypass module with KDL v2 support.
+"""
+
+from .bypass import Bypass
+from .engine import ProtectionEngine
+
+__all__ = ["Bypass", "ProtectionEngine"]

remandochka-0.0.1/rm/bypass/bypass.py

@@ -0,0 +1,57 @@
+"""
+RM (ReMandochka) Bypass: Developer-facing hook interface with KDL support.
+"""
+
+from typing import Any, Optional, Union
+from .engine import ProtectionEngine
+
+
+class Bypass:
+    """
+    Обход защиты хуков RM (ReMandochka).
+    Предоставляет чистый, простой и ультра-быстрый API для плагин-мейкеров.
+    Поддерживает моментальную загрузку конфигураций и правил в формате KDL v2.
+    """
+
+    def __init__(self, plugin_instance, rules_path: Optional[str] = None):
+        self.plugin = plugin_instance
+        self.engine = ProtectionEngine(plugin_instance, rules_path)
+
+    def apply_kdl(self, kdl_text: str):
+        """
+        Моментально парсит и применяет конфигурацию правил обхода из KDL-строки.
+        """
+        self.engine.load_kdl_rules(kdl_text)
+        return self
+
+    def hook_method(self, target_class: Union[str, Any], method_name: str, hook_handler: Any):
+        """
+        Регистрирует хук на метод или конструктор любого защищенного класса.
+        """
+        cname = target_class if isinstance(target_class, str) else target_class.__name__
+        self.engine.register_hook(cname, method_name, hook_handler)
+        return self
+
+    def hook(self, target_class: Union[str, Any], method_name: str):
+        """
+        Декоратор для классов MethodHook / MethodReplacement.
+
+        Пример:
+            @bypass.hook("InstallPluginBottomSheet", "startAnalysis")
+            class MyHook(MethodHook):
+                def before_hooked_method(self, param):
+                    param.returnEarly = True
+        """
+        def decorator(cls_or_instance):
+            instance = cls_or_instance() if isinstance(cls_or_instance, type) else cls_or_instance
+            self.hook_method(target_class, method_name, instance)
+            return cls_or_instance
+        return decorator
+
+    def install(self) -> bool:
+        """Активирует движок обхода защит."""
+        return self.engine.activate()
+
+    def uninstall(self):
+        """Снимает все хуки."""
+        self.engine.deactivate()