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.dev103

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.dev103
File	Size	Uploaded
moto-4.1.15.dev103.tar.gz	3.6 MB	Aug 21, 2023	Details

Built distribution (wheel)

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

Total release size: 6.7 MB

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

Download URL	moto-4.1.15.dev103.tar.gz
Size	3.6 MB
Tags	Source
SHA-256 checksum How to use checksums	`307ae7ee56842e51eef3f48744681ffd1365a8345304a6ab94a24ab95cd31d00`
BLAKE2b-256 checksum How to use checksums	`2ad2d0cabee3aa27372e598ef8eee4aac778983016eacaa4951cbc6bb6fba6b0`
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.dev103-py2.py3-none-any.whl

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