hungerlib 3.0.dev5__tar.gz → 3.0.dev6__tar.gz

{hungerlib-3.0.dev5/src/hungerlib.egg-info → hungerlib-3.0.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hungerlib
-Version: 3.0.dev5
+Version: 3.0.dev6
 Summary: Powerful automation library for Pterodactyl.
 Author: iFamished
 License: MIT

{hungerlib-3.0.dev5 → hungerlib-3.0.dev6}/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hungerlib"
-version = "3.0.dev5"
+version = "3.0.dev6"
 description = "Powerful automation library for Pterodactyl."
 readme = "README.md"
 requires-python = ">=3.9"

{hungerlib-3.0.dev5 → hungerlib-3.0.dev6}/src/hungerlib/__init__.py

@@ -9,6 +9,7 @@ except PackageNotFoundError:
 # --- Core modules ---
 from .panel import Panel
 from .messagerouter import MessageRouter
+from .datamap import *
 
 # --- API endpoints ---
 from .api.schedule import ScheduleAPI
@@ -23,6 +24,9 @@ __all__ = [
     # core utilities
     "Panel",
     "MessageRouter",
+    "Syntax",
+    "DataMap",
+    "mapit",
 
     # API endpoints
     "ScheduleAPI",

hungerlib-3.0.dev6/src/hungerlib/datamap.py

@@ -0,0 +1,60 @@
+import re
+from dataclasses import dataclass, fields, is_dataclass
+
+
+class Syntax:
+    BRACES   = r"\{([^{}]+)\}"      # {key}
+    DOLLARS  = r"\$\{([^{}]+)\}"    # ${key}
+    ANGLES   = r"<([^<>]+)>"        # <key>
+    PERCENTS = r"%([^%]+)%"         # %key%
+
+
+@dataclass
+class DataMap:
+    __syntax__: str = Syntax.BRACES
+
+    def as_map(self) -> dict:
+        return {
+            f.name: getattr(self, f.name)
+            for f in fields(self)
+            if f.init and f.name != "__syntax__"
+        }
+
+    @classmethod
+    def syntax(cls) -> str:
+        return getattr(cls, "__syntax__", Syntax.BRACES)
+
+
+def mapit(text: str, *maps, **runtime) -> str:
+    for m in maps:
+        # auto-instantiate dataclass classes
+        if isinstance(m, type) and is_dataclass(m):
+            m = m()
+
+        # dataclass instance to dict
+        if is_dataclass(m):
+            pattern = m.syntax()
+            dmap = m.as_map()
+
+        # colormap-like objects to dict
+        elif hasattr(m, "as_dict"):
+            pattern = Syntax.ANGLES
+            dmap = m.as_dict()
+
+        # raw dict
+        elif isinstance(m, dict):
+            pattern = runtime.get("syntax", None)
+            if not pattern:
+                continue
+            dmap = m
+
+        else:
+            continue
+
+        # apply this map's syntax only
+        def repl(match):
+            key = match.group(1)
+            return str(dmap.get(key, match.group(0)))
+        text = re.sub(pattern, repl, text)
+
+    return text

{hungerlib-3.0.dev5 → hungerlib-3.0.dev6/src/hungerlib.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hungerlib
-Version: 3.0.dev5
+Version: 3.0.dev6
 Summary: Powerful automation library for Pterodactyl.
 Author: iFamished
 License: MIT

{hungerlib-3.0.dev5 → hungerlib-3.0.dev6}/src/hungerlib.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@ LICENSE
 README.md
 pyproject.toml
 src/hungerlib/__init__.py
+src/hungerlib/datamap.py
 src/hungerlib/messagerouter.py
 src/hungerlib/panel.py
 src/hungerlib.egg-info/PKG-INFO