aws-lambda-artifact-builder 0.1.8

Build and package AWS Lambda deployment artifacts: source code, dependency layers, and container images.

---

Welcome to aws_lambda_artifact_builder Documentation

AWS Lambda Artifact Builder is a comprehensive Python library that solves the deployment challenges every team faces when building Lambda applications. It provides battle-tested solutions for both Lambda Layer creation and deployment package building across pip, Poetry, and UV dependency managers.

Key Features:

• Multi-Tool Support: Seamless integration with pip, Poetry, and UV dependency managers

• Cross-Platform Builds: Container-based builds ensuring Linux compatibility from any development platform

• Private Repository Support: Built-in AWS CodeArtifact and private PyPI server integration

• Command Pattern Architecture: Granular control with simple builder.run() interface

• Enterprise Ready: Intelligent change detection, automated cleanup, cross-account layer sharing

• Complete Workflow: End-to-end automation from dependency installation to AWS deployment

The Problems It Solves:

• Platform compatibility issues (Windows/macOS → Linux Lambda runtime)

• Dependency separation complexity (stable layers vs changing application code)

• Build reproducibility across development, CI, and production environments

• Private repository authentication and credential management

• Storage optimization and version management

• Enterprise deployment workflows

Usage Examples

Lambda Source Artifacts (Deployment Packages):

Build application code packages for Lambda function deployment:

• example_1_build_lambda_source_using_pip_step_by_step.py: Step-by-step source building with pip

• example_2_build_lambda_source_using_pip_all_in_one.py: All-in-one source building workflow

Lambda Layer Artifacts:

Build dependency layers for Lambda functions using different build tools:

Common Setup:

• settings.py: Shared configuration for all layer examples

Pip Builder Examples:

• example_1_1_build_lambda_layer_using_pip_in_local.py: Local pip-based layer building

• example_1_2_build_lambda_layer_using_pip_in_container.py: Container-based pip layer building

Poetry Builder Examples:

• example_2_1_build_lambda_layer_using_poetry_in_local.py: Local Poetry-based layer building

• example_2_2_build_lambda_layer_using_poetry_in_container.py: Container-based Poetry layer building

UV Builder Examples:

• example_3_1_build_lambda_layer_using_uv_in_local.py: Local UV-based layer building

• example_3_2_build_lambda_layer_using_uv_in_container.py: Container-based UV layer building

Advanced Workflow Examples:

• example_4_package.py: Layer packaging with optimization and exclusions

• example_5_upload.py: S3 upload with organized artifact storage

• example_6_publish.py: Lambda layer version publishing with change detection

• example_7_workflow.py: Complete end-to-end workflow (Build → Package → Upload → Publish)

Install

aws_lambda_artifact_builder is released on PyPI, so all you need is to:

$ pip install aws-lambda-artifact-builder

To upgrade to latest version:

$ pip install --upgrade aws-lambda-artifact-builder