Allow users to specify a custom source package to uv tool run
#3677
Conversation
crates/uv/src/cli.rs
Outdated
| // TODO(zanieb): Consider using `Vec<String>` instead, treating the first as the target package | ||
| /// Use the given package specification instead of inferring it from the target command. | ||
| #[arg(long)] | ||
| pub(crate) package: Option<String>, |
There was a problem hiding this comment.
Open to some bike-shedding here.
pipx says
--spec SPEC
The package name or specific installation source passed to pip. Runs
pip install -U SPEC. For
example--spec mypackage==2.0.0or--spec git+https://github.com/user/repo.git@branch
which I find very unintuitive
There was a problem hiding this comment.
Hmm. package isn't bad but it might be confusing with -p in the workspace API. I find spec okay but don't feel strongly.
There was a problem hiding this comment.
Like -p being short for --python?
There was a problem hiding this comment.
Oh, I was assuming -p would be short for package in the workspace API, as it is in cargo (cargo test -p uv, etc.).
There was a problem hiding this comment.
Uh oh haha it's short for --python right now. We might need to reconsider that?
I'll think about this some more.
There was a problem hiding this comment.
--from? e.g. uv tool run --from foo -- bar or uv tool run --from git+https://github.com/user/repo.git@branch -- bar
There was a problem hiding this comment.
Dumb question, but how does it differ from --with?
There was a problem hiding this comment.
If you use --with (as in #3678), we will still infer the package that provides the tool from the command name so --with is additive while this flag replaces the inferred requirement.
I considered having the first --with package replace the inferred requirement but that seems confusing.
There was a problem hiding this comment.
This is especially important for installation where we won't install entry points from additional dependencies, just the tool package (and I'd expect the uv tool run semantics to match)
zanieb
force-pushed
the
zb/tool-run-spec
branch
2 times, most recently
from
cafe018 to
0ac2052
Compare
zanieb
changed the title
uv tool runuv tool run
We usually infer the package the tool is pulled from to be the same name as the tool itself, but that's not always the case. This allows users to provide a custom package.