hungerlib 4.23.dev9__tar.gz → 4.24.dev1__tar.gz

{hungerlib-4.23.dev9/src/hungerlib.egg-info → hungerlib-4.24.dev1}/PKG-INFO

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

{hungerlib-4.23.dev9 → hungerlib-4.24.dev1}/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hungerlib"
-version = "4.23.dev9"
+version = "4.24-dev.1"
 description = "Powerful automation library for Pterodactyl."
 readme = "README.md"
 requires-python = ">=3.9"

{hungerlib-4.23.dev9 → hungerlib-4.24.dev1}/src/hungerlib/__init__.py

@@ -13,6 +13,8 @@ from .messagerouter import MessageRouter
 from .panel import Panel
 from .servers import GenericServer, MinecraftServer
 from .bridgeclient import BridgeClient
+from .discord_bot_webhook import DiscordBotWebhook
+from .email import Email, EmailManager, EmailUser
 from .validator import (
     Validator,
     ValidationError,
@@ -32,6 +34,12 @@ from .utils import (
     Snapshot,
     clearTerminal,
     validateAll,
+
+    # exceptions
+    HungerLibError,
+    InvalidLevelError,
+    InvalidModeError,
+    HungerBridgeError
 )
 
 # namespaces
@@ -65,7 +73,11 @@ __all__ = [
     'GenericServer',
     'MinecraftServer',
     'BridgeClient',
+    'DiscordBotWebhook',
     'Validator',
+    'Email',
+    'EmailManager',
+    'EmailUser',
 
     # sub-modules
     'snapSchedule',
@@ -85,6 +97,11 @@ __all__ = [
     'FallbackError',
     'RecommendedError',
 
+    'HungerLibError',
+    'InvalidLevelError',
+    'InvalidModeError',
+    'HungerBridgeError',
+
     # namespaces
     'utils',
     'servers',

hungerlib-4.24.dev1/src/hungerlib/discord_bot_webhook.py

@@ -0,0 +1,14 @@
+import requests
+
+class DiscordBotWebhook:
+    def __init__(self, url: str, token: str):
+        self.url = url
+        self.token = token
+    
+    def send(self, event: str, **ctx):
+        requests.post(
+            self.url,
+            json={"event": event, **ctx},
+            headers={"X-Webhook-Token": self.token},
+            timeout=5
+        ).raise_for_status()

hungerlib-4.24.dev1/src/hungerlib/email/__init__.py

@@ -0,0 +1,9 @@
+from .message import Email
+from .manager import EmailManager
+from .user import EmailUser
+
+__all__ = [
+    'Email',
+    'EmailManager',
+    'EmailUser',
+]

hungerlib-4.24.dev1/src/hungerlib/email/manager.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+import pathlib
+from cloudflare import Cloudflare
+from mapres import res
+from .message import Email
+
+TEMPLATE_DIR = pathlib.Path(__file__).resolve().parent.parent / 'email_templates'
+
+class EmailManager:
+    '''
+    Backend email system.
+    Holds API token and account ID.
+    Sends emails created by EmailUser.
+    '''
+    def __init__(self, api_token: str, account_id: str):
+        self.client = Cloudflare(api_token=api_token)
+        self.account_id = account_id
+
+    # -------------------------
+    # Template loader
+    # -------------------------
+    def load_template(self, name: str) -> str:
+        path = TEMPLATE_DIR / f'{name}.html'
+        return path.read_text(encoding='utf8')
+
+    # -------------------------
+    # Template renderer
+    # -------------------------
+    def render_template(self, template: str, ctx: dict) -> str:
+        raw = self.load_template(template)
+        return res(raw, **ctx)
+
+    # -------------------------
+    # Actual sending
+    # -------------------------
+    def send_email(self, user, email: Email) -> bool:
+        to_str = ','.join(email.to)
+        cc_str = ','.join(email.cc) if email.cc else None
+        bcc_str = ','.join(email.bcc) if email.bcc else None
+
+        if email.template and not email.html:
+            email.html = self.render_template(email.template, email.template_ctx)
+
+        resp = self.client.email_sending.send(
+            account_id=self.account_id,
+            from_=f'{user.name} <{user.address}>',
+            to=to_str,
+            cc=cc_str,
+            bcc=bcc_str,
+            subject=email.subject,
+            text=email.text,
+            html=email.html
+        )
+
+        return bool(getattr(resp, 'delivered', None))

hungerlib-4.24.dev1/src/hungerlib/email/message.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+class Email:
+    '''
+    Simple email data container.
+    '''
+    def __init__(
+        self,
+        subject: str,
+        text: str | None = None,
+        html: str | None = None,
+        to: list | str | None = None,
+        cc: list | str | None = None,
+        bcc: list | str | None = None,
+        template: str | None = None,
+        template_ctx: dict | None = None
+    ):
+        self.subject = subject
+        self.text = text or ''
+        self.html = html or ''
+        self.to = self._normalize(to)
+        self.cc = self._normalize(cc)
+        self.bcc = self._normalize(bcc)
+        self.template = template
+        self.template_ctx = template_ctx or {}
+
+    @staticmethod
+    def _normalize(value) -> list[str]:
+        if value is None:
+            return []
+        if isinstance(value, str):
+            return [s.strip() for s in value.split(',') if s.strip()]
+        return [str(x).strip() for x in value]

hungerlib-4.24.dev1/src/hungerlib/email/user.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+from .message import Email
+
+class EmailUser:
+    '''
+    Represents a sender identity.
+    The frontend API for sending emails.
+    '''
+    def __init__(self, name: str, address: str, manager):
+        self.name = name
+        self.address = address
+        self.manager = manager  # backend EmailManager
+
+    def send(
+        self,
+        subject: str,
+        text: str | None = None,
+        html: str | None = None,
+        to: list | str | None = None,
+        cc: list | str | None = None,
+        bcc: list | str | None = None,
+        template: str | None = None,
+        template_ctx: dict | None = None
+    ):
+        email = Email(
+            subject=subject,
+            text=text,
+            html=html,
+            to=to,
+            cc=cc,
+            bcc=bcc,
+            template=template,
+            template_ctx=template_ctx
+        )
+        return self.manager.send_email(self, email)

{hungerlib-4.23.dev9 → hungerlib-4.24.dev1}/src/hungerlib/messagerouter.py

@@ -51,6 +51,14 @@ class MessageRouter:
         # custom level registry
         self.custom_levels = {}
 
+        # routing table
+        self.ROUTES = {
+            'origin': self.origin,
+            'destination': self.destination,
+            'broadcast': self.broadcast,
+            'filelog': self.filelog
+        }
+
     def registerLevel(self, name, prefix, file_method=None, routes=None):
         lvl = name.lower()
         self.custom_levels[lvl] = {
@@ -59,21 +67,9 @@ class MessageRouter:
             'routes': routes or ['origin', 'filelog']
         }
 
-        def make_method(level_name):
-            def _method(text, **ctx):
-                cfg = self.custom_levels[level_name]
-                rts = cfg['routes']
-                if 'origin' in rts:
-                    self.origin(text, level=level_name, **ctx)
-                if 'destination' in rts:
-                    self.destination(text, level=level_name, **ctx)
-                if 'broadcast' in rts:
-                    self.broadcast(text, level=level_name, **ctx)
-                if 'filelog' in rts:
-                    self.filelog(text, level=level_name, **ctx)
-            return _method
-
-        setattr(self, lvl, make_method(lvl))
+        def _method(text, **ctx):
+            self._route(lvl, text, None, None, ctx)
+        setattr(self, lvl, _method)
 
     def _init_file_logger(self):
         log_file = self.log_path / f'{self.name}_{datetime.now().strftime("%Y-%m-%d")}.log'
@@ -95,29 +91,53 @@ class MessageRouter:
             maps.extend(extra)
         return maps
 
+    # prefix resolver
+    def _resolve_prefix(self, level, ctx):
+        lvl = level.lower() if isinstance(level, str) else None
+
+        if lvl == 'info':
+            return self.res(self.info_prefix, override_maps=self.prefix_maps)
+        if lvl == 'warn':
+            return self.res(self.warn_prefix, override_maps=self.prefix_maps)
+        if lvl == 'error':
+            return self.res(self.error_prefix, override_maps=self.prefix_maps)
+        if lvl in self.custom_levels:
+            return self.res(self.custom_levels[lvl]['prefix'], override_maps=self.prefix_maps)
+        if level is None:
+            return ''
+        if lvl == 'custom':
+            return ctx.get('prefix', '')
+
+        return self.res(level, override_maps=self.prefix_maps)
+
+    # routing engine
+    def _route(self, level, text, extra_maps, override_maps, ctx):
+        cfg = self.custom_levels.get(level.lower())
+        routes = cfg['routes'] if cfg else ['origin', 'filelog']
+
+        for r in routes:
+            self.ROUTES[r](text, level=level, extra_maps=extra_maps, override_maps=override_maps, **ctx)
+
+    # file logging
+    def _log_file(self, level, msg):
+        lvl = level.lower()
+        if lvl in self.custom_levels:
+            method = self.custom_levels[lvl]['file_method']
+            if method:
+                getattr(self.logger, method)(msg)
+            return
+
+        {
+            'info': self.logger.info,
+            'warn': self.logger.warning,
+            'error': self.logger.error
+        }[lvl](msg)
+
     # routing primitives
     def origin(self, text, level='info', extra_maps=None, override_maps=None, **ctx):
-        level_norm = level.lower() if isinstance(level, str) else None
-
         maps = self._merge_maps(override_maps or self.origin_maps, extra_maps)
         mapped = self._format(text, maps, **ctx)
-
-        # Prefix resolution
-        if level_norm == 'info':
-            prefix = self.res(self.info_prefix, override_maps=self.prefix_maps)
-        elif level_norm == 'warn':
-            prefix = self.res(self.warn_prefix, override_maps=self.prefix_maps)
-        elif level_norm == 'error':
-            prefix = self.res(self.error_prefix, override_maps=self.prefix_maps)
-        elif level_norm in self.custom_levels:
-            prefix = self.res(self.custom_levels[level_norm]['prefix'], override_maps=self.prefix_maps)
-        elif level is None:
-            prefix = ''
-        elif level_norm == 'custom':
-            prefix = ctx.get('prefix', '')
-        else:
-            prefix = self.res(level, override_maps=self.prefix_maps)
-
+        prefix = self._resolve_prefix(level, ctx)
         msg = prefix + mapped
         print(msg)
         return msg
@@ -125,7 +145,6 @@ class MessageRouter:
     def destination(self, text, level='info', extra_maps=None, override_maps=None, **ctx):
         maps = self._merge_maps(override_maps or self.destination_maps, extra_maps)
         msg = self._format(text, maps, **ctx)
-
         for server in self.Servers:
             if hasattr(server, 'bridge'):
                 server.bridge.log(msg, level)
@@ -134,7 +153,6 @@ class MessageRouter:
     def broadcast(self, text, extra_maps=None, override_maps=None, **ctx):
         maps = self._merge_maps(override_maps or self.broadcast_maps, extra_maps)
         msg = self._format(text, maps, **ctx)
-
         for server in self.Servers:
             if hasattr(server, 'sendBroadcast'):
                 server.sendBroadcast(msg)
@@ -143,33 +161,15 @@ class MessageRouter:
     def filelog(self, text, level='info', extra_maps=None, override_maps=None, **ctx):
         maps = self._merge_maps(override_maps or self.file_maps, extra_maps)
         msg = self._format(text, maps, **ctx)
-
-        # custom file logging
-        if level in self.custom_levels:
-            method = self.custom_levels[level]['file_method']
-            if method:
-                getattr(self.logger, method)(msg)
-            return msg
-
-        {
-            'info': self.logger.info,
-            'warn': self.logger.warning,
-            'error': self.logger.error
-        }[level](msg)
+        self._log_file(level, msg)
         return msg
 
     # passthrough helpers
     def info(self, text, extra_maps=None, override_maps=None, **ctx):
-        msg = self.origin(text, 'info', extra_maps, override_maps, **ctx)
-        self.filelog(text, 'info', extra_maps, override_maps, **ctx)
-        return msg
+        self._route('info', text, extra_maps, override_maps, ctx)
 
     def warn(self, text, extra_maps=None, override_maps=None, **ctx):
-        msg = self.origin(text, 'warn', extra_maps, override_maps, **ctx)
-        self.filelog(text, 'warn', extra_maps, override_maps, **ctx)
-        return msg
+        self._route('warn', text, extra_maps, override_maps, ctx)
 
     def error(self, text, extra_maps=None, override_maps=None, **ctx):
-        msg = self.origin(text, 'error', extra_maps, override_maps, **ctx)
-        self.filelog(text, 'error', extra_maps, override_maps, **ctx)
-        return msg
+        self._route('error', text, extra_maps, override_maps, ctx)

{hungerlib-4.23.dev9 → hungerlib-4.24.dev1}/src/hungerlib/utils/__init__.py

@@ -1,3 +1,10 @@
+from .utils import Snapshot, clearTerminal, validateAll
+from .exceptions import (
+    HungerLibError,
+    InvalidLevelError,
+    InvalidModeError,
+    HungerBridgeError
+)
 from .time import (
     snapSchedule,
     runCountdownEvents,
@@ -6,7 +13,6 @@ from .time import (
     secsUntil,
     minsUntil
 )
-from .utils import Snapshot, clearTerminal, validateAll
 
 __all__ = [
     'snapSchedule',
@@ -18,4 +24,10 @@ __all__ = [
     'Snapshot',
     'clearTerminal',
     'validateAll',
+
+    # exceptions
+    'HungerLibError',
+    'InvalidLevelError',
+    'InvalidModeError',
+    'HungerBridgeError',
 ]

{hungerlib-4.23.dev9 → hungerlib-4.24.dev1/src/hungerlib.egg-info}/PKG-INFO

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

{hungerlib-4.23.dev9 → hungerlib-4.24.dev1}/src/hungerlib.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ pyproject.toml
 src/hungerlib/__init__.py
 src/hungerlib/bridgeclient.py
 src/hungerlib/configloader.py
+src/hungerlib/discord_bot_webhook.py
 src/hungerlib/messagerouter.py
 src/hungerlib/panel.py
 src/hungerlib/validator.py
@@ -19,6 +20,10 @@ src/hungerlib/api/databases.py
 src/hungerlib/api/filemanager.py
 src/hungerlib/api/schedule.py
 src/hungerlib/api/startup.py
+src/hungerlib/email/__init__.py
+src/hungerlib/email/manager.py
+src/hungerlib/email/message.py
+src/hungerlib/email/user.py
 src/hungerlib/servers/__init__.py
 src/hungerlib/servers/generic.py
 src/hungerlib/servers/minecraft.py