Skip to content

Avoid rendering pyproject.toml suggestions for some settings#7

Closed
zanieb wants to merge 1 commit intomainfrom
claude/hide-uv-only-variables-BLWDl
Closed

Avoid rendering pyproject.toml suggestions for some settings#7
zanieb wants to merge 1 commit intomainfrom
claude/hide-uv-only-variables-BLWDl

Conversation

@zanieb
Copy link
Collaborator

@zanieb zanieb commented Jan 14, 2026

Following astral-sh#16918, mark additional system-level settings as uv_toml_only so they don't appear in the pyproject.toml documentation examples:

  • native-tls
  • cache-dir
  • python-install-mirror
  • pypy-install-mirror
  • python-downloads-json-url

Eventually, we'll want to ban these in the pyproject.toml without some opt-in.

Following astral-sh#16918, mark additional system-level settings as `uv_toml_only`
so they don't appear in the `pyproject.toml` documentation examples:

- `native-tls`: System-level TLS configuration that depends on the OS
  certificate store
- `cache-dir`: Machine-specific filesystem paths
- `python-install-mirror`: Organization-specific mirror URLs
- `pypy-install-mirror`: Organization-specific mirror URLs
- `python-downloads-json-url`: Organization-specific URLs

These settings are machine/user/organization-specific and shouldn't be
committed to VCS via `pyproject.toml`.
@zanieb zanieb marked this pull request as ready for review January 14, 2026 14:07
@zanieb zanieb added the documentation Improvements or additions to documentation label Jan 14, 2026
@zanieb zanieb changed the title Avoid rendering pyproject.toml suggestions for some additional settings Avoid rendering pyproject.toml suggestions for some settings Jan 14, 2026
@zanieb zanieb closed this Jan 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants