pip-ui-tkinter 0.1.0__py3-none-any.whl

pip_ui/__about__.py

@@ -0,0 +1,25 @@
+"""Metadata for pip-ui-tkinter."""
+
+__all__ = [
+    "__credits__",
+    "__dependencies__",
+    "__description__",
+    "__keywords__",
+    "__license__",
+    "__readme__",
+    "__requires_python__",
+    "__status__",
+    "__title__",
+    "__version__",
+]
+
+__title__ = "pip-ui-tkinter"
+__version__ = "0.1.0"
+__description__ = "A pip UI tool"
+__readme__ = "README.md"
+__credits__ = [{"name": "Matthew Martin", "email": "matthewdeanmartin@gmail.com"}]
+__keywords__ = ["pip-ui-tkinter", "pip"]
+__license__ = "MIT"
+__requires_python__ = ">=3.10"
+__status__ = "3 - Alpha"
+__dependencies__: list[str] = []

pip_ui/__init__.py

@@ -0,0 +1,5 @@
+"""A pip UI tool."""
+
+from pip_ui.__about__ import __version__
+
+__all__ = ["__version__"]

pip_ui/__main__.py

@@ -0,0 +1,6 @@
+"""Allows `python -m pip_ui` invocation."""
+
+from pip_ui.cli import main
+
+if __name__ == "__main__":
+    main()

pip_ui/cli.py

@@ -0,0 +1,117 @@
+"""Command-line entry point for pip_ui."""
+
+from __future__ import annotations
+
+import argparse
+import importlib.util
+import sys
+
+from pip_ui.__about__ import __version__
+from pip_ui.encoding import configure_utf8_stdio
+
+
+def main() -> None:
+    """Parse CLI arguments and launch the GUI or diagnostics mode."""
+    configure_utf8_stdio()
+    parser = argparse.ArgumentParser(
+        prog="pip-ui",
+        description="A Tkinter GUI for pip. Runs commands via: python -m pip",
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {__version__}",
+    )
+    parser.add_argument(
+        "--interpreter",
+        metavar="PATH",
+        help="Path to the Python interpreter to use.",
+        default=None,
+    )
+    parser.add_argument(
+        "--working-directory",
+        metavar="PATH",
+        help="Working directory for pip commands.",
+        default=None,
+    )
+    parser.add_argument(
+        "--diagnostics",
+        action="store_true",
+        help="Print a diagnostics report and exit without launching the GUI.",
+    )
+    parser.add_argument(
+        "--no-history",
+        action="store_true",
+        help="Do not record command history.",
+    )
+    parser.add_argument(
+        "--safe-mode",
+        action="store_true",
+        help="Prompt for confirmation before any potentially destructive command.",
+    )
+
+    args = parser.parse_args()
+
+    if args.diagnostics:
+        run_diagnostics(args.interpreter)
+        return
+
+    if importlib.util.find_spec("tkinter") is None:
+        print(
+            "Error: Tkinter is not available in this Python installation.\n"
+            "On Debian/Ubuntu: sudo apt-get install python3-tk\n"
+            "On Fedora: sudo dnf install python3-tkinter\n"
+            "On macOS: install Python from python.org (includes Tk)\n"
+            "On Windows: re-run the Python installer and ensure 'tcl/tk' is checked.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    from pip_ui.ui.main_window import MainWindow  # pylint: disable=import-outside-toplevel
+
+    app = MainWindow(
+        no_history=args.no_history,
+        safe_mode=args.safe_mode,
+    )
+
+    if args.interpreter:
+        app.after(200, lambda: app.interpreter_picker.set_from_path(args.interpreter))
+
+    if args.working_directory:
+        app.workdir_var.set(args.working_directory)
+        app.status_workdir_var.set(args.working_directory)
+
+    try:
+        app.mainloop()
+    except KeyboardInterrupt:
+        app.on_close()
+
+
+def run_diagnostics(interpreter_path: str | None) -> None:
+    """Print a diagnostics report for the selected or default interpreter."""
+    from pip_ui.environment import InterpreterDiscovery  # pylint: disable=import-outside-toplevel
+
+    discovery = InterpreterDiscovery()
+    interpreters = discovery.discover()
+
+    if interpreter_path:
+        target = discovery.validate(interpreter_path)
+        if target is None:
+            print(f"Warning: Could not validate interpreter at: {interpreter_path}", file=sys.stderr)
+            target = interpreters[0] if interpreters else None
+    else:
+        target = interpreters[0] if interpreters else None
+
+    if target is None:
+        print("No Python interpreters found.", file=sys.stderr)
+        sys.exit(1)
+
+    from pip_ui.config_inspector import ConfigInspector  # pylint: disable=import-outside-toplevel
+
+    inspector = ConfigInspector(target.path)
+    report = inspector.build_diagnostics_report("markdown")
+    print(report)
+
+
+if __name__ == "__main__":
+    main()