pip-ui-tkinter 0.1.0__tar.gz

pip_ui_tkinter-0.1.0/.gitignore

@@ -0,0 +1,70 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg
+*.egg-info/
+dist/
+build/
+eggs/
+parts/
+var/
+sdist/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+MANIFEST
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Testing
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+htmlcov/
+junit.xml
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+
+# Linting
+.ruff_cache/
+
+# Docs
+site/
+docs/_build/
+
+# Build history
+.build_logs/
+.build_history/
+.uv/
+
+# Editors
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store

pip_ui_tkinter-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthew Martin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pip_ui_tkinter-0.1.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: pip-ui-tkinter
+Version: 0.1.0
+Summary: A pip UI tool
+Project-URL: Repository, https://github.com/matthewdeanmartin/pip_ui
+Project-URL: Documentation, https://pip_ui.readthedocs.io/en/latest/
+Project-URL: Changelog, https://github.com/matthewdeanmartin/pip_ui/blob/main/CHANGELOG.md
+Project-URL: homepage, https://github.com/matthewdeanmartin/pip_ui
+Project-URL: issues, https://github.com/matthewdeanmartin/pip_ui/issues/
+Author-email: Matthew Martin <matthewdeanmartin@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: pip,pip-ui-tkinter
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+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
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# pip-ui-tkinter
+
+<!-- TODO (generated from template — delete this block once done)
+  - [ ] Replace this description with a real one-paragraph summary
+  - [ ] Update pyproject.toml [project] keywords with real search terms
+  - [ ] Update pyproject.toml classifiers Development Status (3-Alpha → 4-Beta → 5-Production)
+  - [ ] Update pyproject.toml description (shown on PyPI)
+  - [ ] Add a PyPI badge: https://badge.fury.io/py/pip-ui-tkinter
+  - [ ] Add a CI badge from your GitHub Actions build.yml
+  - [ ] Fill in docs/overview/README.md with a real project overview
+  - [ ] Add real subcommands to pip_ui/cli.py and update scripts/basic_checks.sh
+  - [ ] Register project on Read the Docs and point it at mkdocs.yml
+  - [ ] Set up PyPI OIDC trusted publishing (no token needed) for publish_to_pypi.yml
+  - [ ] Run `make pre-commit-install` to install git hooks
+  - [ ] Run `make gha-upgrade` after first push to pin GHA action SHAs
+  - [ ] Add project-specific words to private_dictionary.txt
+  - [ ] Update SECURITY.md scope section with what's actually in scope for this project
+  - [ ] Update CHANGELOG.md 0.1.0 entry with real release notes
+-->
+
+A Tkinter-based UI for pip
+
+## Installation
+
+```bash
+pipx install pip-ui-tkinter
+```
+
+Or with pip:
+
+```bash
+pip install pip-ui-tkinter
+```
+
+## Usage
+
+```bash
+pip-ui-tkinter --help
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](docs/extending/CONTRIBUTING.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).

pip_ui_tkinter-0.1.0/README.md

@@ -0,0 +1,51 @@
+# pip-ui-tkinter
+
+<!-- TODO (generated from template — delete this block once done)
+  - [ ] Replace this description with a real one-paragraph summary
+  - [ ] Update pyproject.toml [project] keywords with real search terms
+  - [ ] Update pyproject.toml classifiers Development Status (3-Alpha → 4-Beta → 5-Production)
+  - [ ] Update pyproject.toml description (shown on PyPI)
+  - [ ] Add a PyPI badge: https://badge.fury.io/py/pip-ui-tkinter
+  - [ ] Add a CI badge from your GitHub Actions build.yml
+  - [ ] Fill in docs/overview/README.md with a real project overview
+  - [ ] Add real subcommands to pip_ui/cli.py and update scripts/basic_checks.sh
+  - [ ] Register project on Read the Docs and point it at mkdocs.yml
+  - [ ] Set up PyPI OIDC trusted publishing (no token needed) for publish_to_pypi.yml
+  - [ ] Run `make pre-commit-install` to install git hooks
+  - [ ] Run `make gha-upgrade` after first push to pin GHA action SHAs
+  - [ ] Add project-specific words to private_dictionary.txt
+  - [ ] Update SECURITY.md scope section with what's actually in scope for this project
+  - [ ] Update CHANGELOG.md 0.1.0 entry with real release notes
+-->
+
+A Tkinter-based UI for pip
+
+## Installation
+
+```bash
+pipx install pip-ui-tkinter
+```
+
+Or with pip:
+
+```bash
+pip install pip-ui-tkinter
+```
+
+## Usage
+
+```bash
+pip-ui-tkinter --help
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](docs/extending/CONTRIBUTING.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).

pip_ui_tkinter-0.1.0/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_tkinter-0.1.0/pip_ui/__init__.py

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

pip_ui_tkinter-0.1.0/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_tkinter-0.1.0/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()