abstract-utilities 0.2.2.540__py3-none-any.whl → 0.2.2.667__py3-none-any.whl

abstract_utilities/type_utils/is_type.py

@@ -0,0 +1,455 @@
+def is_iterable(obj:any):
+    try:
+        iterator=iter(obj)
+    except TypeError:
+        return False
+    else:
+        return True
+    return True
+
+def get_type(obj:any) -> any:
+    """
+    Determines the type of the input object.
+
+    Args:
+        obj: The object to determine the type of.
+
+    Returns:
+        any: The object with the updated type.
+    """
+    if is_number(obj):
+        obj = int(obj)
+    if is_float(obj):
+        return float(obj)
+    elif obj == 'None':
+        obj = None
+    elif is_str(obj):
+        obj = str(obj)
+    return obj
+
+def is_instance(obj:any,typ:any) -> bool:
+    """
+    Checks whether the input object can be represented as a number.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object can be represented as a number, False otherwise.
+    """
+    boolIt = False
+    try:
+        boolIt = isinstance(obj, typ)
+        return boolIt
+    except:
+        return boolIt
+
+def is_number(s):
+    try:
+        float(s)
+        return True
+    except:
+        return False
+
+def is_object(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'object'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'object', False otherwise.
+    """
+    return is_instance(obj, object)
+def is_str(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'str'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'str', False otherwise.
+    """
+    return is_instance(obj, str)
+def is_int(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'int'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'int', False otherwise.
+    """
+    return is_instance(obj, int)
+def is_float(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'float'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'float', False otherwise.
+    """
+    return is_instance(obj, float)
+def is_bool(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'bool'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'bool', False otherwise.
+    """
+    return is_instance(obj, bool)
+
+
+def is_list(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'list'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'list', False otherwise.
+    """
+    return is_instance(obj, list)
+def is_tuple(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'tuple'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'tuple', False otherwise.
+    """
+    return is_instance(obj, tuple)
+def is_set(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'set'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'set', False otherwise.
+    """
+    return is_instance(obj, set)
+def is_dict(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'dict'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'dict', False otherwise.
+    """
+    return is_instance(obj, dict)
+def is_frozenset(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'frozenset'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'frozenset', False otherwise.
+    """
+    return is_instance(obj, frozenset)
+def is_bytearray(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'bytearray'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'bytearray', False otherwise.
+    """
+    return is_instance(obj, bytearray)
+def is_bytes(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'bytes'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'bytes', False otherwise.
+    """
+    return is_instance(obj, bytes)
+def is_memoryview(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'memoryview'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'memoryview', False otherwise.
+    """
+    return is_instance(obj, memoryview)
+def is_range(obj:any) -> bool:
+    """
+    Checks whether the input object is
+
+ of type 'range'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'range', False otherwise.
+    """
+    return is_instance(obj, range)
+def is_enumerate(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'enumerate'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'enumerate', False otherwise.
+    """
+    return is_instance(obj, enumerate)
+def is_zip(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'zip'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'zip', False otherwise.
+    """
+    return is_instance(obj, zip)
+def is_filter(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'filter'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'filter', False otherwise.
+    """
+    return is_instance(obj, filter)
+def is_map(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'map'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'map', False otherwise.
+    """
+    return is_instance(obj, map)
+def is_property(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'property'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'property', False otherwise.
+    """
+    return is_instance(obj, property)
+
+
+def is_slice(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'slice'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'slice', False otherwise.
+    """
+    return is_instance(obj, slice)
+
+
+def is_super(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'super'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'super', False otherwise.
+    """
+    return is_instance(obj, super)
+
+
+def is_type(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'type'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'type', False otherwise.
+    """
+    return is_instance(obj, type)
+
+
+def is_Exception(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'Exception'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'Exception', False otherwise.
+    """
+    return is_instance(obj, Exception)
+
+
+def is_none(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'None'.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'None', False otherwise.
+    """
+    if type(obj) is None:
+        return True
+    else:
+        return False
+
+
+
+def is_dict_or_convertable(obj:any) -> bool:
+    """
+    Checks whether the input object is of type 'dict' or can be converted to a dictionary.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object is of type 'dict' or can be converted to a dictionary, False otherwise.
+    """
+    if is_dict(obj):
+        return True
+    if is_str_convertible_dict(obj):
+        return True
+    return False
+def is_str_convertible_dict(obj:any) -> bool:
+    """
+    Checks whether the input object is a string that can be converted to a dict.
+
+    Args:
+        obj: The object to check.
+
+    Returns:
+        bool: True if the object can be converted to a dict, False otherwise.
+    """
+    import json
+
+    if is_instance(obj, str):
+        try:
+            json.loads(obj)
+            return True
+        except json.JSONDecodeError:
+            return False
+
+    return False
+def is_any_instance(value):
+    for each in [dict, list, int, float]:
+        if is_instance(value, each):
+            return True
+def det_bool_F(obj: (tuple or list or bool) = False):
+    """
+    Determines if the given object is a boolean False value.
+
+    Args:
+        obj (tuple or list or bool): The object to determine the boolean False value.
+
+    Returns:
+        bool: True if the object is a boolean False value, False otherwise.
+    """
+    if is_instance(obj, bool):
+        return obj
+    return all(obj)
+def det_bool_T(obj: (tuple or list or bool) = False):
+    """
+    Determines if the given object is a boolean True value.
+
+    Args:
+        obj (tuple or list or bool): The object to determine the boolean True value.
+
+    Returns:
+        bool: True if the object is a boolean True value, False otherwise.
+    """
+    if is_instance(obj, bool):
+        return obj 
+    return any(obj)
+def T_or_F_obj_eq(event: any = '', obj: any = ''):
+    """
+    Compares two objects and returns True if they are equal, False otherwise.
+
+    Args:
+        event (any): The first object to compare.
+        obj (any): The second object to compare.
+
+    Returns:
+        bool: True if the objects are equal, False otherwise.
+    """
+    return True if event == obj else False
+def ensure_integer(page_value:any, default_value:int):
+    """
+    Ensures the given value is an integer. If not, it tries to extract 
+    the numeric part of the value. If still unsuccessful, it defaults 
+    to the given default value.
+
+    Parameters:
+    - page_value (str|int|any): The value to ensure as integer. 
+                                Non-numeric characters are stripped if necessary.
+    - default_value (int): The default value to return if conversion 
+                           to integer is unsuccessful.
+
+    Returns:
+    - int: The ensured integer value.
+    """
+    # Check if page_value is already a number
+    if not is_number(page_value):
+        # Convert to string in case it's not already
+        page_value = str(page_value)
+        
+        # Remove non-numeric characters from the beginning
+        while len(page_value) > 0 and page_value[0] not in '0123456789'.split(','):
+            page_value = page_value[1:]
+
+        # Remove non-numeric characters from the end
+        while len(page_value) > 0 and page_value[-1] not in '0123456789'.split(','):
+            page_value = page_value[:-1]
+
+    # If page_value is empty or still not a number, use the default value
+    if len(page_value) == 0 or not is_number(page_value):
+        return default_value
+
+    # Convert page_value to an integer and return
+    return int(page_value)
+def if_default_return_obj(obj:any,default:any=None,default_compare:any=None):
+    if default == default_compare:
+        return obj
+    return default
+
+
+            

abstract_utilities/type_utils/make_type.py

@@ -0,0 +1,126 @@
+from .imports import *
+from .alpha_utils import *
+from .num_utils import *
+from .is_type import *
+def make_list(obj:any) -> list:
+    """
+    Converts the input object to a list. If the object is already a list, it is returned as is.
+    
+    Args:
+        obj: The object to convert.
+        
+    Returns:
+        list: The object as a list.
+    """
+    if isinstance(obj,str):
+        if ',' in obj:
+            obj = obj.split(',')
+    if isinstance(obj,set) or isinstance(obj,tuple):
+        return list(obj)
+    if isinstance(obj, list):
+        return obj
+    return [obj]
+def get_if_None(obj,default):
+    return obj if obj != None else default
+def dict_check_conversion(obj:any) -> Union[dict,any]:
+    """
+    Converts the input object to a dictionary if possible.
+
+    Args:
+        obj: The object to convert.
+
+    Returns:
+        The object converted to a dictionary if possible, otherwise the original object.
+    """
+    import json
+
+    if is_dict_or_convertable(obj):
+        if is_dict(obj):
+            return obj
+        return json.loads(obj)
+    
+    return obj
+
+    
+def make_list_lower(ls: list) -> list:
+    """
+    Converts all elements in a list to lowercase. Ignores None values.
+    
+    Args:
+        ls: The list to convert.
+        
+    Returns:
+        list: The list with all strings converted to lowercase.
+    """
+    return [item.lower() if is_instance(item, str) else item for item in ls]
+
+
+def make_float(obj:Union[str,float,int]) -> float:
+    """
+    Converts the input object to a float.
+    
+    Args:
+        x: The object to convert.
+        
+    Returns:
+        float: The float representation of the object.
+    """
+    try:
+        return float(obj)
+    except (TypeError, ValueError):
+        return 1.0
+
+def make_bool(obj: Union[bool, int, str]) -> Union[bool, str]:
+    """
+    Converts the input object to a boolean representation if possible.
+
+    The function attempts to convert various objects, including integers and strings, to their boolean equivalents. 
+    If the conversion is not possible, the original object is returned.
+
+    Args:
+        obj: The object to be converted.
+
+    Returns:
+        bool or original type: The boolean representation of the object if conversion is possible. Otherwise, it returns the original object.
+
+    Examples:
+        make_bool("true") -> True
+        make_bool(1)      -> True
+        make_bool("0")    -> False
+        make_bool(2)      -> 2
+    """
+    if is_instance(obj, bool):
+        return obj
+    if is_instance(obj, int):
+        if obj == 0:
+            return False
+        if obj == 1:
+            return True
+    if is_instance(obj, str):
+        if obj.lower() in ['0', "false"]:
+            return False
+        if obj.lower() in ['1', "true"]:
+            return True
+    return obj
+
+def make_str(obj: any) -> str:
+    """
+    Converts the input object to a string.
+    
+    Args:
+        obj: The object to convert.
+        
+    Returns:
+        str: The string representation of the object.
+    """
+    return str(obj)
+def convert_to_number(value):
+    value_str = str(value)
+    if is_number(value_str):
+        return float(value_str) if '.' in value_str else int(value_str)
+    return value_str
+
+def makeInt(obj):
+    if is_number(obj):
+       return int(obj)
+    return obj

abstract_utilities/type_utils/mime_types.py

@@ -0,0 +1,68 @@
+from .imports import *
+# A big, but by no means exhaustive, map of extensions to mime‐types by category:
+def get_media_map(categories=None):
+    """
+    Return a sub‐dict of MEDIA_TYPES for the given categories.
+    If categories is None or empty, return the whole MEDIA_TYPES.
+    """
+    if not categories:
+        return MEDIA_TYPES
+    cats = {str(c) for c in categories}
+    return {c: MEDIA_TYPES[c] for c in cats if c in MEDIA_TYPES}
+
+
+def get_media_exts(categories=None):
+    """
+    Return a flat, sorted list of all extensions for the given categories.
+    """
+    media_map = get_media_map(categories)
+    return sorted({ext for exts in media_map.values() for ext in exts})
+
+
+def confirm_type(path_or_ext, categories=None,**kwargs):
+    """
+    Given a file‐path or extension, return its media category (e.g. "image"), or None.
+    """
+    categories = categories or kwargs.get('media_types')
+    ext = Path(path_or_ext).suffix.lower()
+    media_map = get_media_map(categories)
+    for category, exts in media_map.items():
+        if ext in exts:
+            return category
+    return None
+
+
+def is_media_type(path_or_ext, categories=None,**kwargs):
+    """
+    True if the given file‐path or extension belongs to one of the categories.
+    """
+    categories = categories or kwargs.get('media_types')
+    return confirm_type(path_or_ext, categories) is not None
+
+
+def get_mime_type(path_or_ext):
+    """
+    Look up the MIME type by extension in MIME_TYPES; fall back to octet‐stream.
+    """
+    ext = Path(path_or_ext).suffix.lower()
+    for mapping in MIME_TYPES.values():
+        if ext in mapping:
+            return mapping[ext]
+    return 'application/octet-stream'
+
+
+def get_all_file_types(categories=None, directory=None,**kwargs):
+    """
+    Recursively glob for files under `directory` whose extension belongs to `categories`.
+    Returns a list of full paths.
+    """
+    categories = categories or kwargs.get('media_types')
+    base = Path(directory)
+    if not base.is_dir():
+        return []
+    wanted = get_media_map(categories)
+    return [
+        str(p)
+        for p in base.rglob('*')
+        if p.is_file() and Path(p).suffix.lower() in {e for exts in wanted.values() for e in exts}
+    ]