pytest-serverless

Automatically mocks resources from serverless.yml file.


Keywords
pytest, serverless, moto, boto3
License
MIT
Install
pip install pytest-serverless==0.7.0

Documentation

pytest-serverless

Mock local resources for serverless framework.

master PyPI Python Licence
Build Status PyPI

Installation

pip install pytest-serverless

What problem it tries to solve?

When building your project with serverless most likely you will create resources like dynamodb tables, sqs queues, sns topics.

During writing tests you will have to mock those in moto.

This pytest plugin tries to automate this process by reading serverless.yml file and create mocks of resources for you.

Usage

Mark your test with @pytest.mark.usefixtures("serverless"), and rest will be done by plugin.

import boto3
import pytest


@pytest.mark.usefixtures("serverless")
def test():
    table = boto3.resource("dynamodb").Table("my-microservice.my-table")
    count_of_items = len(table.scan()["Items"])
    assert count_of_items == 0

Supported resources

AWS::DynamoDB::Table

AWS::SQS::Queue

Issues?

Plugin is in early stage of development, so you might find some bugs or missing functionality.

If possible create pull request (with tests) that fixes particular problem.