This is an easy-to-use Python client for LocalStack. The client library provides a thin wrapper around boto3 which automatically configures the target endpoints to use LocalStack for your local cloud application development.
To make use of this library, you need to have LocalStack
installed on your local machine. In particular, the localstack command needs to be available.
The easiest way to install LocalStack is via pip:
pip install localstack-client
This library provides an API that is identical to boto3's. For example, to list the SQS queues
in your local (LocalStack) environment, use the following code:
import localstack_client.session
session = localstack_client.session.Session()
sqs = session.client('sqs')
assert sqs.list_queues() is not None
We welcome feedback, bug reports, and pull requests!
Use these commands to get you started and test your code:
make install
make test
- v0.20: Add endpoints for AWS CloudTrail, Glacier, Batch, Organizations
- v0.19: Add endpoints for AWS ECR and QLDB
- v0.18: Add endpoint for AWS API Gateway V2
- v0.16: Add endpoint for AWS SageMaker
- v0.15: Add endpoint for AWS Glue
- v0.14: Add endpoint for AWS Athena
- v0.13: Add endpoint for AWS CloudFront
- v0.8: Add more service endpoint mappings that will be implemented in the near future
- v0.7: Add endpoint for AWS Step Functions
- v0.6: Add endpoint for AWS Secrets Manager
- v0.5: Fix passing of credentials to client session
- v0.4: Add functions to retrieve service port mappings
- v0.3: Add new service endpoints
- v0.2: Add missing service endpoints; enable SSL connections; put default endpoints into
config.py - v0.1: Initial version
The LocalStack Python Client is released under the Apache License, Version 2.0 (see LICENSE).