This Python utility streamlines the integration of Localstack, a local AWS cloud services mock, with unit tests. Seamlessly incorporate Localstack into your Python projects to facilitate efficient and reliable testing of AWS interactions within a controlled local environment. Enhance the development process by utilizing this utility to simulate AWS services during unit testing, ensuring robust and dependable code before deployment.

Prerequisites

• Docker
• Localstack

Instalation

pip install localstack-utils

Usage example

import time
import boto3
import unittest
from localstack_utils.localstack import startup_localstack, stop_localstack
class TestKinesis(unittest.TestCase):
    def setUp(self):
        startup_localstack()
    def tearDown(self):
        stop_localstack()
        return super().tearDown()
    def test_create_stream(self):
        kinesis = boto3.client(
            service_name="kinesis",
            aws_access_key_id="test",
            aws_secret_access_key="test",
            endpoint_url="http://localhost:4566",
        )
        kinesis.create_stream(StreamName="test", ShardCount=1)
        time.sleep(1)
        response = kinesis.list_streams()
        self.assertGreater(len(response.get("StreamNames", [])), 0)

Change Log

• 1.0.5: Add support for configurable container name and auth token forwarding
• 1.0.4: Fixes to LocalStack and Container modules
• 1.0.3: Add auto_remove config option
• 1.0.2: LocalStack Pro image set as default
• 1.0.1: Repository URL fixed
• 1.0.0: Initial version