Releases and Upgrade Paths

Release Schedule

There is no fixed release schedule, although we try to release a new version every 1 or 2 weeks.

Specific release intervals will be influenced by 1) high-priority bugs, 2) number of new features and 3) maintainer availability.

Every commit should result in a development release, marked as Pre-releases in PyPi and with the latest-tag in DockerHub.

Moto follows a semver scheme: major.minor.patch.

A full list of all changes in a specific release can be found on Github: https://github.com/getmoto/moto/blob/master/CHANGELOG.md

A overview of the breaking changes between major versions:

For Moto 2.x:

A change in the installation method. Use pip install moto[service] to only install the required dependencies for that service, or pip install moto[all] to install all (1.x behaviour)

For Moto 3.x:

Removed compatibility with boto. Specifically: all service_deprecated-decorators were removed.
The class-decorator now resets the state before every test-method (before, the state was global - shared between class-methods).
ECS ARN’s now use the new (long) format by default

For Moto 4.x:

Removed decorators mock_dynamodb2 and mock_rds2 (they were functionally equivalent with mock_dynamodb and mock_rds since 3.x)

For Moto 5.x:

All decorators have been replaced with mock_aws
The batch_simple decorator has been replaced with: @mock_aws(config={“batch”: {“use_docker”: False}})
The awslambda_simple decorator has been replaced with: @mock_aws(config={“lambda”: {“use_docker”: False}})
When starting the MotoServer, the service-argument (i.e.: motoserver s3) is no longer supported. A single MotoServer-instance can be used for all AWS-services.