v0.2.0

Shieldgram v0.2.0

— 2026-07-17

Added

• Spam Detector — Link detection (URL + t.me), advertising pattern matching (casino, crypto, "buy cheap", etc.)
• User Reputation System — Redis-backed 0.0–1.0 scoring with penalty on attack and decay on normal behavior
• PostgreSQL Logger — AsyncSQLAlchemy event store for audit trails and analytics (detection_logs table)
• Reputation Config — penalty (0.15) and decay (0.95) tunable per deployment
• Spam Config — max_links_per_message (3) and ad_pattern_threshold (2)

Changed

• ShieldConfig — Added spam_detector, reputation, and postgres_url fields
• Shield middleware — Integrated reputation engine, spam detector, and PostgreSQL logging
• Bumped test suite from 26 to 37 tests

v0.1.0

Shieldgram v0.1.0 — Initial Release

Features

• Rate Limiter — Sliding Window + Token Bucket (Lua scripts)
• Flood Detector — Burst + repeat content analysis
• Threat Score Engine — Weighted scoring
• Detection Engine — Concurrent orchestration
• Decision Engine — Worst-case aggregation
• Shield Middleware — aiogram 3, one-line setup
• Redis Storage — Lua, hiredis, connection pooling

Install

pip install shieldgram

Quick Start

from shieldgram import Shield
shield = Shield(redis="redis://localhost:6379/0")
dp.message.middleware(shield)

Full Changelog: https://github.com/fvckxd55/Shieldgram/blob/master/CHANGELOG.md