--extra dev/docs not recognized by uv

[kshitijaucharmal]

Search before asking

• I have searched the Supervision issues and found no similar bug report.

Bug

When trying to install development dependencies from pyproject.toml using uv, the command fails if I use --extra dev --extra docs (as is mentioned in the guide

The pyproject.toml uses [dependency-groups] for dev, docs, and build, but uv only recognises them via --group, not --extra. This leads to a confusing developer experience since metrics is under [project.optional-dependencies] and does work with --extra metrics.

So,

• uv pip install -r pyproject.toml --extra metrics works
• uv pip install -r pyproject.toml --extra dev --extra docs fails with:

error: Requested extras not found: dev, docs

Also, this leads me to another bug (which I think will need to be fixed after this)
The guide) mentions you can install pre-commit by using --extra dev, but its missing from the pyproject.toml (not just the dev section) entirely, making the guide false.

Environment

• Supervision: develop branch
• Python: 3.13.7
• OS: 6.16.8-arch3-1
• uv: 0.8.13

Minimal Reproducible Example

Run:

uv pip install -r pyproject.toml --extra dev --extra docs --extra metrics

Result:

error: Requested extras not found: dev, docs

Additional

I want to contribute by submitting a PR, just want to know if I should just use [project.optional-dependencies] or [dependency-groups]
(I think first one would be better as the docs won't need to change)

Are you willing to submit a PR?

• Yes I'd like to help by submitting a PR!

[ArnabTechiee]

This is a great find! I'd be happy to submit a PR to fix this if you haven't already started. Please let me know!

[kshitijaucharmal]

Have the changes done already, haven't submitted a PR as I was waiting to be approved.
Thanks for confirming this problem, I'll be submitting the PR soon !

You could create another one for the pre-commit issue I found, mentioned in the description above after this is merged, as it depends on the dev extra to be working