dswebhook 0.2.3__tar.gz → 0.2.5__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dswebhook
-Version: 0.2.3
+Version: 0.2.5
 Summary: Lib for easy use of discord webhook
 Author: Beks1k
 Requires-Python: >=3.8
@@ -13,9 +13,8 @@ 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:
 
 - **`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 +25,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 +39,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 +48,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 +66,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.5}/README.md

@@ -2,9 +2,8 @@
 
 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:
 
 - **`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 +14,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 +28,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 +37,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 +55,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.5}/pyproject.toml

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

{dswebhook-0.2.3 → dswebhook-0.2.5}/src/dswebhook/dswebhook.py

@@ -1,9 +1,45 @@
 import requests
 
-from exceptions import (
-    InvalidURL, SchemaError, AlreadyExists, NoSuchID, 
-    ContentTooLarge, ConnectionError, BadRequest, InternalServerError, HTTPError
-)
+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
+
+class NotJSON(Exception):
+    '''If customJSON is not a dictionary'''
+    pass
+
 urlr = {}
 
 def init(url:str, id=1):
@@ -25,6 +61,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 +70,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.5/src/dswebhook.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dswebhook
-Version: 0.2.3
+Version: 0.2.5
 Summary: Lib for easy use of discord webhook
 Author: Beks1k
 Requires-Python: >=3.8
@@ -13,9 +13,8 @@ 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:
 
 - **`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 +25,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 +39,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 +48,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 +66,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.5}/src/dswebhook.egg-info/SOURCES.txt

@@ -1,7 +1,6 @@
 LICENSE
 README.md
 pyproject.toml
-src/exceptions.py
 src/dswebhook/__init__.py
 src/dswebhook/dswebhook.py
 src/dswebhook.egg-info/PKG-INFO

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

@@ -0,0 +1 @@
+dswebhook

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

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

dswebhook-0.2.3/src/exceptions.py

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