osbot-utils 2.57.0__tar.gz → 2.59.0__tar.gz

{osbot_utils-2.57.0 → osbot_utils-2.59.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: osbot_utils
-Version: 2.57.0
+Version: 2.59.0
 Summary: OWASP Security Bot - Utils
 License: MIT
 Author: Dinis Cruz
@@ -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-v2.57.0-blue)
+![Current Release](https://img.shields.io/badge/release-v2.59.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-2.57.0 → osbot_utils-2.59.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-v2.57.0-blue)
+![Current Release](https://img.shields.io/badge/release-v2.59.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-2.57.0 → osbot_utils-2.59.0}/osbot_utils/helpers/ast/Ast_Base.py

@@ -1,11 +1,11 @@
 import ast
 import inspect
 
-from osbot_utils.utils.Dev import pprint, jprint
-from osbot_utils.utils.Exceptions import syntax_error
-from osbot_utils.utils.Files import is_file, file_contents
-from osbot_utils.utils.Objects import obj_data, obj_info
-from osbot_utils.utils.Str import str_dedent
+from osbot_utils.utils.Dev          import pprint, jprint
+from osbot_utils.utils.Exceptions   import syntax_error
+from osbot_utils.utils.Files        import is_file, file_contents
+from osbot_utils.utils.Objects      import obj_data, obj_info
+from osbot_utils.utils.Str          import str_dedent
 
 
 class Ast_Base:

{osbot_utils-2.57.0 → osbot_utils-2.59.0}/osbot_utils/helpers/safe_str/Safe_Str.py

@@ -37,6 +37,9 @@ class Safe_Str(str):
         elif not cls.exact_length and len(value) > cls.max_length:                                                      # Check max length
             raise ValueError(f"Value exceeds maximum length of {cls.max_length} characters (was {len(value)})")
 
+        if cls.allow_empty and value =='':
+            return str.__new__(cls, '')
+
         if cls.strict_validation:                                                                                       # If using strict validation, check if the value matches the regex pattern exactly
             if not cls.regex.search(value) is None:                                                                     # If there are non-matching characters
                 raise ValueError(f"Value contains invalid characters (must match pattern: {cls.regex.pattern})")

osbot_utils-2.59.0/osbot_utils/helpers/safe_str/http/Safe_Str__Http__Content_Type.py

@@ -0,0 +1,12 @@
+import re
+from osbot_utils.helpers.safe_str.Safe_Str import Safe_Str
+
+TYPE_SAFE_STR__HTTP__CONTENT_TYPE__REGEX = re.compile(r'[^a-zA-Z0-9/\-+.;= ]')
+TYPE_SAFE_STR__HTTP__CONTENT_TYPE__MAX_LENGTH = 256
+
+class Safe_Str__Http__Content_Type(Safe_Str):
+    regex                      = TYPE_SAFE_STR__HTTP__CONTENT_TYPE__REGEX
+    max_length                 = TYPE_SAFE_STR__HTTP__CONTENT_TYPE__MAX_LENGTH
+    allow_empty                = False
+    trim_whitespace            = True
+    allow_all_replacement_char = False

osbot_utils-2.59.0/osbot_utils/helpers/safe_str/http/Safe_Str__Http__ETag.py

@@ -0,0 +1,10 @@
+import re
+from osbot_utils.helpers.safe_str.Safe_Str import Safe_Str
+
+TYPE_SAFE_STR__HTTP__ETAG__REGEX = re.compile(r'[^a-zA-Z0-9"\/\-_.:]')  # Allow alphanumerics, quotes, slashes, hyphens, underscores, periods, colons
+TYPE_SAFE_STR__HTTP__ETAG__MAX_LENGTH = 128
+
+class Safe_Str__Http__ETag(Safe_Str):
+    regex                      = TYPE_SAFE_STR__HTTP__ETAG__REGEX
+    max_length                 = TYPE_SAFE_STR__HTTP__ETAG__MAX_LENGTH
+    trim_whitespace            = True

osbot_utils-2.59.0/osbot_utils/helpers/safe_str/http/Safe_Str__Http__Last_Modified.py

@@ -0,0 +1,10 @@
+import re
+from osbot_utils.helpers.safe_str.Safe_Str import Safe_Str
+
+TYPE_SAFE_STR__HTTP__LAST_MODIFIED__REGEX = re.compile(r'[^a-zA-Z0-9:, -]')
+TYPE_SAFE_STR__HTTP__LAST_MODIFIED__MAX_LENGTH = 64
+
+class Safe_Str__Http__Last_Modified(Safe_Str):
+    regex                      = TYPE_SAFE_STR__HTTP__LAST_MODIFIED__REGEX
+    max_length                 = TYPE_SAFE_STR__HTTP__LAST_MODIFIED__MAX_LENGTH
+    trim_whitespace            = True

osbot_utils-2.59.0/osbot_utils/helpers/safe_str/http/Safe_Str__Http__Text.py

@@ -0,0 +1,35 @@
+import re
+from osbot_utils.helpers.safe_str.Safe_Str import Safe_Str
+
+
+TYPE_SAFE_STR__TEXT__MAX_LENGTH = 1048576           # Define the size constant - 1 megabyte in bytes
+
+# A more permissive regex that primarily filters out:
+# - NULL byte (U+0000)
+# - Control characters (U+0001 to U+0008, U+000B to U+000C, U+000E to U+001F)
+# - Some potentially problematic characters in various contexts
+# But allows:
+# - All standard printable ASCII characters
+# - Tab (U+0009), Line Feed (U+000A), and Carriage Return (U+000D)
+# - A wide range of punctuation, symbols, and Unicode characters for international text
+
+TYPE_SAFE_STR__HTTP__TEXT__REGEX = re.compile(r'[\x00\x01-\x08\x0B\x0C\x0E-\x1F\x7F]')
+
+class Safe_Str__Http__Text(Safe_Str):
+    """
+    Safe string class for general text content with a 1MB limit.
+    Allows a wide range of characters suitable for natural language text,
+    including international characters, while filtering out control characters
+    and other potentially problematic sequences.
+    """
+    max_length                  = TYPE_SAFE_STR__TEXT__MAX_LENGTH
+    regex                       = TYPE_SAFE_STR__HTTP__TEXT__REGEX
+    trim_whitespace             = True              # Trim leading/trailing whitespace
+    normalize_newlines          = True              # Option to normalize different newline styles
+
+    def __new__(cls, value=None):
+
+        if cls.normalize_newlines and value is not None and isinstance(value, str):         # Handle newline normalization before passing to parent class
+            value = value.replace('\r\n', '\n').replace('\r', '\n')                         # Normalize different newline styles to \n
+
+        return super().__new__(cls, value)                                                  # Now call the parent implementation

{osbot_utils-2.57.0 → osbot_utils-2.59.0}/osbot_utils/utils/Functions.py

@@ -25,13 +25,13 @@ def function_name(function):
     if isinstance(function, types.FunctionType):
         return function.__name__
 
-def function_source_code(function):
-    if isinstance(function, types.FunctionType):
-        source_code = inspect.getsource(function)
+def function_source_code(target):
+    if isinstance(target, (types.FunctionType, types.MethodType)):
+        source_code = inspect.getsource(target)
         source_code = textwrap.dedent(source_code).strip()
         return source_code
-    elif isinstance(function, str):
-        return function
+    elif isinstance(target, str):                               # todo: see if we really need this logic (or we just return none when "target" is a str)
+        return target
     return None
 
 def get_line_number(function):
@@ -110,4 +110,5 @@ def type_file(target):
 
 
 function_line_number = get_line_number
-method_line_number   = get_line_number
+method_line_number   = get_line_number
+method_source_code   = function_source_code

osbot_utils-2.59.0/osbot_utils/version

@@ -0,0 +1 @@
+v2.59.0

{osbot_utils-2.57.0 → osbot_utils-2.59.0}/pyproject.toml

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

osbot_utils-2.57.0/osbot_utils/version

@@ -1 +0,0 @@
-v2.57.0