← Back to issue list

The uv plugin reference does not explain the dependencies

View original Github issue

Metadata

Project
snapcraft
Number
#5827
Type
issue
State
open
Author
bepri
Labels
Status: Triaged Type: Documentation
Created
Updated
Closed
—

Current evaluation

Snapcraft's uv plugin docs omit the craft-parts 'Dependencies' section (uv-deps/astral-uv provisioning), causing user confusion. Triaged, tracked as SNAPCRAFT-1250, awaiting a doc fix.

Suggested action: keep open

Reason: Triaged (Status: Triaged, Type: Documentation) and tracked as SNAPCRAFT-1250, with a maintainer comment (2025-10-23) noting the fix will be easier once uv becomes an official Canonical snap. The underlying doc gap is still present: snapcraft's uv_plugin.rst includes the craft-parts file but the Dependencies section is not surfaced in the snapcraft docs, so the issue remains valid and should stay open.

Impact: 40 Quick Win: 36.0 Staleness: 55 Complexity: 10 Confidence: 80 Support Request: 10

Issue body

### What needs to get done Craft Parts' documentation talks about the need for `uv-deps` or some other provisioning method for uv itself before building a part with it: https://canonical-craft-parts.readthedocs-hosted.com/latest/common/craft-parts/reference/plugins/uv_plugin/#dependencies Snapcraft appears to drop this information entirely: https://canonical-craft-parts.readthedocs-hosted.com/latest/common/craft-parts/reference/plugins/uv_plugin/#dependencies ### Why it needs to get done This information should be kept to avoid confusion, such as that in [this forum post](https://forum.snapcraft.io/t/uv-plugin-environment-validation-failed/48929)

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.8-27b
Impact: 40
Quick Win: 36.0
Staleness: 55
Complexity: 10
Confidence: 80
Support Request: 10
keep open Snapcraft's uv plugin docs omit the craft-parts 'Dependencies' section (uv-deps/astral-uv provisioning), causing user confusion. Triaged, tracked as SNAPCRAFT-1250, awaiting a doc fix.
qwen/qwen3.6-35b-a3b
Staleness: 45
Complexity: 20
Confidence: 85
Support Request: 10
keep open Documentation issue: Snapcraft docs lack dependency info for uv plugin present in Craft Parts docs. Triaged, awaiting resolution. Bot created internal ticket.
qwen3.6-35b-a3b-mtp-q6
Staleness: 70
Complexity: 10
Confidence: 85
Support Request: 0
keep open Snapcraft uv plugin docs lack dependency instructions found in Craft Parts, causing user confusion. Issue is triaged but inactive for over eight months.
qwen3.6-35b-a3b-mtp-q6
Staleness: 65
Complexity: 15
Confidence: 85
Support Request: 0
keep open Snapcraft uv plugin documentation omits required dependency setup instructions present in Craft Parts. Triaged with an internal ticket created, awaiting a docs update or the official uv snap release.

Update history

No update history recorded yet.

Related work

  • Related To: craft-parts#1486 (confidence 60%)

    craft-parts 'docs: update uv plugin reference' touched the same uv_plugin.rst shared doc; relevant context for the Dependencies section.

Related issues

No related issues found above the similarity threshold.