Pytest plugin for AWS integration tests
Project description
pytest-localstack
pytest-localstack is a plugin for pytest to create AWS integration tests via a Localstack Docker container.
Requires:
pytest >= 3.3.0
Docker
Features
Create pytest fixtures that start and stop a Localstack container.
Temporarily patch botocore to redirect botocore/boto3 API calls to Localstack container.
Plugin system to easily extend supports to other AWS client libraries such as aiobotocore.
Example
import boto3
import pytest_localstack
localstack = pytest_localstack.patch_fixture(
services=["s3"], # Limit to the AWS services you need.
scope='module', # Use the same Localstack container for all tests in this module.
autouse=True, # Automatically use this fixture in tests.
)
def test_s3_bucket_creation():
s3 = boto3.resource('s3') # Botocore/boto3 will be patched to use Localstack
assert len(list(s3.buckets.all())) == 0
bucket = s3.Bucket('foobar')
bucket.create()
assert len(list(s3.buckets.all())) == 1Installation
Install with pipenv:
$ pipenv install pytest-localstack(You have pipenv, right?)
TODO
More detailed docs.
Break Docker container running out of LocalstackSession.
Make botocore patching more comprehensible.
Add common test resource fixture factories i.e. S3 buckets, SQS queues, SNS topics, etc.
Test this works for non-localhost Docker containers.
Add other client libraries such as aiobotocore.
Change Log
0.1.0 (2018-03-13)
Initial release
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pytest_localstack-0.1.0-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 55baef0e22e58f7ff1bb7d56bac5b15e307edcc874c1bd5a34aba7df98e1a4d3 |
|
| MD5 | 531fe82b84f769f8bf99ba9f63c64da1 |
|
| BLAKE2b-256 | f5050b00a539b27d4f8ac19c89dc65307a9d9c827439acbdb241d70102f71c70 |
