No project description provided
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:
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_aws
from mymodule import MyModel
@mock_aws
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 track of 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 its 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.
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
Built Distribution
Hashes for moto-5.0.13.dev53-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | de89b70adfe8dd3bec4dc3e9915b0f223fd1cc3d39ea358d9d0b11adf9ea3db1 |
|
MD5 | 3089876216200b9481f593e0d56b12ca |
|
BLAKE2b-256 | d0d59cb4248d7d0e3f064c75114a61c9dfc04ef1aabd650435332ad45ffa36d8 |