poetry_builder

Poetry-based Lambda layer builder implementation.

This module provides Lambda layer creation using Poetry’s dependency management, supporting both local and containerized builds. Poetry offers reproducible builds through lock files and sophisticated dependency resolution.

Command Pattern Classes:

• PoetryBasedLambdaLayerLocalBuilder: Local poetry-based builds

• PoetryBasedLambdaLayerContainerBuilder: Containerized poetry-based builds

class aws_lambda_artifact_builder.layer.poetry_builder.PoetryBasedLambdaLayerLocalBuilder(verbose: bool = True, printer: ~typing.Callable[[str], None] = <built-in function print>, path_pyproject_toml: ~pathlib.Path = REQ, credentials: ~aws_lambda_artifact_builder.layer.foundation.Credentials | None = None, skip_prompt: bool = False, _build_tool: str = LayerBuildToolEnum.poetry, path_bin_poetry: ~pathlib.Path = REQ)

This class implements Poetry-specific build workflow using virtual environments and lock file-based dependency resolution.

Key Features:

• Lock file-based reproducible builds

• Environment variable authentication (POETRY_HTTP_BASIC_*)

• In-project virtual environment setup

• No root package installation (–no-root)

See also

BasedLambdaLayerLocalBuilder

step_1_1_print_info()

Display Poetry-specific build information.

step_2_prepare_environment()

Set up necessary prerequisites for the build process.

step_2_2_prepare_poetry_stuff()

Copy Poetry project files to build directory.

Copies pyproject.toml and poetry.lock to ensure reproducible builds with exact dependency versions as resolved in development.

step_3_execute_build()

Perform Poetry-based Lambda layer build step.

step_3_1_poetry_login()

Configure Poetry authentication via environment variables.

step_3_2_run_poetry_install()

Execute Poetry installation with lock file constraints.

Runs Poetry install with –no-root to exclude the project package itself, installing only dependencies into an in-project virtual environment.

class aws_lambda_artifact_builder.layer.poetry_builder.PoetryBasedLambdaLayerContainerBuilder(verbose: bool = True, printer: ~typing.Callable[[str], None] = <built-in function print>, path_pyproject_toml: ~pathlib.Path = REQ, py_ver_major: int = REQ, py_ver_minor: int = REQ, is_arm: bool = REQ, path_script: ~pathlib.Path = PosixPath('/home/docs/checkouts/readthedocs.org/user_builds/aws-lambda-artifact-builder/envs/latest/lib/python3.11/site-packages/aws_lambda_artifact_builder/layer/_build_lambda_layer_using_poetry_in_container.py'), credentials: ~aws_lambda_artifact_builder.layer.foundation.Credentials | None = None)

Command class for containerized Poetry-based Lambda layer builds.

See also

BasedLambdaLayerContainerBuilder

step_1_preflight_check()

Validate Docker environment and container build prerequisites.