feat: Python UV workflow (aws#756)

* feat: Python UV workflow

Core Features:
 * Intelligent handling of pyproject.toml with automatic uv.lock detection
 * Multi-format support: pyproject.toml, requirements.txt, and requirements-*.txt variants
 * Lock file optimization: Automatic uv.lock usage for reproducible builds when available
 * Platform targeting: Lambda-compatible builds for x86_64 and ARM64 architectures
 * Python version control: Precise Python version targeting via UV's --python flags

UV Functionality:
* `uv sync --python X.Y` for lock-based builds (pyproject.toml + uv.lock)
* `uv lock && uv export` workflow for pyproject.toml without lock files
* `uv pip install --python-version X.Y --python-platform` for requirements.txt
* Proper virtual environment handling and site-packages extraction

Documentation:
* Complete DESIGN.md with architecture overview and usage patterns
* Accurate API documentation reflecting constructor + method call pattern
* Smart dispatch logic clearly explained with examples
* Updated to match actual implementation (no outdated references)

Compatibility:
* Compatible with existing Lambda Builders interface
* Supports standard build parameters (source_dir, artifacts_dir, scratch_dir)
* Runtime parameter properly extracted and used for Python version targeting
* Architecture parameter mapped to UV platform specifications

* tests: additional functional tests for python_uv

* fix(): address comments

* fix: address comments - round 2

* fix(additional tests cases): python-uv

* chore(README.md): update with python uv support

* fix: have lock file builds run in cwd

* fix: misc pr feedback

* cd: setup uv for unit tests

* nit: format

* test: remove hardcoded pathsep

---------

Co-authored-by: Roger Zhang <roger.zhang.cs@gmail.com>
Co-authored-by: Reed Hamilton <reedham@amazon.com>
Co-authored-by: vicheey <181402101+vicheey@users.noreply.github.com>

Author: 4 people

.github/workflows/build.yml

@@ -30,7 +30,8 @@ jobs:
       - java-maven-integration
       - java-gradle-integration
       - custom-make-integration
-      - python-integration
+      - python-pip-integration
+      - python-uv-integration
       - ruby-integration
       - dotnet-integration
       - rust-cargo-lambda-integration
@@ -44,7 +45,8 @@ jobs:
           needs.java-maven-integration.result != 'success' ||
           needs.java-gradle-integration.result != 'success' ||
           needs.custom-make-integration.result != 'success' ||
-          needs.python-integration.result != 'success' ||
+          needs.python-pip-integration.result != 'success' ||
+          needs.python-uv-integration.result != 'success' ||
           needs.ruby-integration.result != 'success' ||
           needs.dotnet-integration.result != 'success' ||
           needs.rust-cargo-lambda-integration.result != 'success'
@@ -74,6 +76,7 @@ jobs:
       - uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python }}
+      - uses: astral-sh/setup-uv@v4
       - name: Unit Testing
         run: make pr
       - name: Functional Testing
@@ -248,8 +251,37 @@ jobs:
       - run: make init
       - run: pytest -vv tests/integration/workflows/custom_make
 
-  python-integration:
-    name: ${{ matrix.os }} / ${{ matrix.python }} / python
+  python-pip-integration:
+    name: ${{ matrix.os }} / ${{ matrix.python }} / python-pip
+    if: github.repository_owner == 'aws'
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+          - windows-latest
+        python:
+          - "3.9"
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: |
+          python -m pip install --upgrade pip
+          pip install --upgrade setuptools
+        if: ${{ matrix.os }} == 'ubuntu-latest' && ${{ matrix.python }} == '3.12'
+      - run: make init
+      - run: pytest -vv tests/integration/workflows/python_pip
+
+  python-uv-integration:
+    name: ${{ matrix.os }} / ${{ matrix.python }} / python-uv
     if: github.repository_owner == 'aws'
     runs-on: ${{ matrix.os }}
     strategy:
@@ -274,8 +306,13 @@ jobs:
           python -m pip install --upgrade pip
           pip install --upgrade setuptools
         if: ${{ matrix.os }} == 'ubuntu-latest' && ${{ matrix.python }} == '3.12'
+      # Install UV for python_uv workflow tests
+      - name: Install UV
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
       - run: make init
-      - run: pytest -vv tests/integration/workflows/python_pip
+      - run: pytest -vv tests/integration/workflows/python_uv
 
   ruby-integration:
     name: ${{ matrix.os }} / ${{ matrix.python }} / ruby

README.md

@@ -14,6 +14,7 @@ Lambda Builders currently contains the following workflows
 * Java with Maven
 * Dotnet with amazon.lambda.tools
 * Python with Pip
+* Python with Uv (beta)
 * Javascript with Npm
 * Typescript with esbuild
 * Ruby with Bundler

aws_lambda_builders/workflows/__init__.py

@@ -10,5 +10,6 @@
 import aws_lambda_builders.workflows.nodejs_npm
 import aws_lambda_builders.workflows.nodejs_npm_esbuild
 import aws_lambda_builders.workflows.python_pip
+import aws_lambda_builders.workflows.python_uv
 import aws_lambda_builders.workflows.ruby_bundler
 import aws_lambda_builders.workflows.rust_cargo