Moto - Mock AWS Services

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/

Financial Contributions

Support this project and continued development, by sponsoring us!

Click the Sponsor-button at the top of the page for more information.

Our finances are managed by OpenCollective, which means you have full visibility into all our contributions and expenses: https://opencollective.com/moto

Security contact information

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.

Release files for moto 4.1.15.dev101

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for moto 4.1.15.dev101
File	Size	Uploaded
moto-4.1.15.dev101.tar.gz	3.6 MB	Aug 21, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for moto 4.1.15.dev101
File	Interpreter	ABI	Platform	Reset
moto-4.1.15.dev101-py2.py3-none-any.whl 3.1 MB Aug 21, 2023	Python 2, Python 3	none	any	Details

Total release size: 6.7 MB

Release files / moto-4.1.15.dev101.tar.gz

Download URL	moto-4.1.15.dev101.tar.gz
Size	3.6 MB
Tags	Source
SHA-256 checksum How to use checksums	`fd9fb8917b86d8a71b14b7345323f57a6847df446e282d0463a16cf9709d57d6`
BLAKE2b-256 checksum How to use checksums	`1b3ecbf1d45fc52bd8d6bb250ce2db0cfabb7ee61d2e77e60ebca423431a6474`
Upload date	Aug 21, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.4`

Release files / moto-4.1.15.dev101-py2.py3-none-any.whl

Download URL	moto-4.1.15.dev101-py2.py3-none-any.whl
Size	3.1 MB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`e3565c63bcef1494539e6765339cf5840d7fa7c64b0d2fef1dbf5fd0692ae084`
BLAKE2b-256 checksum How to use checksums	`74dcc6e8ef35e6b3859bf0e0faf96d716d986170366f84e0cfc7c667ba25624f`
Upload date	Aug 21, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.4`