A library that allows your python tests to easily mock out the boto library
Project description
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(object):
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:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
moto-4.0.2.dev11.tar.gz
(2.4 MB
view hashes)
Built Distribution
Close
Hashes for moto-4.0.2.dev11-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2f70e466d89534b83f6b4df1c2bc008b140293968097fe26103e0d70b957b980 |
|
MD5 | 57cce7b4f5e9ac593199514c5d973e84 |
|
BLAKE2b-256 | 5d3e19ce7cbdeb139ba4360ea0aa4a30247f3d89c108cb50c35bd813acd6035c |