kdefender-wrapper 0.4.0

A Telegram bot wrapper for K-Defender security

K-Defender-wrapper

🛡️ K-Defender-wrapper protects Telegram bot handlers with K-Defender verdict checks. Works with both async and sync bot libraries.

---

Features

• Async + sync support in one API
• Compatible with aiogram, python-telegram-bot, TeleBot and similar frameworks
• Decorator-based protection (@kdefender_check)
• Automatic message/callback text detection
• Safe-by-default blocking on failed verdict/network errors

---

Installation

pip install kdefender-wrapper

Quick Start (aiogram / PTB async)

from kdefender_wrapper import setup, close, kdefender_check

await setup(
    bot=bot,
    url=URL,
    chat_token=CHAT_TOKEN,  # token from K-Defender
    lang="en"
)

@kdefender_check()
async def handler(message):
    await message.answer("Message accepted")

@kdefender_check(param="message")
async def strict_handler(message):
    await message.answer("Message accepted")

await close()

Quick Start (TeleBot sync)

from kdefender_wrapper import setup, close, kdefender_check

setup(
    bot=bot,
    url=URL,
    chat_token=CHAT_TOKEN,
    lang="en"
)

@kdefender_check()
def handler(message):
    bot.reply_to(message, "Message accepted")

close()

How It Works

1. User message is intercepted
2. Text is sent to K-Defender /check/
3. JSON verdict is parsed
4. Handler executes only for {"result":"ok"}
5. Otherwise message is blocked and user gets a safe notice