Feature request: Add native uv support and configuration
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 38/100
- issue の種類
- 機能追加
- 明瞭さ
- おおむね明確
- 活発さ
- 静か
- 技術スタック
- python
- 領域
- build-system
調査の方向性
aws_lambda_builders/workflows/python_uv/DESIGN.md から始め、エクスポートオプション、インストール設定、キャッシュされた依存関係のコピーに関連すると issue で特定されている packager.py と workflow.py を調査してください。文書化されている高度な設定と報告された要件を比較してください。完了の条件は、サポート対象の uv 設定とローカルパッケージの動作が定義され、報告されたビルド失敗が解消されていることです。
索引モデルが issue の本文から書いたものです。
説明
Describe your idea/feature/enhancement
I wish the AWS Lambda Builders would support native uv usage instead of using uv export to facilitate dependency management (as designed here).
I know that experimental uv support was just added (related: https://github.com/aws/aws-lambda-builders/pull/756 and https://github.com/aws/aws-lambda-builders/issues/818). It mirrors the workaround I've been using for a while, but lacks certain capabilities that I need (and also have workarounds for).
Additional Details
It would be nice to be able to pass certain variables or arguments in order to use specific uv features, like described below
- I noticed that the
uv exportdoesn't include a--no-dev, which bloats the final artifact:
This seems to be in conflict with one statement from the design document:
- Currently,
--no-hashesis hard coded, but in my environment I do require hashes in mypyproject.toml. This causes an issue because my[tool.uv.pip]config leaks into the builder subprocess, causing a conflict.
I'm not sure what phase things are currently in, given this is deployed, but still experimental, but I did note the following:
Which mentions "Advanced configuration options", and so it may be planned, future work to add support for --no-dev, etc.
- It would be very useful to be able to natively mount a local package into the final build artifact. I already support this in my flow which wraps
aws-lambda-builder/sambut I'd rather it be supported natively
I had Opus 4.6 do a write-up of some of the details/issues it had migrating from my current workaround to the new experimental approach, which may be helpful. I'm doing this with the sam cli.
Details
Upstream Issues in aws-lambda-builders UV Workflow
All bugs are in the experimental PythonUvBuilder workflow (aws-lambda-builders, shipped with SAM CLI >= 1.155.2). The
relevant code lives in aws_lambda_builders/workflows/python_uv/.
Bug 1: Dev dependencies included in build artifact
File: packager.py, _build_from_lock_file() ~line 326-338
Problem: The uv export command is missing --no-dev. All dependencies from [dependency-groups] dev in pyproject.toml
are exported and installed into the Lambda artifact.
Impact: Build artifact balloons from ~144M to ~408M (in our case), including pytest, pyright, cfn-lint, coverage,
etc. Exceeds Lambda's 250MB unzipped size limit.
Expected: uv export should include --no-dev to exclude development dependencies from production builds.
Current code:
export_args = [
"export",
"--format", "requirements.txt",
"--no-emit-project",
"--no-hashes",
"--output-file", temp_requirements,
"--python", python_version,
]
Fix: Add "--no-dev" to export_args.
---
Bug 2: --cached mode fails with CopyDependenciesAction
File: workflow.py, _setup_build_actions() ~line 142-151
Problem: When --cached is used (i.e. dependencies_dir is set), deps are installed to .aws-sam/deps/<uuid>/ but the
CopyDependenciesAction is constructed with swapped semantics. It tries to os.listdir(artifact_dir)
(.aws-sam/build/ExampleFunction) which doesn't exist yet — the deps are in destination_dir (.aws-sam/deps/).
Error: [Errno 2] No such file or directory: '.aws-sam/build/ExampleFunction'
Current code:
CopyDependenciesAction(
source_dir=source_dir,
artifact_dir=artifacts_dir, # .aws-sam/build/ExampleFunction (empty)
destination_dir=self.dependencies_dir, # .aws-sam/deps/... (has deps)
)
The DependencyManager.yield_source_dest() does os.listdir(self._artifact_dir) then copies FROM artifact_dir TO
dest_dir — which is backwards. Deps are in dependencies_dir but it tries to read from artifacts_dir.
Impact: Every sam build with --cached fails for the UV workflow. Without --cached, builds always re-download deps.
---
Bug 3: [tool.uv.pip] config leaks into builder subprocess
File: packager.py, _build_from_lock_file() ~line 345-353
Problem: The uv pip install command runs with cwd=project_dir, which makes uv read [tool.uv.pip] settings from the
project's pyproject.toml. If the project has require-hashes = true (common security practice), but the builder
exported with --no-hashes, uv pip install fails because it requires hashes that aren't present.
Error: error: In --require-hashes mode, all requirements must have a hash, but none were provided for: aenum==3.1.16
Root cause: The builder explicitly exports with --no-hashes (line 331) but doesn't account for the project's
[tool.uv.pip] config overriding the install behavior. The uv pip install inherits the project's pyproject.toml
settings since it runs from the project directory.
Possible fixes:
- Pass --no-verify-hashes to the uv pip install command
- Run uv pip install with UV_NO_VERIFY_HASHES=true in the subprocess env
- Export WITH hashes instead of --no-hashes (then the require-hashes config is satisfied)
- Run uv pip install from a temp dir without pyproject.toml context
---
Our Workarounds
┌────────────────────────┬───────────────────────────────────────────────────────────────────────────┐
│ Bug │ Workaround │
├────────────────────────┼───────────────────────────────────────────────────────────────────────────┤
│ Bug 1 (dev deps) │ Generate our own uv export --no-dev requirements file, pass as --manifest │
├────────────────────────┼───────────────────────────────────────────────────────────────────────────┤
│ Bug 2 (--cached) │ Don't use --cached flag │
├────────────────────────┼───────────────────────────────────────────────────────────────────────────┤
│ Bug 3 (require-hashes) │ Removed generate-hashes/require-hashes from pyproject.toml [tool.uv.pip] │
└────────────────────────┴───────────────────────────────────────────────────────────────────────────┘
Bugs 1 and 2 are worked around by the same mechanism: since we generate our own requirements-*.txt via uv export
--no-dev --no-hashes --frozen --no-emit-project, the lambda-builders use the _build_from_requirements path (simple uv
pip install -r) instead of the buggy _build_from_lock_file path. This also avoids the --cached
CopyDependenciesAction issue since we don't use --cached.
- 主要言語
- Python
- スター
- 381
- フォーク
- 162
- 平均マージ
- 1日 1時間
- マージ済み PR(30日)
- 2
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
aws/aws-lambda-builders のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
aws/aws-lambda-builders#925 · リアクション 1 件 ·
-
難易度 4/5 3〜5日 初心者へのやさしさ 64/100
aws/aws-lambda-builders#924 · コメント 1 件 · リアクション 1 件 ·
-
Bug: PythonUvBuilder fails to build app with dependencies on editable installs in the workspace オープンstage/needs-triage
難易度 3/5 1〜2日 初心者へのやさしさ 25/100
aws/aws-lambda-builders#892 ·
-
area/build contributors/good-first-issue contributors/welcome type/feature
難易度 4/5 3〜5日 初心者へのやさしさ 38/100
aws/aws-lambda-builders#831 · コメント 3 件 ·
-
blocked/more-info-needed type/feature
難易度 5/5 1週間以上 初心者へのやさしさ 25/100
aws/aws-lambda-builders#713 · コメント 2 件 ·
aws/aws-lambda-builders の issue をすべて見る
似ている issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 75/100
-
hcocena オープンpolicies-accepted pre-review precheck-passed
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
Bioconductor/BiocContributions#214 · コメント 5 件 ·
-
難易度 1/5 1時間未満 初心者へのやさしさ 92/100
TencentCloud/Octop#1169 · コメント 1 件 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
521xueweihan/HelloGitHub#3778 ·
-
The version checker's trailing attribute region has no control for a less-than inside a quoted value オープンarea: dashboard area: tests bug perceived difficulty: 2 python
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
Nitjsefnie-Harness-Commons/daedalus#1105 · コメント 1 件 ·