webhookspot 1.0.0__tar.gz

webhookspot-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 webhookspot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

webhookspot-1.0.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: webhookspot
+Version: 1.0.0
+Summary: A tiny Python library for sending Discord webhook messages.
+Author: webhookspot
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+# webhookspot
+
+`webhookspot` is a tiny Python library for sending Discord webhook messages.
+
+## Install locally
+
+Open a terminal in this folder and run:
+
+```bash
+py -m pip install .
+```
+
+or:
+
+```bash
+pip install .
+```
+
+## Example
+
+```python
+import webhookspot
+
+x = webhookspot.Webhook("https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN")
+x.send_message("hello")
+```
+
+## More examples
+
+Change the webhook username:
+
+```python
+import webhookspot
+
+hook = webhookspot.Webhook("https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN")
+hook.send_message("Hello from webhookspot!", username="WebhookSpot Bot")
+```
+
+Send an embed:
+
+```python
+import webhookspot
+
+hook = webhookspot.Webhook("https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN")
+
+hook.send_embed(
+    title="WebhookSpot",
+    description="This is an embed message.",
+    color=0x5865F2
+)
+```
+
+## Safety note
+
+Do not post your real Discord webhook URL publicly. Anyone with the URL can send messages through it.

webhookspot-1.0.0/README.md

@@ -0,0 +1,55 @@
+# webhookspot
+
+`webhookspot` is a tiny Python library for sending Discord webhook messages.
+
+## Install locally
+
+Open a terminal in this folder and run:
+
+```bash
+py -m pip install .
+```
+
+or:
+
+```bash
+pip install .
+```
+
+## Example
+
+```python
+import webhookspot
+
+x = webhookspot.Webhook("https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN")
+x.send_message("hello")
+```
+
+## More examples
+
+Change the webhook username:
+
+```python
+import webhookspot
+
+hook = webhookspot.Webhook("https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN")
+hook.send_message("Hello from webhookspot!", username="WebhookSpot Bot")
+```
+
+Send an embed:
+
+```python
+import webhookspot
+
+hook = webhookspot.Webhook("https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN")
+
+hook.send_embed(
+    title="WebhookSpot",
+    description="This is an embed message.",
+    color=0x5865F2
+)
+```
+
+## Safety note
+
+Do not post your real Discord webhook URL publicly. Anyone with the URL can send messages through it.

webhookspot-1.0.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=77.0.3", "wheel"]
+build-backend = "setuptools.build_meta"

webhookspot-1.0.0/setup.cfg

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

webhookspot-1.0.0/setup.py

@@ -0,0 +1,18 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="webhookspot",
+    version="1.0.0",
+    description="A tiny Python library for sending Discord webhook messages.",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    author="webhookspot",
+    packages=find_packages(),
+    python_requires=">=3.8",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3 :: Only",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+)

webhookspot-1.0.0/webhookspot/__init__.py

@@ -0,0 +1,4 @@
+from .core import Webhook, WebhookError
+
+__all__ = ["Webhook", "WebhookError"]
+__version__ = "1.0.0"

webhookspot-1.0.0/webhookspot/core.py

@@ -0,0 +1,148 @@
+import json
+import urllib.error
+import urllib.request
+from typing import Any, Dict, List, Optional
+
+
+class WebhookError(Exception):
+    """Raised when Discord rejects the webhook request."""
+
+
+class Webhook:
+    """
+    Simple Discord webhook sender.
+
+    Example:
+        import webhookspot
+
+        x = webhookspot.Webhook("https://discord.com/api/webhooks/...")
+        x.send_message("hello")
+    """
+
+    def __init__(self, url: str):
+        if not isinstance(url, str) or not url.strip():
+            raise ValueError("Webhook URL must be a non-empty string.")
+
+        if "discord.com/api/webhooks/" not in url and "discordapp.com/api/webhooks/" not in url:
+            raise ValueError("This does not look like a Discord webhook URL.")
+
+        self.url = url.strip()
+
+    def _post(self, payload: Dict[str, Any]) -> Dict[str, Any]:
+        data = json.dumps(payload).encode("utf-8")
+
+        req = urllib.request.Request(
+            self.url,
+            data=data,
+            headers={
+                "Content-Type": "application/json",
+                "User-Agent": "webhookspot/1.0.0",
+            },
+            method="POST",
+        )
+
+        try:
+            with urllib.request.urlopen(req, timeout=15) as response:
+                text = response.read().decode("utf-8", errors="replace")
+                if text:
+                    try:
+                        return json.loads(text)
+                    except json.JSONDecodeError:
+                        return {"raw": text}
+                return {"ok": True, "status": response.status}
+
+        except urllib.error.HTTPError as e:
+            body = e.read().decode("utf-8", errors="replace")
+            raise WebhookError(f"Discord returned HTTP {e.code}: {body}") from e
+
+        except urllib.error.URLError as e:
+            raise WebhookError(f"Could not connect to Discord: {e}") from e
+
+    def send_message(
+        self,
+        message: str,
+        username: Optional[str] = None,
+        avatar_url: Optional[str] = None,
+        tts: bool = False,
+    ) -> Dict[str, Any]:
+        """
+        Send a normal text message.
+
+        Args:
+            message: The message to send.
+            username: Optional custom webhook username.
+            avatar_url: Optional custom webhook avatar URL.
+            tts: Whether Discord should read the message using text-to-speech.
+
+        Returns:
+            A dictionary with request result information.
+        """
+        if not isinstance(message, str) or not message:
+            raise ValueError("Message must be a non-empty string.")
+
+        payload: Dict[str, Any] = {
+            "content": message,
+            "tts": bool(tts),
+        }
+
+        if username:
+            payload["username"] = username
+
+        if avatar_url:
+            payload["avatar_url"] = avatar_url
+
+        return self._post(payload)
+
+    def send_embed(
+        self,
+        title: Optional[str] = None,
+        description: Optional[str] = None,
+        color: Optional[int] = None,
+        fields: Optional[List[Dict[str, Any]]] = None,
+        username: Optional[str] = None,
+        avatar_url: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Send a simple Discord embed.
+
+        Args:
+            title: Embed title.
+            description: Embed description.
+            color: Embed color as an integer, like 0x5865F2.
+            fields: Optional list of embed fields.
+            username: Optional custom webhook username.
+            avatar_url: Optional custom webhook avatar URL.
+
+        Returns:
+            A dictionary with request result information.
+        """
+        embed: Dict[str, Any] = {}
+
+        if title:
+            embed["title"] = title
+
+        if description:
+            embed["description"] = description
+
+        if color is not None:
+            if not isinstance(color, int):
+                raise ValueError("Color must be an integer, like 0x5865F2.")
+            embed["color"] = color
+
+        if fields:
+            embed["fields"] = fields
+
+        if not embed:
+            raise ValueError("Embed must have at least a title, description, color, or fields.")
+
+        payload: Dict[str, Any] = {
+            "embeds": [embed],
+        }
+
+        if username:
+            payload["username"] = username
+
+        if avatar_url:
+            payload["avatar_url"] = avatar_url
+
+        return self._post(payload)

webhookspot-1.0.0/webhookspot.egg-info/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: webhookspot
+Version: 1.0.0
+Summary: A tiny Python library for sending Discord webhook messages.
+Author: webhookspot
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+# webhookspot
+
+`webhookspot` is a tiny Python library for sending Discord webhook messages.
+
+## Install locally
+
+Open a terminal in this folder and run:
+
+```bash
+py -m pip install .
+```
+
+or:
+
+```bash
+pip install .
+```
+
+## Example
+
+```python
+import webhookspot
+
+x = webhookspot.Webhook("https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN")
+x.send_message("hello")
+```
+
+## More examples
+
+Change the webhook username:
+
+```python
+import webhookspot
+
+hook = webhookspot.Webhook("https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN")
+hook.send_message("Hello from webhookspot!", username="WebhookSpot Bot")
+```
+
+Send an embed:
+
+```python
+import webhookspot
+
+hook = webhookspot.Webhook("https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN")
+
+hook.send_embed(
+    title="WebhookSpot",
+    description="This is an embed message.",
+    color=0x5865F2
+)
+```
+
+## Safety note
+
+Do not post your real Discord webhook URL publicly. Anyone with the URL can send messages through it.

webhookspot-1.0.0/webhookspot.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+webhookspot/__init__.py
+webhookspot/core.py
+webhookspot.egg-info/PKG-INFO
+webhookspot.egg-info/SOURCES.txt
+webhookspot.egg-info/dependency_links.txt
+webhookspot.egg-info/top_level.txt

webhookspot-1.0.0/webhookspot.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

webhookspot-1.0.0/webhookspot.egg-info/top_level.txt

@@ -0,0 +1 @@
+webhookspot