bad-checker 0.1.0__tar.gz

bad_checker-0.1.0/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.4
+Name: bad-checker
+Version: 0.1.0
+Summary: A typo-tolerant blocklist checker.
+Author-email: coder5330 <hello@jldev.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# bad-checker
+
+A fuzzy, keyboard-typo- and leetspeak-aware content blocklist for Python.
+
+Install name: `bad-checker` &nbsp;|&nbsp; Import name: `bad`
+
+## Usage
+
+```python
+import bad
+
+if "something bad" in bad:
+    print("Caught it!")
+```
+
+Matching combines:
+- direct substring lookups against a blocklist
+- leetspeak normalization (`v1agra` -> `viagra`, `fr33` -> `free`)
+- a keyboard-proximity-aware Damerau-Levenshtein distance, so typos on
+  physically nearby keys (and adjacent-letter transpositions) are caught
+  cheaply while unrelated words are not
+
+Add your own keywords at runtime:
+
+```python
+bad.add_keywords("mycompanyscam", "internaltermtoflag")
+```
+
+## Install
+
+```bash
+pip install bad-checker
+```
+
+## Build from source
+
+```bash
+pip install --upgrade build
+python -m build
+```
+
+## License
+
+MIT

bad_checker-0.1.0/README.md

@@ -0,0 +1,44 @@
+# bad-checker
+
+A fuzzy, keyboard-typo- and leetspeak-aware content blocklist for Python.
+
+Install name: `bad-checker`  |  Import name: `bad`
+
+## Usage
+
+```python
+import bad
+
+if "something bad" in bad:
+    print("Caught it!")
+```
+
+Matching combines:
+- direct substring lookups against a blocklist
+- leetspeak normalization (`v1agra` -> `viagra`, `fr33` -> `free`)
+- a keyboard-proximity-aware Damerau-Levenshtein distance, so typos on
+  physically nearby keys (and adjacent-letter transpositions) are caught
+  cheaply while unrelated words are not
+
+Add your own keywords at runtime:
+
+```python
+bad.add_keywords("mycompanyscam", "internaltermtoflag")
+```
+
+## Install
+
+```bash
+pip install bad-checker
+```
+
+## Build from source
+
+```bash
+pip install --upgrade build
+python -m build
+```
+
+## License
+
+MIT

bad_checker-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bad-checker"
+version = "0.1.0"
+authors = [{ name="coder5330", email="hello@jldev.com" }]
+description = "A typo-tolerant blocklist checker."
+readme = "README.md"
+requires-python = ">=3.7"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]

bad_checker-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

bad_checker-0.1.0/src/bad/__init__.py

@@ -0,0 +1,102 @@
+import sys as _sys
+import types as _types
+
+__all__ = []
+
+_ROWS = [
+    "`1234567890-=",
+    "qwertyuiop[]\\",
+    "asdfghjkl;'",
+    "zxcvbnm,./",
+]
+_ROW_OFFSETS = [0.0, 0.5, 0.75, 1.25]
+
+_KEY_COORDS = {}
+for _row, _text in enumerate(_ROWS):
+    for _col, _char in enumerate(_text):
+        _KEY_COORDS[_char] = (_col + _ROW_OFFSETS[_row], float(_row))
+
+_LEET_TABLE = str.maketrans({
+    "0": "o", "1": "i", "3": "e", "4": "a", "5": "s",
+    "7": "t", "@": "a", "$": "s", "!": "i", "+": "t",
+})
+
+_DEFAULT_BLOCKLIST = [
+    "microsoft", "blocksi"
+]
+
+
+class _BadModule(_types.ModuleType):
+    @staticmethod
+    def _key_distance(c1, c2):
+        c1, c2 = c1.lower(), c2.lower()
+        if c1 == c2:
+            return 0.0
+        p1, p2 = _KEY_COORDS.get(c1), _KEY_COORDS.get(c2)
+        if p1 is None or p2 is None:
+            return 3.0
+        return ((p1[0] - p2[0]) ** 2 + (p1[1] - p2[1]) ** 2) ** 0.5
+
+    @classmethod
+    def _sub_cost(cls, c1, c2):
+        if c1.lower() == c2.lower():
+            return 0.0
+        dist = cls._key_distance(c1, c2)
+        return min(1.0, 0.3 + 0.2 * dist)
+
+    @classmethod
+    def _fuzzy_distance(cls, w1, w2):
+        m, n = len(w1), len(w2)
+        dp = [[0.0] * (n + 1) for _ in range(m + 1)]
+        for i in range(m + 1):
+            dp[i][0] = float(i)
+        for j in range(n + 1):
+            dp[0][j] = float(j)
+
+        for i in range(1, m + 1):
+            for j in range(1, n + 1):
+                cost = cls._sub_cost(w1[i - 1], w2[j - 1])
+                dp[i][j] = min(
+                    dp[i - 1][j] + 1.0,
+                    dp[i][j - 1] + 1.0,
+                    dp[i - 1][j - 1] + cost,
+                )
+                if (i > 1 and j > 1
+                        and w1[i - 1] == w2[j - 2]
+                        and w1[i - 2] == w2[j - 1]):
+                    dp[i][j] = min(dp[i][j], dp[i - 2][j - 2] + 0.6)
+        return dp[m][n]
+
+    @staticmethod
+    def _deleet(text):
+        return text.translate(_LEET_TABLE)
+
+    def __contains__(self, text):
+        if not isinstance(text, str):
+            return False
+
+        normalized = text.lower()
+        deleeted = self._deleet(normalized)
+        words = deleeted.split()
+
+        for keyword in self.banned_keywords:
+            keyword = keyword.lower()
+
+            if keyword in normalized or keyword in deleeted:
+                return True
+
+            if " " in keyword:
+                continue
+
+            for word in words:
+                if abs(len(word) - len(keyword)) <= 2:
+                    if self._fuzzy_distance(word, keyword) <= 1.0:
+                        return True
+        return False
+
+    def add_keywords(self, *keywords):
+        self.banned_keywords.extend(k.lower() for k in keywords)
+
+_mod = _sys.modules[__name__]
+_mod.__class__ = _BadModule
+_mod.banned_keywords = list(_DEFAULT_BLOCKLIST)

bad_checker-0.1.0/src/bad_checker.egg-info/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.4
+Name: bad-checker
+Version: 0.1.0
+Summary: A typo-tolerant blocklist checker.
+Author-email: coder5330 <hello@jldev.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# bad-checker
+
+A fuzzy, keyboard-typo- and leetspeak-aware content blocklist for Python.
+
+Install name: `bad-checker` &nbsp;|&nbsp; Import name: `bad`
+
+## Usage
+
+```python
+import bad
+
+if "something bad" in bad:
+    print("Caught it!")
+```
+
+Matching combines:
+- direct substring lookups against a blocklist
+- leetspeak normalization (`v1agra` -> `viagra`, `fr33` -> `free`)
+- a keyboard-proximity-aware Damerau-Levenshtein distance, so typos on
+  physically nearby keys (and adjacent-letter transpositions) are caught
+  cheaply while unrelated words are not
+
+Add your own keywords at runtime:
+
+```python
+bad.add_keywords("mycompanyscam", "internaltermtoflag")
+```
+
+## Install
+
+```bash
+pip install bad-checker
+```
+
+## Build from source
+
+```bash
+pip install --upgrade build
+python -m build
+```
+
+## License
+
+MIT

bad_checker-0.1.0/src/bad_checker.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+README.md
+pyproject.toml
+src/bad/__init__.py
+src/bad_checker.egg-info/PKG-INFO
+src/bad_checker.egg-info/SOURCES.txt
+src/bad_checker.egg-info/dependency_links.txt
+src/bad_checker.egg-info/top_level.txt

bad_checker-0.1.0/src/bad_checker.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bad_checker-0.1.0/src/bad_checker.egg-info/top_level.txt

@@ -0,0 +1 @@
+bad