pyhabitat 1.0.23__py3-none-any.whl → 1.0.25__py3-none-any.whl

pyhabitat/__init__.py

@@ -27,6 +27,9 @@ from .environment import (
     edit_textfile,
     interp_path,
     main,
+    user_darrin_deyoung,
+    can_read_input,
+    can_spawn_shell,
 )
 
 # Optional: Set __all__ for explicit documentation and cleaner imports
@@ -57,6 +60,9 @@ __all__ = [
     'edit_textfile',
     'interp_path',
     'main',
+    'user_darrin_deyoung',
+    'can_read_input',
+    'can_spawn_shell',
 ]
 
-__version__ = get_version()
+__version__ = get_version()

pyhabitat/__main__.py

@@ -1,3 +1,4 @@
+#!/usr/bin/env python3
 from pyhabitat.cli import run_cli
 
 if __name__ == "__main__":

pyhabitat/cli.py

@@ -2,6 +2,7 @@ import argparse
 from pathlib import Path
 from pyhabitat.environment import main
 from pyhabitat.utils import get_version
+import pyhabitat
 
 def run_cli():
     """Parse CLI arguments and run the pyhabitat environment report."""
@@ -28,6 +29,32 @@ def run_cli():
         action="store_true",
         help="Enable verbose debug output",
     )
+    parser.add_argument(
+        "--list",
+        action="store_true",
+        help="List available callable functions in pyhabitat"
+    )
+                
+    parser.add_argument(
+        "command",
+        nargs="?",
+        help="Function name to run (or use --list)",
+    )
+
+                
     args = parser.parse_args()
-    main(path=Path(args.path) if args.path else None, debug=args.debug)
 
+    if args.list:
+        for name in dir(pyhabitat):
+            if callable(getattr(pyhabitat, name)) and not name.startswith("_"):
+                print(name)
+        return
+
+    if args.command:
+        func = getattr(pyhabitat, args.command, None)
+        if callable(func):
+            print(func())
+        else:
+            print(f"Unknown function: {args.command}")
+
+    main(path=Path(args.path) if args.path else None, debug=args.debug)

pyhabitat/environment.py

@@ -14,6 +14,8 @@ import subprocess
 import io
 import zipfile
 import logging
+import getpass
+import select 
 
 __all__ = [
     'matplotlib_is_available_for_gui_plotting',
@@ -41,13 +43,17 @@ __all__ = [
     'in_repl',
     'interp_path',
     'main',
+    'user_darrin_deyoung',
+    'can_read_input',
+    'can_spawn_shell',
 ]
 
 # Global cache for tkinter and matplotlib (mpl) availability
 _TKINTER_AVAILABILITY: bool | None = None
 _MATPLOTLIB_EXPORT_AVAILABILITY: bool | None = None
 _MATPLOTLIB_WINDOWED_AVAILABILITY: bool | None = None
-
+_CAN_SPAWN_SHELL: bool | None = None
+_CAN_READ_INPUT: bool | None = None
 
 # --- GUI CHECKS ---
 def matplotlib_is_available_for_gui_plotting(termux_has_gui=False):
@@ -538,10 +544,66 @@ def interactive_terminal_is_available():
         without getting lost in a log or lost entirely.
     
     """
+    # Address walmart demo unit edge case, fast check, though this might hamstring othwrwise successful processes
+    if in_repl() and user_darrin_deyoung():
+        return False
+    # A new shell can be launched to print stuff
+    if not can_spawn_shell():
+        return False
+    # A user can interact with a console, providing input
+    if not can_read_input():
+        return False
     # Check if a tty is attached to stdin
     return sys.stdin.isatty() and sys.stdout.isatty()
-
     
+def user_darrin_deyoung():
+    """Common demo unit undicator, edge case that is unable to launch terminal"""
+    if not on_windows():
+        return False
+    username = getpass.getuser()
+    return username.lower() == "darrin deyoung"
+
+def can_spawn_shell(override_known:bool=False)->bool: 
+    """Check if a shell command can be executed successfully.""" 
+    global _CAN_SPAWN_SHELL
+    if _CAN_SPAWN_SHELL is not None and override_known is False:
+        return _CAN_SPAWN_SHELL
+    try: 
+        result = subprocess.run( ['echo', 'hello'], 
+        stdout=subprocess.PIPE, stderr=subprocess.PIPE, 
+        timeout=2 )
+        _CAN_SPAWN_SHELL = True
+        return result.returncode == 0 
+    except subprocess.TimeoutExpired: 
+        logging.debug("Shell spawn failed: TimeoutExpired")
+        _CAN_SPAWN_SHELL = False
+        return False
+    except subprocess.SubprocessError: 
+        logging.debug("Shell spawn failed: SubprocessError") 
+        _CAN_SPAWN_SHELL = False
+        return False 
+    except OSError: 
+        _CAN_SPAWN_SHELL = False
+        logging.debug("Shell spawn failed: OSError (likely permission or missing binary)") 
+    return  False
+    
+def can_read_input(override_known:bool=False)-> bool:
+    """Check if input is readable from stdin."""
+    global _CAN_READ_INPUT
+    if _CAN_READ_INPUT is not None and override_known is False:
+        return _CAN_READ_INPUT
+    try:
+        _CAN_READ_INPUT = select.select([sys.stdin], [], [], 0.1)[0]
+        return _CAN_READ_INPUT
+    except ValueError:
+        logging.debug("Input check failed: ValueError (invalid file descriptor)")
+        _CAN_READ_INPUT = False
+        return False
+    except OSError:
+        logging.debug("Input check failed: OSError (likely I/O issue)")
+        _CAN_READ_INPUT = False
+        return False
+                
 # --- Browser Check ---
 def web_browser_is_available() -> bool:
     """ Check if a web browser can be launched in the current environment."""
@@ -833,6 +895,13 @@ def main(path=None, debug=False):
     print("=== PyHabitat Report Complete ===")
     print("=================================")
     print("")
-
+    if is_pyz(): # and is_repl(): 
+        # Keep window open. This iteration is non rigorous.
+        # To address use pf Python launcher from Windows Store to launch downoaded .pyz, which closed quickly
+        try:
+            input("Press Return to Exit...")
+        except Exception as e:
+            logging.debug("input() failed")
+               
 if __name__ == "__main__": 
     main(debug=True)

{pyhabitat-1.0.23.dist-info → pyhabitat-1.0.25.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyhabitat
-Version: 1.0.23
+Version: 1.0.25
 Summary: A lightweight library for detecting system environment, GUI, and build properties.
 Author-email: George Clayton Bennett <george.bennett@memphistn.gov>
 License-Expression: MIT

pyhabitat-1.0.25.dist-info/RECORD

@@ -0,0 +1,11 @@
+pyhabitat/__init__.py,sha256=WI0Mx7cWQXrAXRX-AxTDjY_Jn8V5DWbAdJHI-2W5J3Y,1485
+pyhabitat/__main__.py,sha256=6wcF1BhvoRQe4iwq1Px0GNughRXGFRBufWRdaZePu1s,99
+pyhabitat/cli.py,sha256=oNZFFobkUhpNGTsizHmgINr9O79f5ZqwSJdtnbNe15E,1670
+pyhabitat/environment.py,sha256=V489_X3uX7GcszEBNo16dG2kxOP9gA86cJwG99r-D20,36616
+pyhabitat/utils.py,sha256=h-TPwxZr93LOvjrIrDrsBWdU2Vhc4FUvAhDqIv-N0GQ,537
+pyhabitat-1.0.25.dist-info/licenses/LICENSE,sha256=D4fg30ctUGnCJlWu3ONv5-V8JE1v3ctakoJTcVjsJlg,1072
+pyhabitat-1.0.25.dist-info/METADATA,sha256=nzq03FJd4aJUAdBinWwwyxaSVpibhBk4gw_W-u9UeFw,10900
+pyhabitat-1.0.25.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pyhabitat-1.0.25.dist-info/entry_points.txt,sha256=409xZ-BrarQJJLtO-aActCGkL0FMhNVi9wsq3u7tRHM,52
+pyhabitat-1.0.25.dist-info/top_level.txt,sha256=zXYK44Qu8EqxUETREvd2diMUaB5JiGRErkwFaoLQnnI,10
+pyhabitat-1.0.25.dist-info/RECORD,,

pyhabitat/__main__stable.py

@@ -1,72 +0,0 @@
-#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.23.dist-info/RECORD

@@ -1,12 +0,0 @@
-pyhabitat/__init__.py,sha256=spekwjNKjr9i8HgPmShCMpNFzol3okeQw3t2JReqtaY,1346
-pyhabitat/__main__.py,sha256=qlOKShd_Xk0HGpYOySXQSQe3K60a9wwrstCAceJkKIs,76
-pyhabitat/__main__stable.py,sha256=UACpHLrr_Rmf0L5dJCEae6kFzLn7dqCqIri68IBnb10,2910
-pyhabitat/cli.py,sha256=80t9cOwfmDktnHnhGHL-iEgJBXkB0bVCJBPrVWzWUPU,980
-pyhabitat/environment.py,sha256=CwAJDYRNbA5Dzb7feHptxmgKb4_IayQGA_yRGHEpse0,33876
-pyhabitat/utils.py,sha256=h-TPwxZr93LOvjrIrDrsBWdU2Vhc4FUvAhDqIv-N0GQ,537
-pyhabitat-1.0.23.dist-info/licenses/LICENSE,sha256=D4fg30ctUGnCJlWu3ONv5-V8JE1v3ctakoJTcVjsJlg,1072
-pyhabitat-1.0.23.dist-info/METADATA,sha256=9_vmgovmq-FWmFQM2K8kQO1qjrrG8B8t0yvkqzbvTbA,10900
-pyhabitat-1.0.23.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pyhabitat-1.0.23.dist-info/entry_points.txt,sha256=409xZ-BrarQJJLtO-aActCGkL0FMhNVi9wsq3u7tRHM,52
-pyhabitat-1.0.23.dist-info/top_level.txt,sha256=zXYK44Qu8EqxUETREvd2diMUaB5JiGRErkwFaoLQnnI,10
-pyhabitat-1.0.23.dist-info/RECORD,,