hungerlib 2.19.dev1__tar.gz → 3.0__tar.gz

{hungerlib-2.19.dev1/src/hungerlib.egg-info → hungerlib-3.0}/PKG-INFO

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

{hungerlib-2.19.dev1 → hungerlib-3.0}/pyproject.toml

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

hungerlib-3.0/src/hungerlib/__init__.py

@@ -0,0 +1,101 @@
+from importlib.metadata import version as _pkg_version, PackageNotFoundError
+from types import SimpleNamespace
+
+# package version
+try:
+    __version__ = _pkg_version('hungerlib')
+except PackageNotFoundError:
+    __version__ = '0.0.0'
+
+# modules
+from .configloader import loadConfig
+from .datamap import set_default_maps, get_default_maps, Syntax, DataMap, datamap, mapit
+from .messagerouter import MessageRouter
+from .panel import Panel
+from .servers import GenericServer, MinecraftServer
+from .utils import (
+    ColorMap,
+    ASCII_COLOR_MAP,
+    MC_COLOR_MAP,
+    snapSchedule,
+    runCountdownEvents,
+    waitForOnline,
+    waitForOffline,
+    secsUntil,
+    minsUntil,
+    Snapshot,
+    clearTerminal,
+    validateAll,
+)
+
+# namespaces
+utils = SimpleNamespace(
+    ColorMap = ColorMap,
+    ASCII_COLOR_MAP = ASCII_COLOR_MAP,
+    MC_COLOR_MAP = MC_COLOR_MAP,
+    snapSchedule = snapSchedule,
+    runCountdownEvents = runCountdownEvents,
+    waitForOnline = waitForOnline,
+    waitForOffline = waitForOffline,
+    secsUntil = secsUntil,
+    minsUntil = minsUntil,
+    Snapshot = Snapshot,
+    clearTerminal = clearTerminal,
+    validateAll = validateAll,
+)
+
+servers = SimpleNamespace(
+    Panel = Panel,
+    Generic = GenericServer,
+    Minecraft = MinecraftServer,
+)
+
+datamap_api = SimpleNamespace(
+    set_default_maps = set_default_maps,
+    get_default_maps = get_default_maps,
+    Syntax = Syntax,
+    DataMap = DataMap,
+    decorator = datamap,
+    mapit = mapit,
+
+    braces = Syntax.braces,
+    dollars = Syntax.dollars,
+    angles = Syntax.angles,
+    percents = Syntax.percents,
+)
+
+
+
+__all__ = [
+    '__version__',
+
+    # modules
+    'loadConfig',
+    'MessageRouter',
+    'Panel',
+    'set_default_maps',
+    'get_default_maps',
+    'Syntax',
+    'DataMap',
+    'datamap',
+    'mapit',
+    'GenericServer',
+    'MinecraftServer',
+    'ColorMap',
+    'ASCII_COLOR_MAP',
+    'MC_COLOR_MAP',
+    'snapSchedule',
+    'runCountdownEvents',
+    'waitForOnline',
+    'waitForOffline',
+    'secsUntil',
+    'minsUntil',
+    'Snapshot',
+    'clearTerminal',
+    'validateAll',
+
+    # namespaces
+    'utils',
+    'servers',
+    'datamap_api',
+]

{hungerlib-2.19.dev1 → hungerlib-3.0}/src/hungerlib/api/backups.py

@@ -1,8 +1,4 @@
 class BackupsAPI:
-    """
-    Raw backups endpoints.
-    """
-
     def __init__(self, panel):
         self.panel = panel
 
@@ -16,11 +12,7 @@ class BackupsAPI:
         )
 
     def delete(self, server_id, backup_id):
-        return self.panel.delete(
-            f"/api/client/servers/{server_id}/backups/{backup_id}"
-        )
+        return self.panel.delete(f"/api/client/servers/{server_id}/backups/{backup_id}")
 
     def download(self, server_id, backup_id):
-        return self.panel.get(
-            f"/api/client/servers/{server_id}/backups/{backup_id}/download"
-        )
+        return self.panel.get(f"/api/client/servers/{server_id}/backups/{backup_id}/download")

{hungerlib-2.19.dev1 → hungerlib-3.0}/src/hungerlib/api/command.py

@@ -1,10 +1,4 @@
-# src/hungerlib/api/command.py
-
 class CommandAPI:
-    """
-    Raw command endpoint.
-    """
-
     def __init__(self, panel):
         self.panel = panel
 

{hungerlib-2.19.dev1 → hungerlib-3.0}/src/hungerlib/api/databases.py

@@ -1,8 +1,4 @@
 class DatabasesAPI:
-    """
-    Raw database endpoints.
-    """
-
     def __init__(self, panel):
         self.panel = panel
 
@@ -19,11 +15,7 @@ class DatabasesAPI:
         )
 
     def rotate_password(self, server_id, db_id):
-        return self.panel.post(
-            f"/api/client/servers/{server_id}/databases/{db_id}/rotate-password"
-        )
+        return self.panel.post(f"/api/client/servers/{server_id}/databases/{db_id}/rotate-password")
 
     def delete(self, server_id, db_id):
-        return self.panel.delete(
-            f"/api/client/servers/{server_id}/databases/{db_id}"
-        )
+        return self.panel.delete(f"/api/client/servers/{server_id}/databases/{db_id}")

{hungerlib-2.19.dev1 → hungerlib-3.0}/src/hungerlib/api/filemanager.py

@@ -1,20 +1,12 @@
 class FileManagerAPI:
-    """
-    Raw file manager endpoints.
-    """
-
     def __init__(self, panel):
         self.panel = panel
 
     def list(self, server_id, directory="/"):
-        return self.panel.get(
-            f"/api/client/servers/{server_id}/files/list?directory={directory}"
-        )
+        return self.panel.get(f"/api/client/servers/{server_id}/files/list?directory={directory}")
 
     def download(self, server_id, file_path):
-        return self.panel.get(
-            f"/api/client/servers/{server_id}/files/download?file={file_path}"
-        )
+        return self.panel.get(f"/api/client/servers/{server_id}/files/download?file={file_path}")
 
     def upload(self, server_id, directory, file_data):
         return self.panel._raw_upload(

{hungerlib-2.19.dev1 → hungerlib-3.0}/src/hungerlib/api/schedule.py

@@ -1,9 +1,4 @@
 class ScheduleAPI:
-    """
-    Raw schedule endpoints.
-    No logic. No models. No convenience.
-    """
-
     def __init__(self, panel):
         self.panel = panel
 
@@ -14,7 +9,6 @@ class ScheduleAPI:
         return self.panel.post(f"/api/client/servers/{server_id}/schedules", json=payload)
 
     def update(self, server_id, schedule_id, payload):
-        # Your panel uses POST for full updates
         return self.panel.post(
             f"/api/client/servers/{server_id}/schedules/{schedule_id}",
             json=payload
@@ -24,6 +18,4 @@ class ScheduleAPI:
         return self.panel.delete(f"/api/client/servers/{server_id}/schedules/{schedule_id}")
 
     def run(self, server_id, schedule_id):
-        return self.panel.post(
-            f"/api/client/servers/{server_id}/schedules/{schedule_id}/execute"
-        )
+        return self.panel.post(f"/api/client/servers/{server_id}/schedules/{schedule_id}/execute")

{hungerlib-2.19.dev1 → hungerlib-3.0}/src/hungerlib/api/startup.py

@@ -1,8 +1,4 @@
 class StartupAPI:
-    """
-    Raw startup variable endpoints.
-    """
-
     def __init__(self, panel):
         self.panel = panel
 

{hungerlib-2.19.dev1/src/hungerlib/addons → hungerlib-3.0/src/hungerlib}/configloader.py

@@ -1,3 +1,4 @@
+import inspect
 import os
 import yaml
 import importlib
@@ -50,7 +51,7 @@ def loadConfig(path, default_path, schema):
 
     raw = load_yaml(abs_path)
 
-    cfg = schema()  # empty dataclass instance
+    values = {}
 
     for f in fields(schema):
         yaml_path = f.metadata.get("yaml_key")
@@ -61,7 +62,6 @@ def loadConfig(path, default_path, schema):
         if value is None:
             continue
 
-        target, attr = ensure_nested(cfg, f.name)
-        setattr(target, attr, value)
+        values[f.name] = value
 
-    return cfg
+    return schema(**values)

hungerlib-3.0/src/hungerlib/datamap.py

@@ -0,0 +1,87 @@
+import re
+import inspect
+import sys
+from dataclasses import dataclass, fields, is_dataclass
+
+# default maps
+_default_maps = []
+
+def set_default_maps(*maps):
+    global _default_maps
+    _default_maps = list(maps)
+
+def get_default_maps():
+    return _default_maps
+
+# syntax patterns
+class Syntax:
+    braces   = r"\{([^{}]+)\}"
+    dollars  = r"\$\{([^{}]+)\}"
+    angles   = r"<([^<>]+)>"
+    percents = r"%([^%]+)%"
+
+# base datamap
+@dataclass(frozen=True)
+class DataMap:
+    __syntax__: str = Syntax.braces
+    def as_map(self):
+        return {
+            f.name: getattr(self, f.name)
+            for f in fields(self)
+            if f.init and f.name != "__syntax__"
+        }
+    @classmethod
+    def get_syntax(cls):
+        return getattr(cls, "__syntax__", Syntax.braces)
+
+# decorator
+def datamap(_cls=None, *, syntax=Syntax.braces):
+    def wrap(cls):
+        cls.__syntax__ = syntax
+        cls = type(cls.__name__, (DataMap,), dict(cls.__dict__))
+        return dataclass(frozen=True)(cls)
+
+    return wrap if _cls is None else wrap(_cls)
+
+datamap.braces = datamap(syntax=Syntax.braces)
+datamap.angles = datamap(syntax=Syntax.angles)
+datamap.dollars = datamap(syntax=Syntax.dollars)
+datamap.percents = datamap(syntax=Syntax.percents)
+
+# core templating
+def mapit(text: str, *maps, **runtime):
+    maps = (*get_default_maps(), *maps)
+    for m in maps:
+        if isinstance(m, type) and is_dataclass(m):
+            m = m()
+        if is_dataclass(m):
+            pattern = m.get_syntax()
+            d = m.as_map()
+        elif hasattr(m, "as_dict"):
+            pattern = Syntax.angles
+            d = m.as_dict()
+        elif isinstance(m, dict):
+            pattern = runtime.get("syntax")
+            if not pattern:
+                continue
+            d = m
+        else:
+            continue
+
+        def repl(match):
+            k = match.group(1)
+            return str(d.get(k, match.group(0)))
+
+        text = re.sub(pattern, repl, text)
+
+    if runtime:
+        pattern = Syntax.braces
+        d = runtime
+
+        def repl(match):
+            k = match.group(1)
+            return str(d.get(k, match.group(0)))
+
+        text = re.sub(pattern, repl, text)
+
+    return text

hungerlib-3.0/src/hungerlib/messagerouter.py

@@ -0,0 +1,148 @@
+import inspect
+import logging
+from pathlib import Path
+from datetime import datetime
+from hungerlib.utils.colormaps import ASCII_COLOR_MAP, MC_COLOR_MAP
+from hungerlib.datamap import DataMap, Syntax, mapit
+
+
+class MessageRouter:
+    def __init__(
+        self,
+        name,
+        server,
+        log_path,
+        formatter=None,
+        console_backspaces=0,
+
+        origin_map=ASCII_COLOR_MAP,
+        destination_map=ASCII_COLOR_MAP,
+        broadcast_map=MC_COLOR_MAP,
+        log_map=None,
+
+        info_prefix="<white>[INFO]: ",
+        warn_prefix="<yellow>[WARN]: ",
+        error_prefix="<red>[ERROR]: "
+    ):
+        self.name = name
+        self.server = server
+        self.formatter = formatter
+
+        self.log_path = Path(log_path)
+        self.log_path.mkdir(parents=True, exist_ok=True)
+
+        self.console_backspaces = "\b" * console_backspaces
+
+        self._origin_map = origin_map
+        self._destination_map = destination_map
+        self._broadcast_map = broadcast_map
+        self._log_map = log_map
+
+        self.info_prefix = info_prefix
+        self.warn_prefix = warn_prefix
+        self.error_prefix = error_prefix
+
+        self.logger = logging.getLogger(name)
+        self.logger.setLevel(logging.DEBUG)
+        self._init_file_logger()
+
+    def _init_file_logger(self):
+        log_file = self.log_path / f"{self.name}_{datetime.now().strftime('%Y-%m-%d')}.log"
+        if not self.logger.handlers:
+            handler = logging.FileHandler(str(log_file))
+            formatter = logging.Formatter(
+                "[%(asctime)s] [%(levelname)s] %(message)s",
+                datefmt="%H:%M:%S"
+            )
+            handler.setFormatter(formatter)
+            self.logger.addHandler(handler)
+
+    # colormap getters/setters
+    def setOriginMap(self, cmap): self._origin_map = cmap
+    def getOriginMap(self): return self._origin_map
+
+    def setDestinationMap(self, cmap): self._destination_map = cmap
+    def getDestinationMap(self): return self._destination_map
+
+    def setBroadcastMap(self, cmap): self._broadcast_map = cmap
+    def getBroadcastMap(self): return self._broadcast_map
+
+    def setLogMap(self, cmap): self._log_map = cmap
+    def getLogMap(self): return self._log_map
+
+    # routing primatives
+    def origin(self, msg):
+        colored = mapit(msg, self._origin_map)
+        print(colored)
+
+    def destination(self, msg):
+        if not self.server or not hasattr(self.server, "_rcon_send"):
+            return
+        colored = mapit(msg, self._destination_map)
+        self.server._rcon_send(
+            f'logtellraw targetless "{self.console_backspaces}{colored}"'
+        )
+
+    def log(self, msg, level="INFO"):
+        clean = msg
+        if self._log_map:
+            for tag in self._log_map.as_dict().keys():
+                clean = clean.replace(tag, "")
+        {
+            "INFO": self.logger.info,
+            "WARN": self.logger.warning,
+            "ERROR": self.logger.error
+        }[level](clean)
+
+    def broadcast(self, msg):
+        if hasattr(self.server, "sendBroadcast"):
+            colored = mapit(msg, self._broadcast_map)
+            self.server.sendBroadcast(colored)
+
+    # high level router
+    def say(
+        self,
+        template,
+        level="info",
+        destination=False,
+        broadcast=False,
+        log=True,
+        origin=True,
+        **fmt
+    ):
+        if not template:
+            return
+
+        if level == "info":
+            template = self.info_prefix + template
+        elif level == "warn":
+            template = self.warn_prefix + template
+        elif level == "error":
+            template = self.error_prefix + template
+
+        if self.formatter:
+            msg = self.formatter(template, **fmt)
+        else:
+            msg = template
+
+        if origin:
+            self.origin(msg)
+
+        if destination:
+            self.destination(msg)
+
+        if log:
+            self.log(msg, level=level.upper())
+
+        if broadcast:
+            self.broadcast(msg)
+
+    # level helpers
+    def info(self, template, **fmt):
+        self.say(self.info_prefix + template, level="info", **fmt)
+
+    def warn(self, template, **fmt):
+        self.say(self.warn_prefix + template, level="warn", **fmt)
+
+    def error(self, template, **fmt):
+        self.say(self.error_prefix + template, level="error", **fmt)

{hungerlib-2.19.dev1 → hungerlib-3.0}/src/hungerlib/panel.py

@@ -1,11 +1,7 @@
+import inspect
 import requests
 
-from hungerlib.api import CommandAPI
-from hungerlib.api import ScheduleAPI
-from hungerlib.api import FileManagerAPI
-from hungerlib.api import BackupsAPI
-from hungerlib.api import DatabasesAPI
-from hungerlib.api import StartupAPI
+from hungerlib.api import CommandAPI, ScheduleAPI, FileManagerAPI, BackupsAPI, DatabasesAPI, StartupAPI
 
 
 class Panel:

{hungerlib-2.19.dev1 → hungerlib-3.0}/src/hungerlib/servers/__init__.py

@@ -4,4 +4,4 @@ from .minecraft import MinecraftServer
 __all__ = [
     "GenericServer",
     "MinecraftServer",
-]
+]

{hungerlib-2.19.dev1 → hungerlib-3.0}/src/hungerlib/servers/generic.py

@@ -1,6 +1,6 @@
 # Universal server class
-from hungerlib import Panel
-from hungerlib.addons import MC_COLOR_MAP, ASCII_COLOR_MAP
+from hungerlib.panel import Panel
+from hungerlib.utils.colormaps import MC_COLOR_MAP, ASCII_COLOR_MAP
 
 
 class GenericServer:
@@ -187,10 +187,6 @@ class GenericServer:
 
 
     def getSchedule(self, schedule_id: int):
-        """
-        Returns a dict containing all schedule attributes for the given schedule_id.
-        Works with raw ScheduleAPI responses.
-        """
         resp = self.panel.schedules.list(self.server_id)
         data = resp.json()
         for item in data.get("data", []):

{hungerlib-2.19.dev1 → hungerlib-3.0}/src/hungerlib/servers/minecraft.py

@@ -1,10 +1,9 @@
-# Minecraft server class
 import time
 import re
 import mcrcon
-from hungerlib import Panel
+from hungerlib.panel import Panel
+from hungerlib.utils.colormaps import MC_COLOR_MAP, ASCII_COLOR_MAP
 from hungerlib.servers import GenericServer
-from hungerlib.addons import MC_COLOR_MAP, ASCII_COLOR_MAP
 
 
 class MinecraftServer(GenericServer):

hungerlib-3.0/src/hungerlib/utils/__init__.py

@@ -0,0 +1,25 @@
+from .colormaps import ColorMap, ASCII_COLOR_MAP, MC_COLOR_MAP
+from .time import (
+    snapSchedule,
+    runCountdownEvents,
+    waitForOnline,
+    waitForOffline,
+    secsUntil,
+    minsUntil
+)
+from .utils import Snapshot, clearTerminal, validateAll
+
+__all__ = [
+    'ColorMap',
+    'ASCII_COLOR_MAP',
+    'MC_COLOR_MAP',
+    'snapSchedule',
+    'runCountdownEvents',
+    'waitForOnline',
+    'waitForOffline',
+    'secsUntil',
+    'minsUntil',
+    'Snapshot',
+    'clearTerminal',
+    'validateAll',
+]

hungerlib-3.0/src/hungerlib/utils/colormaps.py

@@ -0,0 +1,52 @@
+from hungerlib.datamap import datamap, Syntax, mapit, set_default_maps
+
+@datamap(syntax=Syntax.angles) # produces <>
+class ColorMap:
+    black: str = "\033[30m"
+    dark_blue: str = "\033[34m"
+    dark_green: str = "\033[32m"
+    dark_aqua: str = "\033[36m"
+    dark_red: str = "\033[31m"
+    dark_purple: str = "\033[35m"
+    gold: str = "\033[33m"
+    gray: str = "\033[37m"
+    dark_gray: str = "\033[90m"
+    blue: str = "\033[94m"
+    green: str = "\033[92m"
+    aqua: str = "\033[96m"
+    red: str = "\033[91m"
+    light_purple: str = "\033[95m"
+    yellow: str = "\033[93m"
+    white: str = "\033[97m"
+    reset: str = "\033[0m"
+    bold: str = "\033[1m"
+    italic: str = "\033[3m"
+
+    def as_dict(self):
+        return {f"<{k}>": getattr(self, k) for k in self.__dataclass_fields__}
+
+# ASCII color map
+ASCII_COLOR_MAP = ColorMap()
+
+# Minecraft color map
+MC_COLOR_MAP = ColorMap(
+    black="§0",
+    dark_blue="§1",
+    dark_green="§2",
+    dark_aqua="§3",
+    dark_red="§4",
+    dark_purple="§5",
+    gold="§6",
+    gray="§7",
+    dark_gray="§8",
+    blue="§9",
+    green="§a",
+    aqua="§b",
+    red="§c",
+    light_purple="§d",
+    yellow="§e",
+    white="§f",
+    reset="§r",
+    bold="§l",
+    italic="§o"
+)

hungerlib-2.19.dev1/src/hungerlib/addons/scheduler.py → hungerlib-3.0/src/hungerlib/utils/time.py

@@ -21,33 +21,12 @@ def snapSchedule(minimumMinutes=30, snapMinutes=(0, 30)):
         "formatted": scheduled.strftime("%I:%M %p")
     }
 
-
 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 {}
@@ -78,13 +57,7 @@ def runCountdownEvents(
 
         time.sleep(tick_interval)
 
-
-
 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():
@@ -93,12 +66,7 @@ def waitForOnline(server, timeout=60, interval=2):
         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():
@@ -107,13 +75,10 @@ def waitForOffline(server, timeout=60, interval=2):
         elapsed += interval
     return False
 
-
-
 def secsUntil(target):
     now = datetime.now()
     return int((target - now).total_seconds())
 
-
 def minsUntil(target):
     now = datetime.now()
     return int((target - now).total_seconds()) // 60

hungerlib-2.19.dev1/src/hungerlib/addons/snapshot.py → hungerlib-3.0/src/hungerlib/utils/utils.py

@@ -1,3 +1,5 @@
+import os
+
 class Snapshot:
     def __init__(self, Server, rounding=2, gb=False):
         self.Server = Server
@@ -28,4 +30,14 @@ class Snapshot:
         if self.players is not None:
             base += f'\nOnline players: {self.players}'
 
-        return base
+        return base
+
+def clearTerminal():
+    os.system("clear" if os.name == "posix" else "cls")
+
+def validateAll(panel, server):
+    return (
+        panel.ping() is True and
+        panel.validateAPI() is True and
+        server.getStatus() == "running"
+    )

{hungerlib-2.19.dev1 → hungerlib-3.0/src/hungerlib.egg-info}/PKG-INFO

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

{hungerlib-2.19.dev1 → hungerlib-3.0}/src/hungerlib.egg-info/SOURCES.txt

@@ -2,20 +2,15 @@ LICENSE
 README.md
 pyproject.toml
 src/hungerlib/__init__.py
-src/hungerlib/logger.py
+src/hungerlib/configloader.py
+src/hungerlib/datamap.py
+src/hungerlib/messagerouter.py
 src/hungerlib/panel.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/__init__.py
-src/hungerlib/addons/colormap.py
-src/hungerlib/addons/configloader.py
-src/hungerlib/addons/mchelpers.py
-src/hungerlib/addons/scheduler.py
-src/hungerlib/addons/snapshot.py
-src/hungerlib/addons/utils.py
 src/hungerlib/api/__init__.py
 src/hungerlib/api/backups.py
 src/hungerlib/api/command.py
@@ -25,4 +20,8 @@ src/hungerlib/api/schedule.py
 src/hungerlib/api/startup.py
 src/hungerlib/servers/__init__.py
 src/hungerlib/servers/generic.py
-src/hungerlib/servers/minecraft.py
+src/hungerlib/servers/minecraft.py
+src/hungerlib/utils/__init__.py
+src/hungerlib/utils/colormaps.py
+src/hungerlib/utils/time.py
+src/hungerlib/utils/utils.py

hungerlib-2.19.dev1/src/hungerlib/__init__.py

@@ -1,33 +0,0 @@
-from importlib.metadata import version as _pkg_version, PackageNotFoundError
-
-# Package version
-try:
-    __version__ = _pkg_version("hungerlib")
-except PackageNotFoundError:
-    __version__ = "0.0.0"
-
-# --- Core modules ---
-from .panel import Panel
-from .logger import HungerLogger
-
-# --- API endpoints ---
-from .api.schedule import ScheduleAPI
-from .api.filemanager import FileManagerAPI
-from .api.backups import BackupsAPI
-from .api.databases import DatabasesAPI
-from .api.startup import StartupAPI
-
-__all__ = [
-    "__version__",
-
-    # core utilities
-    "Panel",
-    "HungerLogger",
-
-    # API endpoints
-    "ScheduleAPI",
-    "FileManagerAPI",
-    "BackupsAPI",
-    "DatabasesAPI",
-    "StartupAPI",
-]

hungerlib-2.19.dev1/src/hungerlib/addons/__init__.py

@@ -1,29 +0,0 @@
-from .colormap import *
-from .snapshot import Snapshot
-from .scheduler import *
-from .utils import *
-from .configloader import *
-
-__all__ = [
-    'ColorMap',
-    'MC_COLOR_MAP',
-    'ASCII_COLOR_MAP',
-    'runCountdownEvents',
-    'waitForOnline',
-    'waitForOffline',
-    'Snapshot',
-    'snapSchedule',
-    'secsUntil',
-    'minsUntil',
-    'validateAll',
-    'mb_gb',
-    'gb_mb',
-    'mib_gib',
-    'gib_mib',
-    'clearTerminal',
-    'load_yaml',
-    'loadConfig',
-    'clrz',
-    'set_default_colormap',
-    'get_default_colormap',
-]

hungerlib-2.19.dev1/src/hungerlib/addons/colormap.py

@@ -1,96 +0,0 @@
-# Environment-based color translation and mapping
-from dataclasses import dataclass, field
-
-
-@dataclass(frozen=True)
-class ColorMap:
-    black: str
-    dark_blue: str
-    dark_green: str
-    dark_aqua: str
-    dark_red: str
-    dark_purple: str
-    gold: str
-    gray: str
-    dark_gray: str
-    blue: str
-    green: str
-    aqua: str
-    red: str
-    light_purple: str
-    yellow: str
-    white: str
-    reset: str
-    bold: str
-    italic: str
-
-    def as_dict(self):
-        """Convert dataclass to dict with <tags> as keys."""
-        return {
-            f"<{field}>": getattr(self, field)
-            for field in self.__dataclass_fields__
-        }
-
-
-MC_COLOR_MAP = ColorMap(
-    black="§0",
-    dark_blue="§1",
-    dark_green="§2",
-    dark_aqua="§3",
-    dark_red="§4",
-    dark_purple="§5",
-    gold="§6",
-    gray="§7",
-    dark_gray="§8",
-    blue="§9",
-    green="§a",
-    aqua="§b",
-    red="§c",
-    light_purple="§d",
-    yellow="§e",
-    white="§f",
-    reset="§r",
-    bold="§l",
-    italic="§o"
-)
-
-ASCII_COLOR_MAP = ColorMap(
-    black="\033[30m",
-    dark_blue="\033[34m",
-    dark_green="\033[32m",
-    dark_aqua="\033[36m",
-    dark_red="\033[31m",
-    dark_purple="\033[35m",
-    gold="\033[33m",
-    gray="\033[37m",
-    dark_gray="\033[90m",
-    blue="\033[94m",
-    green="\033[92m",
-    aqua="\033[96m",
-    red="\033[91m",
-    light_purple="\033[95m",
-    yellow="\033[93m",
-    white="\033[97m",
-    reset="\033[0m",
-    bold="\033[1m",
-    italic="\033[3m"
-)
-
-_DEFAULT_COLORMAP = ASCII_COLOR_MAP
-
-def set_default_colormap(cmap):
-    global _DEFAULT_COLORMAP
-    _DEFAULT_COLORMAP = cmap
-
-def get_default_colormap():
-    return _DEFAULT_COLORMAP
-
-def clrz(text: str, cmap=None):
-    if cmap is None:
-        cmap = get_default_colormap()
-    if hasattr(cmap, "as_dict"):
-        cmap = cmap.as_dict()
-    for tag, code in cmap.items():
-        text = text.replace(tag, code)
-    reset = cmap.get("<reset>", "")
-    return text + reset

hungerlib-2.19.dev1/src/hungerlib/addons/mchelpers.py

@@ -1,107 +0,0 @@
-# Minecraft-specific helper functions that operate on a MinecraftServer instance.
-
-class MCHelpers:
-    def __init__(self, server):
-        """
-        Helper utilities for a MinecraftServer instance.
-        """
-        self.server = server
-
-    def run(self, command):
-        """Send a raw RCON command."""
-        return self.server._rcon_send(command)
-
-    def tellraw(self, target, message):
-        """Send a tellraw message with color translation."""
-        translated = self.server._translate_mc_colors(message)
-        safe = translated.replace('"', '\\"')
-        cmd = f'tellraw {target} {{"text":"{safe}"}}'
-        return self.run(cmd)
-
-    def kick(self, player, message="Kicked"):
-        safe = message.replace('"', '\\"')
-        return self.run(f'kick {player} "{safe}"')
-
-    def kickAll(self, message="Server restarting"):
-        safe = message.replace('"', '\\"')
-        return self.run(f'kick @a "{safe}"')
-
-    def whitelistAdd(self, player):
-        return self.run(f"whitelist add {player}")
-
-    def whitelistRemove(self, player):
-        return self.run(f"whitelist remove {player}")
-
-    def whitelistList(self):
-        return self.run("whitelist list")
-
-    def runFunction(self, function_name):
-        """Run a datapack function."""
-        return self.run(f"function {function_name}")
-
-    def enableDatapack(self, name):
-        return self.run(f"datapack enable {name}")
-
-    def disableDatapack(self, name):
-        return self.run(f"datapack disable {name}")
-
-    def listDatapacks(self):
-        return self.run("datapack list")
-
-    # ============================================================
-    # GAMERULE HELPERS
-    # ============================================================
-
-    def setGamerule(self, rule, value):
-        return self.run(f"gamerule {rule} {value}")
-
-    def getGamerule(self, rule):
-        return self.run(f"gamerule {rule}")
-
-    # ============================================================
-    # SCOREBOARD HELPERS
-    # ============================================================
-
-    def scoreboardAddObjective(self, name, criteria="dummy", display_name=None):
-        if display_name:
-            safe = display_name.replace('"', '\\"')
-            return self.run(f'scoreboard objectives add {name} {criteria} "{safe}"')
-        return self.run(f"scoreboard objectives add {name} {criteria}")
-
-    def scoreboardRemoveObjective(self, name):
-        return self.run(f"scoreboard objectives remove {name}")
-
-    def scoreboardSetDisplay(self, slot, objective):
-        return self.run(f"scoreboard objectives setdisplay {slot} {objective}")
-
-    def scoreboardSet(self, player, objective, value):
-        return self.run(f"scoreboard players set {player} {objective} {value}")
-
-    def scoreboardAdd(self, player, objective, value):
-        return self.run(f"scoreboard players add {player} {objective} {value}")
-
-    def scoreboardGet(self, player, objective):
-        return self.run(f"scoreboard players get {player} {objective}")
-
-    # ============================================================
-    # TIME & WEATHER HELPERS
-    # ============================================================
-
-    def setTime(self, value):
-        return self.run(f"time set {value}")
-
-    def addTime(self, value):
-        return self.run(f"time add {value}")
-
-    def setWeather(self, weather, duration=None):
-        if duration:
-            return self.run(f"weather {weather} {duration}")
-        return self.run(f"weather {weather}")
-
-    # ============================================================
-    # BROADCAST HELPERS
-    # ============================================================
-
-    def broadcast(self, message):
-        """Broadcast using tellraw @a."""
-        return self.tellraw("@a", message)

hungerlib-2.19.dev1/src/hungerlib/addons/utils.py

@@ -1,26 +0,0 @@
-import os
-
-def mb_gb(mb, floor=False):
-    return mb / 1000 if not floor else mb // 1000
-
-def gb_mb(gb):
-    return gb * 1000
-
-def mib_gib(mib, floor=False):
-    return mib / 1024 if not floor else mib // 1024
-
-def gib_mib(gib):
-    return gib * 1024
-
-def clearTerminal():
-    os.system("clear" if os.name == "posix" else "cls")
-
-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"
-    )

hungerlib-2.19.dev1/src/hungerlib/logger.py

@@ -1,124 +0,0 @@
-# Logging system
-
-import os
-os.environ['TZ'] = 'America/Chicago'
-import time
-time.tzset()
-
-import logging
-from pathlib import Path
-from datetime import datetime
-from hungerlib.addons import ASCII_COLOR_MAP, MC_COLOR_MAP, clrz
-
-
-class HungerLogger:
-    def __init__(
-        self,
-        name,
-        server,
-        log_path,
-        log_destination_method='rcon',
-
-        # backspaces
-        console_backspaces=0,
-
-        # color mapping
-        file_color_map=None,
-        origin_color_map=ASCII_COLOR_MAP,
-        destination_color_map=ASCII_COLOR_MAP,
-
-        # prefixes
-        info_prefix='<white>[INFO]: ',
-        warn_prefix='<yellow>[WARN]: ',
-        error_prefix='<red>[ERROR]: '
-    ):
-
-        self.name = name
-        self.server = server
-        self.log_path = Path(f'{log_path}')
-        self.log_destination_method = log_destination_method
-
-        self.console_backspaces = '\b' * console_backspaces
-
-        self.file_color_map = file_color_map
-        self.origin_color_map = origin_color_map
-        self.destination_color_map = destination_color_map
-
-        self.info_prefix = info_prefix
-        self.warn_prefix = warn_prefix
-        self.error_prefix = error_prefix
-
-        self.prefixes = {
-            "INFO": self.info_prefix,
-            "WARN": self.warn_prefix,
-            "ERROR": self.error_prefix
-        }
-        
-        self.log_path.mkdir(parents=True, exist_ok=True)
-        self.logger = logging.getLogger(name)
-        self.logger.setLevel(logging.DEBUG)
-        self._initializeLogger()
-
-    def _initializeLogger(self):
-        logFile = self.log_path / f"{self.name}_{datetime.now().strftime('%Y-%m-%d')}.log"
-
-        if not self.logger.handlers:
-            handler = logging.FileHandler(str(logFile))
-            formatter = logging.Formatter(
-                "[%(asctime)s] [%(levelname)s] %(message)s",
-                datefmt="%H:%M:%S"
-            )
-            handler.setFormatter(formatter)
-            self.logger.addHandler(handler)
-
-        self.logger.info("Logger initialized.")
-
-    def _strip_colors(self, msg):
-        if not self.file_color_map:
-            return msg
-        for tag in self.file_color_map.as_dict().keys():
-            msg = msg.replace(tag, "")
-        return msg
-
-    def _destinationLog(self, msg):
-        if not self.server:
-            return
-        if not hasattr(self.server, "_rcon_send"):
-            return
-        colored = clrz(msg, cmap=self.destination_color_map)
-        if self.log_destination_method == 'rcon':
-            self.server._rcon_send(f'logtellraw targetless \"{self.console_backspaces}{colored}\"')
-        if self.log_destination_method == 'api':
-            self.server.sendConsoleCommand(f'logtellraw targetless \"{self.console_backspaces}{colored}\"')
-            
-
-    def _log(self, level, msg, destination, origin, logs):
-        prefix = self.prefixes[level] + f"[{self.name}] "
-        full = prefix + msg
-
-        if destination:
-            self._destinationLog(full)
-
-        if origin:
-            colored = clrz(full + "<reset>", cmap=self.origin_color_map)
-            print(colored)
-
-        if logs:
-            clean = self._strip_colors(full)
-            {
-                "INFO": self.logger.info,
-                "WARN": self.logger.warning,
-                "ERROR": self.logger.error
-            }[level](clean)
-
-    def info(self, msg, destination=False, origin=True, logs=True):
-        '''Log to the INFO channel'''
-        self._log("INFO", msg, destination, origin, logs)
-
-    def warn(self, msg, destination=False, origin=True, logs=True):
-        '''Log to the WARN channel'''
-        self._log("WARN", msg, destination, origin, logs)
-
-    def error(self, msg, destination=False, origin=True, logs=True):
-        '''Log to the ERROR channel'''
-        self._log("ERROR", msg, destination, origin, logs)