$ pip install 'moto[ec2,s3,all]'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:
importboto3classMyModel:
def__init__(self, name, value):
self.name=nameself.value=valuedefsave(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:
importboto3frommotoimportmock_s3frommymoduleimportMyModel@mock_s3deftest_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 accountconn.create_bucket(Bucket="mybucket")
model_instance=MyModel("steve", "is awesome")
model_instance.save()
body=conn.Object("mybucket", "steve").get()["Body"].read().decode("utf-8")
assertbody=="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.
The full documentation can be found here:
http://docs.getmoto.org/en/latest/
To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.