abstract-utilities 0.2.2.448__tar.gz → 0.2.2.450__tar.gz

{abstract_utilities-0.2.2.448 → abstract_utilities-0.2.2.450}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstract_utilities
-Version: 0.2.2.448
+Version: 0.2.2.450
 Summary: abstract_utilities is a collection of utility modules providing a variety of functions to aid in tasks such as data comparison, list manipulation, JSON handling, string manipulation, mathematical computations, and time operations.
 Home-page: https://github.com/AbstractEndeavors/abstract_utilities
 Author: putkoff
@@ -10,12 +10,10 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
-Requires-Python: >=3.11
+Requires-Python: >=3.6
 Description-Content-Type: text/markdown
-Requires-Dist: pathlib>=1.0.1
-Requires-Dist: abstract_security>=0.0.1
-Requires-Dist: yt_dlp>=2023.10.13
 Requires-Dist: pexpect>=4.8.0
+Requires-Dist: abstract_security>=0.0.1
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier

{abstract_utilities-0.2.2.448 → abstract_utilities-0.2.2.450}/pyproject.toml

@@ -1,3 +1,3 @@
 [build-system]
-requires = ["setuptools>=42"]
+requires = ["setuptools>=42", "wheel"]
 build-backend = "setuptools.build_meta"

{abstract_utilities-0.2.2.448 → abstract_utilities-0.2.2.450}/setup.py

@@ -4,7 +4,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
     long_description = fh.read()
 setuptools.setup(
     name='abstract_utilities',
-    version='0.2.2.448',
+    version='0.2.2.450',
     author='putkoff',
     author_email='partners@abstractendeavors.com',
     description='abstract_utilities is a collection of utility modules providing a variety of functions to aid in tasks such as data comparison, list manipulation, JSON handling, string manipulation, mathematical computations, and time operations.',
@@ -18,10 +18,10 @@ setuptools.setup(
       'Programming Language :: Python :: 3',
       'Programming Language :: Python :: 3.11',
     ],
-    install_requires=['pathlib>=1.0.1', 'abstract_security>=0.0.1', 'yt_dlp>=2023.10.13', 'pexpect>=4.8.0'],
+    install_requires=['pexpect>=4.8.0', 'abstract_security>=0.0.1'],
    package_dir={"": "src"},
    packages=setuptools.find_packages(where="src"),
-   python_requires=">=3.11",
+   python_requires=">=3.6",
   
 
 )

{abstract_utilities-0.2.2.448 → abstract_utilities-0.2.2.450}/src/abstract_utilities/__init__.py

@@ -3,9 +3,8 @@ from datetime import timedelta
 from datetime import datetime
 from typing import *
 from .hash_utils import *
-##from .dynimport import get_abstract_import,import_symbols_to_parent,call_for_all_tabs
-from .robust_readers import *
-from .dynimport import get_abstract_import
+from .dynimport import get_abstract_import,import_symbols_to_parent,call_for_all_tabs
+
 from .json_utils import (unified_json_loader,
                          find_keys,
                          get_key_values_from_path,
@@ -41,8 +40,42 @@ from .json_utils import (unified_json_loader,
                          )
 from .read_write_utils import (read_from_file,
                                write_to_file)
-from .path_utils import *
-from .file_utils import *
+from .path_utils import (get_file_create_time,
+                         get_files,
+                         get_folders,
+                         path_join,
+                         mkdirs,
+                         split_text,
+                         get_all_item_paths,
+                         get_directory_items,
+                         get_files,
+                         get_folders,
+                         break_down_find_existing,
+                         get_directory_items,
+                         get_directory_files,
+                         get_all_item_paths,
+                         get_all_file_paths,
+                         get_directory,
+                         create_directory,
+                         initialize_file,
+                         join_path,
+                         is_last_itter,
+                         path_join,
+                         is_file,
+                         is_dir,
+                         is_path,
+                         get_all_directories,
+                         get_all_files,
+                         get_all_items,
+                         collate_text_docs,
+                         get_dirlist,
+                         get_content,
+                         is_directory_in_paths,
+                         make_dirs,
+                         remove_directory,
+                         remove_path,
+                         get_file_parts
+                         )
 from .list_utils import (get_highest_value_obj,
                          make_list,
                          safe_list_return,
@@ -87,8 +120,7 @@ from .type_utils import (make_bool,
                          get_numbers,
                          get_numbers_comp,
                          is_any_instance,
-                         break_string,
-                         MIME_TYPES
+                         break_string
                          )
 get_media_types = get_all_types = get_all_file_types
 from .math_utils import (convert_to_percentage,
@@ -100,10 +132,7 @@ from .math_utils import (convert_to_percentage,
                          return_0)
 from .compare_utils import (create_new_name,
                             get_last_comp_list,
-                            get_closest_match_from_list,
-                            get_first_match,
-                            get_all_match,
-                            best_match)
+                            get_closest_match_from_list)
 from .thread_utils import ThreadManager
 from .history_utils import HistoryManager
 from .abstract_classes import *
@@ -117,9 +146,6 @@ from .parse_utils import (num_tokens_from_string,
 from .log_utils import get_caller_info,get_logFile,print_or_log,get_json_call_response,initialize_call_log
 from .error_utils import try_func
 from .class_utils import alias,get_class_inputs,get_set_attr
-from .ssh_utils import *
-from .env_utils import *
-from .path_utils import *
-from .file_utils import *
-from .file_utils import call_for_all_tabs
-from .string_utils import *
+from .robust_reader import *
+from .robust_readers import *
+

abstract_utilities-0.2.2.450/src/abstract_utilities/abstract_classes.py

@@ -0,0 +1,24 @@
+class SingletonMeta(type):
+    _instances = {}
+    def __call__(cls, *args, **kwargs):
+        if cls not in cls._instances:
+            cls._instances[cls] = super(SingletonMeta, cls).__call__(*args, **kwargs)
+        return cls._instances[cls]
+def get_inputs(cls, *args, **kwargs):
+    """
+    Dynamically construct a dataclass instance from args and kwargs,
+    filling missing values from defaults in the dataclass.
+    """
+    fields = list(cls.__annotations__.keys())
+    values = {}
+
+    args = list(args)
+    for field in fields:
+        if field in kwargs:
+            values[field] = kwargs[field]
+        elif args:
+            values[field] = args.pop(0)
+        else:
+            values[field] = getattr(cls(), field)  # default from dataclass
+
+    return cls(**values)

{abstract_utilities-0.2.2.448 → abstract_utilities-0.2.2.450}/src/abstract_utilities/class_utils.py

@@ -44,9 +44,9 @@ Dependencies:
 Each function is furnished with its own docstring that elaborates on its purpose, expected inputs, and outputs.
 
 """
-import os,json,functools,inspect
-from typing import *
-
+import inspect
+import json
+import functools
 def get_type_list() -> list:
     """Get a list of common Python types."""
     return ['None','str','int','float','bool','list','tuple','set','dict','frozenset','bytearray','bytes','memoryview','range','enumerate','zip','filter','map','property','slice','super','type','Exception','object']
@@ -370,39 +370,3 @@ def get_class_inputs(cls, *args, **kwargs):
         else:
             values[field] = getattr(cls(), field)
     return cls(**values)
-def get_caller(i: Optional[int] = None) -> str:
-    """
-    Return the filename of the calling frame.
-
-    Args:
-        i: Optional stack depth offset. 
-           None = immediate caller (depth 1).
-
-    Returns:
-        Absolute path of the file for the stack frame.
-    """
-    depth = 1 if i is None else int(i)
-    stack = inspect.stack()
-    if depth >= len(stack):
-        depth = len(stack) - 1
-    return stack[depth].filename
-
-
-def get_caller_path(i: Optional[int] = None) -> str:
-    """
-    Return the absolute path of the caller's file.
-    """
-    depth = 1 if i is None else int(i)
-    file_path = get_caller(depth + 1)
-    return os.path.realpath(file_path)
-
-
-def get_caller_dir(i: Optional[int] = None) -> str:
-    """
-    Return the absolute directory of the caller's file.
-    """
-    depth = 1 if i is None else int(i)
-    abspath = get_caller_path(depth + 1)
-    return os.path.dirname(abspath)
-
-

{abstract_utilities-0.2.2.448 → abstract_utilities-0.2.2.450}/src/abstract_utilities/cmd_utils/user_utils.py

@@ -1,4 +1,4 @@
-
+from ..string_clean import eatOuter
 def get_user_input(text,default='y'):
     choices = '(y/n)' if default in ['y','n'] else ''
     response = input(f"{text} {choices}:({default}) ") or default

{abstract_utilities-0.2.2.448/src/abstract_utilities/compare_utils → abstract_utilities-0.2.2.450/src/abstract_utilities}/compare_utils.py

@@ -9,7 +9,7 @@ Date: 05/31/2023
 Version: 0.1.2
 """
 import string
-from ..type_utils import is_number,make_list
+from .type_utils import is_number,make_list
 def get_comp(string:str, string_2:str):
     """
     Calculates the similarity between two strings.

{abstract_utilities-0.2.2.448 → abstract_utilities-0.2.2.450}/src/abstract_utilities/dynimport.py

@@ -1,12 +1,12 @@
 # abstract_utilities/dynimport.py
 from __future__ import annotations
+import importlib, sys, os
 from functools import lru_cache
-from typing import *
-import importlib, sys, os, sys,inspect
-from typing import Optional
+from typing import Any, Callable, Iterable, Optional
+import inspect, sys
 from importlib import import_module
 from .type_utils import make_list
-
+from .robust_readers import get_for_all_tabs,call_for_all_tabs
 class _LazyAttr:
     """Lazy resolver proxy to avoid import-time cycles.
     First use triggers actual import & attribute lookup.
@@ -181,6 +181,14 @@ def get_many_module_imports(*args):
             all_modules[symbol] = get_abstract_import(module = module,symbol=symbol)
     import_symbols(all_modules)
     return all_modules
-
-
-
+def get_caller_path():
+    frame = inspect.stack()[1]
+    return os.path.abspath(frame.filename)
+def get_caller_dir():
+    frame = inspect.stack()[1]
+    abspath = os.path.abspath(frame.filename)
+    return os.path.dirname(abspath)
+def call_for_all_tabs():
+    
+    root = get_caller_dir()
+    get_for_all_tabs(root)

{abstract_utilities-0.2.2.448 → abstract_utilities-0.2.2.450}/src/abstract_utilities/json_utils.py

@@ -188,41 +188,6 @@ def find_keys(data, target_keys):
     values = []
     _find_keys_recursive(data, target_keys, values)
     return values
-def try_json_dumps_spec(obj, logger=True, level='error', file_path=None, **kwargs):
-    """
-    Attempts to serialize an object to JSON using json.dumps or json.dump.
-    
-    Args:
-        obj: The Python object to serialize (e.g., dict, list, str, int, etc.).
-        logger: Logger object or None to use _default_logger.
-        level: Logging level for errors (default: 'error').
-        file_path: If provided, writes JSON to this file using json.dump.
-        **kwargs: Additional arguments to pass to json.dumps or json.dump (e.g., indent, sort_keys).
-    
-    Returns:
-        str: The JSON-serialized string if file_path is None and serialization succeeds.
-        None: If serialization fails or file_path is provided (in which case it writes to the file).
-    
-    Raises:
-        ValueError: If file_path is provided but the file cannot be written.
-    """
-    
-    try:
-        if file_path:
-            # Use json.dump to write to a file
-            with open(file_path, 'w', encoding='utf-8') as f:
-                json.dump(obj, f, **kwargs)
-            return None
-        else:
-            # Use json.dumps to return a string
-            return json.dumps(obj)
-    except (TypeError, OverflowError, ValueError) as e:
-        if log_callable:
-            print_or_log(f"Exception in json.dumps/dump: {e}")
-        return None
-def run_it(endpoint,**kwargs):
-    response= make_request_link('typicaly',endpoint,data=kwargs)
-    return response
 def get_logNone(e):
     logger(f"{e}")
     return None

{abstract_utilities-0.2.2.448 → abstract_utilities-0.2.2.450}/src/abstract_utilities/log_utils.py

@@ -5,17 +5,6 @@ from flask import jsonify
 from .path_utils import mkdirs
 from logging.handlers import RotatingFileHandler
 from .abstract_classes import SingletonMeta
-from pathlib import Path
-
-def _normalize(obj):
-    """Recursively turn PosixPath into str, sets into list, etc."""
-    if isinstance(obj, Path):
-        return str(obj)
-    if isinstance(obj, dict):
-        return {k: _normalize(v) for k, v in obj.items()}
-    if isinstance(obj, (list, tuple, set)):
-        return [_normalize(x) for x in obj]
-    return obj
 
 
 # from abstract_utilities import get_logFile  # Potential conflict - consider removing or renaming
@@ -229,11 +218,11 @@ def initialize_call_log(value=None,
 
     print_or_log(full_message,level=log_level)
     
-def get_json_call_response(value=None, status_code=None, data=None, logMsg=None, callLog=False):
+def get_json_call_response(value, status_code, data=None,logMsg=None,callLog = False):
     response_body = {}
     if status_code == 200:
         response_body["success"] = True
-        response_body["result"] = _normalize(value)
+        response_body["result"] = value
         logMsg = logMsg or "success"
         if callLog:
             initialize_call_log(value=value,
@@ -242,7 +231,7 @@ def get_json_call_response(value=None, status_code=None, data=None, logMsg=None,
                             log_level='info')
     else:
         response_body["success"] = False
-        response_body["error"] = _normalize(value)
+        response_body["error"] = value
         logMsg = logMsg or f"ERROR: {logMsg}"
         initialize_call_log(value=value,
                             data=data,

{abstract_utilities-0.2.2.448 → abstract_utilities-0.2.2.450}/src/abstract_utilities/path_utils.py

@@ -23,13 +23,8 @@ Date: 05/31/2023
 Version: 0.1.2
 """
 import os
-from .read_write_utils import read_from_file,write_to_file
-from .string_clean import eatAll
-from .list_utils import make_list
-from .type_utils import get_media_exts, is_media_type,MIME_TYPES
-from .safe_utils import safe_join
-from .class_utils import get_caller_path,get_caller_dir
-
+import platform
+from .read_write_utils import read_from_file
 def get_os_info():
     """
     Get Operating System Information
@@ -577,87 +572,8 @@ def remove_path(path=None):
             remove_directory(path)
         else:
             os.remove(path)
-def get_safe_dirname(path=None):
-    if path:
-        path_str = str(path)
-        return os.path.dirname(path_str)
-def get_safe_basename(path=None):
-    if path:
-        path_str = str(path)
-        return os.path.basename(path_str)
-def get_safe_splitext(path=None,basename=None):
-    basename = basename or get_safe_basename(path=path)
-    if basename:
-        basename_str = str(basename)
-        filename,ext = os.path.splitext(basename_str)
-        return filename,ext
-def get_safe_filename(path=None,basename=None):
-    filename,_ = get_safe_splitext(path=path,basename=basename)
-    return filename
-def get_safe_ext(path=None,basename=None):
-    _,ext = get_safe_splitext(path=path,basename=basename)
-    return ext
-def raw_create_dirs(*paths):
-    """Recursively create all directories along the given path."""
-    full_path = os.path.abspath(safe_join(*paths))
-    sub_parts = [p for p in full_path.split(os.sep) if p]
-
-    current_path = "/" if full_path.startswith(os.sep) else ""
-    for part in sub_parts:
-        current_path = safe_join(current_path, part)
-        os.makedirs(current_path, exist_ok=True)
-    return full_path
-
-
-def create_dirs(directory, child=None):
-    """Create directory and optional child path safely."""
-    full_path = os.path.abspath(safe_join(directory, child))
-    if not os.path.exists(full_path):
-        raw_create_dirs(full_path)
-    return full_path
-
-
-def get_base_dir(directory=None):
-    """Return given directory or _BASE_DIR fallback."""
-    return directory or _BASE_DIR
-
-
-def create_base_path(directory=None, child=None):
-    """Join base dir with child."""
-    directory = get_base_dir(directory)
-    return safe_join(directory, child)
-
-
-def create_base_dir(directory=None, child=None):
-    """Ensure existence of base directory path."""
-    full_path = create_base_path(directory, child)
-    if not os.path.exists(full_path):
-        raw_create_dirs(full_path)
-    return full_path
-
-
-
 def get_file_parts(path):
-    
-    basename = get_safe_basename(path)
-    filename, ext = get_safe_splitext(basename=basename)
-
-    dirname = get_safe_dirname(path)
-    dirbase = get_safe_basename(dirname)
-    
-    parent_dirname = get_safe_dirname(dirname)
-    parent_dirbase = get_safe_basename(parent_dirname)
-    
-    super_dirname = get_safe_dirname(parent_dirname)
-    super_dirbase = get_safe_basename(super_dirname)
-
-    return {"dirname": dirname,
-            "basename": basename,
-            "filename": filename,
-            "ext": ext,
-            "dirbase":dirbase,
-            "parent_dirname":parent_dirname,
-            "parent_dirbase":parent_dirbase,
-            "super_dirname":super_dirname,
-            "super_dirbase":super_dirbase
-            }
+    dirName = os.path.dirname(path)
+    baseName = os.path.basename(path)
+    fileName, ext = os.path.splitext(baseName)
+    return {"dirName": dirName, "baseName": baseName, "fileName": fileName, "ext": ext}

abstract_utilities-0.2.2.450/src/abstract_utilities/read_write_utils.py

@@ -0,0 +1,199 @@
+"""
+read_write_utils.py
+
+This module, 'read_write_utils.py', provides utility functions for reading and writing to files.
+These include functions to:
+
+Usage:
+    import abstract_utilities.read_write_utils as read_write_utils
+
+1. Write content to a file.
+2. Read content from a file.
+3. Check if a string has a file extension.
+4. Read from or write to a file depending on the number of arguments.
+5. Create a file if it does not exist, then read from it.
+
+Each function includes a docstring to further explain its purpose, input parameters, and return values.
+import os
+
+# File and Directory Operations
+os.rename(src, dst)            # Rename a file or directory
+os.remove(path)               # Remove a file
+os.unlink(path)               # Alias for os.remove()
+os.rmdir(path)                # Remove an empty directory
+os.makedirs(path)             # Create directories recursively
+os.makedirs(path, exist_ok=True)  # Create directories, ignore if exists
+os.mkdir(path)                # Create a single directory
+os.listdir(path)              # List files and directories in a path
+os.chdir(path)                # Change current working directory
+os.getcwd()                   # Get current working directory
+os.stat(path)                 # Get file/directory information
+os.lstat(path)                # Get symbolic link information
+os.symlink(src, dst)          # Create a symbolic link
+os.readlink(path)             # Read the target of a symbolic link
+os.getcwd()                   # Get current working directory
+os.chdir(path)                # Change current working directory
+
+# File and Directory Information
+os.path.exists(path)          # Check if a path exists
+os.path.isfile(path)          # Check if a path points to a file
+os.path.isdir(path)           # Check if a path points to a directory
+os.path.islink(path)          # Check if a path points to a symbolic link
+os.path.abspath(path)         # Get the absolute path of a file/directory
+os.path.basename(path)        # Get the base name of a path
+os.path.dirname(path)         # Get the directory name of a path
+os.path.join(path1, path2, ...)  # Join path components into a single path
+
+# File Permissions
+os.chmod(path, mode)          # Change file permissions
+os.access(path, mode)         # Check if a file is accessible with given mode
+
+# File Times
+os.path.getatime(path)        # Get last access time of a file
+os.path.getmtime(path)        # Get last modification time of a file
+os.path.getctime(path)        # Get creation time of a file
+os.utime(path, times)         # Set access and modification times
+
+# Working with Paths
+os.path.split(path)           # Split a path into (head, tail)
+os.path.splitext(path)        # Split a path into (root, ext)
+os.path.normpath(path)        # Normalize a path (e.g., convert slashes)
+
+# Other
+os.path.samefile(path1, path2)  # Check if two paths refer to the same file
+
+# Directory Traversal
+for root, dirs, files in os.walk(top, topdown=True):
+    # Traverse a directory tree, yielding root, dirs, and files lists
+
+# Temporary Files and Directories
+import tempfile
+tempfile.mkstemp()            # Create a temporary file
+tempfile.mkdtemp()            # Create a temporary directory
+tempfile.TemporaryFile()      # Create a temporary file object
+
+# Environment Variables
+os.environ                    # Dictionary of environment variables
+os.environ['VAR_NAME']        # Access an environment variable
+os.environ.get('VAR_NAME')    # Access an environment variable (with default)
+
+# Path Manipulation
+os.path.abspath(path)         # Convert relative path to absolute path
+os.path.join(path1, path2, ...)  # Join paths together
+os.path.split(path)           # Split a path into directory and filename
+os.path.dirname(path)         # Get the directory part of a path
+os.path.basename(path)        # Get the filename part of a path
+os.path.exists(path)          # Check if a path exists
+os.path.isfile(path)          # Check if a path points to a file
+os.path.isdir(path)           # Check if a path points to a directory
+
+# File Permissions
+os.chmod(path, mode)          # Change file permissions
+
+# Miscellaneous
+os.getpid()                   # Get the current process ID
+os.getlogin()                 # Get the name of the logged-in user
+
+"""
+import os
+def break_down_find_existing(path):
+    test_path = ''
+    for part in path.split(os.sep):
+        test_path = os.path.join(test_path, part)
+        if not os.path.exists(test_path):
+            return test_path if test_path else None
+    return test_path
+
+def string_in_keys(strings, kwargs):
+    return next((key for key in kwargs if any(s.lower() in key.lower() for s in strings)), None)
+
+def get_path(paths):
+    for path in paths:
+        if isinstance(path,str):
+            if os.path.isfile(path):
+                return path
+            dirname = os.path.dirname(path)
+            if os.path.exists(dirname):
+                return path
+    return None
+
+def check_read_write_params(*args, **kwargs):
+    file_path = kwargs.get('file_path', None)
+    contents = kwargs.get('contents', None)
+    if contents is None:
+        contents = kwargs.get('data', None)
+
+    # Handle positional arguments
+    if file_path is None and len(args) > 0:
+        file_path = args[0]
+    if contents is None and len(args) > 1:
+        contents = args[1]
+    elif contents is None and len(args) > 0 and file_path != args[0]:
+        contents = args[0]
+
+    if file_path is None or contents is None:
+        raise ValueError("Both 'file_path' and 'contents' (or 'data') are required.")
+
+    return file_path, contents
+
+def write_to_file(file_path=None, contents=None,*args,  **kwargs):
+    """
+    Write contents to a file. If the file does not exist, it is created.
+
+    Args:
+        file_path: The path of the file to write to.
+        contents: The content to write to the file.
+        
+    Returns:
+        The contents that were written to the file.
+    """
+    params = check_read_write_params(file_path=file_path, contents=contents,*args,  **kwargs)
+    if params:
+        with open(params[0], 'w', encoding='UTF-8') as f:
+            f.write(params[1])
+        return contents
+
+
+def read_from_file(file_path) -> str:
+    """
+    Read the contents of a file.
+    
+    Args:
+        file_path: The path of the file to read from.
+        
+    Returns:
+        The contents of the file.
+    """
+    with open(file_path, 'r', encoding='UTF-8') as f:
+        return f.read()
+
+def create_and_read_file(file_path=None, contents:str='',*args,  **kwargs) -> str:
+    """
+    Create a file if it does not exist, then read from it.
+    
+    Args:
+        file_path: The path of the file to create and read from.
+        contents: The content to write to the file if it does not exist.
+        
+    Returns:
+        The contents of the file.
+    """
+    if not os.path.isfile(file_path):
+        write_to_file(contents, file_path)
+    return read_from_file(file_path)
+def is_file_extension(obj: str) -> bool:
+    """
+    Check if a string has a file extension.
+    
+    Args:
+        obj: The string to check.
+        
+    Returns:
+        True if the string has a file extension, False otherwise.
+    """
+    return len(obj) >= 4 and '.' in obj[-4:-3]
+
+def delete_file(file_path: str):
+    if os.path.isfile(file_path):
+        os.remove(file_path)
+

abstract_utilities-0.2.2.450/src/abstract_utilities/robust_reader/__init__.py

@@ -0,0 +1,2 @@
+from .file_reader import *
+