Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LocalStack Utils

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

About

Localstack utility for tests

Resources

Code of conduct

Contributing

Stars

4 stars

Watchers

14 watching

Forks

Releases

Packages

Used by

Contributors

Languages