hungerlib 2.3.5.dev0__py3-none-any.whl → 2.4.dev0__py3-none-any.whl

hungerlib/__init__.py

@@ -1,74 +1,33 @@
 from importlib.metadata import version as _pkg_version, PackageNotFoundError
-import importlib
 
+# Package version
 try:
     __version__ = _pkg_version("hungerlib")
 except PackageNotFoundError:
     __version__ = "0.0.0"
 
-
-# Public API map
-# name -> (module_path, attribute_name or None)
-_EXPORTS = {
-    # core modules
-    "panel": ("panel", None),
-    "config": ("config", None),
-    "logger": ("logger", None),
-    "scheduler": ('scheduler', None),
-
-    # core module utilities
-    "Panel": ('panel', 'Panel'),
-    'Config': ('config', 'Config'),
-    'HungerLogger': ('logger', 'HungerLogger'),
-    "snapSchedule": ("scheduler", "snapSchedule"),
-    "secsUntil": ("scheduler", "secsUntil"),
-    "minsUntil": ("scheduler", "minsUntil"),
-
-    # servers
-    "GenericServer": ("servers.generic", "GenericServer"),
-    "MinecraftServer": ("servers.minecraft", "MinecraftServer"),
-
-    # addons 
-    "genericAddons": ("addons.generic", None),
-    "minecraftAddons": ("addons.minecraft", None),
-    "colormap": ("addons.colormap", None),
-
-    # addon utilities
-    "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"),
-
-    # api endpoints
-    "ScheduleAPI": ("api.schedule", "ScheduleAPI"),
-    "FileManagerAPI": ("api.filemanager", "FileManagerAPI"),
-    "BackupsAPI": ("api.backups", "BackupsAPI"),
-    "DatabasesAPI": ("api.databases", "DatabasesAPI"),
-    "StartupAPI": ("api.startup", "StartupAPI")
-
-}
-
-
-__all__ = list(_EXPORTS.keys()) + ["__version__"]
-
-
-# Lazy loader
-def __getattr__(name):
-    if name not in _EXPORTS:
-        raise AttributeError(f"module 'hungerlib' has no attribute '{name}'")
-
-    module_name, attr = _EXPORTS[name]
-    module = importlib.import_module(f"hungerlib.{module_name}")
-
-    # Export module itself
-    if attr is None:
-        globals()[name] = module
-        return module
-
-    # Export attribute from module
-    value = getattr(module, attr)
-    globals()[name] = value
-    return value
+# --- 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/addons/__init__.py

@@ -0,0 +1,19 @@
+from .colormap import ColorMap, MC_COLOR_MAP, ASCII_COLOR_MAP
+from .countdown import runCountdownEvents, waitForOnline, waitForOffline
+from .lag import checkLag
+from .scheduler import snapSchedule, secsUntil, minsUntil
+from .validation import validateAll
+
+__all__ = [
+    'ColorMap',
+    'MC_COLOR_MAP',
+    'ASCII_COLOR_MAP',
+    'runCountdownEvents',
+    'waitForOnline',
+    'waitForOffline',
+    'checkLag',
+    'snapSchedule',
+    'secsUntil',
+    'minsUntil',
+    'validateAll',
+]

hungerlib/addons/colormap.py

@@ -1,44 +1,77 @@
 # Environment-based color translation and mapping
+from dataclasses import dataclass, field
 
-MC_COLOR_MAP = {
-    "<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"
-}
-ASCI_COLOR_MAP = {
-    "<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"
-}
+
+@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"
+)

hungerlib/addons/{generic.py → countdown.py}

@@ -59,15 +59,7 @@ def runCountdownEvents(
         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"
-    )
+
 
 
 # ============================================================

hungerlib/addons/validation.py

@@ -0,0 +1,9 @@
+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/logger.py

@@ -8,7 +8,7 @@ time.tzset()
 import logging
 from pathlib import Path
 from datetime import datetime
-from hungerlib.addons.colormap import ASCI_COLOR_MAP, MC_COLOR_MAP
+from hungerlib.addons import ASCII_COLOR_MAP, MC_COLOR_MAP
 
 
 class HungerLogger:
@@ -24,8 +24,8 @@ class HungerLogger:
 
         # color mapping
         file_color_map=None,
-        origin_color_map=ASCI_COLOR_MAP,
-        destination_color_map=ASCI_COLOR_MAP,
+        origin_color_map=ASCII_COLOR_MAP.as_dict(),
+        destination_color_map=ASCII_COLOR_MAP.as_dict(),
         mc_color_map=MC_COLOR_MAP,
 
         # prefixes

hungerlib/panel.py

@@ -1,11 +1,11 @@
 import requests
 
-from hungerlib.api.command import CommandAPI
-from hungerlib.api.schedule import ScheduleAPI
-from hungerlib.api.filemanager import FileManagerAPI
-from hungerlib.api.backups import BackupsAPI
-from hungerlib.api.databases import DatabasesAPI
-from hungerlib.api.startup import StartupAPI
+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
 
 
 class Panel:

hungerlib/servers/__init__.py

@@ -0,0 +1,7 @@
+from .generic import GenericServer
+from .minecraft import MinecraftServer
+
+__all__ = [
+    "GenericServer",
+    "MinecraftServer",
+]

hungerlib/servers/generic.py

@@ -1,5 +1,5 @@
 # Universal server class
-from hungerlib.panel import Panel
+from hungerlib import Panel
 
 
 class GenericServer:

hungerlib/servers/minecraft.py

@@ -2,8 +2,8 @@
 import time
 import re
 import mcrcon
-from hungerlib.panel import Panel
-from hungerlib.servers.generic import GenericServer
+from hungerlib import Panel
+from hungerlib.servers import GenericServer
 
 
 class MinecraftServer(GenericServer):

{hungerlib-2.3.5.dev0.dist-info → hungerlib-2.4.dev0.dist-info}/METADATA

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

hungerlib-2.4.dev0.dist-info/RECORD

@@ -0,0 +1,25 @@
+hungerlib/__init__.py,sha256=tgUaYt_H1BUKCvIGz0KHhgsDg6AMY9UiEGPBNHnq1kg,708
+hungerlib/logger.py,sha256=-2amipjJi2tLY5RwG0Poe0Mr2Tr_Sq5aFC0R574Zjqc,4140
+hungerlib/panel.py,sha256=WMKBVh9MUM1KEYbvYwLFVzLCMZW4Dopfcxs09FEvfhU,2123
+hungerlib/addons/__init__.py,sha256=LBvYij6tCS59E0p735CUw9FwIqdoDErOagVzepnBaEY,486
+hungerlib/addons/colormap.py,sha256=W06Y9Pd8jGiXUbCNyaCmh8_pN_40Gl04qO7yWulEarw,1508
+hungerlib/addons/countdown.py,sha256=fE922-W9VTTMMkeVKLQfuTR6CK0A4sHkrPSOU2tbXP0,2601
+hungerlib/addons/lag.py,sha256=Ch-E781HRcmCl9CNb3Wx2rg9NyMQ_30tTYLP2RPXONU,963
+hungerlib/addons/mchelpers.py,sha256=PuENTlzwPIBHymlmdynMK28CCy_l8x8yzJSzaguvMMM,3789
+hungerlib/addons/scheduler.py,sha256=40WcKF5Bc4Fmx-pviZuWA4GkNwrn8RP_TupA00SwD2A,890
+hungerlib/addons/validation.py,sha256=QKVrp-NriH9ZkMNwwjpPRvLQAbFtTd4N0Sq_yz63UUg,250
+hungerlib/api/__init__.py,sha256=xuPbWBXVTkr9Jtcmvk8PPiVvi8HDxrIOmb_gOcDZy-M,336
+hungerlib/api/backups.py,sha256=P_3b4_UPF7y9LDpfyKPh3TpHDIrTm8k_Z3xGmvBE5Qk,730
+hungerlib/api/command.py,sha256=OvqzEmqMbDFnlhecxzJ2z_NxVoybEHq94fcGAk383_0,328
+hungerlib/api/databases.py,sha256=xxPGMsqZQZ8eP0tSgNVB3i9m-3tdR5ws2aqbMmJDH2c,849
+hungerlib/api/filemanager.py,sha256=kB5NP3ELQzY1uW6JWVN1g4dekVl8Kk-u9cK7N5dsg3w,2050
+hungerlib/api/schedule.py,sha256=3gdl0jiIOScdVXWy4aOef-KIoKqUopbI8b1dPgXf5Vg,953
+hungerlib/api/startup.py,sha256=hKhBjpLMVYa3jjq6ahqm2N32B_fu-bZnOJTZ-P57v4M,434
+hungerlib/servers/__init__.py,sha256=iL2KajxhGHLdvGzEujTaEQmj1wvoHEB5f23YMu1gpyQ,133
+hungerlib/servers/generic.py,sha256=wZ7zphkzmK_Xto33ftWVgokn-Pz0FnK5Lp5cNVS5Yrc,6529
+hungerlib/servers/minecraft.py,sha256=DJ2GwJ4KLnZsxVN66YsCZgQfgMizcKp-9Tcdze23tfg,2541
+hungerlib-2.4.dev0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+hungerlib-2.4.dev0.dist-info/METADATA,sha256=HSRFFLfZOOOc8Yl0RSErOukkJH6nXxpiFPPkPSZQynE,1514
+hungerlib-2.4.dev0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+hungerlib-2.4.dev0.dist-info/top_level.txt,sha256=uHBMIM8b2Gt6daNkDF4uw-M2Hm2IpIVw1jOK9wC0fNQ,10
+hungerlib-2.4.dev0.dist-info/RECORD,,

{hungerlib-2.3.5.dev0.dist-info → hungerlib-2.4.dev0.dist-info}/top_level.txt

@@ -1,2 +1 @@
-examples
 hungerlib

examples/Config.py

@@ -1,24 +0,0 @@
-from hungerlib import Config, Panel
-from pathlib import Path
-from hungerlib.addons.colormap import ASCI_COLOR_MAP, MC_COLOR_MAP
-
-ExampleConfig = Config(
-
-    # Color maps
-    file_color_map=None,
-    origin_color_map=ASCI_COLOR_MAP.copy(),
-    destination_color_map=ASCI_COLOR_MAP.copy(),
-    mc_color_map=MC_COLOR_MAP.copy(),
-
-    
-    # --- Prefixes ---
-    info_prefix='<white>[INFO]: ',
-    warn_prefix='<yellow>[WARN]: ',
-    error_prefix='<red>[ERROR]: ',
-    console_backspaces=8,
-
-    # --- Logging ---
-    log_path=Path("/home/container/logs"),
-    log_destination_method='rcon',
-
-)

hungerlib/config.py

@@ -1,30 +0,0 @@
-# =====================================
-#         CORE CONFIG SYSTEM
-# =====================================
-# The variables in this file can be used to control many things in Hungerlib's functions.
-# It helps keep track of constants and serves as an easy-to-use configuration system.
-
-from dataclasses import dataclass, field
-from pathlib import Path
-from hungerlib.addons.colormap import *
-
-@dataclass
-class Config:
-
-    # Color maps
-    file_color_map: dict | None = None
-    origin_color_map: dict = field(default_factory=lambda: ASCI_COLOR_MAP.copy())
-    destination_color_map: dict = field(default_factory=lambda: ASCI_COLOR_MAP.copy())
-    mc_color_map: dict = field(default_factory=lambda: MC_COLOR_MAP.copy())
-
-    # Prefixes
-    info_prefix: str = '<white>[INFO]: '
-    warn_prefix: str = '<yellow>[WARN]: '
-    error_prefix: str = '<red>[ERROR]: '
-    console_backspaces: int = 8
-
-    # Logging
-    log_path: Path = Path("/home/container/logs")
-    log_destination_method: str = 'rcon'
-
-_internal_config = Config()

hungerlib-2.3.5.dev0.dist-info/RECORD

@@ -1,24 +0,0 @@
-examples/Config.py,sha256=3sgbcahc0H6PWcFV9WQ0Ykc_QayYYWWAt2EAzchKPso,591
-hungerlib/__init__.py,sha256=owBo4YCdX29GFuAXX1-kzbYYbeqGLDgryBDKjvChsDQ,2254
-hungerlib/config.py,sha256=NWEj4C8SetNOwQMXKuuPRQ0OWEe8S4M3QWmEI5OW8R8,1026
-hungerlib/logger.py,sha256=Gx8oegOjXzQAsXbTOV3pIZMXNMPROvUvc3nK1pPSDHc,4126
-hungerlib/mchelpers.py,sha256=PuENTlzwPIBHymlmdynMK28CCy_l8x8yzJSzaguvMMM,3789
-hungerlib/panel.py,sha256=H0B6Ohshombsz2w3dFjJTbOfyRgcO-l-DARRfo0PVqQ,2178
-hungerlib/scheduler.py,sha256=40WcKF5Bc4Fmx-pviZuWA4GkNwrn8RP_TupA00SwD2A,890
-hungerlib/addons/colormap.py,sha256=s3GGE2g6xfRTsJdGnevFJ9tyaY0pDpX8pnxvv013fl8,1072
-hungerlib/addons/generic.py,sha256=jUuoV7nlvApQBmtOkVbD2B5SkA2b2SUx5fGlpfZRT9Y,2851
-hungerlib/addons/minecraft.py,sha256=Ch-E781HRcmCl9CNb3Wx2rg9NyMQ_30tTYLP2RPXONU,963
-hungerlib/api/__init__.py,sha256=xuPbWBXVTkr9Jtcmvk8PPiVvi8HDxrIOmb_gOcDZy-M,336
-hungerlib/api/backups.py,sha256=P_3b4_UPF7y9LDpfyKPh3TpHDIrTm8k_Z3xGmvBE5Qk,730
-hungerlib/api/command.py,sha256=OvqzEmqMbDFnlhecxzJ2z_NxVoybEHq94fcGAk383_0,328
-hungerlib/api/databases.py,sha256=xxPGMsqZQZ8eP0tSgNVB3i9m-3tdR5ws2aqbMmJDH2c,849
-hungerlib/api/filemanager.py,sha256=kB5NP3ELQzY1uW6JWVN1g4dekVl8Kk-u9cK7N5dsg3w,2050
-hungerlib/api/schedule.py,sha256=3gdl0jiIOScdVXWy4aOef-KIoKqUopbI8b1dPgXf5Vg,953
-hungerlib/api/startup.py,sha256=hKhBjpLMVYa3jjq6ahqm2N32B_fu-bZnOJTZ-P57v4M,434
-hungerlib/servers/generic.py,sha256=PKVoxV9KI8Ep9Cv7pYj8gXcJXrfycMW7UeQphgmqp28,6535
-hungerlib/servers/minecraft.py,sha256=FPIaaelHtMulucD42fxnx4pXfc_TN0RPY2onv--zMQ8,2555
-hungerlib-2.3.5.dev0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-hungerlib-2.3.5.dev0.dist-info/METADATA,sha256=UPpJ2zqWtNRAj4PhegUxC3jUVdC0euQ0U204lFf9rH0,1516
-hungerlib-2.3.5.dev0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-hungerlib-2.3.5.dev0.dist-info/top_level.txt,sha256=-oFAkOTGMfuvp0CBu82Ltag3EZwIqb663p_fymgcaqI,19
-hungerlib-2.3.5.dev0.dist-info/RECORD,,