pyhabitat 1.0.14__py3-none-any.whl → 1.0.16__py3-none-any.whl

pyhabitat/__init__.py

@@ -11,7 +11,7 @@ from .environment import (
     is_windows,
     is_apple,
     is_ish_alpine,
-    pyinstaller,
+    is_pyinstaller,
     is_frozen,
     is_elf,
     is_pyz,
@@ -20,7 +20,7 @@ from .environment import (
     is_pipx,
     interactive_terminal_is_available,
     web_browser_is_available,
-    open_text_file_for_editing,
+    edit_textfile,
 )
 
 # Optional: Set __all__ for explicit documentation and cleaner imports
@@ -35,7 +35,7 @@ __all__ = [
     'is_windows',
     'is_apple',
     'is_ish_alpine',
-    'pyinstaller',
+    'is_pyinstaller',
     'is_frozen',
     'is_elf',
     'is_pyz',
@@ -44,5 +44,5 @@ __all__ = [
     'is_pipx',
     'interactive_terminal_is_available',
     'web_browser_is_available',
-    'open_text_file_for_editing',
-]
+    'edit_textfile',
+]

pyhabitat/environment.py

@@ -12,8 +12,7 @@ import shutil
 from pathlib import Path
 import subprocess
 import io
-
-from pipeline.helpers import check_if_zip
+import zipfile
 
 # Global cache for tkinter and matplotlib (mpl) availability
 _TKINTER_AVAILABILITY: bool | None = None
@@ -212,7 +211,7 @@ def is_ish_alpine() -> bool:
 
 # --- BUILD AND EXECUTABLE CHECKS ---
     
-def pyinstaller():
+def is_pyinstaller():
     """Detects if the Python script is running as a 'frozen' in the course of generating a PyInstaller binary executable."""
     # If the app is frozen AND has the PyInstaller-specific temporary folder path
     return is_frozen() and hasattr(sys, '_MEIPASS')
@@ -277,7 +276,7 @@ def is_pyz(exec_path: Path=None, debug=False) -> bool:
     if not str(exec_path).endswith(".pyz"):
         return False
     
-    if not check_if_zip():
+    if not _check_if_zip():
         return False
 
 def is_windows_portable_executable(exec_path: Path = None, debug=False) -> bool:
@@ -449,36 +448,39 @@ def web_browser_is_available() -> bool:
         return False
     
 # --- LAUNCH MECHANISMS BASED ON ENVIRONMENT ---
-def open_text_file_for_editing(filepath):
+def edit_textfile(filepath) -> None:
+#def open_text_file_for_editing(filepath):
     """
     Opens a file with the environment's default application (Windows, Linux, macOS)
     or a guaranteed console editor (nano) in constrained environments (Termux, iSH)
     after ensuring line-ending compatibility.
     """
-    if is_windows():
-        os.startfile(filepath)
-    elif is_termux():
-        # Install dependencies if missing (Termux pkg returns non-zero if already installed, so no check=True)
-        subprocess.run(['pkg','install', 'dos2unix', 'nano'], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
-        _run_dos2unix(filepath)
-        subprocess.run(['nano', filepath])
-    elif is_ish_alpine():
-        # Install dependencies if missing (apk returns 0 if already installed, so check=True is safe)
-        subprocess.run(['apk','add', 'dos2unix'], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, check=True)
-        subprocess.run(['apk','add', 'nano'], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, check=True)
-        _run_dos2unix(filepath)
-        subprocess.run(['nano', filepath])
-    # --- Standard Unix-like Systems (Conversion + Default App) ---
-    elif is_linux():
-        _run_dos2unix(filepath) # Safety conversion for user-defined console apps
-        subprocess.run(['xdg-open', filepath])
-        
-    elif is_apple():
-        _run_dos2unix(filepath) # Safety conversion for user-defined console apps
-        subprocess.run(['open', filepath])
-    else:
-        print("Unsupported operating system.")
-    
+    try:
+        if is_windows():
+            os.startfile(filepath)
+        elif is_termux():
+    	    # Install dependencies if missing (Termux pkg returns non-zero if already installed, so no check=True)
+    	    subprocess.run(['pkg','install', 'dos2unix', 'nano'], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    	    _run_dos2unix(filepath)
+    	    subprocess.run(['nano', filepath])
+        elif is_ish_alpine():
+            # Install dependencies if missing (apk returns 0 if already installed, so check=True is safe)
+    	    subprocess.run(['apk','add', 'dos2unix'], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, check=True)
+    	    subprocess.run(['apk','add', 'nano'], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, check=True)
+    	    _run_dos2unix(filepath)
+    	    subprocess.run(['nano', filepath])
+    	# --- Standard Unix-like Systems (Conversion + Default App) ---
+        elif is_linux():
+    	    _run_dos2unix(filepath) # Safety conversion for user-defined console apps
+    	    subprocess.run(['xdg-open', filepath])
+        elif is_apple():
+    	    _run_dos2unix(filepath) # Safety conversion for user-defined console apps
+    	    subprocess.run(['open', filepath])
+        else:
+    	    print("Unsupported operating system.")
+    except Exception as e:
+	    print("The file could not be opened for editing in the current environment. Known failure points: Pydroid3")
+
     """Why Not Use check=True on Termux:
     The pkg utility in Termux is a wrapper around Debian's apt. When you run pkg install <package>, if the package is already installed, the utility often returns an exit code of 100 (or another non-zero value) to indicate that no changes were made because the package was already present.
     """
@@ -522,3 +524,13 @@ def _get_pipx_paths():
         pipx_venv_base = Path.home() / '.local' / 'share' / 'pipx' / 'venvs'
 
     return pipx_bin_path, pipx_venv_base.resolve()
+
+
+def _check_if_zip(file_path: str | Path) -> bool:
+    """Checks if the file at the given path is a valid ZIP archive."""
+    try:
+        return zipfile.is_zipfile(file_path)
+    except Exception:
+        # Handle cases where the path might be invalid, or other unexpected errors
+        return False
+        

{pyhabitat-1.0.14.dist-info → pyhabitat-1.0.16.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyhabitat
-Version: 1.0.14
+Version: 1.0.16
 Summary: A lightweight library for detecting system environment, GUI, and build properties.
 Author-email: George Clayton Bennett <george.bennett@memphistn.gov>
 License-Expression: MIT
@@ -89,10 +89,12 @@ Key question: "What is the character of my executable?"
 | Function | Description |
 | :--- | :--- |
 | `is_frozen()` | Returns `True` if the script is running as a standalone executable (any bundler). |
+| `is_pyinstaller()` | Returns `True` if the script is_frozen() and was generated by Pyinstaller (has MEI). |
 | `is_pipx()` | Returns `True` if running from a pipx managed virtual environment. |
 | `is_elf()` | Checks if the executable is an ELF binary (Linux standalone executable), excluding pipx. |
 | `is_windows_portable_executable()` | Checks if the executable is a Windows PE binary (MZ header), excluding pipx. |
-| `is_macos_executable()` | Checks if the executable is a macOS/Darwin Mach-O binary, excluding pipx. |
+| `is_macos_executable()` | Checks if the executable is a macOS/Darwin Mach-O binary, excluding pipx. || `is_macos_executable()` | Checks if the executable is a macOS/Darwin Mach-O binary, excluding pipx. |
+
 
 ### Capability Checking
 
@@ -110,7 +112,7 @@ Key Question: "What could I do next?"
 
 | Function | Description |
 | :--- | :--- |
-| `open_text_file_for_editing()` | Smoothly opens a text file for editing (for configuration editing prompted by a CLI flag). |
+| `edit_textfile()` | Smoothly opens a text file for editing (for configuration editing prompted by a CLI flag). |
 
 </details>
 
@@ -177,7 +179,7 @@ Use this function to smoothly open a text file for editing.
 Ideal use case: Edit a configuration file, if prompted by a CLI command like 'config --textedit'.
 
 ```python
-open_text_file_for_editing(filepath=Path('./config.json'))
+edit_textfile(filepath=Path('./config.json'))
 ```
 </details>
 

pyhabitat-1.0.16.dist-info/RECORD

@@ -0,0 +1,7 @@
+pyhabitat/__init__.py,sha256=MiYIzYPqB3o6ZFXQ1C9BV2M2KI17BSq9CA6p8Uc7_h0,1096
+pyhabitat/environment.py,sha256=v9e47TdbtMSiljkjr9-lfdUILQu95HLH0SB6k7QIba0,20757
+pyhabitat-1.0.16.dist-info/licenses/LICENSE,sha256=D4fg30ctUGnCJlWu3ONv5-V8JE1v3ctakoJTcVjsJlg,1072
+pyhabitat-1.0.16.dist-info/METADATA,sha256=APK_RIRIKYUzZ3nuNgcRUvbDhaHZnWXAwvatvPwU_Qg,9001
+pyhabitat-1.0.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pyhabitat-1.0.16.dist-info/top_level.txt,sha256=zXYK44Qu8EqxUETREvd2diMUaB5JiGRErkwFaoLQnnI,10
+pyhabitat-1.0.16.dist-info/RECORD,,

pyhabitat-1.0.14.dist-info/RECORD

@@ -1,7 +0,0 @@
-pyhabitat/__init__.py,sha256=XVMOgp7YPR0xYD1F_4-VEhG4rTwx3ga3CttdRKpkyxA,1115
-pyhabitat/environment.py,sha256=c_eUqlqiAYGBX2LLCMo3PctOYhwTywOrCBrvjg_rXUs,20248
-pyhabitat-1.0.14.dist-info/licenses/LICENSE,sha256=D4fg30ctUGnCJlWu3ONv5-V8JE1v3ctakoJTcVjsJlg,1072
-pyhabitat-1.0.14.dist-info/METADATA,sha256=2_t5JIthRCcKCg5s4cX-CnAGLzfd36LNNmksec8zrM0,8813
-pyhabitat-1.0.14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pyhabitat-1.0.14.dist-info/top_level.txt,sha256=zXYK44Qu8EqxUETREvd2diMUaB5JiGRErkwFaoLQnnI,10
-pyhabitat-1.0.14.dist-info/RECORD,,