Initial parser admin implementation

src/vk_parser_app/text_utils.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+import re
+
+
+def normalize_hash_tag(value: str, fallback: str = "source") -> str:
+    tag = (value or "").strip().lstrip("#").lower()
+    tag = re.sub(r"\s+", "_", tag)
+    tag = re.sub(r"[^\wа-яё_]+", "_", tag, flags=re.IGNORECASE)
+    tag = re.sub(r"_+", "_", tag).strip("_")
+    return tag or fallback
+
+
+def parse_categories(value: object) -> list[str]:
+    if isinstance(value, list):
+        raw_items = [str(item) for item in value]
+    else:
+        text = str(value or "")
+        raw_items = re.split(r"[\n,|]+", text)
+    categories: list[str] = []
+    seen: set[str] = set()
+    for item in raw_items:
+        category = item.strip().strip("#")
+        key = category.lower()
+        if category and key not in seen:
+            categories.append(category)
+            seen.add(key)
+    return categories