Release v0.1.8 (What’s new?).

---

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

Table of Content

• About This Project
• Build Lambda Source Guide
• Build Lambda Layer Guide

About the Author

(\ (\
( -.-)o
o_(")(")

Sanhe Hu is a seasoned software engineer with a deep passion for Python development since 2010. As an author and maintainer of 150+ open-source Python projects, with over 15 million monthly downloads, I bring a wealth of experience to the table. As a Senior Solution Architect and Subject Matter Expert in AI, Data, Amazon Web Services, Cloud Engineering, DevOps, I thrive on helping clients with platform design, enterprise architecture, and strategic roadmaps.

Talk is cheap, show me the code:

• My Github: https://github.com/MacHu-GWU

API Document

• by Name

• by Structure