dswebhook 0.2.2__tar.gz → 0.2.4__tar.gz

dswebhook-0.2.4/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: dswebhook
+Version: 0.2.4
+Summary: Lib for easy use of discord webhook
+Author: Beks1k
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Dynamic: license-file
+
+# 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.
+
+## Exceptions
+
+The module imports 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.
+- **`NotJSON`**: Triggers if given value isnt JSON
+
+## 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.
+- **`customJSON`**: Must be a variable dictionary, sends custom JSON request for custom url
+
+## 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}")
+```
+
+### Usage example for custom JSON request
+
+```python
+import dswebhook as dsw
+
+# 1. Initialize dswebhook with ID 
+
+customData = {
+    "auth":"User"
+    "token":"token"
+    ...
+}
+
+dsw.init("https://your-custom-URL...", id=1)
+dsw.init("https://your-custom-URL...", id="backup_channel")
+
+# 2. Send logs with debugging features enabled
+try:
+    # Sends a message with custom JSON and prints out status code and server raw response text
+dsw.send("System updated successfully!", ids=1, statCode=True, flush=True, customJSON=customData )
+
+    # 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 → dswebhook-0.2.4}/README.md

@@ -2,9 +2,9 @@
 
 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
+## Exceptions
 
-The module imports custom exceptions from an external `exceptions` file:
+The module imports 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.
@@ -15,6 +15,7 @@ The module imports custom exceptions from an external `exceptions` file:
 - **`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.
+- **`NotJSON`**: Triggers if given value isnt JSON
 
 ## Core Functions
 
@@ -28,6 +29,7 @@ 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.
+- **`customJSON`**: Must be a variable dictionary, sends custom JSON request for custom url
 
 ## Usage Example
 
@@ -36,7 +38,8 @@ import dswebhook as dsw
 
 # 1. Initialize dswebhook with ID 
 
-dsw.init("https://discord.com...", id=1)dsw.init("https://discord.com...", "id="backup_channel")
+dsw.init("https://discord.com...", id=1)
+dsw.init("https://discord.com...", id="backup_channel")
 
 # 2. Send logs with debugging features enabled
 try:
@@ -53,3 +56,35 @@ except dsw.NoSuchID as e:
 except dsw.HTTPError as e:
     print(f"Server communication failed: {e}")
 ```
+
+### Usage example for custom JSON request
+
+```python
+import dswebhook as dsw
+
+# 1. Initialize dswebhook with ID 
+
+customData = {
+    "auth":"User"
+    "token":"token"
+    ...
+}
+
+dsw.init("https://your-custom-URL...", id=1)
+dsw.init("https://your-custom-URL...", id="backup_channel")
+
+# 2. Send logs with debugging features enabled
+try:
+    # Sends a message with custom JSON and prints out status code and server raw response text
+dsw.send("System updated successfully!", ids=1, statCode=True, flush=True, customJSON=customData )
+
+    # 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 → dswebhook-0.2.4}/pyproject.toml

@@ -4,7 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dswebhook"
-version = "0.2.2"
+version = "0.2.4"
+readme = "README.md"
 description = "Lib for easy use of discord webhook"
 requires-python = ">=3.8"
 authors = [

{dswebhook-0.2.2 → dswebhook-0.2.4}/src/dswebhook/dswebhook.py

@@ -2,7 +2,7 @@ import requests
 
 from exceptions import (
     InvalidURL, SchemaError, AlreadyExists, NoSuchID, 
-    ContentTooLarge, ConnectionError, BadRequest, InternalServerError, HTTPError
+    ContentTooLarge, ConnectionError, BadRequest, InternalServerError, HTTPError, NotJSON
 )
 urlr = {}
 
@@ -15,7 +15,7 @@ def init(url:str, id=1):
         raise AlreadyExists(f"{id} ALREADY EXSISTS")
     urlr[id] = url
 
-def send(content:str, ids, statCode:bool=False, flush:bool = False):
+def send(content:str, ids, statCode:bool=False, flush:bool = False, customJSON = {}):
     '''Send content to specified webhook'''
     global urlr
     if not urlr:
@@ -25,23 +25,27 @@ def send(content:str, ids, statCode:bool=False, flush:bool = False):
     data = {
         "content":content
     }
+    if not isinstance(customJSON, dict):
+        raise NotJSON("customJSON PARAMETR IS NOT DICTIONARY. FOR id{ids}")
+    if customJSON:
+        data = customJSON
     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")
+        raise ConnectionError(f"CONNECTION ERROR FOR id={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}")
+        raise SchemaError(f"MUST BE WITH https:// OR http:// IF HTTPS NOT SUPPORTED. FOR id={ids}")
     
     if a.status_code == 400:
-        raise BadRequest(f"BAD REQUEST (HTTP ERROR: 400) FOR {ids}")
+        raise BadRequest(f"BAD REQUEST (HTTP ERROR: 400). FOR id{ids}")
     
     if a.status_code == 500:
-        raise InternalServerError(f"INTERNAL SERVER ERROR (HTTP ERROR: 500) FOR {ids}")
+        raise InternalServerError(f"INTERNAL SERVER ERROR (HTTP ERROR: 500). FOR id={ids}")
 
     if not a.ok:
-        raise HTTPError(f"SERVER RETURNED NOT 2xx RESPONSE {a.status_code} FOR {ids}")
+        raise HTTPError(f"SERVER RETURNED NOT 2xx RESPONSE {a.status_code}. FOR id={ids}")
     
     if statCode:
         print(a.status_code, f"FOR {ids}")

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

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: dswebhook
+Version: 0.2.4
+Summary: Lib for easy use of discord webhook
+Author: Beks1k
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Dynamic: license-file
+
+# 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.
+
+## Exceptions
+
+The module imports 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.
+- **`NotJSON`**: Triggers if given value isnt JSON
+
+## 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.
+- **`customJSON`**: Must be a variable dictionary, sends custom JSON request for custom url
+
+## 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}")
+```
+
+### Usage example for custom JSON request
+
+```python
+import dswebhook as dsw
+
+# 1. Initialize dswebhook with ID 
+
+customData = {
+    "auth":"User"
+    "token":"token"
+    ...
+}
+
+dsw.init("https://your-custom-URL...", id=1)
+dsw.init("https://your-custom-URL...", id="backup_channel")
+
+# 2. Send logs with debugging features enabled
+try:
+    # Sends a message with custom JSON and prints out status code and server raw response text
+dsw.send("System updated successfully!", ids=1, statCode=True, flush=True, customJSON=customData )
+
+    # 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 → dswebhook-0.2.4}/src/exceptions.py

@@ -32,4 +32,8 @@ class AlreadyExists(Exception):
 
 class HTTPError(Exception):
     '''When other HTTP error accures'''
+    pass
+
+class NotJSON(Exception):
+    '''If customJSON is not a dictionary'''
     pass

dswebhook-0.2.2/PKG-INFO

@@ -1,9 +0,0 @@
-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/PKG-INFO

@@ -1,9 +0,0 @@
-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