abstract-utilities 0.2.2.420__tar.gz → 0.2.2.422__tar.gz

{abstract_utilities-0.2.2.420 → abstract_utilities-0.2.2.422}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstract_utilities
-Version: 0.2.2.420
+Version: 0.2.2.422
 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

{abstract_utilities-0.2.2.420 → abstract_utilities-0.2.2.422}/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.420',
+    version='0.2.2.422',
     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.',

{abstract_utilities-0.2.2.420 → abstract_utilities-0.2.2.422}/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 .dynimport import get_abstract_import,import_symbols_to_parent,call_for_all_tabs
 
-from .robust_readers import *
 from .json_utils import (unified_json_loader,
                          find_keys,
                          get_key_values_from_path,

{abstract_utilities-0.2.2.420 → abstract_utilities-0.2.2.422}/src/abstract_utilities/dynimport.py

@@ -6,7 +6,7 @@ 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
+from .file_utils 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.

abstract_utilities-0.2.2.422/src/abstract_utilities/file_utils/file_utils/file_utils.py

@@ -0,0 +1,208 @@
+from .imports import *
+# -------- Public API drop-ins that mirror your originals --------
+from .filter_params import *
+from .file_filters import *
+# -------------------------------------------------------------
+# Wrapper: respects your original API and naming conventions
+# -------------------------------------------------------------
+
+def get_allowed_predicate(allowed=None):
+    if allowed is not False:
+        if allowed is True:
+            allowed = None
+        allowed = allowed or make_allowed_predicate()
+    else:
+        def allowed(*args):
+            return True
+    return allowed
+
+
+# -------------------------------------------------------------
+# Remote-aware globbing
+# -------------------------------------------------------------
+def get_globs(items, recursive: bool = True, allowed=None, **kwargs):
+    """
+    Behaves like your original get_globs(), but can traverse both
+    local and remote paths transparently via normalize_items().
+    """
+    glob_paths = []
+    roots = [p for p in make_list(items) if p]
+
+    kwargs.setdefault("mindepth", 0)
+    if not recursive:
+        kwargs.setdefault("maxdepth", 1)
+    
+    for fs, root, _ in normalize_items(roots, **kwargs):
+        # use the backend's recursive walker
+        nu_items = fs.glob_recursive(root, **kwargs)
+        if allowed:
+           
+            nu_items = [n for n in nu_items if n and allowed(n)]
+            
+        glob_paths += nu_items
+    return glob_paths
+
+
+# -------------------------------------------------------------
+# Allowed filters
+# -------------------------------------------------------------
+def get_allowed_files(items, allowed=True, **kwargs):
+    allowed = get_allowed_predicate(allowed=allowed)
+    out = []
+    for fs, item, _ in normalize_items(items, **kwargs):
+        if fs.isfile(item) and allowed(item):
+            out.append(item)
+    return out
+
+
+def get_allowed_dirs(items, allowed=False, **kwargs):
+    allowed = get_allowed_predicate(allowed=allowed)
+    out = []
+    for fs, item, _ in normalize_items(items, **kwargs):
+        if fs.isdir(item) and allowed(item):
+            out.append(item)
+    return out
+
+
+# -------------------------------------------------------------
+# Filtered sets
+# -------------------------------------------------------------
+def get_filtered_files(items, allowed=None, files=None, **kwargs):
+    allowed = get_allowed_predicate(allowed=allowed)
+    files = set(files or [])
+    out = []
+    for fs, root, _ in normalize_items(items, **kwargs):
+        for p in fs.glob_recursive(root, **kwargs):
+            if p in files:
+                continue
+            if allowed(p) and fs.isfile(p):
+                out.append(p)
+    return out
+
+
+def get_filtered_dirs(items, allowed=None, dirs=None, **kwargs):
+    allowed = get_allowed_predicate(allowed=allowed)
+    dirs = set(dirs or [])
+    out = []
+    for fs, root, _ in normalize_items(items, **kwargs):
+        for p in fs.glob_recursive(root, **kwargs):
+            if p in dirs:
+                continue
+            if allowed(p) and fs.isdir(p):
+                out.append(p)
+    return out
+
+
+# -------------------------------------------------------------
+# Recursive expansion
+# -------------------------------------------------------------
+def get_all_allowed_files(items, allowed=None, **kwargs):
+    dirs = get_all_allowed_dirs(items, allowed=allowed, **kwargs)
+    files = get_allowed_files(items, allowed=allowed, **kwargs)
+    seen = set(files)
+    for fs, directory, _ in normalize_items(dirs, **kwargs):
+        for p in fs.glob_recursive(directory, **kwargs):
+            if p in seen:
+                continue
+            if allowed and not allowed(p):
+                continue
+            if fs.isfile(p):
+                files.append(p)
+                seen.add(p)
+    return files
+
+
+def get_all_allowed_dirs(items, allowed=None, **kwargs):
+    allowed = get_allowed_predicate(allowed=allowed)
+    out = []
+    seen = set()
+    for fs, root, _ in normalize_items(items, **kwargs):
+        if fs.isdir(root) and allowed(root):
+            out.append(root)
+            seen.add(root)
+        for p in fs.glob_recursive(root, **kwargs):
+            if p in seen:
+                continue
+            if allowed(p) and fs.isdir(p):
+                out.append(p)
+                seen.add(p)
+    return out
+
+
+# -------------------------------------------------------------
+# Unified directory scan
+# -------------------------------------------------------------
+def get_files_and_dirs(
+    directory: str,
+    cfg: Optional["ScanConfig"] = None,
+    allowed_exts: Optional[Set[str]] = False,
+    unallowed_exts: Optional[Set[str]] = False,
+    exclude_types: Optional[Set[str]] = False,
+    exclude_dirs: Optional[List[str]] = False,
+    exclude_patterns: Optional[List[str]] = False,
+    add=False,
+    recursive: bool = True,
+    include_files: bool = True,
+    **kwargs
+):
+    """
+    Same public signature as your original get_files_and_dirs(),
+    but powered by backend objects (LocalFS or SSHFS).
+    """
+    cfg = cfg or define_defaults(
+        allowed_exts=allowed_exts,
+        unallowed_exts=unallowed_exts,
+        exclude_types=exclude_types,
+        exclude_dirs=exclude_dirs,
+        exclude_patterns=exclude_patterns,
+        add=add
+    )
+    allowed = make_allowed_predicate(cfg)
+    items = []
+    files = []
+    input(allowed)
+    if recursive:
+        items = get_globs(directory, recursive=recursive, allowed=allowed, **kwargs)
+    else:
+        for fs, base, _ in normalize_items(make_list(directory), **kwargs):
+            try:
+                items += [fs.join(base, name) for name in fs.listdir(base)]
+            except Exception:
+                pass
+
+    dirs = get_allowed_dirs(items, allowed=allowed, **kwargs)
+    if include_files:
+        files = get_allowed_files(items, allowed=allowed, **kwargs)
+    return dirs, files
+
+
+# -------------------------------------------------------------
+# Unchanged predicate builder
+# -------------------------------------------------------------
+def make_allowed_predicate(cfg: ScanConfig) -> Callable[[str], bool]:
+    def allowed(path: str) -> bool:
+        p = Path(path)
+        name = p.name.lower()
+        path_str = str(p).lower()
+
+        # A) directory exclusions
+        if cfg.exclude_dirs:
+            for dpat in cfg.exclude_dirs:
+                if dpat in path_str or fnmatch.fnmatch(name, dpat.lower()):
+                    if p.is_dir() or dpat in path_str:
+                        return False
+
+        # B) filename pattern exclusions
+        if cfg.exclude_patterns:
+            for pat in cfg.exclude_patterns:
+                if fnmatch.fnmatch(name, pat.lower()):
+                    return False
+
+        # C) extension gates
+        if p.is_file():
+            ext = p.suffix.lower()
+            if (cfg.allowed_exts and ext not in cfg.allowed_exts) or \
+               (cfg.unallowed_exts and ext in cfg.unallowed_exts):
+                return False
+        return True
+    return allowed

abstract_utilities-0.2.2.422/src/abstract_utilities/file_utils/imports/classes.py

@@ -0,0 +1,406 @@
+from .imports import *
+from .module_imports import *
+from .constants import *
+def get_item_check_cmd(path, file=True, directory=False, exists=False):
+    if (directory and file) or exists:
+        typ = "e"
+    elif file:
+        typ = "f"
+    elif directory:
+        typ = "d"
+    elif isinstance(file, str):
+        if "f" in file:
+            typ = "f"
+        elif "d" in file:
+            typ = "d"
+        else:
+            typ = "e"
+    else:
+        typ = "e"
+    return f"test -{typ} {shlex.quote(path)} && echo __OK__ || true"
+
+
+def get_all_item_check_cmd(path, file=True, directory=True, exists=True):
+    collects = []
+    out_js = {}
+
+    if file:
+        collects.append("file")
+    if directory:
+        collects.append("dir")
+    if exists:
+        collects.append("exists")
+
+    if not collects:
+        return out_js
+
+    path = shlex.quote(path)
+    for typ in collects:
+        t = typ[0]  # f, d, or e
+        out_js[typ] = f"test -{t} {path} && echo __OK__ || true"
+
+    return out_js
+        
+
+def is_file(
+    path,
+    user_at_host=None,
+    password=None,
+    key=None,
+    env_path=None,
+    **kwargs
+    ):
+    contingencies = list(set([user_at_host,password,key,env_path]))
+    len_contingencies = len(contingencies)
+    is_potential = (len_contingencies >1 or (None not in contingencies))
+    if not is_potential:
+        return os.path.isfile(path)
+    cmd = get_item_check_cmd(path,file=True)
+    return run_cmd(cmd=cmd,
+            user_at_host=user_at_host,
+            password=password,
+            key=key,
+            env_path=env_path,
+            **kwargs
+            )
+def is_dir(
+    path,
+    user_at_host=None,
+    password=None,
+    key=None,
+    env_path=None,
+    **kwargs
+    ):
+    contingencies = list(set([user_at_host,password,key,env_path]))
+    len_contingencies = len(contingencies)
+    is_potential = (len_contingencies >1 or (None not in contingencies))
+    if not is_potential:
+        return os.path.isdir(path)
+    cmd = get_item_check_cmd(path,file=False,directory=True)
+    return run_cmd(cmd=cmd,
+            user_at_host=user_at_host,
+            password=password,
+            key=key,
+            env_path=env_path,
+            **kwargs
+            )
+def is_exists(
+    path,
+    user_at_host=None,
+    password=None,
+    key=None,
+    env_path=None,
+    **kwargs
+    ):
+    contingencies = list(set([user_at_host,password,key,env_path]))
+    len_contingencies = len(contingencies)
+    is_potential = (len_contingencies >1 or (None not in contingencies))
+    if not is_potential:
+        return os.path.exists(path)
+    if is_potential == True:
+        cmd = get_item_check_cmd(path,exists=True)
+        return run_cmd(cmd=cmd,
+                user_at_host=user_at_host,
+                password=password,
+                key=key,
+                env_path=env_path,
+                **kwargs
+                )
+def is_any(
+    path,
+    user_at_host=None,
+    password=None,
+    key=None,
+    env_path=None,
+    **kwargs
+    ):
+    contingencies = list(set([user_at_host,password,key,env_path]))
+    len_contingencies = len(contingencies)
+    is_potential = (len_contingencies >1 or (None not in contingencies))
+    if not is_potential:
+        return os.path.exists(path)
+    if is_potential == True:
+        out_js = get_all_item_check_cmd(path,file=True,directory=True,exists=True)
+        for typ,cmd in out_js.items():
+            response = run_cmd(cmd=cmd,
+                    user_at_host=user_at_host,
+                    password=password,
+                    key=key,
+                    env_path=env_path,
+                    **kwargs
+                    )
+            result = "__OK__" in (response or "")
+            if result:
+                return typ
+    return None
+class PathBackend(Protocol):
+    def join(self, *parts: str) -> str: ...
+    def isfile(self, path: str) -> bool: ...
+    def isdir(self, path: str) -> bool: ...
+    def glob_recursive(self, base: str, **opts) -> List[str]: ...
+    def listdir(self, base: str) -> List[str]: ...
+
+class LocalFS:
+    def __init__(self, get_type=False, get_is_dir=False, get_is_file=False, get_is_exists=False, **kwargs):
+        self.get_type = get_type
+        self.get_is_dir = get_is_dir
+        self.get_is_file = get_is_file
+        self.get_is_exists = get_is_exists
+
+    def join(self, *parts: str) -> str:
+        return os.path.join(*parts)
+
+    def isfile(self, path: str) -> bool:
+        return os.path.isfile(path)
+
+    def isdir(self, path: str) -> bool:
+        return os.path.isdir(path)
+
+    def isexists(self, path: str) -> bool:
+        return os.path.exists(path)
+
+    def istype(self, path: str) -> str | None:
+        funcs_js = {"file": os.path.isfile, "dir": os.path.isdir, "exists": os.path.exists}
+        for key, func in funcs_js.items():
+            if func(path):
+                return key
+        return None
+
+    def is_included(self, path, **kwargs):
+        include_js = {}
+        if self.get_type:
+            include_js["typ"] = self.istype(path)
+        if self.get_is_dir:
+            include_js["dir"] = self.isdir(path)
+        if self.get_is_file:
+            include_js["file"] = self.isfile(path)
+        if self.get_is_exists:
+            include_js["exists"] = self.isexists(path)
+        return include_js
+    def glob_recursive(self, base: str, **opts) -> List[str]:
+        """
+        opts:
+          - maxdepth: int | None
+          - mindepth: int (default 1)
+          - follow_symlinks: bool
+          - include_dirs: bool
+          - include_files: bool
+          - exclude_hidden: bool
+        """
+        maxdepth = opts.get("maxdepth")
+        mindepth = opts.get("mindepth", 1)
+        follow   = opts.get("follow_symlinks", False)
+        want_d   = opts.get("include_dirs", True)
+        want_f   = opts.get("include_files", True)
+        hide     = opts.get("exclude_hidden", False)
+
+        results: List[str] = []
+        base_depth = os.path.normpath(base).count(os.sep)
+
+        for root, dirs, files in os.walk(base, followlinks=follow):
+            depth = os.path.normpath(root).count(os.sep) - base_depth
+            if maxdepth is not None and depth > maxdepth:
+                dirs[:] = []
+                continue
+            if want_d and depth >= mindepth:
+                for d in dirs:
+                    if hide and d.startswith("."): continue
+                    results.append(os.path.join(root, d))
+            if want_f and depth >= mindepth:
+                for f in files:
+                    if hide and f.startswith("."): continue
+                    results.append(os.path.join(root, f))
+        return results
+
+    def listdir(self, base: str) -> List[str]:
+        try:
+            return [os.path.join(base, name) for name in os.listdir(base)]
+        except Exception:
+            return []
+def get_spec_kwargs(
+    user_at_host=None,
+    password=None,
+    key=None,
+    env_path=None,
+    kwargs=None
+):
+    kwargs = kwargs or {}
+    kwargs["user_at_host"] = kwargs.get("user_at_host") or user_at_host
+    kwargs["password"] = kwargs.get("password") or password
+    kwargs["key"] = kwargs.get("key") or key
+    kwargs["env_path"] = kwargs.get("env_path") or env_path
+    return kwargs
+class SSHFS:
+    """Remote POSIX backend via run_remote_cmd."""
+    def __init__(self, password=None, key=None, env_path=None,
+                 get_type=False, get_is_dir=False, get_is_file=False, get_is_exists=False, **kwargs):
+        self.user_at_host = kwargs.get('user_at_host') or kwargs.get('user') or kwargs.get('host')
+        self.password = password
+        self.key = key
+        self.env_path = env_path
+        self.get_type = get_type
+        self.get_is_dir = get_is_dir
+        self.get_is_file = get_is_file
+        self.get_is_exists = get_is_exists
+
+    def cell_spec_kwargs(self, func, path, **kwargs):
+        kwargs = get_spec_kwargs(
+            user_at_host=self.user_at_host,
+            password=self.password,
+            key=self.key,
+            env_path=self.env_path,
+            kwargs=kwargs
+        )
+        return func(path, **kwargs)
+
+    def is_included(self, path, **kwargs):
+        include_js = {}
+        if self.get_type:
+            include_js["typ"] = self.istype(path, **kwargs)
+        if self.get_is_dir:
+            include_js["dir"] = self.isdir(path, **kwargs)
+        if self.get_is_file:
+            include_js["file"] = self.isfile(path, **kwargs)
+        if self.get_is_exists:
+            include_js["exists"] = self.isexists(path, **kwargs)
+        return include_js
+
+    def join(self, *parts: str) -> str:
+        return posixpath.join(*parts)
+
+    def isfile(self, path: str, **kwargs) -> bool:
+        out = self.cell_spec_kwargs(is_file, path, **kwargs)
+        return "__OK__" in (out or "")
+
+    def isdir(self, path: str, **kwargs) -> bool:
+        out = self.cell_spec_kwargs(is_dir, path, **kwargs)
+        return "__OK__" in (out or "")
+
+    def isexists(self, path: str, **kwargs) -> bool:
+        out = self.cell_spec_kwargs(is_exists, path, **kwargs)
+        return "__OK__" in (out or "")
+
+    def istype(self, path: str, **kwargs) -> str | None:
+        out = self.cell_spec_kwargs(is_any, path, **kwargs)
+        return out
+
+    def glob_recursive(self, base: str, **opts) -> List[str]:
+        maxdepth = opts.get("maxdepth")
+        mindepth = opts.get("mindepth", 1)
+        follow   = opts.get("follow_symlinks", False)
+        want_d   = opts.get("include_dirs", True)
+        want_f   = opts.get("include_files", True)
+        hide     = opts.get("exclude_hidden", False)
+
+        parts = []
+        if follow:
+            parts.append("-L")
+        parts += ["find", shlex.quote(base)]
+        if mindepth is not None:
+            parts += ["-mindepth", str(mindepth)]
+        if maxdepth is not None:
+            parts += ["-maxdepth", str(maxdepth)]
+
+        type_filters = []
+        if want_d and not want_f:
+            type_filters = ["-type", "d"]
+        elif want_f and not want_d:
+            type_filters = ["-type", "f"]
+
+        hidden_filter = []
+        if hide:
+            hidden_filter = ["!", "-regex", r".*/\..*"]
+
+        cmd = " ".join(parts + type_filters + hidden_filter + ["-printf", r"'%p\n'"]) + " 2>/dev/null"
+        out = run_remote_cmd(self.user_at_host, cmd)
+        return [line.strip().strip("'") for line in (out or "").splitlines() if line.strip()]
+
+    def listdir(self, base: str) -> List[str]:
+        cmd = f"find {shlex.quote(base)} -maxdepth 1 -mindepth 1 -printf '%p\\n' 2>/dev/null"
+        out = run_remote_cmd(self.user_at_host, cmd)
+        return [line.strip() for line in (out or "").splitlines() if line.strip()]
+
+
+def make_allowed_predicate(cfg: ScanConfig,fs=None) -> Callable[[str], bool]:
+    fs = fs or LocalFS()
+    def allowed(path: str) -> bool:
+        
+        name = p.name.lower()
+        path_str = str(p).lower()
+        # A) directories
+        if cfg.exclude_dirs:
+            for dpat in cfg.exclude_dirs:
+                if dpat in path_str or fnmatch.fnmatch(name, dpat.lower()):
+                    if p.is_dir() or dpat in path_str:
+                        return False
+
+        if cfg.exclude_patterns:
+            # B) filename patterns
+            for pat in cfg.exclude_patterns:
+                if fnmatch.fnmatch(name, pat.lower()):
+                    return False
+
+        # C) extension gates
+        if p.is_file():
+            ext = p.suffix.lower()
+            if (cfg.allowed_exts and ext not in cfg.allowed_exts) or (cfg.unallowed_exts and ext in cfg.unallowed_exts):
+                return False
+        return True
+    return allowed
+def try_group(pre,item,strings):
+    
+    try:
+        m = pre.match(item)
+        for i,string in enumerate(strings):
+            strings[i] = m.group(string)
+        
+    except:
+        return None
+    return strings
+def normalize_items(
+    paths: Iterable[str],
+    user_at_host=None,
+    get_type=True,
+    get_is_dir=False,
+    get_is_file=False,
+    get_is_exists=False,
+    **kwargs
+) -> List[tuple[PathBackend, str, dict]]:
+    pairs: List[tuple[PathBackend, str, dict]] = []
+    host = user_at_host or kwargs.get("host") or kwargs.get("user")
+
+    for item in paths:
+        if not item:
+            continue
+
+        strings = try_group(REMOTE_RE, item, ["host", "path"])
+        fs_host = None
+        nuhost = None
+
+        if (strings and None not in strings) or host:
+            if strings and None not in strings:
+                nuhost = strings[0]
+                item = strings[1] or item
+            nuhost = nuhost or host
+            fs_host = SSHFS(
+                nuhost,
+                user_at_host=user_at_host,
+                get_type=get_type,
+                get_is_dir=get_is_dir,
+                get_is_file=get_is_file,
+                get_is_exists=get_is_exists,
+                **kwargs
+            )
+        else:
+            fs_host = LocalFS(
+                get_type=get_type,
+                get_is_dir=get_is_dir,
+                get_is_file=get_is_file,
+                get_is_exists=get_is_exists
+            )
+
+        includes = fs_host.is_included(item)
+        pairs.append((fs_host, item, includes))
+    return pairs
+
+

{abstract_utilities-0.2.2.420 → abstract_utilities-0.2.2.422}/src/abstract_utilities/file_utils/imports/module_imports.py

@@ -1,8 +1,8 @@
 from ...string_clean import eatAll
 from ...list_utils import make_list
 from ...type_utils import get_media_exts, is_media_type,MIME_TYPES,is_str
-from ...ssh_utils import run_local_cmd, run_ssh_cmd,run_any_cmd,run_cmd,cmd_input,run_remote_cmd
+from ...ssh_utils import *
 from ...env_utils import *
-from ...path_utils import *
+
 from ...abstract_classes import SingletonMeta
-from ...read_write_utils import *
+