taze 0.2.1

🥬 Keep your Python deps fresh

taze 🥬

Keep your Python dependencies fresh.

Inspired by taze for Node.js — ported to the Python ecosystem with support for pyproject.toml and requirements.txt.

---

Features

• Checks all dependencies against PyPI in parallel
• Shows the bump level (patch / minor / MAJOR) with colors
• Displays release age for both the current and latest version
• Supports pyproject.toml (PEP 508, PEP 735, uv, PDM, Hatch) and requirements*.txt
• Writes updated version constraints back to the file (-w)
• Detects uv, Poetry, PDM, and Pixi before installing (-i)
• Interactive package selection (-I)
• Recursive monorepo scanning (-r)
• Pre-release support (newest / next mode)
• Regex filtering for include / exclude
• Safe PEP 440 range resolution, maturity periods, and per-package policies

---

Installation

uv tool install taze
# or
uvx taze
# or
pip install taze

---

Usage

taze [mode] [options]

Modes

Mode	What it shows
default	Latest stable release allowed by the declared PEP 440 range
major	Latest stable release, including major changes
minor	Latest stable release in the current major version
patch	Latest stable release in the current major/minor version
latest	Alias for major
stable	Range-safe stable updates
newest	All updates including pre-releases
next	Same as newest

Examples

# Check everything in the current directory
taze

# Only show minor and patch updates
taze minor

# Write patch updates back to pyproject.toml
taze patch -w

# Write all updates and run uv sync
taze -w -i

# Interactive — pick which packages to update
taze -I

# Include pre-releases
taze newest

# Scan all subdirectories (monorepo)
taze -r

# Only check specific packages
taze -n requests,httpx

# Skip packages matching a pattern
taze -x /^pytest/

# Do not upgrade releases published in the last two weeks
taze --maturity-period 14

# Include exact == pins (they are skipped by default)
taze -l

# Sort by largest update first
taze --sort diff-desc

# Machine-readable JSON output
taze --json

Options

  -w, --write              Write updates back to file
  -i, --install            Install after writing (implies -w)
  -u, --update             Alias for --install
  -I, --interactive        Choose which packages to update interactively
  -r, --recursive          Scan subdirectories for pyproject.toml / requirements*.txt
      --ignore-paths <glob> Comma-separated glob paths to skip with --recursive
      --ignore-other-workspaces / --include-other-workspaces
                            Skip nested repositories and workspaces (default: skip)
  -a, --all                Show up-to-date packages too
  -n, --include <deps>     Only check these packages (comma-separated or /regex/)
  -x, --exclude <deps>     Skip these packages (comma-separated or /regex/)
  -C, --cwd <path>         Working directory
  -s, --silent             No output
  -v, --version            Show version
      --sort <type>        Sort output: name-asc | name-desc | diff-asc | diff-desc
      --fail-on-outdated   Exit with code 1 if any outdated dependencies are found
  -l, --include-locked     Include exact == version pins
      --maturity-period <n>
                            Require a release to be at least n days old
      --maturity-period-exclude <deps>
                            Bypass the maturity period for selected packages
      --config <path>      Read settings from a taze.toml file
      --concurrency <n>    Number of concurrent PyPI requests (default: 10)
      --json               Machine-readable JSON output

---

Output

  📦  pyproject.toml  /home/user/myproject/pyproject.toml

  dependencies  3 outdated
    packaging  ~8mo  >=25.2     →  >=26.2     ~3mo  MAJOR
    rich       ~4mo  >=14.0.0   →  >=15.0.0   ~3d   MAJOR
    typer      ~6mo  >=0.25.7   →  >=0.26.7   ~3d   minor

  group:dev  1 outdated
    ruff       ~8mo  >=0.14.1   →  >=0.15.19  ~1d   minor

  Run taze -w to write 4 update(s) to pyproject.toml

The age columns show how old the current pinned version is and how recently the latest version was released — green for < 4 weeks, yellow for < 6 months, red for older.

---

Supported file formats

File	Section
pyproject.toml	[project] dependencies
pyproject.toml	[project.optional-dependencies.*]
pyproject.toml	[dependency-groups.*] (PEP 735)
pyproject.toml	[tool.uv.dev-dependencies]
pyproject.toml	[tool.pdm.dev-dependencies.*]
pyproject.toml	[tool.hatch.envs.*.dependencies]
requirements*.txt	Standard pip format

---

Monorepos

taze -r finds supported dependency files under the working directory. It skips virtual environments, build/cache directories, and nested repositories/workspaces by default. Use --ignore-paths examples/**,vendor/** for additional exclusions, or --include-other-workspaces to deliberately scan nested workspaces.

Project names declared in workspace pyproject.toml files are recognised as local packages and are not looked up on PyPI.

Configuration

Place options in taze.toml or in the [tool.taze] table of pyproject.toml. CLI values take precedence over project configuration.

[tool.taze]
recursive = true
ignore-paths = ["examples/**", "vendor/**"]
maturity-period = 7
maturity-period-exclude = "internal-tools"
include-locked = false

[tool.taze.package-mode]
django = "minor"
"/pytest-.*/" = "patch"
setuptools = "ignore"

package-mode accepts every mode listed above, plus ignore. Exact package names and slash-delimited regular expressions are supported.

Installation

taze -i writes updates, then chooses an installer from the project metadata: uv sync, poetry install, pdm install, or pixi install. -u is an alias for -i.

---

License

MIT