# Feature catalog — python-poetry/poetry

> Canonical page: https://codevetter.com/unpack/poetry/feature-catalog

# Feature catalog — python-poetry/poetry

Scanned commit d4fd21e4711ae948f04e18a1736d9ee85b590e87 (2026-09-27). Generated by codevetter codevetter 1.15.0 on 2026-10-02.

Source inspection; upstream code and tests were not executed.

The inspected command table spans project creation, dependency changes, installation, packaging, diagnostics, environments, sources, and Poetry's own runtime. Dependency operations expose groups, extras, dry runs, lock-only execution, and synchronization. Build and publish integrate with Python packaging backends and package indexes. Plugin-provided commands and documented compatibility limits extend or qualify the built-in surface.
- new creates a project with a default src layout; init interactively creates pyproject.toml; version displays or changes the project version using PEP 440 values or bump rules. — [docs/cli.md#L453-L471](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L453-L471) [docs/cli.md#L639-L658](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L639-L658) [docs/cli.md#L1404-L1412](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L1404-L1412)
- add accepts names, constraints, Git references/subdirectories, files, directories, and URLs; remove is registered alongside update, whose documented behavior preserves pyproject constraints while refreshing compatible locked versions. — [src/poetry/console/commands/add.py#L95-L116](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/src/poetry/console/commands/add.py#L95-L116) [src/poetry/console/application.py#L54-L71](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/src/poetry/console/application.py#L54-L71) [docs/cli.md#L1352-L1382](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L1352-L1382)
- install supports group selection, extras, no-root/no-directory, bytecode compilation, and dry runs; sync additionally removes packages outside the desired lock state; lock preserves existing versions unless --regenerate is used. — [src/poetry/console/commands/install.py#L21-L60](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/src/poetry/console/commands/install.py#L21-L60) [docs/cli.md#L1234-L1247](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L1234-L1247) [src/poetry/console/commands/lock.py#L19-L44](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/src/poetry/console/commands/lock.py#L19-L44)
- build selects direct poetry-core builders or isolated backend builds; publish targets PyPI by default or a configured repository and accepts certificates, dry-run, and skip-existing behavior. — [src/poetry/console/commands/build.py#L52-L118](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/src/poetry/console/commands/build.py#L52-L118) [src/poetry/publishing/publisher.py#L43-L99](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/src/poetry/publishing/publisher.py#L43-L99)
- env exposes activate/info/list/remove/use, with activate printing shell instructions; run executes environment commands or configured script callables; python install/list/remove manages or discovers interpreters, including standalone builds. — [src/poetry/console/application.py#L79-L88](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/src/poetry/console/application.py#L79-L88) [docs/cli.md#L354-L360](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L354-L360) [src/poetry/console/commands/run.py#L25-L37](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/src/poetry/console/commands/run.py#L25-L37) [docs/cli.md#L766-L816](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L766-L816)
- source add/show/remove manages project indexes with primary/supplemental/explicit priorities; config lists, sets, unsets, migrates, or applies local settings; cache clear/list manages cached repository entries. — [docs/cli.md#L1182-L1228](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L1182-L1228) [docs/cli.md#L296-L326](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L296-L326) [docs/cli.md#L243-L271](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L243-L271)
- about reports Poetry/core versions; check validates project and lock consistency; debug info/resolve/tags diagnoses environments and resolution; show lists packages; search queries remote indexes with a documented PyPI browser requirement. — [docs/cli.md#L50-L52](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L50-L52) [docs/cli.md#L277-L345](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L277-L345) [docs/cli.md#L1138-L1146](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L1138-L1146) [docs/cli.md#L942-L955](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L942-L955)
- self add/install/lock/remove/show/show plugins/sync/update manages Poetry's runtime and addons; project-required plugins can install under .poetry/plugins, while export and shell are documented plugin commands. — [src/poetry/console/application.py#L89-L97](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/src/poetry/console/application.py#L89-L97) [docs/cli.md#L958-L964](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L958-L964) [docs/plugins.md#L258-L280](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/plugins.md#L258-L280) [docs/cli.md#L406-L419](https://github.com/python-poetry/poetry/blob/d4fd21e4711ae948f04e18a1736d9ee85b590e87/docs/cli.md#L406-L419)

Every claim links to its cited files at the pinned commit. Citations identify source evidence; they do not establish runtime correctness. Independent CodeVetter scan — not reviewed by upstream maintainers.

## Public product links

- [CodeVetter](https://codevetter.com/)
- [Download](https://codevetter.com/download)
- [Documentation](https://codevetter.com/docs/)
- [Source](https://github.com/Codevetter/codevetter)