pyhabitat 1.0.15__tar.gz → 1.0.16__tar.gz

{pyhabitat-1.0.15 → pyhabitat-1.0.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyhabitat
-Version: 1.0.15
+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.15 → pyhabitat-1.0.16}/README.md

@@ -74,10 +74,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
 
@@ -95,7 +97,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>
 
@@ -162,7 +164,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>
 
@@ -174,4 +176,4 @@ Contributions are welcome\! If you find an environment or build system that is n
 
 ## 📄 License
 
-This project is licensed under the MIT License. See the LICENSE file for details.
+This project is licensed under the MIT License. See the LICENSE file for details.

{pyhabitat-1.0.15 → pyhabitat-1.0.16}/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-1.0.15 → pyhabitat-1.0.16}/pyhabitat/environment.py

@@ -211,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')
@@ -448,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.
     """
@@ -530,4 +533,4 @@ def _check_if_zip(file_path: str | Path) -> bool:
     except Exception:
         # Handle cases where the path might be invalid, or other unexpected errors
         return False
-        
+        

{pyhabitat-1.0.15 → pyhabitat-1.0.16}/pyhabitat.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyhabitat
-Version: 1.0.15
+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.15 → pyhabitat-1.0.16}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyhabitat"
-version = "1.0.15"
+version = "1.0.16"
 #dynamic = ["version"] # 
 authors = [
   { name="George Clayton Bennett", email="george.bennett@memphistn.gov" },
@@ -28,4 +28,4 @@ include = ["pyhabitat"] # Only include the main package
 
 [tool.setuptools_scm] 
 # This tells setuptools_scm to look at your git history/tags for the version
-write_to = "pyhabitat/_version.py"
+write_to = "pyhabitat/_version.py"