Registry / aws / aiomoto

aiomoto

JSON →
library0.5.3pypypi✓ verified 80d ago

aiomoto provides Moto-style AWS service mocks for aiobotocore/aioboto3, enabling async mocking of AWS services like S3, SES, etc. Current version is 0.3.0, with an active release cadence targeting developers using async AWS SDKs.

pip install aiomoto
INSTALL
IMPORT
SIG · AIOMOTO
A
aiomoto
awspythonv0.5.3
Install
19.8s avg
Import
Disk
129MB
Pass rate
8/ 10
Env Coverage8 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.3.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
glibc
py 3.10
✓ 0.1s
✓ 55.8s
py 3.11
✓ —
✓ 15.3s
py 3.12
✓ —
✓ 18.3s
py 3.13
✓ —
✓ 9.7s
py 3.9
✕ build_error
✕ build_error
129MB installed
● package 129MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

mock_aws
from aiomoto import mock_aws
from aiomoto import AioMoto
mock_aws_decorator
from aiomoto import mock_aws_decorator
context
from aiomoto import context

Apply @mock_s3 decorator to async test functions to mock S3 operations.

import aioboto3 from aiomoto import mock_s3 @mock_s3 async def test_s3_bucket(): session = aioboto3.Session() async with session.client('s3', region_name='us-east-1') as s3: await s3.create_bucket(Bucket='mybucket') response = await s3.list_buckets() assert 'mybucket' in [b['Name'] for b in response['Buckets']] import asyncio asyncio.run(test_s3_bucket())
Debug
Known issues
breakingVersion 0.3.0 introduced a new server-mode attach/registry feature with custom exceptions; existing code using older mock decorators should remain compatible.
fix
Review if server-mode changes affect your usage; no breaking changes reported for basic mocking.
affects: <0.3.0
deprecatedaiomoto requires Python >=3.10; Python 3.9 or older will cause installation failures.
fix
Upgrade Python to 3.10 or later.
affects: all
gotchaMock decorators must be applied to async functions; applying to sync functions will not work.
fix
Ensure the decorated function is defined with 'async def'.
affects: all
Upgrade
Version history
0.5.3latest on PyPI · released May 30, 2026
Audit
Dependencies
aiobotocorerequiredRequired for async AWS client mocking
aioboto3optionalAlternative async SDK; aiomoto supports both
Agent activity
61 hits · last 30 days
node
52
Perplexity
1
OpenAI (training)
1
Resources
aiomoto — pip install aiomoto · libregistry