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 aswithorasync 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 theAWS_ENDPOINT_URLgotcha. - 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.
1 maintainer
Metadata
1 maintainer
Release files for aiomoto 0.5.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aiomoto-0.5.6.tar.gz | 18.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aiomoto-0.5.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 38.5 kB
Release files / aiomoto-0.5.6.tar.gz
| Download URL | aiomoto-0.5.6.tar.gz |
|---|---|
| Size | 18.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
12d7b05467bf81e5fe5a81a65291221896008186f0555d07216ea12fae033925
|
|
BLAKE2b-256 checksum How to use checksums |
14261009401b748d3c6898d4e51d0c8b4b390087e4ba0615491926c684b9e3db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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.6-py3-none-any.whl
| Download URL | aiomoto-0.5.6-py3-none-any.whl |
|---|---|
| Size | 19.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
22fdaae73bb7ae50648bf4fc231e8026a3e9beb06f49b77dadf69d92f4d4c745
|
|
BLAKE2b-256 checksum How to use checksums |
df58a3176e8493337c49949138821b6f4db84329ee24f7bf898aab72c575e42d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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}
|
