blindwindow 0.1.0__tar.gz

blindwindow-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include src/blindwindow/data/*
+#recursive-include src/blindwindow/data/icons *

blindwindow-0.1.0/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: blindwindow
+Version: 0.1.0
+Summary: Route console stderr and stdout to blindwindow, to either duplicate or display what is otherwise hidden. Namely for MSIX deployed CLI's
+Author-email: George Clayton Bennett <george.bennett@memphistn.gov>
+Maintainer-email: George Clayton Bennett <george.bennett@memphistn.gov>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Typing :: Typed
+Classifier: Development Status :: 3 - Alpha
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: dworshak-config>=0.2.8
+Requires-Dist: pyhabitat>=1.3.9
+Requires-Dist: typer>=0.27.0
+Requires-Dist: typer-helptree>=0.2.12
+Requires-Dist: maxson-gui-utils>=0.1.5
+Provides-Extra: gui
+Requires-Dist: maxson_gui_utils>=0.1.4; extra == "gui"
+
+# Blindwindow
+
+Render console stderr and stdout to a TKinter based REPL widget masquerading as a log pange.
+
+Use Case: When calling a CLI packaged inside of a MSIX that has been delivered via the Microsoft Store. This use case typically does not allow prints. 
+Example: `pdflinkcheck.exe serve --help`
+
+
+
+## Helptree
+
+See the `blindwindow` Typer CLI structure.
+
+```bash
+blindwindow helptree
+```

blindwindow-0.1.0/README.md

@@ -0,0 +1,16 @@
+# Blindwindow
+
+Render console stderr and stdout to a TKinter based REPL widget masquerading as a log pange.
+
+Use Case: When calling a CLI packaged inside of a MSIX that has been delivered via the Microsoft Store. This use case typically does not allow prints. 
+Example: `pdflinkcheck.exe serve --help`
+
+
+
+## Helptree
+
+See the `blindwindow` Typer CLI structure.
+
+```bash
+blindwindow helptree
+```

blindwindow-0.1.0/pyproject.toml

@@ -0,0 +1,114 @@
+[project]
+name = "blindwindow"
+dynamic = ["version"]
+description = "Route console stderr and stdout to blindwindow, to either duplicate or display what is otherwise hidden. Namely for MSIX deployed CLI's"
+readme = "README.md"
+requires-python = ">=3.10"
+
+dependencies = [
+    "dworshak-config>=0.2.8",
+    "pyhabitat>=1.3.9",
+    "typer>=0.27.0",
+    "typer-helptree>=0.2.12",
+    "maxson-gui-utils>=0.1.5",
+]
+
+license = "MIT"
+license-files = ["LICENSE"]
+
+authors = [
+    { name = "George Clayton Bennett", email = "george.bennett@memphistn.gov" }
+]
+
+maintainers = [
+    { name = "George Clayton Bennett", email = "george.bennett@memphistn.gov" }
+]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Typing :: Typed",
+    "Development Status :: 3 - Alpha",
+    #"Development Status :: 4 - Beta",
+    #"Development Status :: 5 - Production/Stable",
+]
+
+keywords = [
+
+]
+
+#[project.urls]
+#Homepage = ""
+#Repository = ""
+#Issues = ""
+#Changelog = ""
+
+[project.scripts]
+"blindwindow" = "blindwindow.__main__:app"
+
+[dependency-groups]
+test = [
+    "pytest>=8.0.0",
+    "pytest-cov>=4.1.0",
+]
+dev = [
+    { include-group = "test" },
+    "build>=1.3.0",
+    "pyinstaller>=6.17.0 ; platform_system == 'Linux' and platform_machine != 'aarch64'",
+    "shiv>=1.0.8",
+    "ruff>=0.7.0 ; platform_system == 'Linux' and platform_machine != 'aarch64'",
+    "maxson-build-utils>=0.1.33",
+]
+
+[project.optional-dependencies]
+gui = [
+    "maxson_gui_utils>=0.1.4",
+]
+
+
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.uv.sources]
+"blindwindow" = { path = "src/blindwindow" }
+
+#[tool.setuptools]
+#packages = [""blindwindow""]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = { file = "src/blindwindow/VERSION" }
+
+[tool.setuptools.package-data]
+"blindwindow" = [
+    "data/*",
+    "data/icons/*",
+    "data/icons/**/*",
+    "data/themes/*",
+    "data/themes/**/*",
+]
+
+[tool.maxson-build-utils.names]
+import = "blindwindow"
+pretty = "Blindwindow"
+
+[tool.maxson-build-utils.pyinstaller]
+mode = "onedir"
+windowed = false
+collect_data_pkgs = ["blindwindow"]
+collect_binary_pkgs = []
+
+[tool.maxson-build-utils.packaging.msix]
+publisher = "CN=Development"
+publisher_display_name = "George Clayton Bennett"
+identity_name = "GeorgeClaytonBennett.Blindwindow"

blindwindow-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

blindwindow-0.1.0/src/blindwindow/VERSION

@@ -0,0 +1,2 @@
+0.1.0
+

blindwindow-0.1.0/src/blindwindow/__init__.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+# src/blindwindow/__init__.py
+from __future__ import annotations
+
+import os
+
+from ._version import __version__
+
+# 1. Clean public-facing mapping
+__all__ = [
+    "__version__",
+
+    "__gui_easteregg_enabled__",
+]
+
+
+def _check_easteregg_env() -> bool:
+    """Helper to dynamically read environment state at call-time."""
+    env_flag = os.environ.get("BLINDWINDOW_GUI_EASTEREGG", "").strip().lower()
+    return env_flag in ("true", "1", "yes", "on")
+
+
+# 2. Fully dynamic attribute routing
+def __getattr__(name: str):
+
+    # Dynamic boolean evaluation for the breadcrumb attribute
+    if name == "__gui_easteregg_enabled__":
+        return _check_easteregg_env()
+
+    # Dynamic lookups for the GUI function invocation
+    if name == "start_gui":
+
+        def _missing_gui():
+            raise RuntimeError(
+                "start_gui requires pyhabitat and a Tkinter-capable environment"
+            )
+
+        _missing_gui.__name__ = "start_gui"
+        _missing_gui.__doc__ = (
+            "GUI support is unavailable in this environment."
+        )
+
+        if _check_easteregg_env():
+            try:
+                import pyhabitat
+
+                if pyhabitat.tkinter_is_available():
+                    from .gui import start_gui
+
+                    return start_gui
+            except ImportError:
+                pass
+
+        return _missing_gui
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+# 3. Dynamic introspection reflecting runtime changes
+def __dir__():
+    exported = list(__all__)
+    if _check_easteregg_env():
+        exported.append("start_gui")
+
+    return sorted(
+        exported
+        + [
+            "__builtins__",
+            "__cached__",
+            "__doc__",
+            "__file__",
+            "__getattr__",
+            "__dir__",
+            "__loader__",
+            "__name__",
+            "__package__",
+            "__path__",
+            "__spec__",
+        ]
+    )

blindwindow-0.1.0/src/blindwindow/__main__.py

@@ -0,0 +1,7 @@
+# src/blindwindow/__main__.py
+from __future__ import annotations
+
+from blindwindow.cli import app
+
+if __name__ == "__main__":
+    app()

blindwindow-0.1.0/src/blindwindow/_version.py

@@ -0,0 +1,23 @@
+
+# src/blindwindow/_version.py
+from pathlib import Path
+from .context import APP_NAME
+def get_version() -> str:
+    try:
+        version_file = Path(__file__).parent / "VERSION"
+        if version_file.exists():
+            return version_file.read_text(encoding="utf-8").strip()
+    except Exception:
+        pass
+
+    # Try metadata (Installed)
+    try:
+        from importlib.metadata import version, PackageNotFoundError
+        return version(APP_NAME)
+    except (ImportError, PackageNotFoundError):
+        pass
+
+
+    return "0.0.0-unknown"
+
+__version__ = get_version()

blindwindow-0.1.0/src/blindwindow/cli.py

@@ -0,0 +1,152 @@
+#!/usr/bin/env python3
+# src/blindwindow/cli.py
+
+from __future__ import annotations
+
+import logging
+import os
+import sys
+from pathlib import Path
+import pyhabitat
+import typer
+from typer.models import OptionInfo
+from rich.console import Console
+from typer_helptree import add_typer_helptree
+
+from ._version import __version__
+from .context import APP_NAME, DESCRIPTION_STR
+from .logging_setup import (
+    configure_logging_all_debug,
+    configure_logging_for_application,
+)
+
+logger = logging.getLogger(__name__)
+
+console_stderr = Console(stderr=True)
+console_stdout = Console()
+
+# Force Rich to always enable colors, even when running from a .pyz bundle.
+os.environ["FORCE_COLOR"] = "1"
+
+# Optional but helpful for full terminal feature detection.
+os.environ["TERM"] = "xterm-256color"
+
+app = typer.Typer(
+    name=APP_NAME,
+    help=f"{DESCRIPTION_STR} (v{__version__})",
+    add_completion=False,
+    invoke_without_command=True,
+    no_args_is_help=True,
+    context_settings={
+        "ignore_unknown_options": True,
+        "allow_extra_args": True,
+        "help_option_names": ["-h", "--help"],
+    },
+)
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    version: bool = typer.Option(
+        False,
+        "--version",
+        "-V",
+        help="Show application version and exit.",
+    ),
+    debug: bool = typer.Option(
+        False,
+        "--debug",
+        "-d",
+        help="Enable debug level logs for app.",
+    ),
+    all_debug: bool = typer.Option(
+        False,
+        "--all-debug",
+        help="Enable debug logs for app AND dependencies.",
+    ),
+    verbose: bool = typer.Option(
+        False,
+        "--verbose",
+        "-v",
+        help="Enable verbose info level logs.",
+    ),
+    log_file: Path | None = typer.Option(
+        None,
+        "--log-file",
+        help="Custom path to output log file.",
+    ),
+):
+    if version:
+        typer.echo(__version__)
+        raise typer.Exit()
+
+    if all_debug:
+        configure_logging_all_debug()
+    else:
+        configure_logging_for_application(
+            debug=debug,
+            verbose=verbose,
+            log_to_file=log_file is not None,
+        )
+
+    logger.debug("Executing command: %s", " ".join(sys.argv))
+
+    if ctx.invoked_subcommand is None and not ctx.resilient_parsing:
+        typer.echo(ctx.get_help())
+        raise typer.Exit()
+
+
+add_typer_helptree(
+    app=app,
+    console=console_stderr,
+    version=__version__,
+    hidden=False,
+)
+
+@app.command(name="gui")
+def gui_command(
+    auto_close: int = typer.Option(0,
+   "--auto-close", "-c",
+   help = "Delay in milliseconds after which the GUI window will close (for automated testing). Use 0 to disable auto-closing.",
+   min=0)
+    )->None:
+    """
+    Launch tkinter-based GUI.
+    """
+    assured_auto_close_value = 0
+
+    # --- Helper, consistent gui failure message. ---
+    def _gui_failure_msg():
+        console_stderr.print("[bold red]GUI failed to launch[/bold red]")
+        console_stderr.print("Use CLI instead.")
+        console_stderr.print(f"pyhabitat.tkinter_is_available() = {pyhabitat.tkinter_is_available()}")
+        console_stderr.print(f"pyhabitat.on_termux() = {pyhabitat.on_termux()}")
+
+    if isinstance(auto_close, OptionInfo):
+        # Case 1: Called implicitly from main() (with no args)
+        # We received the metadata object, so use the function's default value (0).
+        # We don't need to do anything here since final_auto_close_value is already 0.
+        pass
+    else:
+        # Case 2: Called explicitly by Typer (gui -c 3000)
+        # Typer has successfully converted the command line argument, and auto_close is an int.
+        assured_auto_close_value = int(auto_close)
+
+    if not pyhabitat.tkinter_is_available():
+        _gui_failure_msg()
+        return
+
+    from .gui import start_gui
+    start_gui(time_auto_close = assured_auto_close_value)
+
+@app.command(name="placeholder")
+def placeholder(
+    path: Path = Path("path"),
+):
+    """Placeholder."""
+    console_stderr.print(f"{path=}")
+
+
+if __name__ == "__main__":
+    app()

blindwindow-0.1.0/src/blindwindow/config.py

@@ -0,0 +1,9 @@
+# src/blindwindow/config.py
+from __future__ import annotations
+
+
+def get_config_mngr():
+    from .context import APP_DIR
+    from dworshak_config import DworshakConfig
+    return DworshakConfig(path=APP_DIR / "config.json")
+

blindwindow-0.1.0/src/blindwindow/context.py

@@ -0,0 +1,20 @@
+# src/blindwindow/context.py
+from __future__ import annotations
+
+from pathlib import Path
+
+PACKAGE_DIR = Path(__file__).resolve().parent
+SRC_DIR = PACKAGE_DIR.parent
+PROJECT_ROOT = SRC_DIR.parent
+
+APP_NAME = "blindwindow"
+APP_NAME_PRETTY = "Blindwindow"
+IMPORT_NAME = "blindwindow"
+SRC_FOLDER_NAME = "blindwindow"
+DESCRIPTION_STR = "A Python application."
+APP_DIR = Path.home() / ".blindwindow"
+LOG_FILE_PATH = APP_DIR / "blindwindow.log"
+SERVICE = APP_NAME
+CONFIG_PATH = APP_DIR / "config.json"
+SECRET_PATH = APP_DIR / "vault.db"
+ENV_PATH = PROJECT_ROOT / ".env"

blindwindow-0.1.0/src/blindwindow/core.py

@@ -0,0 +1,3 @@
+# src/blindwindow/core.py
+
+from __future__ import annotations

blindwindow-0.1.0/src/blindwindow/gui.py

@@ -0,0 +1,215 @@
+
+#!/usr/bin/env python3
+# src/blindwindow/gui.py
+
+from __future__ import annotations
+
+import ctypes
+import logging
+import sys
+import tkinter as tk
+from importlib.resources import files
+from tkinter import messagebox, ttk
+from maxson_gui_utils.tk_utils import center_window_on_primary
+from maxson_gui_utils.external_web_launch import launch_configured_website
+
+import pyhabitat
+
+from ._version import __version__
+from .context import APP_NAME, IMPORT_NAME, CONFIG_PATH
+
+logger = logging.getLogger(__name__)
+
+APP_WIDTH = 800
+APP_HEIGHT = 600
+
+
+class GuiApp:
+    """Main application window."""
+
+    def __init__(self, root: tk.Tk):
+        self.root = root
+
+        #self._initialize_theme()
+        self._configure_window()
+        self._create_menubar()
+        self._create_widgets()
+
+    def _initialize_theme(self) -> None:
+        """Initialize the application theme."""
+
+        theme_dir = files(
+            f"{IMPORT_NAME}.data.themes.forest"
+        )
+
+        self.root.tk.call(
+            "source",
+            str(theme_dir / "forest-light.tcl"),
+        )
+        self.root.tk.call(
+            "source",
+            str(theme_dir / "forest-dark.tcl"),
+        )
+
+        style = ttk.Style(self.root)
+        style.configure(".", padding=2)
+        style.configure("TFrame", padding=2)
+        style.configure("TLabelFrame", padding=(4, 2))
+        style.configure("TButton", padding=4)
+        style.configure("TCheckbutton", padding=2)
+        style.configure("TRadiobutton", padding=2)
+
+        style.theme_use("forest-dark")
+
+    def _configure_window(self) -> None:
+        self.root.title(f"{APP_NAME} v{__version__}")
+        self.root.geometry(
+            f"{APP_WIDTH}x{APP_HEIGHT}"
+        )
+        self.root.minsize(600, 400)
+
+        self._set_icon()
+
+    def _set_icon(self) -> None:
+        """Set the application icon when available."""
+        try:
+            icon_path = files(
+                f"{IMPORT_NAME}.data.icons"
+            ) / "water-green_256x256.png"
+
+            if icon_path.is_file():
+                self.icon_img = tk.PhotoImage(
+                    file=str(icon_path)
+                )
+                self.root.iconphoto(
+                    True,
+                    self.icon_img,
+                )
+        except Exception:
+            logger.debug(
+                "Unable to load application icon",
+                exc_info=True,
+            )
+
+    def _create_menubar(self) -> None:
+        """Create the application menu bar."""
+
+        menubar = tk.Menu(self.root)
+        self.root.configure(menu=menubar)
+
+        options = tk.Menu(
+            menubar,
+            tearoff=False,
+        )
+
+        menubar.add_cascade(
+            label="Options",
+            menu=options,
+        )
+
+        options.add_command(
+            label="About",
+            command=self._show_about,
+        )
+
+        tools_menu = tk.Menu(menubar, tearoff=0)
+        menubar.add_cascade(label="Tools", menu=tools_menu)
+
+        tools_menu.add_command(label="Show Filled Files ", command=lambda: self._show_target_files_in_system_explorer())
+        tools_menu.add_command(label="Launch Configured Website ", command=lambda: self._launch_configured_website())
+
+        
+        options.add_separator()
+
+        options.add_command(
+            label="Exit",
+            command=self.root.destroy,
+        )
+
+    def _create_widgets(self) -> None:
+        """Create application widgets."""
+
+        frame = ttk.Frame(
+            self.root,
+            padding=12,
+        )
+        frame.pack(
+            fill="both",
+            expand=True,
+        )
+
+        label = ttk.Label(
+            frame,
+            text=f"{APP_NAME} v{__version__}",
+        )
+        label.pack()
+
+    def _show_about(self) -> None:
+        messagebox.showinfo(
+            "About",
+            f"{APP_NAME} Version {__version__}",
+        )
+
+    def _show_target_files_in_system_explorer(self) -> None:
+        """
+        Opens the system file explorer to the directory containing
+        the exported files, with GUI error handling.
+        """
+        try:
+            target_dir = APP_DIR
+            pyhabitat.show_system_explorer(path = target_dir)
+        except Exception as e:
+            # The GUI catches the error to show a user-friendly popup
+            messagebox.showerror("Error", f"Could not open system explorer: {e}")
+
+    def _launch_configured_website(self):
+        launch_configured_website(path = CONFIG_PATH)
+
+
+def apply_windows_taskbar_icon() -> None:
+    """Set a stable Windows AppUserModelID."""
+
+    if not pyhabitat.on_windows():
+        return
+
+    try:
+        app_id = (
+            f"CityOfMemphisWastewater."
+            f"{APP_NAME}.Application"
+        )
+
+        ctypes.windll.shell32.SetCurrentProcessExplicitAppUserModelID(
+            app_id
+        )
+    except Exception:
+        logger.debug(
+            "Unable to set Windows taskbar identity",
+            exc_info=True,
+        )
+
+
+def start_gui(time_auto_close=None) -> None:
+    """Start the graphical application."""
+
+    apply_windows_taskbar_icon()
+
+    root = tk.Tk()
+    root.withdraw()
+
+    logger.debug("Starting %s", APP_NAME)
+
+    try:
+        app = GuiApp(root)
+    except Exception:
+        logger.exception("GUI startup failed")
+        root.destroy()
+        return
+
+    root.deiconify()
+    root.mainloop()
+
+    logger.debug("%s: GUI closed", APP_NAME)
+
+
+if __name__ == "__main__":
+    start_gui()

blindwindow-0.1.0/src/blindwindow/helpers.py

@@ -0,0 +1,3 @@
+# src/blindwindow/helpers.py
+
+from __future__ import annotations

blindwindow-0.1.0/src/blindwindow/logging_setup.py

@@ -0,0 +1,177 @@
+# src/blindwindow/logging_setup.py
+
+from __future__ import annotations
+
+import logging
+import sys
+import traceback
+from logging.handlers import RotatingFileHandler
+from pathlib import Path
+
+from .context import APP_NAME, LOG_FILE_PATH
+
+
+# -----
+# Constants
+# -----
+
+FILE_LOG_LEVEL = logging.DEBUG
+FILE_LOG_MAX_BYTES = 5 * 1024 * 1024
+FILE_LOG_BACKUP_COUNT = 3
+
+
+# -----
+# Logger Access
+# -----
+
+def get_logger(name: str | None = None) -> logging.Logger:
+    """Return the package logger or a sub-logger under its namespace."""
+    target_name = name or "blindwindow"
+    return logging.getLogger(target_name)
+
+
+# -----
+# Formatters
+# -----
+
+def _file_formatter() -> logging.Formatter:
+    """Return the formatter used for persistent file logging."""
+    return logging.Formatter(
+        "%(asctime)s %(levelname)-8s %(name)s: %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+    )
+
+
+def _console_formatter(
+    debug: bool = False,
+    verbose: bool = False,
+) -> logging.Formatter:
+    """Return the formatter used for console output."""
+    if debug:
+        fmt = "%(levelname)-7s %(message)s"
+    elif verbose:
+        fmt = "%(message)s"
+    else:
+        fmt = "%(levelname)s: %(message)s"
+
+    return logging.Formatter(fmt)
+
+
+# -----
+# Handlers
+# -----
+
+def setup_file_logging() -> logging.Handler | None:
+    """Create the persistent application log handler safely."""
+    if LOG_FILE_PATH is None:
+        return None
+
+    try:
+        log_path = Path(LOG_FILE_PATH)
+        log_path.parent.mkdir(parents=True, exist_ok=True)
+
+        handler = RotatingFileHandler(
+            log_path,
+            maxBytes=FILE_LOG_MAX_BYTES,
+            backupCount=FILE_LOG_BACKUP_COUNT,
+            encoding="utf-8",
+        )
+        handler.setLevel(FILE_LOG_LEVEL)
+        handler.setFormatter(_file_formatter())
+        return handler
+    except (OSError, PermissionError) as err:
+        sys.stderr.write(f"Warning: Failed to initialize file log at {LOG_FILE_PATH}: {err}\n")
+        return None
+
+
+# -----
+# Configurations
+# -----
+
+def configure_logging_for_application(
+    debug: bool = False,
+    verbose: bool = False,
+    log_to_file: bool = True,
+) -> logging.Logger:
+    """Configure logging for an executable application entrypoint."""
+    logger = get_logger()
+
+    logger.setLevel(logging.DEBUG)
+    logger.propagate = False
+
+    if logger.hasHandlers():
+        logger.handlers.clear()
+
+    # File Logging
+    if log_to_file:
+        file_handler = setup_file_logging()
+        if file_handler is not None:
+            logger.addHandler(file_handler)
+
+    # Console Logging
+    if debug:
+        console_level = logging.DEBUG
+    elif verbose:
+        console_level = logging.INFO
+    else:
+        console_level = logging.WARNING
+
+    console_handler = logging.StreamHandler(sys.stderr)
+    console_handler.setLevel(console_level)
+    console_handler.setFormatter(
+        _console_formatter(debug=debug, verbose=verbose)
+    )
+    logger.addHandler(console_handler)
+
+    logger.debug("Application logging configured for %s.", APP_NAME)
+    return logger
+
+
+def configure_logging_for_library(
+    debug: bool = False,
+    verbose: bool = False,
+) -> logging.Logger:
+    """Configure logging when this package is consumed as a library module."""
+    logger = get_logger()
+
+    if debug:
+        level = logging.DEBUG
+    elif verbose:
+        level = logging.INFO
+    else:
+        level = logging.WARNING
+
+    logger.setLevel(level)
+    logger.propagate = True
+
+    if not logger.handlers:
+        logger.addHandler(logging.NullHandler())
+
+    return logger
+
+
+def configure_logging_all_debug() -> None:
+    """Force DEBUG level logging globally across the root logger and third-party tools."""
+    root_logger = logging.getLogger()
+    root_logger.setLevel(logging.DEBUG)
+
+    if root_logger.hasHandlers():
+        root_logger.handlers.clear()
+
+    console_handler = logging.StreamHandler(sys.stderr)
+    console_handler.setLevel(logging.DEBUG)
+    console_handler.setFormatter(
+        logging.Formatter("%(asctime)s - %(levelname)-7s - [%(name)s] %(message)s")
+    )
+    root_logger.addHandler(console_handler)
+
+
+# -----
+# Diagnostics
+# -----
+
+def log_traceback(logger_instance: logging.Logger | None = None) -> None:
+    """Safely print stack traces to stderr if debug level is active."""
+    target = logger_instance or get_logger()
+    if target.isEnabledFor(logging.DEBUG):
+        traceback.print_exc(file=sys.stderr)

blindwindow-0.1.0/src/blindwindow.egg-info/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: blindwindow
+Version: 0.1.0
+Summary: Route console stderr and stdout to blindwindow, to either duplicate or display what is otherwise hidden. Namely for MSIX deployed CLI's
+Author-email: George Clayton Bennett <george.bennett@memphistn.gov>
+Maintainer-email: George Clayton Bennett <george.bennett@memphistn.gov>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Typing :: Typed
+Classifier: Development Status :: 3 - Alpha
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: dworshak-config>=0.2.8
+Requires-Dist: pyhabitat>=1.3.9
+Requires-Dist: typer>=0.27.0
+Requires-Dist: typer-helptree>=0.2.12
+Requires-Dist: maxson-gui-utils>=0.1.5
+Provides-Extra: gui
+Requires-Dist: maxson_gui_utils>=0.1.4; extra == "gui"
+
+# Blindwindow
+
+Render console stderr and stdout to a TKinter based REPL widget masquerading as a log pange.
+
+Use Case: When calling a CLI packaged inside of a MSIX that has been delivered via the Microsoft Store. This use case typically does not allow prints. 
+Example: `pdflinkcheck.exe serve --help`
+
+
+
+## Helptree
+
+See the `blindwindow` Typer CLI structure.
+
+```bash
+blindwindow helptree
+```

blindwindow-0.1.0/src/blindwindow.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+MANIFEST.in
+README.md
+pyproject.toml
+src/blindwindow/VERSION
+src/blindwindow/__init__.py
+src/blindwindow/__main__.py
+src/blindwindow/_version.py
+src/blindwindow/cli.py
+src/blindwindow/config.py
+src/blindwindow/context.py
+src/blindwindow/core.py
+src/blindwindow/gui.py
+src/blindwindow/helpers.py
+src/blindwindow/logging_setup.py
+src/blindwindow.egg-info/PKG-INFO
+src/blindwindow.egg-info/SOURCES.txt
+src/blindwindow.egg-info/dependency_links.txt
+src/blindwindow.egg-info/entry_points.txt
+src/blindwindow.egg-info/requires.txt
+src/blindwindow.egg-info/top_level.txt

blindwindow-0.1.0/src/blindwindow.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

blindwindow-0.1.0/src/blindwindow.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+blindwindow = blindwindow.__main__:app

blindwindow-0.1.0/src/blindwindow.egg-info/requires.txt

@@ -0,0 +1,8 @@
+dworshak-config>=0.2.8
+pyhabitat>=1.3.9
+typer>=0.27.0
+typer-helptree>=0.2.12
+maxson-gui-utils>=0.1.5
+
+[gui]
+maxson_gui_utils>=0.1.4

blindwindow-0.1.0/src/blindwindow.egg-info/top_level.txt

@@ -0,0 +1 @@
+blindwindow