pdm-bin-dir 1.0.7

PDM plugin that allows additional directories listed in pyproject.toml to be added to environment PATH

pdm-bin-dir

pdm-bin-dir is a PDM plugin that automatically prepends additional project directories to PATH when running commands via PDM. This lets you place helper scripts alongside your project and run them as plain commands — no prefix or activation needed.

Requirements

• Python 3.10 or later
• PDM 2.0 or later

Installation

Install the plugin into PDM's own environment:

pdm self add pdm-bin-dir

Usage

The plugin is opt-in per project: it has no effect unless [tool.pdm.plugin.bin-dir] is present in the project's pyproject.toml. Once configured, the listed directories are prepended to PATH before every pdm run … invocation.

Configuration

Add to your project's pyproject.toml:

[tool.pdm.plugin.bin-dir]
dirs = ["bin", "scripts"]

Paths are relative to the project root. Absolute paths are also accepted. The default is an empty list (no directories added).

pdm bin-dir command

The plugin registers a bin-dir sub-command for inspecting and changing the configuration:

# Show current configured directories (JSON array)
pdm bin-dir show

# Replace the list
pdm bin-dir set bin scripts

# Append to the list (duplicates are silently skipped)
pdm bin-dir add tools

Changes made via set / add are written back to pyproject.toml.

License

MIT. See LICENSE.

---

For development and release workflow documentation, see CONTRIBUTING.md.