webhookloggerx 2.0.0__tar.gz

webhookloggerx-2.0.0/PKG-INFO

@@ -0,0 +1,284 @@
+Metadata-Version: 2.4
+Name: webhookloggerx
+Version: 2.0.0
+Summary: A clean, user-friendly Python package for sending Discord webhook messages and rich embeds.
+Author: Nur Mohammad Rafi
+Author-email: 
+Keywords: discord webhook embed notification bot
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Communications
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.20.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: keywords
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# webhooklogger-python-rafi
+
+A clean, user-friendly Python package for sending Discord webhook messages and rich embeds.
+
+## Installation
+
+```bash
+pip install webhookloggerx
+```
+
+## Quick Start
+
+```python
+from webhooklogger import WebhookClient, Embed
+
+client = WebhookClient("https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN")
+client.send("Hello from webhooklogger!")
+```
+
+---
+
+## Features
+
+- ✅ Send plain text messages
+- ✅ Send rich Discord embeds
+- ✅ Send multiple embeds in one request
+- ✅ Customise webhook display name & avatar
+- ✅ Embed builder with fluent (chainable) API
+- ✅ Built-in colour themes (`success`, `error`, `warning`, etc.)
+- ✅ Set embed title, description, author, footer, images, timestamp, fields
+
+---
+
+## WebhookClient
+
+### Create a Client
+
+```python
+from webhooklogger import WebhookClient
+
+client = WebhookClient("https://discord.com/api/webhooks/...")
+```
+
+### Set Webhook Profile (name & avatar)
+
+```python
+client.set_profile(
+    username="MyBot",
+    avatar_url="https://example.com/avatar.png"
+)
+```
+
+### Send a Plain Text Message
+
+```python
+client.send("This is a plain message.")
+```
+
+### Send an Embed
+
+```python
+from webhooklogger import Embed
+
+embed = Embed().set_title("Hello!").set_description("Embed body here.")
+client.send_embed(embed)
+```
+
+### Send Multiple Embeds
+
+```python
+embed1 = Embed().set_title("First").set_theme("success")
+embed2 = Embed().set_title("Second").set_theme("error")
+client.send_embeds([embed1, embed2])
+```
+
+### Send Text + Embed Together
+
+```python
+embed = Embed().set_title("Alert").set_description("Check this out!")
+client.send_message(content="Hey team!", embed=embed)
+```
+
+---
+
+## Embed Builder
+
+All methods return `self`, so you can **chain** them fluently.
+
+### Title & Description
+
+```python
+embed = (
+    Embed()
+    .set_title("My Title")
+    .set_description("This is the body of the embed.")
+    .set_url("https://example.com")   # makes title clickable
+)
+```
+
+### Colour
+
+```python
+# Hex string
+embed.set_color("#FF5733")
+
+# Integer
+embed.set_color(16711680)
+
+# Named theme
+embed.set_theme("success")
+```
+
+**Available themes:**
+
+| Theme | Colour |
+|---|---|
+| `default` | Discord Blurple |
+| `success` | Green |
+| `warning` | Yellow |
+| `error` | Red |
+| `info` | Blue |
+| `dark` | Dark Grey |
+| `light` | White |
+| `purple` | Purple |
+| `orange` | Orange |
+| `pink` | Pink |
+
+### Author
+
+```python
+embed.set_author(
+    name="Nur Mohammad Rafi",
+    url="https://github.com/yourusername",
+    icon_url="https://example.com/icon.png"
+)
+```
+
+### Thumbnail & Image
+
+```python
+embed.set_thumbnail("https://example.com/thumb.png")  # top-right corner
+embed.set_image("https://example.com/big-image.png")  # large bottom image
+```
+
+### Fields
+
+```python
+embed.add_field("Status", "Online", inline=True)
+embed.add_field("Server", "Production", inline=True)
+embed.add_field("Message", "All systems go.", inline=False)
+```
+
+- `inline=True` — fields sit side by side (up to 3 per row)
+- `inline=False` — field takes the full width
+- Max **25 fields** per embed
+
+### Footer
+
+```python
+embed.set_footer("webhooklogger v1.0", icon_url="https://example.com/icon.png")
+```
+
+### Timestamp
+
+```python
+embed.set_timestamp()        # use current UTC time
+```
+
+```python
+from datetime import datetime, timezone
+embed.set_timestamp(datetime(2025, 1, 1, tzinfo=timezone.utc))  # custom time
+```
+
+---
+
+## Full Example
+
+```python
+from webhooklogger import WebhookClient, Embed
+
+# Create and configure client
+client = WebhookClient("https://discord.com/api/webhooks/...")
+client.set_profile(username="AlertBot", avatar_url="https://example.com/bot.png")
+
+# Build embed
+embed = (
+    Embed()
+    .set_title("🚨 System Alert")
+    .set_description("A critical event has been detected on the server.")
+    .set_theme("error")
+    .set_author("Monitor System", icon_url="https://example.com/icon.png")
+    .set_thumbnail("https://example.com/thumb.png")
+    .add_field("Host", "prod-server-01", inline=True)
+    .add_field("Status", "❌ Down", inline=True)
+    .add_field("Region", "US-East", inline=True)
+    .add_field("Details", "Connection timeout after 30s", inline=False)
+    .set_image("https://example.com/graph.png")
+    .set_footer("webhooklogger • Auto-alert system")
+    .set_timestamp()
+)
+
+# Send it
+client.send_embed(embed)
+```
+
+---
+
+## Error Handling
+
+```python
+from webhooklogger import WebhookClient, WebhookError
+
+client = WebhookClient("https://discord.com/api/webhooks/...")
+
+try:
+    client.send("Test message")
+except WebhookError as e:
+    print(f"Failed: HTTP {e.status_code} — {e.message}")
+```
+
+---
+
+## API Reference
+
+### `WebhookClient`
+
+| Method | Description |
+|---|---|
+| `__init__(url)` | Create client with webhook URL |
+| `set_profile(username, avatar_url)` | Override display name & avatar |
+| `send(content)` | Send plain text message |
+| `send_embed(embed)` | Send a single Embed |
+| `send_embeds(embeds)` | Send a list of Embeds (max 10) |
+| `send_message(content, embed)` | Send text + embed together |
+
+### `Embed`
+
+| Method | Description |
+|---|---|
+| `set_title(title)` | Embed title |
+| `set_description(text)` | Embed body text |
+| `set_url(url)` | Make title a hyperlink |
+| `set_color(color)` | Hex string or int |
+| `set_colour(color)` | Alias for `set_color` |
+| `set_theme(theme)` | Named colour theme |
+| `set_author(name, url, icon_url)` | Author block |
+| `set_thumbnail(url)` | Small top-right image |
+| `set_image(url)` | Large bottom image |
+| `set_footer(text, icon_url)` | Footer text & icon |
+| `set_timestamp(dt)` | Timestamp (default: now) |
+| `add_field(name, value, inline)` | Add a field |
+| `clear_fields()` | Remove all fields |
+| `build()` | Return raw dict for API |
+
+---
+
+## License
+
+MIT © Nur Mohammad Rafi

webhookloggerx-2.0.0/README.md

@@ -0,0 +1,259 @@
+# webhooklogger-python-rafi
+
+A clean, user-friendly Python package for sending Discord webhook messages and rich embeds.
+
+## Installation
+
+```bash
+pip install webhookloggerx
+```
+
+## Quick Start
+
+```python
+from webhooklogger import WebhookClient, Embed
+
+client = WebhookClient("https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN")
+client.send("Hello from webhooklogger!")
+```
+
+---
+
+## Features
+
+- ✅ Send plain text messages
+- ✅ Send rich Discord embeds
+- ✅ Send multiple embeds in one request
+- ✅ Customise webhook display name & avatar
+- ✅ Embed builder with fluent (chainable) API
+- ✅ Built-in colour themes (`success`, `error`, `warning`, etc.)
+- ✅ Set embed title, description, author, footer, images, timestamp, fields
+
+---
+
+## WebhookClient
+
+### Create a Client
+
+```python
+from webhooklogger import WebhookClient
+
+client = WebhookClient("https://discord.com/api/webhooks/...")
+```
+
+### Set Webhook Profile (name & avatar)
+
+```python
+client.set_profile(
+    username="MyBot",
+    avatar_url="https://example.com/avatar.png"
+)
+```
+
+### Send a Plain Text Message
+
+```python
+client.send("This is a plain message.")
+```
+
+### Send an Embed
+
+```python
+from webhooklogger import Embed
+
+embed = Embed().set_title("Hello!").set_description("Embed body here.")
+client.send_embed(embed)
+```
+
+### Send Multiple Embeds
+
+```python
+embed1 = Embed().set_title("First").set_theme("success")
+embed2 = Embed().set_title("Second").set_theme("error")
+client.send_embeds([embed1, embed2])
+```
+
+### Send Text + Embed Together
+
+```python
+embed = Embed().set_title("Alert").set_description("Check this out!")
+client.send_message(content="Hey team!", embed=embed)
+```
+
+---
+
+## Embed Builder
+
+All methods return `self`, so you can **chain** them fluently.
+
+### Title & Description
+
+```python
+embed = (
+    Embed()
+    .set_title("My Title")
+    .set_description("This is the body of the embed.")
+    .set_url("https://example.com")   # makes title clickable
+)
+```
+
+### Colour
+
+```python
+# Hex string
+embed.set_color("#FF5733")
+
+# Integer
+embed.set_color(16711680)
+
+# Named theme
+embed.set_theme("success")
+```
+
+**Available themes:**
+
+| Theme | Colour |
+|---|---|
+| `default` | Discord Blurple |
+| `success` | Green |
+| `warning` | Yellow |
+| `error` | Red |
+| `info` | Blue |
+| `dark` | Dark Grey |
+| `light` | White |
+| `purple` | Purple |
+| `orange` | Orange |
+| `pink` | Pink |
+
+### Author
+
+```python
+embed.set_author(
+    name="Nur Mohammad Rafi",
+    url="https://github.com/yourusername",
+    icon_url="https://example.com/icon.png"
+)
+```
+
+### Thumbnail & Image
+
+```python
+embed.set_thumbnail("https://example.com/thumb.png")  # top-right corner
+embed.set_image("https://example.com/big-image.png")  # large bottom image
+```
+
+### Fields
+
+```python
+embed.add_field("Status", "Online", inline=True)
+embed.add_field("Server", "Production", inline=True)
+embed.add_field("Message", "All systems go.", inline=False)
+```
+
+- `inline=True` — fields sit side by side (up to 3 per row)
+- `inline=False` — field takes the full width
+- Max **25 fields** per embed
+
+### Footer
+
+```python
+embed.set_footer("webhooklogger v1.0", icon_url="https://example.com/icon.png")
+```
+
+### Timestamp
+
+```python
+embed.set_timestamp()        # use current UTC time
+```
+
+```python
+from datetime import datetime, timezone
+embed.set_timestamp(datetime(2025, 1, 1, tzinfo=timezone.utc))  # custom time
+```
+
+---
+
+## Full Example
+
+```python
+from webhooklogger import WebhookClient, Embed
+
+# Create and configure client
+client = WebhookClient("https://discord.com/api/webhooks/...")
+client.set_profile(username="AlertBot", avatar_url="https://example.com/bot.png")
+
+# Build embed
+embed = (
+    Embed()
+    .set_title("🚨 System Alert")
+    .set_description("A critical event has been detected on the server.")
+    .set_theme("error")
+    .set_author("Monitor System", icon_url="https://example.com/icon.png")
+    .set_thumbnail("https://example.com/thumb.png")
+    .add_field("Host", "prod-server-01", inline=True)
+    .add_field("Status", "❌ Down", inline=True)
+    .add_field("Region", "US-East", inline=True)
+    .add_field("Details", "Connection timeout after 30s", inline=False)
+    .set_image("https://example.com/graph.png")
+    .set_footer("webhooklogger • Auto-alert system")
+    .set_timestamp()
+)
+
+# Send it
+client.send_embed(embed)
+```
+
+---
+
+## Error Handling
+
+```python
+from webhooklogger import WebhookClient, WebhookError
+
+client = WebhookClient("https://discord.com/api/webhooks/...")
+
+try:
+    client.send("Test message")
+except WebhookError as e:
+    print(f"Failed: HTTP {e.status_code} — {e.message}")
+```
+
+---
+
+## API Reference
+
+### `WebhookClient`
+
+| Method | Description |
+|---|---|
+| `__init__(url)` | Create client with webhook URL |
+| `set_profile(username, avatar_url)` | Override display name & avatar |
+| `send(content)` | Send plain text message |
+| `send_embed(embed)` | Send a single Embed |
+| `send_embeds(embeds)` | Send a list of Embeds (max 10) |
+| `send_message(content, embed)` | Send text + embed together |
+
+### `Embed`
+
+| Method | Description |
+|---|---|
+| `set_title(title)` | Embed title |
+| `set_description(text)` | Embed body text |
+| `set_url(url)` | Make title a hyperlink |
+| `set_color(color)` | Hex string or int |
+| `set_colour(color)` | Alias for `set_color` |
+| `set_theme(theme)` | Named colour theme |
+| `set_author(name, url, icon_url)` | Author block |
+| `set_thumbnail(url)` | Small top-right image |
+| `set_image(url)` | Large bottom image |
+| `set_footer(text, icon_url)` | Footer text & icon |
+| `set_timestamp(dt)` | Timestamp (default: now) |
+| `add_field(name, value, inline)` | Add a field |
+| `clear_fields()` | Remove all fields |
+| `build()` | Return raw dict for API |
+
+---
+
+## License
+
+MIT © Nur Mohammad Rafi

webhookloggerx-2.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

webhookloggerx-2.0.0/setup.py

@@ -0,0 +1,29 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as f:
+    long_description = f.read()
+
+setup(
+    name="webhookloggerx",
+    version="2.0.0",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.20.0",
+    ],
+    author="Nur Mohammad Rafi",
+    author_email="",
+    description="A clean, user-friendly Python package for sending Discord webhook messages and rich embeds.",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    # url="https://github.com/yourusername/webhooklogger",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Intended Audience :: Developers",
+        "Topic :: Internet :: WWW/HTTP",
+        "Topic :: Communications",
+    ],
+    python_requires=">=3.7",
+    keywords="discord webhook embed notification bot",
+)

webhookloggerx-2.0.0/webhooklogger/__init__.py

@@ -0,0 +1,32 @@
+"""
+webhooklogger
+~~~~~~~~~~~~~
+A clean, user-friendly Python package for sending Discord webhook messages
+and rich embeds.
+
+Usage::
+
+    from webhooklogger import WebhookClient, Embed
+
+    client = WebhookClient("https://discord.com/api/webhooks/...")
+    client.set_profile(username="MyBot")
+    client.send("Hello from webhooklogger!")
+
+    embed = (
+        Embed()
+        .set_title("Notification")
+        .set_theme("success")
+        .set_description("Everything is running smoothly.")
+        .set_timestamp()
+    )
+    client.send_embed(embed)
+
+:license: MIT
+"""
+
+from .client import WebhookClient, WebhookError
+from .embed import Embed
+
+__all__ = ["WebhookClient", "WebhookError", "Embed"]
+__version__ = "1.0.0"
+__author__ = "Nur Mohammad Rafi"

webhookloggerx-2.0.0/webhooklogger/client.py

@@ -0,0 +1,179 @@
+"""
+webhooklogger.client
+~~~~~~~~~~~~~~~~~~~~
+WebhookClient — send messages and embeds to Discord webhooks.
+"""
+
+import requests
+from .embed import Embed
+
+
+class WebhookError(Exception):
+    """Raised when the Discord API returns a non-2xx response."""
+
+    def __init__(self, status_code: int, message: str):
+        self.status_code = status_code
+        self.message = message
+        super().__init__(f"[HTTP {status_code}] {message}")
+
+
+class WebhookClient:
+    """
+    Main client for sending data to a Discord webhook URL.
+
+    Example::
+
+        from webhooklogger import WebhookClient, Embed
+
+        client = WebhookClient("https://discord.com/api/webhooks/...")
+        client.set_profile(username="MyBot", avatar_url="https://...")
+        client.send("Hello, world!")
+
+        embed = (
+            Embed()
+            .set_title("Alert")
+            .set_color("error")
+            .set_description("Something went wrong!")
+            .set_timestamp()
+        )
+        client.send_embed(embed)
+    """
+
+    BASE_URL = "https://discord.com/api/webhooks/"
+
+    def __init__(self, url: str):
+        """
+        :param url: Full Discord webhook URL.
+        """
+        if not url or "discord.com/api/webhooks" not in url:
+            raise ValueError(
+                "Invalid webhook URL. "
+                "It must be a Discord webhook URL "
+                "(https://discord.com/api/webhooks/...)."
+            )
+        self._url = url.rstrip("/") + "?wait=true"
+        self._username: str = None
+        self._avatar_url: str = None
+
+    # ------------------------------------------------------------------ #
+    # Profile                                                              #
+    # ------------------------------------------------------------------ #
+
+    def set_profile(
+        self,
+        username: str = None,
+        avatar_url: str = None,
+    ) -> "WebhookClient":
+        """
+        Override the webhook's display name and/or avatar.
+
+        :param username:   Custom display name shown in Discord.
+        :param avatar_url: URL to an image used as the avatar.
+
+        Returns ``self`` so you can chain calls::
+
+            client.set_profile(username="AlertBot", avatar_url="https://...")
+        """
+        if username:
+            self._username = str(username)
+        if avatar_url:
+            self._avatar_url = str(avatar_url)
+        return self
+
+    # ------------------------------------------------------------------ #
+    # Internal helpers                                                     #
+    # ------------------------------------------------------------------ #
+
+    def _base_payload(self) -> dict:
+        payload = {}
+        if self._username:
+            payload["username"] = self._username
+        if self._avatar_url:
+            payload["avatar_url"] = self._avatar_url
+        return payload
+
+    def _post(self, payload: dict) -> dict:
+        """Send the payload and raise WebhookError on failure."""
+        response = requests.post(self._url, json=payload, timeout=10)
+        if not response.ok:
+            try:
+                detail = response.json().get("message", response.text)
+            except Exception:
+                detail = response.text
+            raise WebhookError(response.status_code, detail)
+        return response.json()
+
+    # ------------------------------------------------------------------ #
+    # Public send methods                                                  #
+    # ------------------------------------------------------------------ #
+
+    def send(self, content: str) -> dict:
+        """
+        Send a plain text message.
+
+        :param content: The message text (max 2000 chars).
+        :returns: The response dict from Discord.
+        """
+        if not content:
+            raise ValueError("content cannot be empty")
+        payload = self._base_payload()
+        payload["content"] = str(content)
+        return self._post(payload)
+
+    def send_embed(self, embed: Embed) -> dict:
+        """
+        Send a single :class:`~webhooklogger.Embed`.
+
+        :param embed: An :class:`~webhooklogger.Embed` instance.
+        :returns: The response dict from Discord.
+        """
+        if not isinstance(embed, Embed):
+            raise TypeError("embed must be an Embed instance")
+        payload = self._base_payload()
+        payload["embeds"] = [embed.build()]
+        return self._post(payload)
+
+    def send_embeds(self, embeds: list) -> dict:
+        """
+        Send multiple embeds in a single request (up to 10).
+
+        :param embeds: A list of :class:`~webhooklogger.Embed` instances.
+        :returns: The response dict from Discord.
+        """
+        if not embeds:
+            raise ValueError("embeds list cannot be empty")
+        if len(embeds) > 10:
+            raise ValueError("Discord allows a maximum of 10 embeds per message")
+        for i, e in enumerate(embeds):
+            if not isinstance(e, Embed):
+                raise TypeError(f"Item at index {i} is not an Embed instance")
+        payload = self._base_payload()
+        payload["embeds"] = [e.build() for e in embeds]
+        return self._post(payload)
+
+    def send_message(self, content: str = None, embed: Embed = None) -> dict:
+        """
+        Send a message with optional text content AND an embed together.
+
+        :param content: Optional plain text message.
+        :param embed:   Optional :class:`~webhooklogger.Embed`.
+        :returns: The response dict from Discord.
+        """
+        if content is None and embed is None:
+            raise ValueError("Provide at least content or an embed")
+        payload = self._base_payload()
+        if content:
+            payload["content"] = str(content)
+        if embed:
+            if not isinstance(embed, Embed):
+                raise TypeError("embed must be an Embed instance")
+            payload["embeds"] = [embed.build()]
+        return self._post(payload)
+
+    # ------------------------------------------------------------------ #
+    # Repr                                                                 #
+    # ------------------------------------------------------------------ #
+
+    def __repr__(self) -> str:
+        name = self._username or "<default>"
+        return f"<WebhookClient username={name!r}>"

webhookloggerx-2.0.0/webhooklogger/embed.py

@@ -0,0 +1,209 @@
+"""
+webhooklogger.embed
+~~~~~~~~~~~~~~~~~~~
+Chainable Embed builder for Discord webhooks.
+"""
+
+from datetime import datetime, timezone
+
+
+class Embed:
+    """
+    Build a Discord embed with a clean, fluent interface.
+
+    Example::
+
+        embed = (
+            Embed()
+            .set_title("Hello!")
+            .set_description("This is a webhook embed.")
+            .set_color("#5865F2")
+            .add_field("Status", "Online", inline=True)
+            .set_footer("Sent by webhooklogger")
+            .set_timestamp()
+        )
+    """
+
+    # ------------------------------------------------------------------ #
+    # Preset colour themes                                                 #
+    # ------------------------------------------------------------------ #
+    THEMES = {
+        "default":  0x5865F2,   # Discord blurple
+        "success":  0x57F287,   # green
+        "warning":  0xFEE75C,   # yellow
+        "error":    0xED4245,   # red
+        "info":     0x5DADE2,   # blue
+        "dark":     0x2C2F33,   # dark grey
+        "light":    0xFFFFFF,   # white
+        "purple":   0x9B59B6,
+        "orange":   0xE67E22,
+        "pink":     0xFF69B4,
+    }
+
+    def __init__(self):
+        self._data = {}
+
+    # ------------------------------------------------------------------ #
+    # Core setters                                                         #
+    # ------------------------------------------------------------------ #
+
+    def set_title(self, title: str) -> "Embed":
+        """Set the embed title (max 256 chars)."""
+        self._data["title"] = str(title)
+        return self
+
+    def set_description(self, description: str) -> "Embed":
+        """Set the embed description / body text (max 4096 chars)."""
+        self._data["description"] = str(description)
+        return self
+
+    def set_url(self, url: str) -> "Embed":
+        """Make the title a clickable hyperlink."""
+        self._data["url"] = str(url)
+        return self
+
+    # ------------------------------------------------------------------ #
+    # Colour / theme                                                       #
+    # ------------------------------------------------------------------ #
+
+    def set_color(self, color) -> "Embed":
+        """
+        Set the left-border colour.
+
+        Accepts:
+        - Hex string  → ``"#FF5733"`` or ``"FF5733"``
+        - Integer     → ``16711680``
+        - Theme name  → ``"success"``, ``"error"``, ``"warning"``, etc.
+        """
+        if isinstance(color, str):
+            color = color.strip().lstrip("#")
+            if color.lower() in self.THEMES:
+                self._data["color"] = self.THEMES[color.lower()]
+            else:
+                self._data["color"] = int(color, 16)
+        elif isinstance(color, int):
+            self._data["color"] = color
+        else:
+            raise TypeError("color must be a hex string or int")
+        return self
+
+    # Alias for British English users
+    set_colour = set_color
+
+    def set_theme(self, theme: str) -> "Embed":
+        """
+        Apply a named colour theme.
+
+        Available themes: ``default``, ``success``, ``warning``,
+        ``error``, ``info``, ``dark``, ``light``, ``purple``,
+        ``orange``, ``pink``.
+        """
+        theme = theme.lower()
+        if theme not in self.THEMES:
+            raise ValueError(
+                f"Unknown theme '{theme}'. "
+                f"Available: {', '.join(self.THEMES)}"
+            )
+        self._data["color"] = self.THEMES[theme]
+        return self
+
+    # ------------------------------------------------------------------ #
+    # Author                                                               #
+    # ------------------------------------------------------------------ #
+
+    def set_author(
+        self,
+        name: str,
+        url: str = None,
+        icon_url: str = None,
+    ) -> "Embed":
+        """Set the author block shown above the title."""
+        author = {"name": str(name)}
+        if url:
+            author["url"] = url
+        if icon_url:
+            author["icon_url"] = icon_url
+        self._data["author"] = author
+        return self
+
+    # ------------------------------------------------------------------ #
+    # Images                                                               #
+    # ------------------------------------------------------------------ #
+
+    def set_thumbnail(self, url: str) -> "Embed":
+        """Set the small thumbnail image (top-right corner)."""
+        self._data["thumbnail"] = {"url": str(url)}
+        return self
+
+    def set_image(self, url: str) -> "Embed":
+        """Set the large image shown below the body."""
+        self._data["image"] = {"url": str(url)}
+        return self
+
+    # ------------------------------------------------------------------ #
+    # Footer                                                               #
+    # ------------------------------------------------------------------ #
+
+    def set_footer(self, text: str, icon_url: str = None) -> "Embed":
+        """Set the footer text and optional icon."""
+        footer = {"text": str(text)}
+        if icon_url:
+            footer["icon_url"] = icon_url
+        self._data["footer"] = footer
+        return self
+
+    # ------------------------------------------------------------------ #
+    # Timestamp                                                            #
+    # ------------------------------------------------------------------ #
+
+    def set_timestamp(self, dt: datetime = None) -> "Embed":
+        """
+        Add a timestamp to the footer.
+
+        Pass a :class:`datetime` object, or leave blank to use **now** (UTC).
+        """
+        if dt is None:
+            dt = datetime.now(tz=timezone.utc)
+        self._data["timestamp"] = dt.isoformat()
+        return self
+
+    # ------------------------------------------------------------------ #
+    # Fields                                                               #
+    # ------------------------------------------------------------------ #
+
+    def add_field(
+        self,
+        name: str,
+        value: str,
+        inline: bool = False,
+    ) -> "Embed":
+        """
+        Add an inline or block field (up to 25 fields per embed).
+
+        :param name:   Field title.
+        :param value:  Field body text.
+        :param inline: If ``True``, fields sit side-by-side (up to 3 per row).
+        """
+        fields = self._data.setdefault("fields", [])
+        if len(fields) >= 25:
+            raise ValueError("Discord embeds support a maximum of 25 fields")
+        fields.append({"name": str(name), "value": str(value), "inline": inline})
+        return self
+
+    def clear_fields(self) -> "Embed":
+        """Remove all previously added fields."""
+        self._data.pop("fields", None)
+        return self
+
+    # ------------------------------------------------------------------ #
+    # Build                                                                #
+    # ------------------------------------------------------------------ #
+
+    def build(self) -> dict:
+        """Return the raw embed dictionary ready for the Discord API."""
+        return dict(self._data)
+
+    def __repr__(self) -> str:
+        title = self._data.get("title", "<no title>")
+        fields = len(self._data.get("fields", []))
+        return f"<Embed title={title!r} fields={fields}>"

webhookloggerx-2.0.0/webhooklogger/main.py

@@ -0,0 +1,2 @@
+def hello():
+    print("Hello From Webhook Logger!")

webhookloggerx-2.0.0/webhookloggerx.egg-info/PKG-INFO

@@ -0,0 +1,284 @@
+Metadata-Version: 2.4
+Name: webhookloggerx
+Version: 2.0.0
+Summary: A clean, user-friendly Python package for sending Discord webhook messages and rich embeds.
+Author: Nur Mohammad Rafi
+Author-email: 
+Keywords: discord webhook embed notification bot
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Communications
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.20.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: keywords
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# webhooklogger-python-rafi
+
+A clean, user-friendly Python package for sending Discord webhook messages and rich embeds.
+
+## Installation
+
+```bash
+pip install webhookloggerx
+```
+
+## Quick Start
+
+```python
+from webhooklogger import WebhookClient, Embed
+
+client = WebhookClient("https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN")
+client.send("Hello from webhooklogger!")
+```
+
+---
+
+## Features
+
+- ✅ Send plain text messages
+- ✅ Send rich Discord embeds
+- ✅ Send multiple embeds in one request
+- ✅ Customise webhook display name & avatar
+- ✅ Embed builder with fluent (chainable) API
+- ✅ Built-in colour themes (`success`, `error`, `warning`, etc.)
+- ✅ Set embed title, description, author, footer, images, timestamp, fields
+
+---
+
+## WebhookClient
+
+### Create a Client
+
+```python
+from webhooklogger import WebhookClient
+
+client = WebhookClient("https://discord.com/api/webhooks/...")
+```
+
+### Set Webhook Profile (name & avatar)
+
+```python
+client.set_profile(
+    username="MyBot",
+    avatar_url="https://example.com/avatar.png"
+)
+```
+
+### Send a Plain Text Message
+
+```python
+client.send("This is a plain message.")
+```
+
+### Send an Embed
+
+```python
+from webhooklogger import Embed
+
+embed = Embed().set_title("Hello!").set_description("Embed body here.")
+client.send_embed(embed)
+```
+
+### Send Multiple Embeds
+
+```python
+embed1 = Embed().set_title("First").set_theme("success")
+embed2 = Embed().set_title("Second").set_theme("error")
+client.send_embeds([embed1, embed2])
+```
+
+### Send Text + Embed Together
+
+```python
+embed = Embed().set_title("Alert").set_description("Check this out!")
+client.send_message(content="Hey team!", embed=embed)
+```
+
+---
+
+## Embed Builder
+
+All methods return `self`, so you can **chain** them fluently.
+
+### Title & Description
+
+```python
+embed = (
+    Embed()
+    .set_title("My Title")
+    .set_description("This is the body of the embed.")
+    .set_url("https://example.com")   # makes title clickable
+)
+```
+
+### Colour
+
+```python
+# Hex string
+embed.set_color("#FF5733")
+
+# Integer
+embed.set_color(16711680)
+
+# Named theme
+embed.set_theme("success")
+```
+
+**Available themes:**
+
+| Theme | Colour |
+|---|---|
+| `default` | Discord Blurple |
+| `success` | Green |
+| `warning` | Yellow |
+| `error` | Red |
+| `info` | Blue |
+| `dark` | Dark Grey |
+| `light` | White |
+| `purple` | Purple |
+| `orange` | Orange |
+| `pink` | Pink |
+
+### Author
+
+```python
+embed.set_author(
+    name="Nur Mohammad Rafi",
+    url="https://github.com/yourusername",
+    icon_url="https://example.com/icon.png"
+)
+```
+
+### Thumbnail & Image
+
+```python
+embed.set_thumbnail("https://example.com/thumb.png")  # top-right corner
+embed.set_image("https://example.com/big-image.png")  # large bottom image
+```
+
+### Fields
+
+```python
+embed.add_field("Status", "Online", inline=True)
+embed.add_field("Server", "Production", inline=True)
+embed.add_field("Message", "All systems go.", inline=False)
+```
+
+- `inline=True` — fields sit side by side (up to 3 per row)
+- `inline=False` — field takes the full width
+- Max **25 fields** per embed
+
+### Footer
+
+```python
+embed.set_footer("webhooklogger v1.0", icon_url="https://example.com/icon.png")
+```
+
+### Timestamp
+
+```python
+embed.set_timestamp()        # use current UTC time
+```
+
+```python
+from datetime import datetime, timezone
+embed.set_timestamp(datetime(2025, 1, 1, tzinfo=timezone.utc))  # custom time
+```
+
+---
+
+## Full Example
+
+```python
+from webhooklogger import WebhookClient, Embed
+
+# Create and configure client
+client = WebhookClient("https://discord.com/api/webhooks/...")
+client.set_profile(username="AlertBot", avatar_url="https://example.com/bot.png")
+
+# Build embed
+embed = (
+    Embed()
+    .set_title("🚨 System Alert")
+    .set_description("A critical event has been detected on the server.")
+    .set_theme("error")
+    .set_author("Monitor System", icon_url="https://example.com/icon.png")
+    .set_thumbnail("https://example.com/thumb.png")
+    .add_field("Host", "prod-server-01", inline=True)
+    .add_field("Status", "❌ Down", inline=True)
+    .add_field("Region", "US-East", inline=True)
+    .add_field("Details", "Connection timeout after 30s", inline=False)
+    .set_image("https://example.com/graph.png")
+    .set_footer("webhooklogger • Auto-alert system")
+    .set_timestamp()
+)
+
+# Send it
+client.send_embed(embed)
+```
+
+---
+
+## Error Handling
+
+```python
+from webhooklogger import WebhookClient, WebhookError
+
+client = WebhookClient("https://discord.com/api/webhooks/...")
+
+try:
+    client.send("Test message")
+except WebhookError as e:
+    print(f"Failed: HTTP {e.status_code} — {e.message}")
+```
+
+---
+
+## API Reference
+
+### `WebhookClient`
+
+| Method | Description |
+|---|---|
+| `__init__(url)` | Create client with webhook URL |
+| `set_profile(username, avatar_url)` | Override display name & avatar |
+| `send(content)` | Send plain text message |
+| `send_embed(embed)` | Send a single Embed |
+| `send_embeds(embeds)` | Send a list of Embeds (max 10) |
+| `send_message(content, embed)` | Send text + embed together |
+
+### `Embed`
+
+| Method | Description |
+|---|---|
+| `set_title(title)` | Embed title |
+| `set_description(text)` | Embed body text |
+| `set_url(url)` | Make title a hyperlink |
+| `set_color(color)` | Hex string or int |
+| `set_colour(color)` | Alias for `set_color` |
+| `set_theme(theme)` | Named colour theme |
+| `set_author(name, url, icon_url)` | Author block |
+| `set_thumbnail(url)` | Small top-right image |
+| `set_image(url)` | Large bottom image |
+| `set_footer(text, icon_url)` | Footer text & icon |
+| `set_timestamp(dt)` | Timestamp (default: now) |
+| `add_field(name, value, inline)` | Add a field |
+| `clear_fields()` | Remove all fields |
+| `build()` | Return raw dict for API |
+
+---
+
+## License
+
+MIT © Nur Mohammad Rafi

webhookloggerx-2.0.0/webhookloggerx.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+setup.py
+webhooklogger/__init__.py
+webhooklogger/client.py
+webhooklogger/embed.py
+webhooklogger/main.py
+webhookloggerx.egg-info/PKG-INFO
+webhookloggerx.egg-info/SOURCES.txt
+webhookloggerx.egg-info/dependency_links.txt
+webhookloggerx.egg-info/requires.txt
+webhookloggerx.egg-info/top_level.txt

webhookloggerx-2.0.0/webhookloggerx.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

webhookloggerx-2.0.0/webhookloggerx.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.20.0

webhookloggerx-2.0.0/webhookloggerx.egg-info/top_level.txt

@@ -0,0 +1 @@
+webhooklogger