dswebhook 0.2.3__tar.gz → 0.2.4__tar.gz

{dswebhook-0.2.3/src/dswebhook.egg-info → dswebhook-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dswebhook
-Version: 0.2.3
+Version: 0.2.4
 Summary: Lib for easy use of discord webhook
 Author: Beks1k
 Requires-Python: >=3.8
@@ -13,9 +13,9 @@ Dynamic: license-file
 
 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.
@@ -26,6 +26,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
 
@@ -39,6 +40,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
 
@@ -47,7 +49,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:
@@ -64,3 +67,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.3 → 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.3 → dswebhook-0.2.4}/pyproject.toml

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

{dswebhook-0.2.3 → 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 = {}
 
@@ -25,6 +25,8 @@ def send(content:str, ids, statCode:bool=False, flush:bool = False, customJSON =
     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:
@@ -32,18 +34,18 @@ def send(content:str, ids, statCode:bool=False, flush:bool = False, customJSON =
     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.3 → dswebhook-0.2.4/src/dswebhook.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dswebhook
-Version: 0.2.3
+Version: 0.2.4
 Summary: Lib for easy use of discord webhook
 Author: Beks1k
 Requires-Python: >=3.8
@@ -13,9 +13,9 @@ Dynamic: license-file
 
 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.
@@ -26,6 +26,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
 
@@ -39,6 +40,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
 
@@ -47,7 +49,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:
@@ -64,3 +67,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.3 → 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