abstract-utilities 0.2.2.467__py3-none-any.whl → 0.2.2.513__py3-none-any.whl

abstract_utilities/hash_utils/__init__.py

@@ -0,0 +1,2 @@
+from .imports import *
+from .hash_utils import *

abstract_utilities/hash_utils/hash_utils.py

@@ -0,0 +1,5 @@
+from .imports import *
+def generate_data_hash(insertName,value):
+    # Combine values to create a unique reference
+    data_string = f"{insertName}_{value}"
+    return hashlib.md5(data_string.encode()).hexdigest()

abstract_utilities/hash_utils/imports/__init__.py

@@ -0,0 +1,2 @@
+from .imports import *
+from .module_imports import *

abstract_utilities/hash_utils/imports/imports.py

@@ -0,0 +1 @@
+from ...imports import hashlib

abstract_utilities/history_utils/__init__.py

@@ -0,0 +1,2 @@
+from .imports import *
+from .history_utils import *

abstract_utilities/history_utils/history_utils.py

@@ -0,0 +1,37 @@
+class HistoryManager:
+    def __init__(self):
+        self.history_names = {}
+
+    def add_history_name(self, name, initial_data=''):
+        self.history_names[name] = {"history": [initial_data], "history_redo": []}
+        return name
+
+    def transfer_state(self, primary_data, secondary_data):
+        """
+        Transfer the latest state from primary_data to secondary_data
+        Returns the modified primary and secondary data lists
+        """
+        self.last_data = None
+        # If there's data in primary, transfer the latest to secondary
+        if primary_data:
+            self.last_data = primary_data.pop()
+            secondary_data.append(self.last_data)
+
+        return primary_data, secondary_data
+
+    def add_to_history(self, name, data):
+        # Clear the redo history when a new state is added
+        self.history_names[name]['history_redo'] = []
+        self.history_names[name]['history'].append(data)
+
+    def redo(self, name):
+        # Redo by transferring state from redo history to actual history
+        self.history_names[name]["history_redo"], self.history_names[name]["history"] = self.transfer_state(
+            self.history_names[name]["history_redo"], self.history_names[name]["history"])
+        return self.last_data
+
+    def undo(self, name):
+        # Undo by transferring state from actual history to redo history
+        self.history_names[name]["history"], self.history_names[name]["history_redo"] = self.transfer_state(
+            self.history_names[name]["history"], self.history_names[name]["history_redo"])
+        return self.last_data

abstract_utilities/history_utils/imports/__init__.py

@@ -0,0 +1,2 @@
+from .imports import *
+from .module_imports import *

abstract_utilities/history_utils/imports/imports.py

@@ -0,0 +1 @@
+

abstract_utilities/import_utils/__init__.py

@@ -0,0 +1,2 @@
+from .imports import *
+from .src import *

abstract_utilities/import_utils/imports/__init__.py

@@ -0,0 +1,4 @@
+from .imports import *
+from .module_imports import *
+from .constants import *
+from .utils import *

abstract_utilities/import_utils/imports/constants.py

@@ -0,0 +1,2 @@
+IMPORT_TAG = 'import '
+FROM_TAG = 'from '

abstract_utilities/import_utils/imports/imports.py

@@ -0,0 +1,4 @@
+from pathlib import Path
+from typing import *
+from types import MethodType
+from ...imports import os, sys, importlib, os, inspect, re, hashlib

abstract_utilities/import_utils/imports/module_imports.py

@@ -0,0 +1,6 @@
+from ...read_write_utils import read_from_file,write_to_file,get_text_or_read
+from ...string_utils import eatAll,eatInner,eatElse,clean_line
+from ...class_utils import get_caller_path
+from ...list_utils import make_list
+from ...path_utils import get_file_parts
+from ...type_utils  import is_number,make_list

abstract_utilities/import_utils/imports/utils.py

@@ -0,0 +1,30 @@
+import os
+from .constants import *
+
+def is_line_import(line):
+    if line and (line.startswith(FROM_TAG) or line.startswith(IMPORT_TAG)):
+        return True
+    return False
+def is_line_group_import(line):
+    if line and (line.startswith(FROM_TAG) and IMPORT_TAG in line):
+        return True
+    return False
+
+def is_from_line_group(line):
+    if line and line.startswith(FROM_TAG) and IMPORT_TAG in line and '(' in line:
+        import_spl = line.split(IMPORT_TAG)[-1]
+        import_spl_clean = clean_line(line)
+        if not import_spl_clean.endswith(')'):
+            return True
+    return False
+def get_unique_name(string,list_obj):
+    if isinstance(list_obj,dict):
+        list_obj = list(list_obj.keys())
+    if string in list_obj:
+        nustring = f"{string}"
+        for i in range(len(list_obj)):
+            nustring = f"{string}_{i}"
+            if nustring not in list_obj:
+                break
+        string = nustring
+    return string

abstract_utilities/import_utils/src/__init__.py

@@ -0,0 +1,7 @@
+from .clean_imports import *
+from .dot_utils import *
+from .extract_utils import *
+from .import_utils import *
+from .import_functions import *
+from .pkg_utils import *
+from .sysroot_utils import *

abstract_utilities/import_utils/src/clean_imports.py

@@ -0,0 +1,147 @@
+from ..imports import *
+from .pkg_utils import *
+
+def get_text_or_read(text=None,file_path=None):
+    text = text or ''
+    imports_js = {}
+    if not text and file_path and os.path.isfile(file_path):
+        text=read_from_file(file_path)
+    return text
+def is_line_import(line):
+    if line and (line.startswith(FROM_TAG) or line.startswith(IMPORT_TAG)):
+        return True
+    return False
+def is_line_group_import(line):
+    if line and (line.startswith(FROM_TAG) and IMPORT_TAG in line):
+        return True
+    return False
+
+def is_from_line_group(line):
+    if line and line.startswith(FROM_TAG) and IMPORT_TAG in line and '(' in line:
+        import_spl = line.split(IMPORT_TAG)[-1]
+        import_spl_clean = clean_line(line)
+        if not import_spl_clean.endswith(')'):
+            return True
+    return False
+
+def get_all_imports(text=None,file_path=None,import_pkg_js=None):
+    if text and os.path.isfile(text):
+        file_path = text
+        text = read_from_file(text)    
+    text = get_text_or_read(text=text,file_path=file_path)
+    lines = text.split('\n')
+    cleaned_import_list=[]
+    nu_lines = []
+    is_from_group = False
+    import_pkg_js = ensure_import_pkg_js(import_pkg_js,file_path=file_path)
+    for line in lines:
+        if line.startswith(IMPORT_TAG) and ' from ' not in line:
+            cleaned_import_list = get_cleaned_import_list(line)
+            import_pkg_js = add_imports_to_import_pkg_js("import",cleaned_import_list,import_pkg_js=import_pkg_js)
+        else:
+            if is_from_group:
+                import_pkg=is_from_group
+                line = clean_line(line)
+                if line.endswith(')'):
+                   is_from_group=False
+                   line=line[:-1]
+                imports_from_import_pkg = clean_imports(line)
+                import_pkg_js = add_imports_to_import_pkg_js(import_pkg,imports_from_import_pkg,import_pkg_js=import_pkg_js)
+                
+            else:
+                import_pkg_js=update_import_pkg_js(line,import_pkg_js=import_pkg_js)
+            if is_from_line_group(line) and is_from_group == False:
+                is_from_group=get_import_pkg(line)
+    return import_pkg_js
+
+def clean_imports(text=None,file_path=None,import_pkg_js=None,fill_nulines=False):
+    if text and os.path.isfile(text):
+        file_path = text
+        text = read_from_file(text)    
+    if not import_pkg_js:
+        import_pkg_js = get_all_imports(text=text,file_path=file_path)
+    import_pkg_js = ensure_import_pkg_js(import_pkg_js,file_path=file_path)
+    nu_lines = import_pkg_js["context"]["nulines"]
+    for pkg,values in import_pkg_js.items():
+        comments = []
+        if pkg not in ["context"]: 
+            
+            imports = values.get('imports')
+            for i,imp in enumerate(imports):
+                if '#' in imp:
+                    imp_spl = imp.split('#')
+                    comments.append(imp_spl[-1])
+                    imports[i] = clean_line(imp_spl[0])
+            imports = list(set(imports))   
+            if '*' in imports:
+                imports="*"
+            else:
+                imports=','.join(imports)
+                if comments:
+                    comments=','.join(comments)
+                    imports+=f" #{comments}"
+            import_pkg_js[pkg]["imports"]=imports
+            if fill_nulines:
+                line = values.get('line')
+                if len(nu_lines) >= line:
+                    nu_lines[line] += imports
+    return import_pkg_js
+def clean_all_imports(text=None,file_path=None,import_pkg_js=None,fill_nulines=False):
+    clean_imports(text=text,file_path=file_path,import_pkg_js=import_pkg_js,fill_nulines=import_pkg_js)
+    import_pkg_js["context"]["nulines"]=nu_lines
+    return import_pkg_js
+def get_clean_import_string(import_pkg_js,fill_nulines=False,get_locals=False):
+    import_pkg_js = clean_imports(import_pkg_js=import_pkg_js,fill_nulines=fill_nulines)
+    import_ls = []
+    for key,values in import_pkg_js.items():
+        if key not in ['context','nulines']:
+            imports = None
+            imp_values= values.get('imports')
+            if key == 'import':
+                imports = f'import {imp_values}'
+            elif get_locals or not key.startswith('.'):
+                imports = f'from {key} import {imp_values}'
+            if imports:
+                import_ls.append(imports)
+    return '\n'.join(import_ls)
+def get_clean_imports_from_files(files):
+    import_pkg_js={}
+    for file in files:
+        import_pkg_js = get_all_imports(file,import_pkg_js=import_pkg_js)
+    return get_clean_import_string(import_pkg_js)
+def get_dot_fro_line(line,dirname):
+    from_line = line.split(FROM_TAG)[-1]
+    dot_fro = ""
+    for char in from_line:
+        if  char != '.':
+            line = f"from {dot_fro}{eatAll(from_line,'.')}"
+            break
+        dirname = os.path.dirname(dirname)
+        dirbase = os.path.basename(dirname)
+        dot_fro = f"{dirbase}.{dot_fro}"
+    return line
+def get_dot_fro_lines(lines,file_path,all_imps):
+    for line in lines:
+        if line.startswith(FROM_TAG):
+            line = get_dot_fro_line(line,file_path)
+            if line in all_imps:
+                line = ""
+        if line:
+            all_imps.append(line)
+    return all_imps
+def get_all_real_imps(text=None,file_path=None,all_imps=None):
+    if text and os.path.isfile(text):
+        file_path = text
+        text = read_from_file(text)    
+    all_imps = all_imps or []
+    contents = get_text_or_read(text=text,file_path=file_path)
+    lines = contents.split('\n')
+    all_imps = get_dot_fro_lines(lines,file_path,all_imps)
+    return '\n'.join(all_imps)
+def save_cleaned_imports(text=None,file_path=None,write=False,import_pkg_js=None):
+    import_pkg_js=get_all_imports(text=text,file_path=file_path,import_pkg_js=import_pkg_js)
+    import_pkg_js = clean_all_imports(text=text,file_path=file_path,import_pkg_js=import_pkg_js)
+    contents = '\n'.join(import_pkg_js["context"]["nulines"])
+    if file_path and write:
+        write_to_file(contents=contents,file_path=file_path)
+    return contents

abstract_utilities/import_utils/src/dot_utils.py

@@ -0,0 +1,69 @@
+from ..imports import *
+def get_Path(path):
+    if isinstance(path,str):
+        path = Path(str(path))
+    return path
+def get_dot_range(filepath=None,list_obj=None):
+    imports = make_list(list_obj) or extract_imports(filepath)
+    highest=0
+    dots = [get_imp(fro) for fro in imports if fro]
+
+    if dots:
+        dots.sort()
+        highest = dots[0]
+    return highest
+def dotted_from(file: Path, sysroot: Path) -> str:
+    """
+    Build dotted name from sysroot (directory *above* top package)
+    e.g.  /repo/abstract_ide/consoles/launcherWindowTab/functions/core_utils.py
+        sysroot=/repo  -> abstract_ide.consoles.launcherWindowTab.functions.core_utils
+    """
+    file = get_Path(file)
+    sysroot = get_Path(sysroot)
+    file = file.resolve()
+    stem = file.with_suffix("")  # drop .py
+    return ".".join(stem.relative_to(sysroot).parts)
+def to_dotted_name(file_path: Path, top_package: str) -> str:
+    """
+    Convert .../abstract_ide/consoles/launcherWindowTab/functions/core_utils.py
+    -> abstract_ide.consoles.launcherWindowTab.functions.core_utils
+    """
+    # find the index of the top_package in the path parts
+    file_path = get_Path(file_path)
+    top_package = get_Path(top_package)
+    parts = file_path.resolve().parts
+    i = None
+    if is_number(top_package):
+        i= int(top_package)
+    if i is None:
+        try:
+            i = parts.index(top_package)
+        except ValueError:
+            raise RuntimeError(f"Cannot locate package '{top_package}' in {file_path}")
+    rel_parts = parts[i:]  # from top_package onward
+    if rel_parts[-1].endswith(".py"):
+        rel_parts = list(rel_parts)
+        rel_parts[-1] = rel_parts[-1][:-3]  # strip .py
+    return ".".join(rel_parts)
+def compute_dotted_and_sysroot(file_path: Path) -> Tuple[str, Path]:
+    """
+    If inside packages, build dotted name from the top package down.
+    sysroot will be the directory *above* the top package.
+    If not a package, we fall back to a repo-ish root guess (2 parents up).
+    """
+    file_path = get_Path(file_path)
+    file_path = file_path.resolve()
+    stem = file_path.with_suffix("")  # drop .py
+
+    top_pkg_dir = find_top_package_dir(file_path)
+    if top_pkg_dir:
+        sysroot = top_pkg_dir.parent
+        dotted = ".".join(stem.relative_to(sysroot).parts)
+        return dotted, sysroot
+
+    # Fallback: not in a package tree — guess a root a couple levels up
+    sysroot = file_path.parents[2]
+    dotted = ".".join(stem.relative_to(sysroot).parts)
+    return dotted, sysroot
+
+

abstract_utilities/import_utils/src/extract_utils.py

@@ -0,0 +1,42 @@
+from ..imports import *
+def get_imp(line):
+    lis = [li for li in line.split(' ') if li and li.startswith('.')]
+    if lis and len(lis) >0:
+        lis = lis[0]
+        lis = len(lis) - len(eatInner(lis,['.']))
+        return lis
+    return 0
+def extract_imports(path,strings=None):
+    strings = make_list(strings or ['from','import'])
+    funcs = []
+    lines = read_from_file(path).splitlines()
+    return [line for line in lines if [string for string in strings if string and eatAll(line,[' ','\n','\t']) and eatAll(line,[' ','\n','\t']).startswith(string)]]
+
+def extract_froms(path: str):
+    funcs = []
+    for line in read_from_file(path).splitlines():
+        m = re.match(r"^from\s+([A-Za-z_]\w*)\s*", line)
+        if m:
+            funcs.append(m.group(1))
+    return funcs
+def extract_selfs(path: str):
+    funcs = []
+    for line in read_from_file(path).splitlines():
+        m = re.match(r"^def\s+([A-Za-z_]\w*)\s*\(self", line)
+        if m:
+            funcs.append(m.group(1))
+    return funcs
+def extract_funcs(path: str):
+    funcs = []
+    for line in read_from_file(path).splitlines():
+        m = re.match(r"^def\s+([A-Za-z_]\w*)\s*\(", line)
+        if m:
+            funcs.append(m.group(1))
+    return funcs
+def extract_class(path: str):
+    funcs = []
+    for line in read_from_file(path).splitlines():
+        m = re.match(r"^class\s+([A-Za-z_]\w*)\s*\(", line) or re.match(r"^class\s+([A-Za-z_]\w*)\s*\:", line)
+        if m:
+            funcs.append(m.group(1))
+    return funcs

abstract_utilities/import_utils/src/import_functions.py

@@ -0,0 +1,46 @@
+# --- auto-package bootstrap (run-safe) ---------------------------------
+from ..imports import *
+from .dot_utils import get_dot_range
+from .sysroot_utils import get_sysroot
+def clean_imports(imports,commaClean=True):
+    chars=["*"]
+    if not commaClean:
+        chars.append(',')
+    if isinstance(imports,str):
+        imports = imports.split(',')
+    return [eatElse(imp,chars=chars) for imp in imports if imp]
+def get_cleaned_import_list(line,commaClean=True):
+    cleaned_import_list=[]
+    if IMPORT_TAG in line:
+        imports = line.split(IMPORT_TAG)[1]
+        cleaned_import_list+=clean_imports(imports,commaClean=commaClean)
+    return cleaned_import_list
+def get_module_from_import(imp,path=None):
+    path = path or os.getcwd()
+    i = get_dot_range(None,[imp])
+    imp = eatAll(imp,'.')
+    sysroot = get_sysroot(path,i)
+    return os.path.join(sysroot, imp)
+
+def safe_import(name: str, *, package: str | None = None, member: str | None = None, file: str | None = None):
+    """
+    Wrapper over importlib.import_module that:
+    - if `name` is relative (starts with '.'), ensures `package` is set.
+    - if `package` is missing, derives it from `file` (defaults to __file__).
+    """
+    file = file or __file__
+    ensure_package_context(file)
+    if name.startswith(".") and not package:
+        
+            
+        pkg_name = get_module_from_import(name,path=None)
+        # also set __package__ if we are running as a script
+        if __name__ == "__main__" and (not globals().get("__package__")):
+            globals()["__package__"] = pkg_name
+        package = pkg_name
+
+    mod = importlib.import_module(name, package=package)
+    return getattr(mod, member) if member else mod
+
+
+