Python
/
uv
mirror of https://github.com/astral-sh/uv
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
uv/crates
History
konsti 4ac78f673b
Build backend: Switch to custom glob-walkdir implementation (#9013) 
When doing a directory traversal for source dist inclusion, we want to
offer the user include and exclude options, and we want to avoid
traversing irrelevant directories. The latter is important for
performance, especially on network file systems, but also with large
data directories, or (not-included) directories with other permissions.
To support this, we introduce `GlobDirFilter`, which uses a DFA from
regex_automata to determine whether any children of a directory can be
included and skips the directory if not.

The globs are based on PEP 639. The syntax is more restricted than glob
or globset, but it's standardized. I chose it over glob or globset
because we're already using this syntax for `project.license-files` a
required by PEP 639, so it makes sense to use the same globs for all
includes (see e.g.
4f52a3bb62/pyproject.toml (L36-L48)
for example with same semantics for include and exclude)

### Semantics

Glob semantics are complex due to mixing directories and files,
expectations around simplicity and our need to exclude most of the tree
in the project from traversal. The current draft uses a syntax that
optimizes for simple default use cases for the start.

#### includes

Glob expressions which files and directories to include in the source
distribution.

Includes are anchored, which means that `pyproject.toml` includes only
`<project root>/pyproject.toml`. Use for example `assets/**/sample.csv`
to include for all
`sample.csv` files in `<project root>/assets` or any child directory. To
recursively include
all files under a directory, use a `/**` suffix, e.g. `src/**`. For
performance and
reproducibility, avoid unanchored matches such as `**/sample.csv`.

The glob syntax is the reduced portable glob from
[PEP 639](https://peps.python.org/pep-0639/#add-license-FILES-key).

#### excludes

Glob expressions which files and directories to exclude from the
previous source
distribution includes.

Excludes are not, which means that `__pycache__` excludes all
directories named
`__pycache__` and it's children anywhere. To anchor a directory, use a
`/` prefix, e.g.,
`/dist` will exclude only `<project root>/dist`.

The glob syntax is the reduced portable glob from
[PEP 639](https://peps.python.org/pep-0639/#add-license-FILES-key).
 		2024-11-14 13:14:58 +00:00
..
uv Build backend: Switch to custom glob-walkdir implementation (#9013) 2024-11-14 13:14:58 +00:00
uv-auth Document `.netrc` environment variable and path (#8511) 2024-10-24 02:34:45 +00:00
uv-bench *: update "conflicting groups" terminology everywhere else 2024-11-14 08:02:46 -05:00
uv-build-backend Build backend: Switch to custom glob-walkdir implementation (#9013) 2024-11-14 13:14:58 +00:00
uv-build-frontend Add dedicated cache method for creating build directories (#8910) 2024-11-08 00:50:55 +00:00
uv-cache Add dedicated cache method for creating build directories (#8910) 2024-11-08 00:50:55 +00:00
uv-cache-info Improve error message for cache info serialization (#8500) 2024-10-23 13:17:31 +00:00
uv-cache-key chore: Move all integration tests to a single binary (#8093) 2024-10-11 16:41:35 +02:00
uv-cli doc: tweak docs a bit 2024-11-14 08:02:46 -05:00
uv-client Extend BaseClient to accept extra middleware (#8807) 2024-11-04 07:04:26 -06:00
uv-configuration Add `--no-group` support to CLI (#8477) 2024-10-25 13:27:37 -05:00
uv-console Support interactive input in `uv publish` (#8158) 2024-10-15 10:00:43 +02:00
uv-dev Update format of environment variable reference (#9018) 2024-11-11 12:41:33 -06:00
uv-dirs Eliminate dependencies on `directores` and `dirs-sys` (#8048) 2024-11-07 14:29:54 -06:00
uv-dispatch uv-pypi-types: rename "conflicting group" types to more generic "conflicts" 2024-11-14 08:02:46 -05:00
uv-distribution Update Rust crate url to v2.5.3 (#9002) 2024-11-11 14:49:31 +00:00
uv-distribution-filename Add `uv tree --outdated` (#8893) 2024-11-07 14:10:46 -06:00
uv-distribution-types Convert to `RequirementSource` rather than `Requirement` (#9107) 2024-11-13 20:00:13 -05:00
uv-extract Sanitize filenames during zip extraction (#8732) 2024-10-31 19:12:51 +00:00
uv-fs Add support for installing versioned Python executables on Windows (#8663) 2024-10-31 15:58:35 +00:00
uv-git Allow dependency metadata entries for direct URL requirements (#7846) 2024-10-22 22:01:23 -04:00
uv-globfilter Build backend: Switch to custom glob-walkdir implementation (#9013) 2024-11-14 13:14:58 +00:00
uv-install-wheel Build backend: Switch to custom glob-walkdir implementation (#9013) 2024-11-14 13:14:58 +00:00
uv-installer Convert to `RequirementSource` rather than `Requirement` (#9107) 2024-11-13 20:00:13 -05:00
uv-macros Generate environment variables doc from code (#8493) 2024-11-03 08:31:38 -06:00
uv-metadata chore: Move all integration tests to a single binary (#8093) 2024-10-11 16:41:35 +02:00
uv-normalize uv-normalize: add `as_str` method 2024-11-04 11:09:06 -05:00
uv-once-map Use shared resolver state between add and lock (#8146) 2024-10-12 14:58:07 +00:00
uv-options-metadata chore: Move all integration tests to a single binary (#8093) 2024-10-11 16:41:35 +02:00
uv-pep440 Typo fixes (#9057) 2024-11-12 13:45:22 +00:00
uv-pep508 Allow semicolons directly after direct URLs (#8836) 2024-11-05 16:07:07 -05:00
uv-performance-flate2-backend Run `cargo update` (#8703) 2024-11-01 10:26:21 -04:00
uv-performance-memory-allocator Run `cargo update` (#8703) 2024-11-01 10:26:21 -04:00
uv-platform-tags Allow installation of manylinux wheels on riscv64 (#8934) 2024-11-08 16:57:51 +01:00
uv-publish Publish: Ignore non-matching files (#8986) 2024-11-13 12:58:28 +01:00
uv-pypi-types uv-pypi-types: make 'contains' methods generic 2024-11-14 08:02:46 -05:00
uv-python Remove duplicate log when searching for interpreters (#9092) 2024-11-13 11:25:42 -06:00
uv-requirements Consistently box distributions in fetch and build errors (#9038) 2024-11-12 02:19:38 +00:00
uv-requirements-txt Allow semicolons directly after direct URLs (#8836) 2024-11-05 16:07:07 -05:00
uv-resolver uv-resolver: support conflicting groups 2024-11-14 08:02:46 -05:00
uv-scripts Discover and respect `.python-version` files in parent directories (#6370) 2024-11-07 14:29:54 -06:00
uv-settings *: update "conflicting groups" terminology everywhere else 2024-11-14 08:02:46 -05:00
uv-shell chore: unify all env vars used (#8151) 2024-10-14 16:48:13 -05:00
uv-state Add `uv-dirs` to consolidate directory lookup methods (#8453) 2024-10-22 11:33:25 -05:00
uv-static Remove some missed references to `~/.cargo/bin` (#8936) 2024-11-08 07:29:32 -06:00
uv-tool Eliminate dependencies on `directores` and `dirs-sys` (#8048) 2024-11-07 14:29:54 -06:00
uv-trampoline Update Rust crate anyhow to v1.0.93 (#8996) 2024-11-11 02:13:34 +00:00
uv-trampoline-builder Add support for installing versioned Python executables on Windows (#8663) 2024-10-31 15:58:35 +00:00
uv-types Allow incompatible `requires-python` for source distributions with static metadata (#8768) 2024-11-03 19:03:55 +00:00
uv-version Bump to 0.5.1 (#8959) 2024-11-08 17:15:28 -06:00
uv-virtualenv Use base executable to set virtualenv Python path (#8481) 2024-11-07 14:29:54 -06:00
uv-warnings chore: Move all integration tests to a single binary (#8093) 2024-10-11 16:41:35 +02:00
uv-workspace doc: tweak docs a bit 2024-11-14 08:02:46 -05:00
README.md Link to Dependency specifiers instead of PEP 508 (#8411) 2024-10-21 14:43:38 -04:00

README.md

Crates

uv-bench

Functionality for benchmarking uv.

uv-cache-key

Generic functionality for caching paths, URLs, and other resources across platforms.

uv-distribution-filename

Parse built distribution (wheel) and source distribution (sdist) filenames to extract structured metadata.

uv-distribution-types

Abstractions for representing built distributions (wheels) and source distributions (sdists), and the sources from which they can be downloaded.

uv-install-wheel-rs

Install built distributions (wheels) into a virtual environment.

uv-once-map

A waitmap-like concurrent hash map for executing tasks exactly once.

uv-pep440-rs

Utilities for interacting with Python version numbers and specifiers.

uv-pep508-rs

Utilities for parsing and evaluating dependency specifiers, previously known as PEP 508.

uv-platform-tags

Functionality for parsing and inferring Python platform tags as per PEP 425.

uv-cli

Command-line interface for the uv package manager.

uv-build-frontend

A PEP 517-compatible build frontend for uv.

uv-cache

Functionality for caching Python packages and associated metadata.

uv-client

Client for interacting with PyPI-compatible HTTP APIs.

uv-dev

Development utilities for uv.

uv-dispatch

A centralized struct for resolving and building source distributions in isolated environments. Implements the traits defined in uv-types.

uv-distribution

Client for interacting with built distributions (wheels) and source distributions (sdists). Capable of fetching metadata, distribution contents, etc.

uv-extract

Utilities for extracting files from archives.

uv-fs

Utilities for interacting with the filesystem.

uv-git

Functionality for interacting with Git repositories.

uv-installer

Functionality for installing Python packages into a virtual environment.

uv-python

Functionality for detecting and leveraging the current Python interpreter.

uv-normalize

Normalize package and extra names as per Python specifications.

uv-requirements

Utilities for reading package requirements from pyproject.toml and requirements.txt files.

uv-resolver

Functionality for resolving Python packages and their dependencies.

uv-shell

Utilities for detecting and manipulating shell environments.

uv-types

Shared traits for uv, to avoid circular dependencies.

uv-pypi-types

General-purpose type definitions for types used in PyPI-compatible APIs.

uv-virtualenv

A venv replacement to create virtual environments in Rust.

uv-warnings

User-facing warnings for uv.

uv-workspace

Workspace abstractions for uv.

uv-requirements-txt

Functionality for parsing requirements.txt files.