pyhabitat 1.0.9__py3-none-any.whl → 1.0.11__py3-none-any.whl

pyhabitat/environment.py

@@ -449,22 +449,54 @@ def web_browser_is_available() -> bool:
         return False
     
 # --- LAUNCH MECHANISMS BASED ON ENVIRONMENT ---
-def open_text_file_in_default_app(filepath):
-    """Opens a file with its default application based on the OS."""
+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():
-        subprocess.run(['apk','add', 'nano'], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        # 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.")
-
+    
+    """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.
+    """
+    
+def _run_dos2unix(filepath):
+    """Attempt to run dos2unix, failing silently if not installed."""
+    try:
+        # We rely on shutil.which not being needed, as this is a robust built-in utility on most targets
+        # The command won't raise an exception unless the process itself fails, not just if the utility isn't found.
+        # We also don't use check=True here to allow silent failure if the utility is missing (e.g., minimalist Linux).
+        subprocess.run(['dos2unix', filepath], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    except FileNotFoundError:
+        # This will be raised if 'dos2unix' is not on the system PATH
+        pass 
+    except Exception:
+        # Catch other subprocess errors (e.g. permission issues)
+        pass
+        
 def _get_pipx_paths():
     """
     Returns the configured/default pipx binary and home directories.

{pyhabitat-1.0.9.dist-info → pyhabitat-1.0.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyhabitat
-Version: 1.0.9
+Version: 1.0.11
 Summary: A lightweight library for detecting system environment, GUI, and build properties.
 Author-email: George Clayton Bennett <george.bennett@memphistn.gov>
 License-Expression: MIT
@@ -27,7 +27,7 @@ Stop writing verbose `sys.platform` and environment variable checks. Use **`pyha
 
 ---
 
-Read the code on [github](https://github.com/City-of-Memphis-Wastewater/pyhabitat/blob/main/pyhabitat/environment.py).
+Read the code on [github](https://github.com/City-of-Memphis-Wastewater/pyhabitat/blob/main/pyhabitat/environment.py). 🌐
 
 ---
 
@@ -36,10 +36,12 @@ Read the code on [github](https://github.com/City-of-Memphis-Wastewater/pyhabita
 ```bash
 pip install pyhabitat
 ```
+
 ---
 
 <details>
-<summary> Motivation </summary>
+<summary> 🧠 Motivation </summary>
+
 This library is especially useful for **leveraging Python in mobile environments** (`Termux` on Android and `iSH` on iOS), which often have particular limitations and require special handling. For example, it helps automate work-arounds like using **localhost plotting** when `matplotlib` is unavailable or **web-based interfaces** when `tkinter` is missing. 
 
 Our team is fundamentally driven by enabling mobile computing for true utility applications, leveraging environments like Termux (Android) and iSH (iOS). This includes highly practical solutions, such as deploying a lightweight Python web server (e.g., Flask, http.server, FastAPI) directly on a handset, or orchestrating full-stack, utility-grade applications that allow technicians to manage data and systems right from their mobile device in a way that is cross-platform and not overly catered to the App Store.
@@ -119,6 +121,10 @@ Key Question: "What could I do next?"
 
 The module exposes all detection functions directly for easy access.
 
+### 0\. Current Use
+
+The `pipeline-eds` package uses the `pyhabitat` library to handle [configuration](https://github.com/City-of-Memphis-Wastewater/pipeline/blob/main/src/pipeline/security_and_config.py) and [plotting](https://github.com/City-of-Memphis-Wastewater/pipeline/blob/main/src/pipeline/cli.py), among other things.
+
 ### 1\. Checking Environment and Build Type
 
 ```python

pyhabitat-1.0.11.dist-info/RECORD

@@ -0,0 +1,7 @@
+pyhabitat/__init__.py,sha256=fy1SRFXok05bCprjGMCXS5afw27iKBJCLeSQTuBjlRI,1101
+pyhabitat/environment.py,sha256=c_eUqlqiAYGBX2LLCMo3PctOYhwTywOrCBrvjg_rXUs,20248
+pyhabitat-1.0.11.dist-info/licenses/LICENSE,sha256=D4fg30ctUGnCJlWu3ONv5-V8JE1v3ctakoJTcVjsJlg,1072
+pyhabitat-1.0.11.dist-info/METADATA,sha256=eBf2FoFx5utwcsPoRymXTI5vp5av1szHnOxtLfHO8VM,8819
+pyhabitat-1.0.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pyhabitat-1.0.11.dist-info/top_level.txt,sha256=zXYK44Qu8EqxUETREvd2diMUaB5JiGRErkwFaoLQnnI,10
+pyhabitat-1.0.11.dist-info/RECORD,,

pyhabitat-1.0.9.dist-info/RECORD

@@ -1,7 +0,0 @@
-pyhabitat/__init__.py,sha256=fy1SRFXok05bCprjGMCXS5afw27iKBJCLeSQTuBjlRI,1101
-pyhabitat/environment.py,sha256=rteFLXko5VaxwgfQYRR7SBQaRygKqrNr0YjRYQ5mybo,18206
-pyhabitat-1.0.9.dist-info/licenses/LICENSE,sha256=D4fg30ctUGnCJlWu3ONv5-V8JE1v3ctakoJTcVjsJlg,1072
-pyhabitat-1.0.9.dist-info/METADATA,sha256=Th1AvU7Fvpy7WSaesAi1BMVoRcECPlWsmcWV2RGKgNA,8478
-pyhabitat-1.0.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pyhabitat-1.0.9.dist-info/top_level.txt,sha256=zXYK44Qu8EqxUETREvd2diMUaB5JiGRErkwFaoLQnnI,10
-pyhabitat-1.0.9.dist-info/RECORD,,