pkg-guard 0.1.0

Safe, typo-aware package installer for Python.

pkg-guard

pkg-guard is a smart, typo-aware CLI wrapper for pip install — designed to prevent installing the wrong packages (e.g., reqeusts instead of requests).

It checks PyPI before installing, offers fuzzy suggestions, and lets you interactively choose the correct package with arrow keys — just like vite or npm init.

---

Features

✅ Detects misspelled packages before install
✅ Fuzzy matching & intelligent suggestions (powered by RapidFuzz)
✅ Interactive selection with arrow keys (InquirerPy)
✅ Spinner feedback using Rich
✅ Caching for faster lookups
✅ Extensible architecture (future support for npm, cargo, etc.)

---

Installation

From PyPI (after release)

pip install pkg-guard

From source (for developers)

git clone https://github.com/Prasad2357/pkg-guard
cd pkg-guard
pip install -e .

Usage

pkg-guard install reqeusts

Example

pkg-guard → checking PyPI for package: reqeusts ...
✖ Not found on PyPI: reqeusts

? Select package to install instead of 'reqeusts':
  ▸ requests
    request
    regex
    flask
    Other (type manually)
    Skip

• Arrow keys to navigate
• Press Enter to confirm
• Type manually if your package isn’t listed

How it Works

• Checks if the given package exists on PyPI

• If not found, loads a local list of popular packages

• Uses fuzzy matching (WRatio) to find closest matches

• Presents them interactively via InquirerPy

• Safely installs the chosen package with pip

Project Structure

pkg_guard/
├── __main__.py          # Entry point for `python -m pkg_guard
├── cli.py               # CLI definitions (Typer app)
│
├── core/
│   ├── installer.py     # Main install workflow
│   └── pypi_utils.py    # PyPI querying, caching, suggestions
│
└── ui/
    ├── console.py       # Rich-based spinner & console
    └── prompts.py       # Interactive fuzzy selection

Tech Stack

Component	Library/Framework
CLI Framework	Typer
Interactive Prompts	InquirerPy
Fuzzy Matching	RapidFuzz
Console UI	Rich
HTTP Requests	Requests

Development

Run in dev mode:

python -m pkg_guard install flask

Run linting (optional):

pip install black
black pkg_guard

Contributing

Contributions are welcome!
Feel free to fork this repo, open issues, or submit PRs.

License

This project is licensed under the terms of the MIT License — see the LICENSE file for details.