This release is a pre-release and may not be stable for production use.
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.
4 maintainers
Metadata
4 maintainers
Release files for moto 4.1.15.dev100
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| moto-4.1.15.dev100.tar.gz | 3.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| moto-4.1.15.dev100-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
Total release size: 6.7 MB
Release files / moto-4.1.15.dev100.tar.gz
| Download URL | moto-4.1.15.dev100.tar.gz |
|---|---|
| Size | 3.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8c34f64348de7f447b9a7362fff1fd864385226b3cc62353ca00ada185b31d06
|
|
BLAKE2b-256 checksum How to use checksums |
eccab62e3c967b4d75d0156463ad08cd1a9b2b33697111e2854b24676e102e20
|
| Upload date | |
|
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.dev100-py2.py3-none-any.whl
| Download URL | moto-4.1.15.dev100-py2.py3-none-any.whl |
|---|---|
| Size | 3.1 MB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
27a096799c9f7501681aee58d044092a0fe85f2170c39ea1ac50d4b7a25fa064
|
|
BLAKE2b-256 checksum How to use checksums |
031ad93b3a28e78f1aed9d8882ed51fa373e854067437833c79d69b7d5723a46
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.4
|
