pyhabitat 1.0.16__tar.gz → 1.0.18__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyhabitat
-Version: 1.0.16
+Version: 1.0.18
 Summary: A lightweight library for detecting system environment, GUI, and build properties.
 Author-email: George Clayton Bennett <george.bennett@memphistn.gov>
 License-Expression: MIT
@@ -8,7 +8,7 @@ Keywords: environment,os-detection,gui,build-system
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: System :: Systems Administration
-Requires-Python: >=3.8
+Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
@@ -59,11 +59,11 @@ Ultimately, [City-of-Memphis-Wastewater](https://github.com/City-of-Memphis-Wast
 
   * **Definitive Environment Checks:** Rigorous checks catered to Termux and iSH (iOS Alpine). Accurate, typical modern detection for Windows, macOS (Apple), Linux, FreeBSD, Android.
   * **GUI Availability:** Rigorous, cached checks to determine if the environment supports a graphical popup window (Tkinter/Matplotlib TkAgg) or just headless image export (Matplotlib Agg).
-  * **Build/Packaging Detection:** Reliable detection of standalone executables built by tools like PyInstaller, and, crucially, correct identification and exclusion of pipx-managed virtual environments, which also user binaries that could conflate the check.
-  * **Executable Type Inspection:** Uses file magic numbers (ELF and MZ) to confirm if the running script is a monolithic, frozen binary (non-pipx).
+  * **Build/Packaging Detection:** Reliable detection of standalone executables (PyInstaller), Python zipapps (.pyz), Python source scripts (.py), and correct identification/exclusion of pipx-managed virtual environments.
+  * **Executable Type Inspection:** Uses file magic numbers (ELF, MZ, Mach-O) to confirm if the running script is a monolithic, frozen binary (non-pipx) or zipapp (.pyz).
 
 </details>
-  
+
 ---
 
 <details>
@@ -75,26 +75,31 @@ Key question: "What is this running on?"
 
 | Function | Description |
 | :--- | :--- |
-| `is_windows()` | Returns `True` on Windows. |
-| `is_apple()` | Returns `True` on macOS (Darwin). |
-| `is_linux()` | Returns `True` on Linux in general. |
-| `is_termux()` | Returns `True` if running in the Termux Android environment. |
-| `is_ish_alpine()` | Returns `True` if running in the iSH Alpine Linux iOS emulator. |
-| `is_android()` | Returns `True` on any Android-based Linux environment. |
+| `on_windows()` | Returns `True` on Windows. |
+| `on_apple()` | Returns `True` on macOS (Darwin). |
+| `on_linux()` | Returns `True` on Linux in general. |
+| `on_termux()` | Returns `True` if running in the Termux Android environment. |
+| `on_freebsd()` | Returns `True` on FreeBSD. |
+| `on_ish_alpine()` | Returns `True` if running in the iSH Alpine Linux iOS emulator. |
+| `on_android()` | Returns `True` on any Android-based Linux environment. |
+| `in_repl()` | Returns `True` is the user is currently in a Python REPL; hasattr(sys,'ps1'). |
 
 ### Packaging and Build Checking
 
-Key question: "What is the character of my executable?"
+Key question: "What is the character of my executable or my build state?"
+
+These functions accept an optional path argument (Path or str), defaulting to sys.argv[0] (e.g., pyhabitat/__main__.py for python -m pyhabitat, empty in REPL). Path.resolve() is used for stability.
 
 | 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. |
-
+| `as_frozen()` | Returns `True` if the script is running as a standalone executable (any bundler). |
+| `as_pyinstaller()` | Returns `True` if the script is frozen and generated by PyInstaller (has `_MEIPASS`). |
+| `is_python_script(path=None)` | Returns `True` if the script or specified path is a Python source file (.py). |
+| `is_pipx(path=None)` | Returns `True` if the script or specified path is from a pipx-managed virtual environment. |
+| `is_elf(path=None)` | Returns `True` if the script or specified path is an ELF binary (Linux standalone executable, non-pipx). |
+| `is_pyz(path=None)` | Returns `True` if the script or specified path is a Python zipapp (.pyz, non-pipx). |
+| `is_windows_portable_executable(path=None)` | Returns `True` if the script or specified path is a Windows PE binary (MZ header, non-pipx). |
+| `is_macos_executable(path=None)` | Returns `True` if the script or specified path is a macOS Mach-O binary (non-pipx). |
 
 ### Capability Checking
 
@@ -103,16 +108,18 @@ Key Question: "What could I do next?"
 | Function | Description |
 | :--- | :--- |
 | `tkinter_is_available()` | Checks if Tkinter is imported and can successfully create a window. |
-| `matplotlib_is_available_for_gui_plotting(termux_has_gui=False)` | Checks for Matplotlib and its TkAgg backend, required for interactive plotting. |
+| `matplotlib_is_available_for_gui_plotting(termux_has_gui=False)` | Checks for Matplotlib and its TkAgg backend, required for interactive plotting. Set `termux_has_gui=True` for Termux with GUI support; defaults to `False`. |
 | `matplotlib_is_available_for_headless_image_export()` | Checks for Matplotlib and its Agg backend, required for saving images without a GUI. |
 | `interactive_terminal_is_available()` | Checks if standard input and output streams are connected to a TTY (allows safe use of interactive prompts). |
 | `web_browser_is_available()` | Check if a web browser can be launched in the current environment (allows safe use of web-based prompts and localhost plotting). 	|
 
-### Actions
+### Utility
 
 | Function | Description |
 | :--- | :--- |
-| `edit_textfile()` | Smoothly opens a text file for editing (for configuration editing prompted by a CLI flag). |
+| `edit_textfile(path)` | Opens a text file for editing using the default editor (Windows, Linux, macOS) or nano in Termux/iSH. In REPL mode, prints an error. Path argument (str or Path) uses Path.resolve() for stability. |
+| `interp_path(print_path=False)` | Returns the path to the Python interpreter binary (sys.executable). Optionally prints the path. Returns empty string if unavailable. |
+| `main()` | Prints a comprehensive environment report with sections: Interpreter Checks (sys.executable), Current Environment Check (sys.argv[0]), Current Build Checks (sys attributes), Operating System Checks (platform.system()), and Capability Checks. Run via `python -m pyhabitat` or `import pyhabitat; pyhabitat.main()` in the REPL. |
 
 </details>
 
@@ -123,39 +130,57 @@ Key Question: "What could I do next?"
 
 The module exposes all detection functions directly for easy access.
 
-### 0\. Current Use
+### 0\. Example of PyHabitat in Action
 
 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
+### 1\. Running the Environment Report
+
+Run a comprehensive environment report from the command line or REPL to inspect the interpreter (sys.executable), running script (sys.argv[0]), build state, operating system, and capabilities.
+
+```bash
+# In the terminal
+python -m pyhabitat
+```
 
 ```python
-from pyhabitat import is_termux, is_windows, is_pipx, is_frozen
+# In the Python REPL
+import pyhabitat as ph
+ph.main()
+```
+
+### 2\. Checking Environment and Build Type
+
+```python
+from pyhabitat import on_termux, on_windows, is_pipx, is_python_script, as_frozen
 
 if is_pipx():
     print("Running inside a pipx virtual environment. This is not a standalone binary.")
 
-elif is_frozen():
+if as_frozen():
     print("Running as a frozen executable (PyInstaller, cx_Freeze, etc.).")
 
-elif is_termux(): 
+if is_python_script():
+    print("Running as a Python source script (.py).")
+
+if on_termux(): 
 	# Expected cases: 
 	#- pkg install python-numpy python-cryptography
-	#- Avoiding matplotlib unless the user explicitly confirms that termux_has_gui=False in matplotlib_is_available_for_gui_plotting(termux_has_gui=False).
+	#- Avoiding matplotlib unless the user explicitly sets termux_has_gui=True in matplotlib_is_available_for_gui_plotting().
 	#- Auto-selection of 'termux-open-url' and 'xdg-open' in logic.
 	#- Installation on the system, like orchestrating the construction of Termux Widget entries in ~/.shortcuts.
     print("Running in the Termux environment on Android.")
     
-elif is_windows():
+if on_windows():
     print("Running on Windows.")
 ```
 
-### 2\. Checking GUI and Plotting Availability
+### 3\. Checking GUI and Plotting Availability
 
 Use these functions to determine if you can show an interactive plot or if you must save an image file.
 
 ```python
-from pyhabitat import matplotlib_is_available_for_gui_plotting, matplotlib_is_available_for_headless_image_export, 
+from pyhabitat import matplotlib_is_available_for_gui_plotting, matplotlib_is_available_for_headless_image_export
 
 if matplotlib_is_available_for_gui_plotting():
     # We can safely call plt.show()
@@ -173,13 +198,16 @@ else:
     print("Matplotlib is not installed or the environment is too restrictive for plotting.")
 ```
 
-### 3\. Text Editing
+### 4\. Text Editing
 
-Use this function to smoothly open a text file for editing. 
+Use this function to open a text file for editing. 
 Ideal use case: Edit a configuration file, if prompted by a CLI command like 'config --textedit'.
 
 ```python
-edit_textfile(filepath=Path('./config.json'))
+from pathlib import Path
+import pyhabitat as ph
+
+ph.edit_textfile(path=Path('./config.json'))
 ```
 </details>
 

{pyhabitat-1.0.16 → pyhabitat-1.0.18}/README.md

@@ -44,11 +44,11 @@ Ultimately, [City-of-Memphis-Wastewater](https://github.com/City-of-Memphis-Wast
 
   * **Definitive Environment Checks:** Rigorous checks catered to Termux and iSH (iOS Alpine). Accurate, typical modern detection for Windows, macOS (Apple), Linux, FreeBSD, Android.
   * **GUI Availability:** Rigorous, cached checks to determine if the environment supports a graphical popup window (Tkinter/Matplotlib TkAgg) or just headless image export (Matplotlib Agg).
-  * **Build/Packaging Detection:** Reliable detection of standalone executables built by tools like PyInstaller, and, crucially, correct identification and exclusion of pipx-managed virtual environments, which also user binaries that could conflate the check.
-  * **Executable Type Inspection:** Uses file magic numbers (ELF and MZ) to confirm if the running script is a monolithic, frozen binary (non-pipx).
+  * **Build/Packaging Detection:** Reliable detection of standalone executables (PyInstaller), Python zipapps (.pyz), Python source scripts (.py), and correct identification/exclusion of pipx-managed virtual environments.
+  * **Executable Type Inspection:** Uses file magic numbers (ELF, MZ, Mach-O) to confirm if the running script is a monolithic, frozen binary (non-pipx) or zipapp (.pyz).
 
 </details>
-  
+
 ---
 
 <details>
@@ -60,26 +60,31 @@ Key question: "What is this running on?"
 
 | Function | Description |
 | :--- | :--- |
-| `is_windows()` | Returns `True` on Windows. |
-| `is_apple()` | Returns `True` on macOS (Darwin). |
-| `is_linux()` | Returns `True` on Linux in general. |
-| `is_termux()` | Returns `True` if running in the Termux Android environment. |
-| `is_ish_alpine()` | Returns `True` if running in the iSH Alpine Linux iOS emulator. |
-| `is_android()` | Returns `True` on any Android-based Linux environment. |
+| `on_windows()` | Returns `True` on Windows. |
+| `on_apple()` | Returns `True` on macOS (Darwin). |
+| `on_linux()` | Returns `True` on Linux in general. |
+| `on_termux()` | Returns `True` if running in the Termux Android environment. |
+| `on_freebsd()` | Returns `True` on FreeBSD. |
+| `on_ish_alpine()` | Returns `True` if running in the iSH Alpine Linux iOS emulator. |
+| `on_android()` | Returns `True` on any Android-based Linux environment. |
+| `in_repl()` | Returns `True` is the user is currently in a Python REPL; hasattr(sys,'ps1'). |
 
 ### Packaging and Build Checking
 
-Key question: "What is the character of my executable?"
+Key question: "What is the character of my executable or my build state?"
+
+These functions accept an optional path argument (Path or str), defaulting to sys.argv[0] (e.g., pyhabitat/__main__.py for python -m pyhabitat, empty in REPL). Path.resolve() is used for stability.
 
 | 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. |
-
+| `as_frozen()` | Returns `True` if the script is running as a standalone executable (any bundler). |
+| `as_pyinstaller()` | Returns `True` if the script is frozen and generated by PyInstaller (has `_MEIPASS`). |
+| `is_python_script(path=None)` | Returns `True` if the script or specified path is a Python source file (.py). |
+| `is_pipx(path=None)` | Returns `True` if the script or specified path is from a pipx-managed virtual environment. |
+| `is_elf(path=None)` | Returns `True` if the script or specified path is an ELF binary (Linux standalone executable, non-pipx). |
+| `is_pyz(path=None)` | Returns `True` if the script or specified path is a Python zipapp (.pyz, non-pipx). |
+| `is_windows_portable_executable(path=None)` | Returns `True` if the script or specified path is a Windows PE binary (MZ header, non-pipx). |
+| `is_macos_executable(path=None)` | Returns `True` if the script or specified path is a macOS Mach-O binary (non-pipx). |
 
 ### Capability Checking
 
@@ -88,16 +93,18 @@ Key Question: "What could I do next?"
 | Function | Description |
 | :--- | :--- |
 | `tkinter_is_available()` | Checks if Tkinter is imported and can successfully create a window. |
-| `matplotlib_is_available_for_gui_plotting(termux_has_gui=False)` | Checks for Matplotlib and its TkAgg backend, required for interactive plotting. |
+| `matplotlib_is_available_for_gui_plotting(termux_has_gui=False)` | Checks for Matplotlib and its TkAgg backend, required for interactive plotting. Set `termux_has_gui=True` for Termux with GUI support; defaults to `False`. |
 | `matplotlib_is_available_for_headless_image_export()` | Checks for Matplotlib and its Agg backend, required for saving images without a GUI. |
 | `interactive_terminal_is_available()` | Checks if standard input and output streams are connected to a TTY (allows safe use of interactive prompts). |
 | `web_browser_is_available()` | Check if a web browser can be launched in the current environment (allows safe use of web-based prompts and localhost plotting). 	|
 
-### Actions
+### Utility
 
 | Function | Description |
 | :--- | :--- |
-| `edit_textfile()` | Smoothly opens a text file for editing (for configuration editing prompted by a CLI flag). |
+| `edit_textfile(path)` | Opens a text file for editing using the default editor (Windows, Linux, macOS) or nano in Termux/iSH. In REPL mode, prints an error. Path argument (str or Path) uses Path.resolve() for stability. |
+| `interp_path(print_path=False)` | Returns the path to the Python interpreter binary (sys.executable). Optionally prints the path. Returns empty string if unavailable. |
+| `main()` | Prints a comprehensive environment report with sections: Interpreter Checks (sys.executable), Current Environment Check (sys.argv[0]), Current Build Checks (sys attributes), Operating System Checks (platform.system()), and Capability Checks. Run via `python -m pyhabitat` or `import pyhabitat; pyhabitat.main()` in the REPL. |
 
 </details>
 
@@ -108,39 +115,57 @@ Key Question: "What could I do next?"
 
 The module exposes all detection functions directly for easy access.
 
-### 0\. Current Use
+### 0\. Example of PyHabitat in Action
 
 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
+### 1\. Running the Environment Report
+
+Run a comprehensive environment report from the command line or REPL to inspect the interpreter (sys.executable), running script (sys.argv[0]), build state, operating system, and capabilities.
+
+```bash
+# In the terminal
+python -m pyhabitat
+```
 
 ```python
-from pyhabitat import is_termux, is_windows, is_pipx, is_frozen
+# In the Python REPL
+import pyhabitat as ph
+ph.main()
+```
+
+### 2\. Checking Environment and Build Type
+
+```python
+from pyhabitat import on_termux, on_windows, is_pipx, is_python_script, as_frozen
 
 if is_pipx():
     print("Running inside a pipx virtual environment. This is not a standalone binary.")
 
-elif is_frozen():
+if as_frozen():
     print("Running as a frozen executable (PyInstaller, cx_Freeze, etc.).")
 
-elif is_termux(): 
+if is_python_script():
+    print("Running as a Python source script (.py).")
+
+if on_termux(): 
 	# Expected cases: 
 	#- pkg install python-numpy python-cryptography
-	#- Avoiding matplotlib unless the user explicitly confirms that termux_has_gui=False in matplotlib_is_available_for_gui_plotting(termux_has_gui=False).
+	#- Avoiding matplotlib unless the user explicitly sets termux_has_gui=True in matplotlib_is_available_for_gui_plotting().
 	#- Auto-selection of 'termux-open-url' and 'xdg-open' in logic.
 	#- Installation on the system, like orchestrating the construction of Termux Widget entries in ~/.shortcuts.
     print("Running in the Termux environment on Android.")
     
-elif is_windows():
+if on_windows():
     print("Running on Windows.")
 ```
 
-### 2\. Checking GUI and Plotting Availability
+### 3\. Checking GUI and Plotting Availability
 
 Use these functions to determine if you can show an interactive plot or if you must save an image file.
 
 ```python
-from pyhabitat import matplotlib_is_available_for_gui_plotting, matplotlib_is_available_for_headless_image_export, 
+from pyhabitat import matplotlib_is_available_for_gui_plotting, matplotlib_is_available_for_headless_image_export
 
 if matplotlib_is_available_for_gui_plotting():
     # We can safely call plt.show()
@@ -158,13 +183,16 @@ else:
     print("Matplotlib is not installed or the environment is too restrictive for plotting.")
 ```
 
-### 3\. Text Editing
+### 4\. Text Editing
 
-Use this function to smoothly open a text file for editing. 
+Use this function to open a text file for editing. 
 Ideal use case: Edit a configuration file, if prompted by a CLI command like 'config --textedit'.
 
 ```python
-edit_textfile(filepath=Path('./config.json'))
+from pathlib import Path
+import pyhabitat as ph
+
+ph.edit_textfile(path=Path('./config.json'))
 ```
 </details>
 

{pyhabitat-1.0.16 → pyhabitat-1.0.18}/pyhabitat/__init__.py

@@ -4,23 +4,27 @@ from .environment import (
     matplotlib_is_available_for_gui_plotting,
     matplotlib_is_available_for_headless_image_export,
     tkinter_is_available,
-    is_termux,
-    is_freebsd,
-    is_linux,
-    is_android,
-    is_windows,
-    is_apple,
-    is_ish_alpine,
-    is_pyinstaller,
-    is_frozen,
+    in_repl,
+    on_termux,
+    on_freebsd,
+    on_linux,
+    on_android,
+    on_windows,
+    on_apple,
+    on_ish_alpine,
+    as_pyinstaller,
+    as_frozen,
     is_elf,
     is_pyz,
     is_windows_portable_executable,
     is_macos_executable,
     is_pipx,
+    is_python_script,
     interactive_terminal_is_available,
     web_browser_is_available,
     edit_textfile,
+    interp_path,
+    main,
 )
 
 # Optional: Set __all__ for explicit documentation and cleaner imports
@@ -28,21 +32,25 @@ __all__ = [
     'matplotlib_is_available_for_gui_plotting',
     'matplotlib_is_available_for_headless_image_export',
     'tkinter_is_available',
-    'is_termux',
-    'is_freebsd',
-    'is_linux',
-    'is_android',
-    'is_windows',
-    'is_apple',
-    'is_ish_alpine',
-    'is_pyinstaller',
-    'is_frozen',
+    'in_repl',
+    'on_termux',
+    'on_freebsd',
+    'on_linux',
+    'on_android',
+    'on_windows',
+    'on_apple',
+    'on_ish_alpine',
+    'as_pyinstaller',
+    'as_frozen',
     'is_elf',
     'is_pyz',
     'is_windows_portable_executable',
     'is_macos_executable',
     'is_pipx',
+    'is_python_script',
     'interactive_terminal_is_available',
     'web_browser_is_available',
     'edit_textfile',
+    'interp_path',
+    'main',
 ]

pyhabitat-1.0.18/pyhabitat/__main__.py

@@ -0,0 +1,4 @@
+from .cli import run_cli
+
+if __name__ == "__main__":
+    run_cli()

pyhabitat-1.0.18/pyhabitat/__main__stable.py

@@ -0,0 +1,72 @@
+#from .cli import run_cli
+
+from .environment import (
+    in_repl,
+    on_termux,
+    on_windows,
+    on_apple,
+    on_linux,
+    on_ish_alpine,
+    on_android,
+    on_freebsd,
+    is_elf,
+    is_windows_portable_executable,
+    is_macos_executable,
+    is_pyz,
+    is_pipx,
+    is_python_script,
+    as_frozen,
+    as_pyinstaller,
+    interp_path,
+    tkinter_is_available,
+    matplotlib_is_available_for_gui_plotting,
+    matplotlib_is_available_for_headless_image_export,
+    web_browser_is_available,
+    interactive_terminal_is_available
+)
+
+def main():
+    print("PyHabitat Environment Report")
+    print("===========================")
+    print("\nInterpreter Checks // Based on sys.executable()")
+    print("-----------------------------")
+    print(f"interp_path(): {interp_path()}")
+    print(f"is_elf(interp_path()): {is_elf(interp_path())}")
+    print(f"is_windows_portable_executable(interp_path()): {is_windows_portable_executable(interp_path())}")
+    print(f"is_macos_executable(interp_path()): {is_macos_executable(interp_path())}")
+    print(f"is_pyz(interp_path()): {is_pyz(interp_path())}")
+    print(f"is_pipx(interp_path()): {is_pipx(interp_path())}")
+    print(f"is_python_script(interp_path()): {is_python_script(interp_path())}")
+    print("\nCurrent Environment Check // Based on sys.argv[0]")
+    print("-----------------------------")
+    print(f"is_elf(): {is_elf()}")
+    print(f"is_windows_portable_executable(): {is_windows_portable_executable()}")
+    print(f"is_macos_executable(): {is_macos_executable()}")
+    print(f"is_pyz(): {is_pyz()}")
+    print(f"is_pipx(): {is_pipx()}")
+    print(f"is_python_script(): {is_python_script()}")
+    print(f"\nCurrent Build Checks // Based on hasattr(sys,..) and getattr(sys,..)")
+    print("------------------------------")
+    print(f"in_repl(): {in_repl()}")
+    print(f"as_frozen(): {as_frozen()}")
+    print(f"as_pyinstaller(): {as_pyinstaller()}")
+    print("\nOperating System Checks // Based on platform.system()")
+    print("------------------------------")
+    print(f"on_termux(): {on_termux()}")
+    print(f"on_windows(): {on_windows()}")
+    print(f"on_apple(): {on_apple()}")
+    print(f"on_linux(): {on_linux()}")
+    print(f"on_ish_alpine(): {on_ish_alpine()}")
+    print(f"on_android(): {on_android()}")
+    print(f"on_freebsd(): {on_freebsd()}")
+    print("\nCapability Checks")
+    print("-------------------------")
+    print(f"tkinter_is_available(): {tkinter_is_available()}")
+    print(f"matplotlib_is_available_for_gui_plotting(): {matplotlib_is_available_for_gui_plotting()}")
+    print(f"matplotlib_is_available_for_headless_image_export(): {matplotlib_is_available_for_headless_image_export()}")
+    print(f"web_browser_is_available(): {web_browser_is_available()}")
+    print(f"interactive_terminal_is_available(): {interactive_terminal_is_available()}")
+
+if __name__ == "__main__":
+    main()
+    #run_cli()

pyhabitat-1.0.18/pyhabitat/cli.py

@@ -0,0 +1,22 @@
+import argparse
+from pathlib import Path
+from . import main
+
+def run_cli():
+    """Parse CLI arguments and run the pyhabitat environment report."""
+    parser = argparse.ArgumentParser(
+        description="PyHabitat: Python environment and build introspection"
+    )
+    parser.add_argument(
+        "--path",
+        type=str,
+        default=None,
+        help="Path to a script or binary to inspect (defaults to sys.argv[0])",
+    )
+    parser.add_argument(
+        "--debug",
+        action="store_true",
+        help="Enable verbose debug output",
+    )
+    args = parser.parse_args()
+    main(path=Path(args.path) if args.path else None, debug=args.debug)