abstract-utilities 0.2.2.455__tar.gz → 0.2.2.457__tar.gz

{abstract_utilities-0.2.2.455 → abstract_utilities-0.2.2.457}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstract_utilities
-Version: 0.2.2.455
+Version: 0.2.2.457
 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.455 → abstract_utilities-0.2.2.457}/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.455',
+    version='0.2.2.457',
     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.455 → abstract_utilities-0.2.2.457}/src/abstract_utilities/file_utils/file_utils/__init__.py

@@ -5,3 +5,4 @@ from .map_utils import *
 from .pdf_utils import *
 from .file_reader import *
 from .find_collect import *
+from .type_checks import *

abstract_utilities-0.2.2.457/src/abstract_utilities/file_utils/file_utils/type_checks.py

@@ -0,0 +1,83 @@
+from .imports import *
+import subprocess, os
+from typing import Optional
+
+# --- Base remote checker -----------------------------------------------------
+def _remote_test(path: str, test_flag: str, user_at_host: str, timeout: int = 5) -> bool:
+    """
+    Run a remote shell test (e.g. -f, -d) via SSH.
+    Returns True if test succeeds, False otherwise.
+    """
+    cmd = f"[ {test_flag} {shlex.quote(path)} ] && echo 1 || echo 0"
+    try:
+        result = subprocess.check_output(
+            ["ssh", user_at_host, cmd],
+            stderr=subprocess.DEVNULL,
+            text=True,
+            timeout=timeout
+        ).strip()
+        return result == "1"
+    except Exception:
+        return False
+
+
+# --- Individual path checks --------------------------------------------------
+def is_remote_file(path: str, user_at_host: str) -> bool:
+    """True if remote path is a file."""
+    return _remote_test(path, "-f", user_at_host)
+
+
+def is_remote_dir(path: str, user_at_host: str) -> bool:
+    """True if remote path is a directory."""
+    return _remote_test(path, "-d", user_at_host)
+
+
+def is_local_file(path: str) -> bool:
+    """True if local path is a file."""
+    return os.path.isfile(path)
+
+
+def is_local_dir(path: str) -> bool:
+    """True if local path is a directory."""
+    return os.path.isdir(path)
+
+
+# --- Unified interface -------------------------------------------------------
+def is_file(path: str,*args, user_at_host: Optional[str] = None,**kwargs) -> bool:
+    """Determine if path is a file (works local or remote)."""
+    if user_at_host:
+        return is_remote_file(path, user_at_host)
+    return is_local_file(path)
+
+
+def is_dir(path: str, *args,user_at_host: Optional[str] = None,**kwargs)) -> bool:
+    """Determine if path is a directory (works local or remote)."""
+    if user_at_host:
+        return is_remote_dir(path, user_at_host)
+    return is_local_dir(path)
+
+
+# --- Optional: keep your original all-in-one wrapper ------------------------
+def check_path_type(
+    path: str,
+    user_at_host: Optional[str] = None,
+) -> str:
+    """
+    Return 'file', 'directory', 'missing', or 'unknown'.
+    Uses isolated is_file/is_dir functions.
+    """
+    if user_at_host:
+        if is_remote_file(path, user_at_host):
+            return "file"
+        elif is_remote_dir(path, user_at_host):
+            return "directory"
+        else:
+            return "missing"
+    else:
+        if os.path.isfile(path):
+            return "file"
+        elif os.path.isdir(path):
+            return "directory"
+        elif not os.path.exists(path):
+            return "missing"
+        return "unknown"

{abstract_utilities-0.2.2.455 → abstract_utilities-0.2.2.457}/src/abstract_utilities/read_write_utils.py

@@ -14,6 +14,7 @@ Usage:
 
 import os
 from .ssh_utils.utils import run_cmd
+from .ssh_utils.type_checks import is_file,is_dir
 from .abstract_classes import run_pruned_func
 _FILE_PATH_KEYS = ['file', 'filepath', 'file_path', 'path', 'directory', 'f', 'dst', 'dest']
 _CONTENTS_KEYS = ['cont', 'content', 'contents', 'data', 'datas', 'dat', 'src', 'source']
@@ -73,7 +74,73 @@ def check_read_write_params(*args, **kwargs):
         raise ValueError("Missing file_path argument.")
     return file_path, contents
 
+def write_to_path(
+        file_path: str,
+        contents: str,
+        *,
+        user_at_host: str = None,
+        cwd: str | None = None,
+        password=None,
+        key=None,
+        env_path=None,
+        **kwargs
+    ) -> str:
+    """
+    Completely overwrite a file (locally or remotely).
+    Supports sudo and password-based remote execution.
+    """
+
+    # sanitize for shell safety
+    quoted_path = shlex.quote(file_path)
+    quoted_data = shlex.quote(str(contents))
 
+    # shell command that fully overwrites
+    # (no append, replaces contents entirely)
+    base_cmd = f"echo {quoted_data} > {quoted_path}"
+
+    # optional sudo password injection
+    full_cmd = get_print_sudo_cmd(
+        cmd=base_cmd,
+        password=password,
+        key=key,
+        env_path=env_path
+    )
+
+    # local or remote dispatch
+    if user_at_host:
+        return run_remote_cmd(
+            user_at_host=user_at_host,
+            cmd=full_cmd,
+            cwd=cwd,
+            password=password,
+            key=key,
+            env_path=env_path,
+            **kwargs
+        )
+    else:
+        return run_local_cmd(
+            cmd=full_cmd,
+            cwd=cwd,
+            password=password,
+            key=key,
+            env_path=env_path,
+            **kwargs
+        )
+### --- Core functionality -------------------------------------------------------
+##def write_to_file(*args, **kwargs):
+##    """
+##    Write contents to a file (create if missing).
+##
+##    Returns the file_path written.
+##    """
+##    file_path, contents = check_read_write_params(*args, **kwargs)
+##    if contents is None:
+##        raise ValueError("Missing contents to write.")
+##
+##    os.makedirs(os.path.dirname(file_path) or ".", exist_ok=True)
+##    with open(file_path, "w", encoding="utf-8") as f:
+##        f.write(str(contents))
+##    return file_path
 # --- Core functionality -------------------------------------------------------
 def write_to_file(*args, **kwargs):
     """
@@ -84,6 +151,17 @@ def write_to_file(*args, **kwargs):
     file_path, contents = check_read_write_params(*args, **kwargs)
     if contents is None:
         raise ValueError("Missing contents to write.")
+    user_at_host = kwargs.get("user_at_host")
+    if user_at_host:
+        kwargs["cwd"] = kwargs.get('cwd') or os.path.dirname(file_path)
+        # sanitize for shell safety
+        quoted_path = shlex.quote(file_path)
+        quoted_data = shlex.quote(str(contents))
+        # shell command that fully overwrites
+        # (no append, replaces contents entirely)
+        kwargs["cmd"] = f"echo {quoted_data} > {quoted_path}"
+        return run_pruned_func(run_cmd,**kwargs)
+
 
     os.makedirs(os.path.dirname(file_path) or ".", exist_ok=True)
     with open(file_path, "w", encoding="utf-8") as f:

{abstract_utilities-0.2.2.455 → abstract_utilities-0.2.2.457}/src/abstract_utilities.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstract_utilities
-Version: 0.2.2.455
+Version: 0.2.2.457
 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.455 → abstract_utilities-0.2.2.457}/src/abstract_utilities.egg-info/SOURCES.txt

@@ -59,6 +59,7 @@ src/abstract_utilities/file_utils/file_utils/find_collect.py
 src/abstract_utilities/file_utils/file_utils/imports.py
 src/abstract_utilities/file_utils/file_utils/map_utils.py
 src/abstract_utilities/file_utils/file_utils/pdf_utils.py
+src/abstract_utilities/file_utils/file_utils/type_checks.py
 src/abstract_utilities/file_utils/imports/__init__.py
 src/abstract_utilities/file_utils/imports/classes.py
 src/abstract_utilities/file_utils/imports/constants.py