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:

https://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.

all proxy server acm acmpca amp apigateway apigatewayv2 applicationautoscaling appsync athena autoscaling awslambda awslambda-simple backup batch batch-simple budgets ce cleanrooms cloudformation cloudfront cloudtrail cloudwatch codebuild codecommit codepipeline cognitoidentity cognitoidp comprehend config databrew datapipeline datasync dax dms ds dynamodb dynamodbstreams ebs ec2 ec2instanceconnect ecr ecs efs eks elasticache elasticbeanstalk elastictranscoder elb elbv2 emr emrcontainers emrserverless es events firehose forecast glacier glue greengrass guardduty iam inspector2 iot iotdata ivs kinesis kinesisvideo kinesisvideoarchivedmedia kms logs managedblockchain mediaconnect medialive mediapackage mediastore mediastoredata meteringmarketplace mq opsworks organizations panorama personalize pinpoint polly quicksight ram rds redshift redshiftdata rekognition resourcegroups resourcegroupstaggingapi route53 route53resolver s3 s3crc32c s3control sagemaker sdb scheduler secretsmanager servicediscovery servicequotas ses signer sns sqs ssm ssoadmin stepfunctions sts support swf textract timestreamwrite transcribe wafv2 xray

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

moto-5.2.3.tar.gz (8.8 MB view details)

Uploaded Aug 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

moto-5.2.3-py3-none-any.whl (6.8 MB view details)

Uploaded Aug 22, 2026 Python 3

File details

Details for the file moto-5.2.3.tar.gz.

File metadata

Download URL: moto-5.2.3.tar.gz
Upload date: Aug 22, 2026
Size: 8.8 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for moto-5.2.3.tar.gz
Algorithm	Hash digest
SHA256	`a9e95c3218b6eda18e74571f1ced11cb1bc3151467d562c1da6037b9d19832cb`
MD5	`0df61d5875585ef16c94795335f04013`
BLAKE2b-256	`6c0f1682c01ca0608c25526afb150246a3c9c1f609caccbd39758de4850e31bc`

See more details on using hashes here.

Provenance

The following attestation bundles were made for moto-5.2.3.tar.gz:

Publisher: release.yml on getmoto/moto

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: moto-5.2.3.tar.gz
- Subject digest: a9e95c3218b6eda18e74571f1ced11cb1bc3151467d562c1da6037b9d19832cb
- Sigstore transparency entry: 2568038727
- Sigstore integration time: Aug 22, 2026
Source repository:
- Permalink: getmoto/moto@13036cfc6cb3259b6ea21b223f7358c29da969a6
- Branch / Tag: refs/heads/master
- Owner: https://github.com/getmoto
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@13036cfc6cb3259b6ea21b223f7358c29da969a6
- Trigger Event: workflow_dispatch