An open API service indexing awesome lists of open source software.

https://github.com/aj-white/piplexed

Find outdated packages installed with pipx or uv tool
https://github.com/aj-white/piplexed

cli pipx pypi python

Last synced: 4 months ago
JSON representation

Find outdated packages installed with pipx or uv tool

Awesome Lists containing this project

README

          

# Piplexed

### Find outdated packages installed with pipx or uv

[![PyPI - Version](https://img.shields.io/pypi/v/piplexed.svg)](https://pypi.org/project/piplexed)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/piplexed)](https://pypi.org/project/piplexed)

**Piplexed** is a command line tool to identify outdated python packages, installed from [PyPI](https://pypi.org/), via [pipx](https://pypa.github.io/pipx/) or [uv](https://docs.astral.sh/uv/) (using the `uv tool` command).

**Documentation**: [https://aj-white.github.io/piplexed/](https://aj-white.github.io/piplexed/)

## ⛳ Table of Contents

- [Usage](#usage)
- [Installation](#installation)
- [Why piplexed ?](#why-piplexed)
- [Caveats](#caveats)
- [License](#license)

## 🔧 Usage

### Show Outdated Packages (Tools)

Ignores prelease and dev releases by default.

#### Installed with Pipx

```console
piplexed list --outdated
```


piplexed in action

#### Installed with uv
```console
piplexed list --outdated --tool uv
```

### Show outdated packages (include pre or dev releases)

#### Installed with pipx

```console
piplexed list --outdated --pre
```


pipx installed tool include prerelease

#### Installed with uv
```consle
piplexed list --outdated --pre --tool uv
```


uv installed tool include prerelease

### List Installed Packages

#### With pipx

```console
piplexed list
```
Outputs similar information to `pipx list`, albeit minus the names of the binaries, in a rich table format.



```console
piplexed list --tree
```

An optional tree flag can be passed for a tree view (less useful if there are a lot of packages)


piplexed list tree

#### With UV
```console
piplexed list --tool uv
```

## 👷‍♀️ Installation

**Piplexed** is designed to be installed globally via **pipx** or **uv**.

To install **piplexed**:

```console
pipx install piplexed
```

or

```console
uv tool install piplexed
```

Alternatively you can run it wihtout installation, supplying the required arguments shown below

```console
pipx run -- piplexed
```
or
```console
uv tool run piplexed
```

## ❓ Why piplexed

The name **piplexed** is a play on words, it contains the letters for pipx and I was also mildly perplexed trying to find a simpler way to identify outdated pipx installed packages, only to discover it didn't exist. Put the two together and well.... you get the idea (naming things is hard after all!).
For a longer answer see the [documentation](https://aj-white.github.io/piplexed/Why-piplexed/).

## 🩹 Caveats

**Piplexed** is a project that I built for my workflow, but it may not work for everyone.

It is only intended to work for packages that are installed from [PyPI](https://pypi.org), so will not work for local packages or git/url etc.

## 📝 License

**Piplexed** is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.