Quick Look

Build a layer in a container, check it, then zip, upload, and publish it:

from pathlib import Path

import boto3
from s3pathlib.api import S3Path
import aws_lbd_art_builder_uv.api as aws_lbd_art_builder_uv

layer_api = aws_lbd_art_builder_uv.layer_api
path_pyproject_toml = Path("/path/to/my_app-project/pyproject.toml")

builder = layer_api.UvLambdaLayerContainerBuilder(
    path_pyproject_toml=path_pyproject_toml,
    py_ver_major=3,
    py_ver_minor=12,
    is_arm=False,
    skip_prompt=True,
    uv_sync_options=layer_api.UvSyncOptions(extras=["aws"]),
)
builder.run()
layer_api.validate_artifacts(
    dir_python=builder.path_layout.dir_python,
    path_pyproject_toml=path_pyproject_toml,
    check_linux=True,
    extras=["aws"],
)

boto_ses = boto3.Session()
s3dir_lambda = S3Path("s3://my-bucket/projects/my_app/lambda/")
layer_api.create_layer_zip_file(
    dir_python=builder.path_layout.dir_python,
    path_layer_zip=builder.path_layout.path_build_lambda_layer_zip,
)
layer_api.upload_layer_zip_to_s3(
    s3_client=boto_ses.client("s3"),
    path_pyproject_toml=path_pyproject_toml,
    s3dir_lambda=s3dir_lambda,
    path_manifest=path_pyproject_toml.parent / "uv.lock",
)
deployment = layer_api.LambdaLayerVersionPublisher(
    path_pyproject_toml=path_pyproject_toml,
    s3dir_lambda=s3dir_lambda,
    path_manifest=path_pyproject_toml.parent / "uv.lock",
    s3_client=boto_ses.client("s3"),
    layer_name="my_app",
    lambda_client=boto_ses.client("lambda"),
).run()  # raises ValueError if uv.lock is unchanged since the last version
print(deployment.layer_version_arn)

Pass plain boto3 clients. S3 locations are s3pathlib 3.x S3Path objects. The project needs a .venv with the same Python minor version as the build (uv venv --python 3.12). Core’s LayerDeploymentWorkflow runs the same steps in one call with either builder.

Install

aws_lbd_art_builder_uv is released on PyPI and supports Python 3.11 to 3.14. It needs uv on PATH, and Docker for container builds. The base install builds and validates layers; uploading and publishing need an extra:

$ pip install aws-lbd-art-builder-uv                  # build and validate
$ pip install "aws-lbd-art-builder-uv[upload]"        # + S3 upload (boto3, s3pathlib 3.x)
$ pip install "aws-lbd-art-builder-uv[publish]"       # + publish Lambda layer versions

To upgrade to latest version:

$ pip install --upgrade "aws-lbd-art-builder-uv[publish]"

Upgrading from 0.x: 1.0.0 requires aws_lbd_art_builder_core 1.x, which moved to s3pathlib 3.x and no longer accepts a BotoSesManager as s3_client; see the release history.