Go to file
2023-01-04 11:12:16 -01:00
.github/workflows IOTData: Fix bug where publish() could only be called once (#5812) 2023-01-03 20:21:52 -01:00
docs Prep release 4.0.13 (#5813) 2023-01-04 11:12:16 -01:00
moto Prep release 4.0.13 (#5813) 2023-01-04 11:12:16 -01:00
other_langs Added an example of using a moto server with Scala 2019-07-07 14:17:32 +03:00
scripts Feature: ACM-PCA (#5712) 2022-11-28 12:22:48 -01:00
tests IOTData: Fix bug where publish() could only be called once (#5812) 2023-01-03 20:21:52 -01:00
.coveragerc Introduce Github Actions to replace TravisCI (#3610) 2021-01-26 12:37:03 +00:00
.git-blame-ignore-revs Ignore Black formatting commits in the blame view (#5664) 2022-11-16 17:51:34 -08:00
.gitignore Feature: Record/replay incoming requests (#5481) 2022-09-19 15:04:29 +00:00
.gitmodules Terraform Tests - update to latest TF branch (#5031) 2022-04-16 10:02:57 +00:00
.readthedocs.yaml Update .readthedocs.yaml 2021-11-03 21:01:49 -01:00
AUTHORS.md IOT: check if policy name already taken (#5352) 2022-08-02 19:45:46 +02:00
CHANGELOG.md Prep release 4.0.13 (#5813) 2023-01-04 11:12:16 -01:00
CODE_OF_CONDUCT.md Add docs on contributing and code of conduct. 2017-02-26 19:55:19 -05:00
codecov.yml Admin: Enable support for Py 3.11 (#5619) 2022-10-30 10:18:06 -01:00
CONFIG_README.md address PR comments 2020-09-21 17:42:44 -06:00
CONTRIBUTING.md Refer to correct black version (#5038) 2022-04-19 22:18:28 +00:00
Dockerfile Update Dockerfile 2020-04-30 19:18:08 +02:00
IMPLEMENTATION_COVERAGE.md Prep release 4.0.13 (#5813) 2023-01-04 11:12:16 -01:00
ISSUE_TEMPLATE.md Add docs on contributing and code of conduct. 2017-02-26 19:55:19 -05:00
LICENSE
Makefile TechDebt - Unpin coverage-dependency to speed up Py3.11 (#5629) 2022-11-02 20:00:51 -01:00
MANIFEST.in Feature: ServiceQuotas (#5557) 2022-10-11 22:09:17 +00:00
README.md chore(readme): Align code snippets formatting with project's rules. (#5802) 2022-12-22 13:34:17 -01:00
requirements-dev.txt Techdebt: Replace string-format with f-strings (#5695) 2022-11-21 22:20:19 -01:00
requirements-tests.txt TechDebt - Unpin coverage-dependency to speed up Py3.11 (#5629) 2022-11-02 20:00:51 -01:00
requirements.txt First stab at extracting deps in setup.py to extras 2020-09-03 09:23:53 +01:00
setup.cfg Techdebt: MyPy DynamoDB v20111205 (#5799) 2022-12-22 09:58:08 -01:00
setup.py Remove dependency on pytz (#5749) 2022-12-09 22:56:08 -01:00
update_version_from_git.py Add validity dates to IoT fakecert (#4093) 2021-07-27 08:59:01 +01:00

Moto - Mock AWS Services

Join the chat at https://gitter.im/awsmoto/Lobby

Build Status Coverage Status Docs PyPI PyPI - Python Version PyPI - Downloads Code style: black

Install

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

In a nutshell

Moto is a library that allows your tests to easily mock out AWS Services.

Imagine you have the following python code that you want to test:

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)

Take a minute to think how you would have tested that in the past.

Now see how you could test it with Moto:

import boto3
from moto import mock_s3
from mymodule import MyModel


@mock_s3
def test_my_model_save():
    conn = boto3.resource("s3", region_name="us-east-1")
    # We need to create the bucket since this is all in Moto's 'virtual' AWS account
    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"

With the decorator wrapping the test, all the calls to s3 are automatically mocked out. The mock keeps the state of the buckets and keys.

For a full list of which services and features are covered, please see our implementation coverage.

Documentation

The full documentation can be found here:

http://docs.getmoto.org/en/latest/