<!-- This readme file is generated with terraform-docs -->
# LambdaZipBuilder

Download pip packages and create ./lambda\_layer.zip
Optionally upload archive to s3 bucket

## Requirements

| Name | Version |
|------|---------|
| archive | >= 2.7.1 |
| aws | ~> 5.100.0 |
| null | >= 3.2.4 |

## Providers

| Name | Version |
|------|---------|
| archive | >= 2.7.1 |
| aws | ~> 5.100.0 |
| null | >= 3.2.4 |

## Modules

No modules.

## Resources

| Name | Type |
|------|------|
| [aws_s3_object.object](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_object) | resource |
| [null_resource.pip_download](https://registry.terraform.io/providers/hashicorp/null/latest/docs/resources/resource) | resource |
| [null_resource.remove_temp_downloads](https://registry.terraform.io/providers/hashicorp/null/latest/docs/resources/resource) | resource |
| [archive_file.layer1](https://registry.terraform.io/providers/hashicorp/archive/latest/docs/data-sources/file) | data source |

## Inputs

| Name | Description | Type | Default | Required |
|------|-------------|------|---------|:--------:|
| pip\_packages | List of pip packages, separated by space | `string` | n/a | yes |
| pip\_path | Path to pip. Defaults to /usr/bin/pip3 | `string` | `"/usr/bin/pip3"` | no |
| s3\_bucket\_name | Name of s3 bucket for storing lambda layer archive | `string` | `null` | no |
| upload\_archive\_to\_s3 | Whether to upload layer archive to s3. Use this for zipped size >50M or unzipped size >250M. Limit is imposed by AWS API | `bool` | `false` | no |

## Outputs

| Name | Description |
|------|-------------|
| archive\_checksum | Hash of archive |
| archive\_path | Full path to archive file |
| archive\_size | Size of archive |
| s3\_object\_hash | S3 object hash, useful for triggering lambda layer update |
| s3\_object\_key | S3 object key |
 
---
## Authorship
This module was developed by xpk.