This is the Python SDK for LocalStack. LocalStack offers a number of developer endpoints (see docs). 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.
This project follows the following structure:
packages/localstack-sdk-generatedis a Python project generated from the OpenAPI specs with openapi-generator. LocalStack's OpenAPI specs are available in the openapi repository.localstack-sdk-pythonis the main project that haslocalstack-sdk-generatedas the main dependency.
Developers are not supposed to modify at all localstack-sdk-generated.
The code needs to be re-generated from specs every time using the generate.sh script in the bin folder.
This project uses uv as package/project manager.
You can simply run make install-dev to install the two packages and the needed dependencies.
make test runs the test suite.
Note that LocalStack (pro) should be running in the background to execute the test.