dswebhook 0.2.2__tar.gz

dswebhook-0.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Beks1k
+
+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.

dswebhook-0.2.2/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: dswebhook
+Version: 0.2.2
+Summary: Lib for easy use of discord webhook
+Author: Beks1k
+Requires-Python: >=3.8
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Dynamic: license-file

dswebhook-0.2.2/README.md

@@ -0,0 +1,55 @@
+# Simple Multi-Webhook Wrapper
+
+A minimal and efficient Python wrapper for managing and sending messages to multiple webhooks simultaneously using numeric or string IDs. It includes built-in safeguards, response flashing, and clean custom error descriptions.
+
+## Custom Exceptions
+
+The module imports custom exceptions from an external `exceptions` file:
+
+- **`InvalidURL`**: Raised if the URL string is empty or missing.
+- **`AlreadyExists`**: Raised if you try to register a URL on an ID that is already taken.
+- **`NoSuchID`**: Raised if you try to send a message using an uninitialized ID.
+- **`ContentTooLarge`**: Raised if the text payload exceeds the 2000-character limit.
+- **`ConnectionError`**: Network issues or host is completely unreachable.
+- **`SchemaError`**: Raised when the URL format misses `http://` or `https://`.
+- **`BadRequest`**: Server returned an explicit HTTP `400` error.
+- **`InternalServerError`**: Server encountered a critical HTTP `500` error.
+- **`HTTPError`**: Triggers for any other non-2xx server responses.
+
+## Core Functions
+
+### `init(url: str, id=1)`
+Registers a webhook URL under a unique identifier.
+- **Default ID:** `1`
+- **Raises:** `InvalidURL` if the URL is empty, `AlreadyExists` if the ID is already registered.
+
+### `send(content: str, ids, statCode: bool = False, flush: bool = False)`
+Dispatches a payload string to the webhook registered under the specified `ids`.
+- **`ids`**: The target webhook identifier.
+- **`statCode`**: If set to `True`, prints the server response status code in the console.
+- **`flush`**: If set to `True`, prints the raw text/JSON response returned from the server endpoint.
+
+## Usage Example
+
+```python
+import dswebhook as dsw
+
+# 1. Initialize dswebhook with ID 
+
+dsw.init("https://discord.com...", id=1)dsw.init("https://discord.com...", "id="backup_channel")
+
+# 2. Send logs with debugging features enabled
+try:
+    # Sends a message and prints out status code and server raw response text
+dsw.send("System updated successfully!", ids=1, statCode=True, flush=True)
+
+    # Sends a message to the second text channel using a string ID
+dsw.send("Alert triggered.", ids="backup_channel")
+
+except dsw.AlreadyExists as e:
+    print(f"Configuration conflict: {e}")
+except dsw.NoSuchID as e:
+    print(f"Targeting error: {e}")
+except dsw.HTTPError as e:
+    print(f"Server communication failed: {e}")
+```

dswebhook-0.2.2/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dswebhook"
+version = "0.2.2"
+description = "Lib for easy use of discord webhook"
+requires-python = ">=3.8"
+authors = [
+    { name = "Beks1k"}
+]
+dependencies = [
+    "requests>=2.28.0",
+]
+
+[tool.setuptools]
+# Указываем setuptools искать пакеты строго внутри директории src
+package-dir = {"" = "src"}

dswebhook-0.2.2/setup.cfg

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

dswebhook-0.2.2/src/dswebhook/__init__.py

@@ -0,0 +1,3 @@
+from .dswebhook import init, send
+
+__all__ = ["init", "send"]

dswebhook-0.2.2/src/dswebhook/dswebhook.py

@@ -0,0 +1,53 @@
+import requests
+
+from exceptions import (
+    InvalidURL, SchemaError, AlreadyExists, NoSuchID, 
+    ContentTooLarge, ConnectionError, BadRequest, InternalServerError, HTTPError
+)
+urlr = {}
+
+def init(url:str, id=1):
+    '''specify webhook url and id (Deafult 1)'''
+    global urlr
+    if not url:
+        raise InvalidURL(f"MUST BE VALID URL FOR ID {id}")
+    if id in urlr:
+        raise AlreadyExists(f"{id} ALREADY EXSISTS")
+    urlr[id] = url
+
+def send(content:str, ids, statCode:bool=False, flush:bool = False):
+    '''Send content to specified webhook'''
+    global urlr
+    if not urlr:
+        raise InvalidURL("FIRST SPECIFY URL USING init(url, id) MODULE")
+    if len(content) > 2000:
+        raise ContentTooLarge(f"TOO LARGE CONTENT FOR {ids}")
+    data = {
+        "content":content
+    }
+    if urlr.get(ids) == None:
+        raise NoSuchID(f"NOT FOUND {ids}")
+    try:
+        a = requests.post(urlr.get(ids), json=data)
+    except requests.exceptions.ConnectionError:
+        raise ConnectionError(f"CONNECTION ERROR FOR {ids} PLEASE CHECK CONNETCTION AND URL FOR ANY ERRORS")
+    except requests.exceptions.MissingSchema:
+        raise SchemaError(f"MUST BE WITH https:// OR http:// IF HTTPS NOT SUPPORTED FOR {ids}")
+    
+    if a.status_code == 400:
+        raise BadRequest(f"BAD REQUEST (HTTP ERROR: 400) FOR {ids}")
+    
+    if a.status_code == 500:
+        raise InternalServerError(f"INTERNAL SERVER ERROR (HTTP ERROR: 500) FOR {ids}")
+
+    if not a.ok:
+        raise HTTPError(f"SERVER RETURNED NOT 2xx RESPONSE {a.status_code} FOR {ids}")
+    
+    if statCode:
+        print(a.status_code, f"FOR {ids}")
+
+    if flush:
+        if a.text == "":
+            print(f"NOTHING FROM SERVER FOR {ids}")
+        else:
+            print(a.text, f"FOR {ids}")

dswebhook-0.2.2/src/dswebhook.egg-info/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: dswebhook
+Version: 0.2.2
+Summary: Lib for easy use of discord webhook
+Author: Beks1k
+Requires-Python: >=3.8
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Dynamic: license-file

dswebhook-0.2.2/src/dswebhook.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/exceptions.py
+src/dswebhook/__init__.py
+src/dswebhook/dswebhook.py
+src/dswebhook.egg-info/PKG-INFO
+src/dswebhook.egg-info/SOURCES.txt
+src/dswebhook.egg-info/dependency_links.txt
+src/dswebhook.egg-info/requires.txt
+src/dswebhook.egg-info/top_level.txt

dswebhook-0.2.2/src/dswebhook.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dswebhook-0.2.2/src/dswebhook.egg-info/requires.txt

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

dswebhook-0.2.2/src/dswebhook.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+dswebhook
+exceptions

dswebhook-0.2.2/src/exceptions.py

@@ -0,0 +1,35 @@
+class BadRequest(Exception):
+    '''When 400 hits in'''
+    pass
+
+class InternalServerError(Exception):
+    '''When 500 hits in'''
+    pass
+
+class InvalidURL(Exception):
+    '''When Invalid url is given'''
+    pass
+
+class ContentTooLarge(Exception):
+    '''When Given content bigger than 2000'''
+    pass
+
+class ConnectionError(Exception):
+    '''When Connection error accures such as no inter net etc.'''
+    pass
+
+class SchemaError(Exception):
+    '''When schema not right'''
+    pass
+
+class NoSuchID(Exception):
+    '''When id is not found in urlr'''
+    pass
+
+class AlreadyExists(Exception):
+    '''When id is already exists in urlr'''
+    pass
+
+class HTTPError(Exception):
+    '''When other HTTP error accures'''
+    pass