Skip to main content

aiomoto

aiomoto is Moto for aiobotocore (while staying compatible with classic botocore / boto3). It adapts Moto's stubber so async and sync clients share the same in-memory backend: you can write to a mock S3 bucket with boto3 and read it back via aiobotocore in the same process.

📖 Full documentation: https://aiomoto.pages.dev/

Supported today

  • mock_aws() usable as with or async with, guarding against real HTTP requests.
  • Actively exercised in tests: S3 (CRUD + listings + streaming reads), DynamoDB (create/describe/put/get), Secrets Manager, SES, SNS, SQS, KMS, STS, Lambda, Events, Kafka/MSK, and s3fs async integration — all sharing one Moto backend between sync boto3/botocore and async aiobotocore clients.
  • Other Moto services often work out of the box through the same patch layer; if you hit a service-specific gap, open an issue with a minimal repro so we can add a focused slice.

Installation

pip install aiomoto
# or, in a uv project:
uv add aiomoto

aiomoto re-exposes Moto's service extras (for example aiomoto[s3], aiomoto[dynamodb], or aiomoto[all]), plus aiomoto-specific extras (aiomoto[server], aiomoto[pandas], aiomoto[polars]). See the installation guide for details.

Usage

Use aiomoto.mock_aws as a drop-in replacement for Moto's mock_aws that works with both synchronous boto3/botocore clients and asynchronous aiobotocore clients in the same process. It supports with, async with, and decorating sync/async callables.

import boto3
from aiobotocore.session import AioSession
from aiomoto import mock_aws


async def demo() -> None:
    async with mock_aws():
        # Write with a synchronous boto3 client.
        boto3.client("s3", region_name="us-east-1").create_bucket(Bucket="example")

        # Read it back with an async aiobotocore client.
        session = AioSession()
        async with session.create_client("s3", region_name="us-east-1") as s3:
            result = await s3.list_buckets()
            assert any(b["Name"] == "example" for b in result["Buckets"])

The documentation covers more:

  • Contexts and decorators — with / async with, @mock_aws, reset / remove_data, and the AWS_ENDPOINT_URL gotcha.
  • Server mode — run a local Moto server, endpoint-injection modes, and attaching to an existing server.
  • Pandas and Polars — s3:// DataFrame I/O.
  • Examples — S3, DynamoDB, SQS, SNS, s3fs, and streaming reads.
  • API reference — mock_aws, mock_aws_decorator, AutoEndpointMode, and the exception types.

Motivation

Like many others I've wanted to use Moto with aiobotocore but found that wasn't supported. The motivation page explains the background and why aiomoto avoids depending on Moto's server mode by default.

Limitations

aiomoto keeps version ranges narrow and tested together, and a few integrations (notably pandas/polars S3 I/O) only work in server mode. See the limitations page for the full list, including free-threaded CPython support.

Metadata

Release files for aiomoto 0.5.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aiomoto 0.5.9
File Size Uploaded Provenance Actions
aiomoto-0.5.9.tar.gz 19.4 kB Without provenance Details for aiomoto-0.5.9.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aiomoto 0.5.9
File Interpreter ABI Platform Actions
aiomoto-0.5.9-py3-none-any.whl Python 3 none any Details for aiomoto-0.5.9-py3-none-any.whl

Total release size: 39.5 kB

Release files / aiomoto-0.5.9.tar.gz

Download URL aiomoto-0.5.9.tar.gz
Size 19.4 kB
Tags Source
SHA-256 checksum
How to use checksums
7aa8953e15185b87c3af3c415ac65b326708c453d656dfb3860a5c26b27687b3
BLAKE2b-256 checksum
How to use checksums
1eb0adf925adcdf56ae9ea6f45938841d08497110373ac6d78f492f9cbd0ebf6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / aiomoto-0.5.9-py3-none-any.whl

Download URL aiomoto-0.5.9-py3-none-any.whl
Size 20.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
207d866ab8e51ea4c83aef50e516f89206d590357602deb11815f78e3ba450c6
BLAKE2b-256 checksum
How to use checksums
c43e4116fc7b728c65b91d9b811da251691dbdfcb0d9b5e3e8397ea61e091d71
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for aiomoto 0.5.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page