Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 21 Commits
.github/workflows		.github/workflows
bin		bin
localstack-sdk-python/localstack/sdk		localstack-sdk-python/localstack/sdk
packages/localstack-sdk-generated		packages/localstack-sdk-generated
tests		tests
.gitignore		.gitignore
LICENSE.txt		LICENSE.txt
Makefile		Makefile
README.md		README.md
VERSION		VERSION
pyproject.toml		pyproject.toml
requirements-spec.txt		requirements-spec.txt
uv.lock		uv.lock

Repository files navigation

LocalStack Python SDK

This is the Python SDK for LocalStack.LocalStack offers a number of developer endpoints (seedocs).This SDK provides a programmatic and easy way to interact with them.

Warning

This project is still in a preview phase and will be subject to fast and breaking changes.

Project Structure

This project is composed by two Python packages:

packages/localstack-sdk-generated: generated from the LocalStack's OpenAPI specs withopenapi-generator.The LocalStack's OpenAPI specs are available inlocalstack/openapi.This package is not meant to be manually modified, as it needs to be generated every time from the specs.
localstack-sdk-python: the user-facing SDK that consumedlocalstack-sdk-generated as its main dependency.

Installation

You can install the LocalStack Python SDK withpip:

pip install localstack-sdk-python

From Source

This project usesuv as a package manager.On a Unix system, you can installuv with the standalone installer:

curl -LsSf https://astral.sh/uv/install.sh| sh

Onceuv is installed, you can install the project from source with:

make install

To run the integration test suite:

maketest

Note that LocalStack (pro) should be running in the background to execute the test.

Quickstart

To get started with our SDK, check out theofficial documentation on https://docs.localstack.cloud.You'll find comprehensive guides and detailed code samples that demonstrate how to use the various features providedby the SDK.