Skip to main content

Build AWS Lambda deployment packages (zip files) for Python projects

Project description

paketoi

Paketoi is a command-line tool for building AWS Lambda deployment packages (zip files) for Python projects.

The goal is to provide a single command to build the deployment package for simple projects using requirements.txt.

Assumptions

  • The dependencies for your project are specified in a requirements.txt file.
  • Any dependencies with native code have pre-built binary wheels for the target platform.

Installation

Paketoi is available on PyPI. The simplest way to install it globally is to use pipx:

pipx install paketoi

Usage

The tool is meant to be run in the directory that contains your project. The source code is assumed to reside in the working directory. The basic usage is:

paketoi -r <path to requirements.txt> <path to output file>

You can find all the command-line options with paketoi --help.

Command-line options

% paketoi --help
Usage: paketoi [OPTIONS] OUTPUT

  Build AWS Lambda deployment packages (zip files) for Python projects.

Options:
  -s, --source DIRECTORY          The source root of the project.
  -I, --include PATH              Files to be included, relative to the source
                                  root.
  -E, --exclude TEXT              Files to be excluded, relative to the source
                                  root.
  -r, --requirement TEXT          Path to requirements.txt.
  --runtime [3.8|3.9|3.10|3.11|3.12]
                                  Python version to target.
  --platform [x86_64|arm64]       Architecture to target.
  --default-excludes / --no-default-excludes
                                  Enable/disable the default exclusion list.
                                  (.git, .jj, .mypy_cache, .ruff_cache)
  --help                          Show this message and exit.

Python version and architecture

By default, dependencies are downloaded for Python 3.12 running on x86_64. You can change these options with --platform and --runtime options.

For example, to build a deployment package for Python 3.10 running on arm64, do this:

paketoi -r requirements.txt --runtime 3.10 --platform arm64 lambda.zip

Simple layout

.
├── lambda_function.py
└── requirements.txt

With the project layout like above, you can build a deployment package lambda.zip like this:

paketoi -r requirements.txt lambda.zip

src layout

.
├── requirements.txt
└── src
   └── lambda_function.py

When your lambda source is under the directory src, use -s src to set the source root.

paketoi -r requirements.txt -s src lambda.zip

Excluding files

.
├── requirements.txt
├── lambda_function.py
└── tests
   └── lambda_function_test.py

You can exclude files you do not need by using -E path. For example:

paketoi -r requirements.txt -E tests lambda.zip

Alternatives

Developing paketoi

This project uses Poetry as the package manager and just as the command runner. Project setup:

# Create a virtualenv and install all the dependencies
poetry install

# Run all the tests and checks
just check

# Run the tool directly from the repo
poetry run paketoi

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

paketoi-0.1.1.tar.gz (21.0 kB view details)

Uploaded Source

Built Distribution

paketoi-0.1.1-py3-none-any.whl (24.3 kB view details)

Uploaded Python 3

File details

Details for the file paketoi-0.1.1.tar.gz.

File metadata

  • Download URL: paketoi-0.1.1.tar.gz
  • Upload date:
  • Size: 21.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.12.3 Darwin/23.2.0

File hashes

Hashes for paketoi-0.1.1.tar.gz
Algorithm Hash digest
SHA256 906788d8770285926d1b3184f9b0ce2a51c365d3014151a660b9c411bbf71177
MD5 fc483b82625547d382f8e087444e33ff
BLAKE2b-256 9de9c8d7f1c0610b3e4c877c08d3cf09696157279894cb55ac9cc2b22ea902e4

See more details on using hashes here.

File details

Details for the file paketoi-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: paketoi-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 24.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.12.3 Darwin/23.2.0

File hashes

Hashes for paketoi-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 29b6377c402e98c97b56f0ff6419d577e3f5aebe8a8dd41192feaf9cb0e36004
MD5 d2c0ed22bcc644562aefed657fecf26d
BLAKE2b-256 623ae0466295c00ab987aaacef2369f616240dc4ef24968e77f11ede44b5e0dd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page