pyhabitat 1.0.30__py3-none-any.whl → 1.0.35__py3-none-any.whl

pyhabitat/environment.py

@@ -17,6 +17,12 @@ import logging
 import getpass
 import select 
 
+# On Windows, we need the msvcrt module for non-blocking I/O
+try:
+    import msvcrt
+except ImportError:
+    msvcrt = None
+
 __all__ = [
     'matplotlib_is_available_for_gui_plotting',
     'matplotlib_is_available_for_headless_image_export',
@@ -556,21 +562,46 @@ def interactive_terminal_is_available():
         then typer.prompt() or input() will work reliably,
         without getting lost in a log or lost entirely.
     
+    Solution correctly identifies that true interactivity requires:
+        (1) a TTY (potential) connection
+        (2) the ability to execute
+        (3) the ability to read I/O
+        (4) ignores known limitatons in restrictive environments
+
+    Jargon:
+        A TTY, short for Teletypewriter or TeleTYpe, 
+        is a conceptual or physical device that serves 
+        as the interface for a user to interact with 
+        a computer system.
     """
     # Address walmart demo unit edge case, fast check, though this might hamstring othwrwise successful processes
     if user_darrin_deyoung():
         return False
+    
+    # Check if a tty is attached to stdin, 
+    # quick failure here if not before testing spwaning and reading
+    if not (sys.stdin.isatty() and sys.stdout.isatty()):
+        return False
+    
     # Check of 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"""
+    # Enable teating on non-Windows, non-demo systems
+    #  where this function would otherwise return False.
+    # Linux: `export USER_DARRIN_DEYOUNG=True`
+    if os.getenv('USER_DARRIN_DEYOUNG','').lower() ==  "true":
+        print("env var USER_DARRIN_DEYOUNG is set to True.")
+        return True
+    # Darrin Deyoung is the typical username on demo-mode Windows systems
     if not on_windows():
         return False
     username = getpass.getuser()
@@ -581,25 +612,33 @@ def can_spawn_shell(override_known:bool=False)->bool:
     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
+
+    try:
+        # Use a simple, universally applicable command with shell=True
+        # 'true' on Linux/macOS, or a basic command on Windows via cmd.exe
+        # A simple 'echo' or 'exit 0' would also work
+        result = subprocess.run( 
+            'exit 0',  # A shell-internal command that succeeds on most shells
+            stdout=subprocess.PIPE, 
+            stderr=subprocess.PIPE, 
+            timeout=2, 
+            shell=True # <--- ESSENTIAL for cross-platform reliability
+        )
         
-        return result.returncode == 0 
+        _CAN_SPAWN_SHELL = result.returncode == 0
+        return _CAN_SPAWN_SHELL 
+    
     except subprocess.TimeoutExpired: 
-        logging.debug("Shell spawn failed: TimeoutExpired")
+        print("Shell spawn failed: TimeoutExpired")
         _CAN_SPAWN_SHELL = result.returncode == 0
         return _CAN_SPAWN_SHELL
     except subprocess.SubprocessError: 
-        logging.debug("Shell spawn failed: SubprocessError") 
+        print("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)") 
+        print("Shell spawn failed: OSError (likely permission or missing binary)") 
     return  False
     
 def can_read_input(override_known:bool=False)-> bool:
@@ -607,10 +646,43 @@ def can_read_input(override_known:bool=False)-> bool:
     global _CAN_READ_INPUT
     if _CAN_READ_INPUT is not None and override_known is False:
         return _CAN_READ_INPUT
+    
+    # --- 1. Windows Specific Check (msvcrt) ---
+    if msvcrt is not None and sys.stdin.isatty():
+        try:
+            # msvcrt.kbhit() checks if a keyboard hit is present
+            # We don't read the input yet, just check if it's there
+            _CAN_READ_INPUT = msvcrt.kbhit()
+            # If kbhit returns True, it means a key press is waiting.
+            # We assume if the terminal *is* a TTY, it *can* read input.
+            # We can't actually call input() without blocking, so we check TTY instead.
+            if _CAN_READ_INPUT:
+                return True
+            
+            # Since we are checking if a *user can* interact, if we are in a TTY, 
+            # we assume the capability exists, even if nothing is currently buffered.
+            # This prevents the false negative when no key is pressed.
+            _CAN_READ_INPUT = True
+            return True
+
+        except Exception as e:
+            # Catch errors in the kbhit check itself
+            logging.debug(f"msvcrt check failed: {e}")
+            pass # Fall through to the select check
+
+    # --- 2. POSIX/General Check (select) ---
+    # This block is reliable on Linux/macOS and other POSIX systems.
     try:
-        # ERROR THIS IS NOT A BOOLEAN, IS RETURNS []
+        # _CAN_READ_INPUT is assigned the read-ready list ([] or [sys.stdin])
+        # The return value is then the boolean conversion of that list's truthiness.
+        # 1. select.select(...) returns a 3-element tuple.
+        # 2. [0] gets the read-ready list (rlist).
+        # 3. Wrapping the result in bool() converts the list's truth value:
+        #    - [] becomes False
+        #    - [sys.stdin] becomes True
         _CAN_READ_INPUT = select.select([sys.stdin], [], [], 0.1)[0]
-        return _CAN_READ_INPUT
+        # Return the boolean value of the list: True if [sys.stdin], False if []
+        return bool(_CAN_READ_INPUT) # <--- Requied to convert list to boolean
     except ValueError:
         logging.debug("Input check failed: ValueError (invalid file descriptor)")
         _CAN_READ_INPUT = False
@@ -619,6 +691,9 @@ def can_read_input(override_known:bool=False)-> bool:
         logging.debug("Input check failed: OSError (likely I/O issue)")
         _CAN_READ_INPUT = False
         return False
+    
+    # Final fallback: if nothing worked, assume False
+    return False
                 
 # --- Browser Check ---
 def web_browser_is_available() -> bool:

{pyhabitat-1.0.30.dist-info → pyhabitat-1.0.35.dist-info}/METADATA

@@ -1,13 +1,17 @@
 Metadata-Version: 2.4
 Name: pyhabitat
-Version: 1.0.30
+Version: 1.0.35
 Summary: A lightweight library for detecting system environment, GUI, and build properties.
 Author-email: George Clayton Bennett <george.bennett@memphistn.gov>
 License-Expression: MIT
 Keywords: environment,os-detection,gui,build-system
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
-Classifier: Topic :: System :: Systems Administration
+Classifier: Intended Audience :: Developers
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE

pyhabitat-1.0.35.dist-info/RECORD

@@ -0,0 +1,17 @@
+pyhabitat/__init__.py,sha256=7XNuHIDBXvjn_EORWZZUNsBS3qpvWRUha1NHwC3d6bw,1539
+pyhabitat/cli.py,sha256=L7VA-OOust2g6_MxedvvOr4RdnS_-5ZGP2Aj4VtdqAg,2221
+pyhabitat/demo.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyhabitat/environment.py,sha256=zUlZlB9GGbZviEeOkV3yk7GceqUtbfZYXloeRyOK6vU,40221
+pyhabitat/report.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyhabitat/utils.py,sha256=2IGLKGAvDFGQgIzlId4ZGGTJRGG0MXR9UVH3nlQKmHg,988
+pyhabitat-1.0.35.dist-info/licenses/LICENSE,sha256=D4fg30ctUGnCJlWu3ONv5-V8JE1v3ctakoJTcVjsJlg,1072
+pyhabitat-build/__main__.py,sha256=6wcF1BhvoRQe4iwq1Px0GNughRXGFRBufWRdaZePu1s,99
+pyhabitat-build/pyhabitat/__init__.py,sha256=7XNuHIDBXvjn_EORWZZUNsBS3qpvWRUha1NHwC3d6bw,1539
+pyhabitat-build/pyhabitat/cli.py,sha256=L7VA-OOust2g6_MxedvvOr4RdnS_-5ZGP2Aj4VtdqAg,2221
+pyhabitat-build/pyhabitat/environment.py,sha256=zUlZlB9GGbZviEeOkV3yk7GceqUtbfZYXloeRyOK6vU,40221
+pyhabitat-build/pyhabitat/utils.py,sha256=2IGLKGAvDFGQgIzlId4ZGGTJRGG0MXR9UVH3nlQKmHg,988
+pyhabitat-1.0.35.dist-info/METADATA,sha256=1dpi0OLV7wFvGCooNpCwxaUL8rhTFi_avWVTkVgqffY,11086
+pyhabitat-1.0.35.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pyhabitat-1.0.35.dist-info/entry_points.txt,sha256=409xZ-BrarQJJLtO-aActCGkL0FMhNVi9wsq3u7tRHM,52
+pyhabitat-1.0.35.dist-info/top_level.txt,sha256=zI4aHwfZxhq45fnyLM34qDaerg2Iyb4mcsOP-itrJPY,26
+pyhabitat-1.0.35.dist-info/RECORD,,

pyhabitat-build/pyhabitat/__init__.py

@@ -30,6 +30,8 @@ from .environment import (
     user_darrin_deyoung,
     can_read_input,
     can_spawn_shell,
+    is_ascii,
+    is_binary,
 )
 
 # Optional: Set __all__ for explicit documentation and cleaner imports
@@ -63,6 +65,8 @@ __all__ = [
     'user_darrin_deyoung',
     'can_read_input',
     'can_spawn_shell',
+    'is_ascii',
+    'is_binary',
 ]
 
 __version__ = get_version()

pyhabitat-build/pyhabitat/environment.py

@@ -17,6 +17,12 @@ import logging
 import getpass
 import select 
 
+# On Windows, we need the msvcrt module for non-blocking I/O
+try:
+    import msvcrt
+except ImportError:
+    msvcrt = None
+
 __all__ = [
     'matplotlib_is_available_for_gui_plotting',
     'matplotlib_is_available_for_headless_image_export',
@@ -512,6 +518,19 @@ def is_python_script(path: Path | str | None = None, debug: bool = False, suppre
         return False
     return exec_path.suffix.lower() == '.py'    
 
+# --- File encoding check ---
+def is_binary(path:str|Path|None=None)->bool:
+    """
+    Target file is encoded as binary.
+    """
+    pass
+
+def is_ascii(path:str|Path|None=None)->bool:
+    """
+    Target file is encoded as ascii, plaintext.
+    """
+    pass
+    
 # --- Interpreter Check ---
 
 def interp_path(debug: bool = False) -> str:
@@ -543,21 +562,46 @@ def interactive_terminal_is_available():
         then typer.prompt() or input() will work reliably,
         without getting lost in a log or lost entirely.
     
+    Solution correctly identifies that true interactivity requires:
+        (1) a TTY (potential) connection
+        (2) the ability to execute
+        (3) the ability to read I/O
+        (4) ignores known limitatons in restrictive environments
+
+    Jargon:
+        A TTY, short for Teletypewriter or TeleTYpe, 
+        is a conceptual or physical device that serves 
+        as the interface for a user to interact with 
+        a computer system.
     """
     # Address walmart demo unit edge case, fast check, though this might hamstring othwrwise successful processes
-    if in_repl() and user_darrin_deyoung():
+    if user_darrin_deyoung():
         return False
-    # A new shell can be launched to print stuff
+    
+    # Check if a tty is attached to stdin, 
+    # quick failure here if not before testing spwaning and reading
+    if not (sys.stdin.isatty() and sys.stdout.isatty()):
+        return False
+    
+    # Check of 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"""
+    # Enable teating on non-Windows, non-demo systems
+    #  where this function would otherwise return False.
+    # Linux: `export USER_DARRIN_DEYOUNG=True`
+    if os.getenv('USER_DARRIN_DEYOUNG','').lower() ==  "true":
+        print("env var USER_DARRIN_DEYOUNG is set to True.")
+        return True
+    # Darrin Deyoung is the typical username on demo-mode Windows systems
     if not on_windows():
         return False
     username = getpass.getuser()
@@ -568,25 +612,33 @@ def can_spawn_shell(override_known:bool=False)->bool:
     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
+
+    try:
+        # Use a simple, universally applicable command with shell=True
+        # 'true' on Linux/macOS, or a basic command on Windows via cmd.exe
+        # A simple 'echo' or 'exit 0' would also work
+        result = subprocess.run( 
+            'exit 0',  # A shell-internal command that succeeds on most shells
+            stdout=subprocess.PIPE, 
+            stderr=subprocess.PIPE, 
+            timeout=2, 
+            shell=True # <--- ESSENTIAL for cross-platform reliability
+        )
         
-        return result.returncode == 0 
+        _CAN_SPAWN_SHELL = result.returncode == 0
+        return _CAN_SPAWN_SHELL 
+    
     except subprocess.TimeoutExpired: 
-        logging.debug("Shell spawn failed: TimeoutExpired")
+        print("Shell spawn failed: TimeoutExpired")
         _CAN_SPAWN_SHELL = result.returncode == 0
         return _CAN_SPAWN_SHELL
     except subprocess.SubprocessError: 
-        logging.debug("Shell spawn failed: SubprocessError") 
+        print("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)") 
+        print("Shell spawn failed: OSError (likely permission or missing binary)") 
     return  False
     
 def can_read_input(override_known:bool=False)-> bool:
@@ -594,10 +646,43 @@ def can_read_input(override_known:bool=False)-> bool:
     global _CAN_READ_INPUT
     if _CAN_READ_INPUT is not None and override_known is False:
         return _CAN_READ_INPUT
+    
+    # --- 1. Windows Specific Check (msvcrt) ---
+    if msvcrt is not None and sys.stdin.isatty():
+        try:
+            # msvcrt.kbhit() checks if a keyboard hit is present
+            # We don't read the input yet, just check if it's there
+            _CAN_READ_INPUT = msvcrt.kbhit()
+            # If kbhit returns True, it means a key press is waiting.
+            # We assume if the terminal *is* a TTY, it *can* read input.
+            # We can't actually call input() without blocking, so we check TTY instead.
+            if _CAN_READ_INPUT:
+                return True
+            
+            # Since we are checking if a *user can* interact, if we are in a TTY, 
+            # we assume the capability exists, even if nothing is currently buffered.
+            # This prevents the false negative when no key is pressed.
+            _CAN_READ_INPUT = True
+            return True
+
+        except Exception as e:
+            # Catch errors in the kbhit check itself
+            logging.debug(f"msvcrt check failed: {e}")
+            pass # Fall through to the select check
+
+    # --- 2. POSIX/General Check (select) ---
+    # This block is reliable on Linux/macOS and other POSIX systems.
     try:
-        # ERROR THIS IS NOT A BOOLEAN, IS RETURNS []
+        # _CAN_READ_INPUT is assigned the read-ready list ([] or [sys.stdin])
+        # The return value is then the boolean conversion of that list's truthiness.
+        # 1. select.select(...) returns a 3-element tuple.
+        # 2. [0] gets the read-ready list (rlist).
+        # 3. Wrapping the result in bool() converts the list's truth value:
+        #    - [] becomes False
+        #    - [sys.stdin] becomes True
         _CAN_READ_INPUT = select.select([sys.stdin], [], [], 0.1)[0]
-        return _CAN_READ_INPUT
+        # Return the boolean value of the list: True if [sys.stdin], False if []
+        return bool(_CAN_READ_INPUT) # <--- Requied to convert list to boolean
     except ValueError:
         logging.debug("Input check failed: ValueError (invalid file descriptor)")
         _CAN_READ_INPUT = False
@@ -606,6 +691,9 @@ def can_read_input(override_known:bool=False)-> bool:
         logging.debug("Input check failed: OSError (likely I/O issue)")
         _CAN_READ_INPUT = False
         return False
+    
+    # Final fallback: if nothing worked, assume False
+    return False
                 
 # --- Browser Check ---
 def web_browser_is_available() -> bool:
@@ -623,6 +711,7 @@ def web_browser_is_available() -> bool:
         if shutil.which("xdg-open"):
             return True
         return False
+
     
 # --- LAUNCH MECHANISMS BASED ON ENVIRONMENT ---
 def edit_textfile(path: Path | str | None = None) -> None:

pyhabitat-1.0.30.dist-info/RECORD

@@ -1,16 +0,0 @@
-pyhabitat/__init__.py,sha256=7XNuHIDBXvjn_EORWZZUNsBS3qpvWRUha1NHwC3d6bw,1539
-pyhabitat/cli.py,sha256=L7VA-OOust2g6_MxedvvOr4RdnS_-5ZGP2Aj4VtdqAg,2221
-pyhabitat/environment.py,sha256=Us6AXG3T3ocSa8giPvg_zSPVneIQsxa6FjBgcBINmOg,36980
-pyhabitat/report.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pyhabitat/utils.py,sha256=2IGLKGAvDFGQgIzlId4ZGGTJRGG0MXR9UVH3nlQKmHg,988
-pyhabitat-1.0.30.dist-info/licenses/LICENSE,sha256=D4fg30ctUGnCJlWu3ONv5-V8JE1v3ctakoJTcVjsJlg,1072
-pyhabitat-build/__main__.py,sha256=6wcF1BhvoRQe4iwq1Px0GNughRXGFRBufWRdaZePu1s,99
-pyhabitat-build/pyhabitat/__init__.py,sha256=UIlLMIMnJHwV1UHAqNgvC_HURGtCUUgp-34-329FV6E,1477
-pyhabitat-build/pyhabitat/cli.py,sha256=L7VA-OOust2g6_MxedvvOr4RdnS_-5ZGP2Aj4VtdqAg,2221
-pyhabitat-build/pyhabitat/environment.py,sha256=4CL7y1KRoYvaHU9uR5jToOmvo_l9OUQPSHdW-i-WXRM,36721
-pyhabitat-build/pyhabitat/utils.py,sha256=2IGLKGAvDFGQgIzlId4ZGGTJRGG0MXR9UVH3nlQKmHg,988
-pyhabitat-1.0.30.dist-info/METADATA,sha256=8C1M_s19eT8bPsQr6jt7KOXkebKpntZzmKwHlwZydcI,10900
-pyhabitat-1.0.30.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pyhabitat-1.0.30.dist-info/entry_points.txt,sha256=409xZ-BrarQJJLtO-aActCGkL0FMhNVi9wsq3u7tRHM,52
-pyhabitat-1.0.30.dist-info/top_level.txt,sha256=zI4aHwfZxhq45fnyLM34qDaerg2Iyb4mcsOP-itrJPY,26
-pyhabitat-1.0.30.dist-info/RECORD,,