How to uv add with markers?

[dimaqq]

Let's say I want to achieve tomli = { version = "~2.0", python = "<3.11" }.

How do I uv add it? I just can't figure out the syntax and docs don't help.

If manual edit of pyproject.toml is required, maybe there should be a separate page in the docs.

[zanieb]

Like this

❯ uv add --directory example "tomli>=2.0; python_version < '3.11'"

❯ cat example/pyproject.toml
[project]
name = "example"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
requires-python = ">=3.11"
dependencies = [
    "tomli>=2.0 ; python_full_version < '3.11'",
]

[zanieb]

cc @konstin / @charliermarsh should we support adding markers via a dedicated flag (or flags)?

[phi-friday]

Isn't it enough to point users to links?
like
https://peps.python.org/pep-0508/
https://peps.python.org/pep-0621/
https://packaging.python.org/en/latest/specifications/dependency-specifiers/

Of course, it would be nice to have more configurable options.

[dimaqq]

• uv add --help mentions PEP 508, which includes:
  • an example under the Examples heading, but it's unclear how to convert that to a single command line argument
  • a set of tests at the end of the PEP, that clarifies syntax, esp. quotation
• PEP 621 was not useful for me
• packaging dependency specifiers seems to be a copy of PEP 508

I personally would be very happy if the uv add usage had a short link to uv docs as opposed to naming PEP, and the uv docs contained additional examples.