hungerlib 1.2.2b0__tar.gz → 1.3.1.dev0__tar.gz

{hungerlib-1.2.2b0/src/hungerlib.egg-info → hungerlib-1.3.1.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hungerlib
-Version: 1.2.2b0
+Version: 1.3.1.dev0
 Summary: Powerful automation library for Pterodactyl.
 Author: iFamished
 License: MIT

{hungerlib-1.2.2b0 → hungerlib-1.3.1.dev0}/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hungerlib"
-version = "1.2.2-beta"
+version = "1.3.1-dev"
 description = "Powerful automation library for Pterodactyl."
 readme = "README.md"
 requires-python = ">=3.10"

{hungerlib-1.2.2b0 → hungerlib-1.3.1.dev0}/src/hungerlib/__init__.py

@@ -10,14 +10,17 @@ except PackageNotFoundError:
 # api map
 # name > (module_path, attribute_name or None)
 _EXPORTS = {
-    # modules"
-    "colormap": ("colormap", None),
+    # modules
     "config": ("config", None),
     "logger": ("logger", None),
     "mchelpers": ("mchelpers", None),
     "panel": ("panel", None),
     "scheduler": ("scheduler", None),
-    "utils": ("utils", None),
+
+    # addon modules
+    "genericAddons": ('addons._generic', None),
+    'minecraftAddons': ('addons.minecraft', None),
+    "colormap": ("addons.colormap", None),
 
     # classes / functions
     "Panel": ("panel", "Panel"),
@@ -32,15 +35,14 @@ _EXPORTS = {
     "secsUntil": ("scheduler", "secsUntil"),
     "minsUntil": ("scheduler", "minsUntil"),
 
-    # color maps
-    "MC_COLOR_MAP": ("colormap", "MC_COLOR_MAP"),
-    "ASCI_COLOR_MAP": ("colormap", "ASCI_COLOR_MAP"),
-
-    # utils
-    "checkLag": ("utils", "checkLag"),
-    "validateAll": ("utils", 'validateAll'),
-    "waitForOnline": ("utils", 'waitForOnline'),
-    "waitForOffline": ("utils", 'waitForOffline')
+    # addons
+    "runCountdownEvents": ('addons._generic', 'runCountdownEvents'),
+    'validateAll': ('addons._generic', 'validateAll'),
+    "waitForOnline": ("addons._generic", 'waitForOnline'),
+    "waitForOffline": ("addons._generic", 'waitForOffline'),
+    'checkLag': ('addons.minecraft', 'checkLag'),
+    "MC_COLOR_MAP": ("addons.colormap", "MC_COLOR_MAP"),
+    "ASCI_COLOR_MAP": ("addons.colormap", "ASCI_COLOR_MAP")
 
 }
 

hungerlib-1.3.1.dev0/src/hungerlib/addons/_generic.py

@@ -0,0 +1,102 @@
+import time
+from datetime import datetime
+
+# Special use case helper functions that operate on server objects
+def runCountdownEvents(
+    target_time,
+    minute_callbacks=None,
+    second_callbacks=None,
+    tick_interval=1
+):
+    """
+    A simple, readable countdown engine.
+
+    - Counts down until `target_time`
+    - When the countdown hits a configured minute mark, it runs that callback
+    - When the countdown hits a configured second mark, it runs that callback
+
+    Parameters:
+        target_time (datetime):
+            The time we are counting down to.
+
+        minute_callbacks (dict[int, callable]):
+            Example: {5: func, 1: func}
+
+        second_callbacks (dict[int, callable]):
+            Example: {10: func, 5: func, 1: func}
+
+        tick_interval (int):
+            How often to check the countdown (in seconds).
+    """
+
+    # Default to empty dicts if none provided
+    minute_callbacks = minute_callbacks or {}
+    second_callbacks = second_callbacks or {}
+
+    # Track which events we've already fired
+    fired_minutes = set()
+    fired_seconds = set()
+
+    while True:
+        now = datetime.now()
+        seconds_left = int((target_time - now).total_seconds())
+        minutes_left = seconds_left // 60
+
+        # Countdown finished
+        if seconds_left <= 0:
+            return
+
+        # Fire minute-based events
+        if minutes_left in minute_callbacks and minutes_left not in fired_minutes:
+            fired_minutes.add(minutes_left)
+            minute_callbacks[minutes_left]()
+
+        # Fire second-based events
+        if seconds_left in second_callbacks and seconds_left not in fired_seconds:
+            fired_seconds.add(seconds_left)
+            second_callbacks[seconds_left]()
+
+        time.sleep(tick_interval)
+
+
+def validateAll(panel, server):
+    """
+    Validate panel connectivity, API access, and server running state.
+    """
+    return (
+        panel.ping() is True and
+        panel.validateAPI() is True and
+        server.getStatus() == "running"
+    )
+
+
+# ============================================================
+# SERVER STATE HELPERS
+# ============================================================
+
+def waitForOnline(server, timeout=60, interval=2):
+    """
+    Wait until the server reports status 'running'.
+    Returns True if online before timeout.
+    """
+    elapsed = 0
+    while elapsed < timeout:
+        if server.isOnline():
+            return True
+        time.sleep(interval)
+        elapsed += interval
+    return False
+
+
+def waitForOffline(server, timeout=60, interval=2):
+    """
+    Wait until the server reports status 'offline'.
+    Returns True if offline before timeout.
+    """
+    elapsed = 0
+    while elapsed < timeout:
+        if server.isOffline():
+            return True
+        time.sleep(interval)
+        elapsed += interval
+    return False

hungerlib-1.3.1.dev0/src/hungerlib/addons/minecraft.py

@@ -0,0 +1,25 @@
+def checkLag(server, ram, cpu, nwi, nwo, tps):
+    """
+    Pure lag check.
+    Returns a tuple: (lag_detected: bool, reasons: list[str])
+    """
+    reasons = []
+
+    currentRAM = server.getRAM(gb=True)
+    currentCPU = server.getCPU()
+    currentNWI = server.getNetworkIn(gb=True)
+    currentNWO = server.getNetworkOut(gb=True)
+    currentTPS = server.getTPS() if hasattr(server, "getTPS") else None
+
+    if currentRAM is not None and currentRAM >= ram:
+        reasons.append(f"RAM: {currentRAM}GB")
+    if currentCPU is not None and currentCPU >= cpu:
+        reasons.append(f"CPU: {currentCPU}%")
+    if currentNWI is not None and currentNWI >= nwi:
+        reasons.append(f"Network Inbound: {currentNWI}GB")
+    if currentNWO is not None and currentNWO >= nwo:
+        reasons.append(f"Network Outbound: {currentNWO}GB")
+    if currentTPS is not None and currentTPS <= tps:
+        reasons.append(f"TPS: {currentTPS}")
+
+    return (len(reasons) > 0, reasons)

{hungerlib-1.2.2b0 → hungerlib-1.3.1.dev0/src/hungerlib.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hungerlib
-Version: 1.2.2b0
+Version: 1.3.1.dev0
 Summary: Powerful automation library for Pterodactyl.
 Author: iFamished
 License: MIT

{hungerlib-1.2.2b0 → hungerlib-1.3.1.dev0}/src/hungerlib.egg-info/SOURCES.txt

@@ -2,18 +2,19 @@ LICENSE
 README.md
 pyproject.toml
 src/hungerlib/__init__.py
-src/hungerlib/colormap.py
 src/hungerlib/config.py
 src/hungerlib/logger.py
 src/hungerlib/mchelpers.py
 src/hungerlib/panel.py
 src/hungerlib/scheduler.py
-src/hungerlib/utils.py
 src/hungerlib.egg-info/PKG-INFO
 src/hungerlib.egg-info/SOURCES.txt
 src/hungerlib.egg-info/dependency_links.txt
 src/hungerlib.egg-info/requires.txt
 src/hungerlib.egg-info/top_level.txt
+src/hungerlib/addons/_generic.py
+src/hungerlib/addons/colormap.py
+src/hungerlib/addons/minecraft.py
 src/hungerlib/servers/_generic.py
 src/hungerlib/servers/minecraft.py
 src/tests/test_imports.py

hungerlib-1.2.2b0/src/hungerlib/utils.py

@@ -1,72 +0,0 @@
-import time
-
-# Special use case helper functions that operate on server objects
-
-def checkLag(server, ram, cpu, nwi, nwo, tps):
-    """
-    Pure lag check.
-    Returns a tuple: (lag_detected: bool, reasons: list[str])
-    """
-    reasons = []
-
-    currentRAM = server.getRAM(gb=True)
-    currentCPU = server.getCPU()
-    currentNWI = server.getNetworkIn(gb=True)
-    currentNWO = server.getNetworkOut(gb=True)
-    currentTPS = server.getTPS() if hasattr(server, "getTPS") else None
-
-    if currentRAM is not None and currentRAM >= ram:
-        reasons.append(f"RAM: {currentRAM}GB")
-    if currentCPU is not None and currentCPU >= cpu:
-        reasons.append(f"CPU: {currentCPU}%")
-    if currentNWI is not None and currentNWI >= nwi:
-        reasons.append(f"Network Inbound: {currentNWI}GB")
-    if currentNWO is not None and currentNWO >= nwo:
-        reasons.append(f"Network Outbound: {currentNWO}GB")
-    if currentTPS is not None and currentTPS <= tps:
-        reasons.append(f"TPS: {currentTPS}")
-
-    return (len(reasons) > 0, reasons)
-
-
-def validateAll(panel, server):
-    """
-    Validate panel connectivity, API access, and server running state.
-    """
-    return (
-        panel.ping() is True and
-        panel.validateAPI() is True and
-        server.getStatus() == "running"
-    )
-
-
-# ============================================================
-# SERVER STATE HELPERS
-# ============================================================
-
-def waitForOnline(server, timeout=60, interval=2):
-    """
-    Wait until the server reports status 'running'.
-    Returns True if online before timeout.
-    """
-    elapsed = 0
-    while elapsed < timeout:
-        if server.isOnline():
-            return True
-        time.sleep(interval)
-        elapsed += interval
-    return False
-
-
-def waitForOffline(server, timeout=60, interval=2):
-    """
-    Wait until the server reports status 'offline'.
-    Returns True if offline before timeout.
-    """
-    elapsed = 0
-    while elapsed < timeout:
-        if server.isOffline():
-            return True
-        time.sleep(interval)
-        elapsed += interval
-    return False