Metadata-Version: 2.4
Name: pipbrew-cleaner
Version: 0.1.0
Summary: Interactive CLI tool to list and uninstall pip and Homebrew packages
Author-email: Korben <korben@korben.info>
Project-URL: Homepage, https://github.com/korben00/pipbrew-cleaner
Project-URL: Bug Reports, https://github.com/korben00/pipbrew-cleaner/issues
Project-URL: Source, https://github.com/korben00/pipbrew-cleaner
Keywords: pip,brew,package-manager,cleanup,maintenance,utility
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
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: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.md
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == "test"
Dynamic: license-file

# Pip & Brew cleaner

**Pip & Brew cleaner** (`pipbrew-cleaner`) is an interactive command-line tool for
listing and uninstalling pip and Homebrew packages. It provides colorized output of
package information and lets you safely remove packages from your system.

> macOS only (Homebrew features require a macOS/Homebrew install).

## Features

- Lists pip packages and Homebrew formulas/casks.
- Displays package descriptions.
- Allows filtering by package name.
- Interactive selection for uninstallation, with explicit confirmation.
- Logs operations to a per-user log file.
- Protects critical packages (pip, setuptools, wheel, and the tool itself) from being uninstalled.
- Refuses to remove a Homebrew formula that other installed packages depend on.

## Requirements

- Python 3.8+ (tested on macOS)
- Homebrew (for the Homebrew features)
- No third-party Python dependencies (standard library only)

## Installation

Once published on PyPI, install with:

```bash
pip install pipbrew-cleaner
```

Or clone this repository and run it from source (see Usage).

## Usage

If you installed it from PyPI, run the console command:

```bash
pipbrew-cleaner
```

If you cloned the repository, run it as a module from the project root:

```bash
python3 -m pipbrew_cleaner
```

Follow the prompts to list, view, and uninstall packages.

## Contributing

Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## License

Released under the MIT License. See [LICENSE.md](LICENSE.md).

## Author

Manuel DORNE - Korben
[https://korben.info](https://korben.info)
