osbot-utils 1.87.0__tar.gz → 1.88.0__tar.gz

{osbot_utils-1.87.0 → osbot_utils-1.88.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: osbot_utils
-Version: 1.87.0
+Version: 1.88.0
 Summary: OWASP Security Bot - Utils
 Home-page: https://github.com/owasp-sbot/OSBot-Utils
 License: MIT
@@ -23,7 +23,7 @@ Description-Content-Type: text/markdown
 
 Powerful Python util methods and classes that simplify common apis and tasks.
 
-![Current Release](https://img.shields.io/badge/release-v1.87.0-blue)
+![Current Release](https://img.shields.io/badge/release-v1.88.0-blue)
 [![codecov](https://codecov.io/gh/owasp-sbot/OSBot-Utils/graph/badge.svg?token=GNVW0COX1N)](https://codecov.io/gh/owasp-sbot/OSBot-Utils)
 
 

{osbot_utils-1.87.0 → osbot_utils-1.88.0}/README.md

@@ -2,7 +2,7 @@
 
 Powerful Python util methods and classes that simplify common apis and tasks.
 
-![Current Release](https://img.shields.io/badge/release-v1.87.0-blue)
+![Current Release](https://img.shields.io/badge/release-v1.88.0-blue)
 [![codecov](https://codecov.io/gh/owasp-sbot/OSBot-Utils/graph/badge.svg?token=GNVW0COX1N)](https://codecov.io/gh/owasp-sbot/OSBot-Utils)
 
 

osbot_utils-1.88.0/osbot_utils/helpers/Guid.py

@@ -0,0 +1,18 @@
+import uuid
+
+from osbot_utils.utils.Misc import is_guid
+
+GUID__NAMESPACE = uuid.UUID('2cfec064-537a-4ff7-8fdc-2fc9e2606f3d')
+
+class Guid(str):
+    def __new__(cls, value: str):
+        if not isinstance(value, str):                                                  # Check if the value is a string
+            raise ValueError(f'in Guid: value provided was not a string: {value}')      # if not raise a ValueError
+        if is_guid(value):
+            guid = value
+        else:
+            guid = uuid.uuid5(GUID__NAMESPACE, value)                                       # Generate a UUID5 using the namespace and value
+        return super().__new__(cls, str(guid))                                          # Return a new instance of Guid initialized with the string version of the UUID
+
+    def __str__(self):
+        return self

{osbot_utils-1.87.0 → osbot_utils-1.88.0}/osbot_utils/helpers/Random_Guid.py

@@ -11,4 +11,4 @@ class Random_Guid(str):
         raise ValueError(f'in Random_Guid: value provided was not a Guid: {value}')
 
     def __str__(self):
-        return self
+        return self

{osbot_utils-1.87.0 → osbot_utils-1.88.0}/osbot_utils/helpers/Safe_Id.py

@@ -2,10 +2,10 @@ from osbot_utils.utils.Misc import random_id_short
 from osbot_utils.utils.Str  import safe_id
 
 class Safe_Id(str):
-    def __new__(cls, value=None):
+    def __new__(cls, value=None, max_length=36):
         if value is None:
             value = safe_id(random_id_short('safe-id'))
-        sanitized_value = safe_id(value)
+        sanitized_value = safe_id(value, max_length=max_length)
         return str.__new__(cls, sanitized_value)
 
     def __str__(self):

osbot_utils-1.88.0/osbot_utils/helpers/Str_ASCII.py

@@ -0,0 +1,22 @@
+import re
+
+REGEX__ASCII_VALUE = re.compile(r'[^a-zA-Z0-9_\s!@#$%^&*()\[\]{}\-+=:;,.?]')
+
+class Str_ASCII(str):
+    """
+    A string subclass that ensures values only contain safe ASCII characters.
+    Replaces any unsafe characters with underscores.
+    """
+    def __new__(cls, value=None, max_length=None):
+        if value is None:
+            value = ""
+
+        if not isinstance(value, str):
+            value = str(value)
+
+        if max_length and len(value) > max_length:
+            raise ValueError(f"Value length exceeds maximum of {max_length} characters (was {len(value)})")
+
+        sanitized_value = REGEX__ASCII_VALUE.sub('_', value)
+
+        return super().__new__(cls, sanitized_value)

{osbot_utils-1.87.0 → osbot_utils-1.88.0}/osbot_utils/utils/Misc.py

@@ -178,7 +178,6 @@ def is_guid(value):
     except Exception:
         return False
 
-
 def ignore_warning__unclosed_ssl():
     import warnings
     warnings.filterwarnings("ignore", category=ResourceWarning, message="unclosed.*<ssl.SSLSocket.*>")

{osbot_utils-1.87.0 → osbot_utils-1.88.0}/osbot_utils/utils/Objects.py

@@ -109,11 +109,13 @@ def convert_dict_to_value_from_obj_annotation(target, attr_name, value):
 
 def convert_to_value_from_obj_annotation(target, attr_name, value):                             # todo: see the side effects of doing this for all ints and floats
 
-    from osbot_utils.helpers.Safe_Id        import Safe_Id
+    from osbot_utils.helpers.Guid           import Guid
     from osbot_utils.helpers.Timestamp_Now  import Timestamp_Now
     from osbot_utils.helpers.Random_Guid    import Random_Guid
+    from osbot_utils.helpers.Safe_Id        import Safe_Id
+    from osbot_utils.helpers.Str_ASCII      import Str_ASCII
 
-    TYPE_SAFE__CONVERT_VALUE__SUPPORTED_TYPES = [Safe_Id, Random_Guid, Timestamp_Now]
+    TYPE_SAFE__CONVERT_VALUE__SUPPORTED_TYPES = [Guid, Random_Guid, Safe_Id, Str_ASCII, Timestamp_Now]
 
     if target is not None and attr_name is not None:
         if hasattr(target, '__annotations__'):

{osbot_utils-1.87.0 → osbot_utils-1.88.0}/osbot_utils/utils/Str.py

@@ -34,14 +34,14 @@ def strip_quotes(value: str):                           # Remove surrounding quo
         return value[1:-1]
     return value
 
-def safe_id(value):
+def safe_id(value, max_length=36):
     if value is None or value == "":
         raise ValueError("Invalid ID: The ID must not be empty.")
 
     if not isinstance(value, str):
         value = str(value)
 
-    if len(value) > 36:
+    if len(value) > max_length:
         raise ValueError(f"Invalid ID: The ID must not exceed 36 characters (was {len(value)}).")
 
     sanitized_value = REGEX__SAFE_ID_REGEX.sub('_', value)

osbot_utils-1.88.0/osbot_utils/version

@@ -0,0 +1 @@
+v1.88.0

{osbot_utils-1.87.0 → osbot_utils-1.88.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name        = "osbot_utils"
-version     = "v1.87.0"
+version     = "v1.88.0"
 description = "OWASP Security Bot - Utils"
 authors     = ["Dinis Cruz <dinis.cruz@owasp.org>"]
 license     = "MIT"

osbot_utils-1.87.0/osbot_utils/version

@@ -1 +0,0 @@
-v1.87.0