← 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 reference drops the craft-parts "Dependencies" section (uv-deps part / astral-uv build-snap) that explains how to provide uv, causing user confusion. Triaged, still open (SNAPCRAFT-1250).

Suggested action: keep open

Reason: Verified the root cause directly: docs/reference/plugins/uv_plugin.rst includes the upstream file with `:end-before: .. _uv-details-begin:` then `:start-after: .. _uv-details-end:`, and in craft-parts' uv_plugin.rst the entire "Dependencies" section (lines 98-115, explaining the uv-deps part and the astral-uv build-snap) sits exactly between those two markers, so it is silently excluded. Grepping snapcraft for 'uv-deps'/'astral' finds no docs coverage at all. The issue is valid, labelled Status: Triaged / Type: Documentation, has an internal ticket SNAPCRAFT-1250, and lengau's comment ("This will be way easier if/when the uv snap becomes an official Canonical snap") only defers the preferred solution rather than resolving the gap.

Evaluated by: mr-cal-bot

Impact: 45 Quick Win: 23 Complexity: 40 Confidence: 86 Actionability: 85

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
stealth/space-bunny-alpha
Impact: 45
Quick Win: 23
Complexity: 40
Confidence: 86
Actionability: 85
keep open Snapcraft's uv plugin reference drops the craft-parts "Dependencies" section (uv-deps part / astral-uv build-snap) that explains how to provide uv, causing user confusion. Triaged, still open (SNAPCRAFT-1250).
qwen/qwen3.6-35b-a3b
Impact: 30
Quick Win: 22
Complexity: 10
Confidence: 85
Actionability: 80
keep open Snapcraft's uv plugin docs exclude the Dependencies section that explains how to provide uv (via uv-deps part or astral-uv snap), causing user confusion.
qwen/qwen3.8-27b
Impact: 40
Quick Win: 36
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.

Update history

No update history recorded yet.

Related work

  • Related To: charmcraft#2238 (confidence 60%)

    Sibling project already closed the equivalent gap by documenting installing uv in the build environment via the astral-uv snap (PR #2413), showing the concrete remedy for this class of issue.

Related issues

Issue Project State Summary Similarity
#5187 Add support for uv plugin snapcraft closed UV plugin support was added by merged PR #5196 in commit 800823a55, enabling Snapcraft users to build parts with the craft-parts uv plugin.
70%