Moto — Mock AWS Services

Установка

$ pip install 'moto[ec2,s3,all]'

В двух словах

Moto — это библиотека, которая позволяет легко имитировать сервисы AWS в тестах.

Представьте, что у вас есть следующий код на Python, который вы хотите протестировать:

import boto3


class MyModel:
    def __init__(self, name, value):
        self.name = name
        self.value = value

    def save(self):
        s3 = boto3.client("s3", region_name="us-east-1")
        s3.put_object(Bucket="mybucket", Key=self.name, Body=self.value)

Подумайте, как бы вы протестировали этот код в прошлом. Теперь посмотрите, как вы можете протестировать его с помощью Moto:

import boto3
from moto import mock_aws
from mymodule import MyModel


@mock_aws
def test_my_model_save():
    conn = boto3.resource("s3", region_name="us-east-1")
    # Нам нужно создать корзину, так как всё это находится в «виртуальной» учётной записи AWS от Moto
    conn.create_bucket(Bucket="mybucket")
    model_instance = MyModel("steve", "is awesome")
    model_instance.save()
    body = conn.Object("mybucket", "steve").get()["Body"].read().decode("utf-8")
    assert body == "is awesome"

С помощью декоратора, оборачивающего тест, все вызовы s3 автоматически имитируются. Имитация отслеживает состояние корзин и ключей. Полный список сервисов и функций, которые поддерживаются, см. в нашем документе IMPLEMENTATION_COVERAGE.

Документация

Полную документацию можно найти здесь: http://docs.getmoto.org/en/latest/

Финансовые взносы

Поддержите этот проект и его дальнейшее развитие, спонсируя нас! Нажмите кнопку «Sponsor» вверху страницы для получения дополнительной информации. Наши финансы управляются OpenCollective, что означает, что вы полностью видите все наши взносы и расходы: https://opencollective.com/moto

Контактная информация по безопасности

Чтобы сообщить об уязвимости системы безопасности, пожалуйста, используйте контакт безопасности Tidelift. Tidelift будет координировать исправление и раскрытие информации.