Python SDK release notes

Updated at:

This page lists changes in each version of the Simple Message Queue (formerly MNS) Python SDK. To ensure optimal performance and stability, we recommend using the latest version.

1.3.0 (2025-08-01)

Features

  • Updated the message class to carry user-defined properties and system properties.

  • Added the MessageGroupId property to the message class.

Bug fixes

  • Removed the dependency on aliyun-python-sdk-core-v3.

Download: GitHub releases

1.2.1 (2024-11-13)

Features

  • Added queue_multi_thread.py as best practice code for multi-threaded scenarios.

  • Optimized the naming of sample files in the sample directory.

Bug fixes

  • Fixed an issue where the set_attributes method of the queue model incorrectly reset queue properties to their default values.

  • Removed the dependency on pycrypto-2.6.1 to fix an installation error on Windows for Python 3.

Download: GitHub releases

1.2.0 (2024-07-26)

Features

  • Added support for reading AccessKey ID and AccessKey secret from environment variables. For more information, see Configure endpoints and credentials.

  • Added support for producing and consuming messages in the topic-based model and queue-based messaging model, with optional Base64 encoding and decoding.

  • Added receive_message_with_str_body and similar methods for receiving messages whose body is a string.

  • Added sample code for these features.

Bug fixes

  • Fixed incorrect client version reporting.

  • Fixed an issue where Base64 encoding and decoding settings for a queue became invalid when calling the peek_message method, which caused messages to always be decoded in Base64.

  • Fixed Python compatibility issues.

Download: GitHub releases

1.1.6 (2021-05-13)

Features

  • Added parsing for ReceiptHandle in the return value of sent messages.

Bug fixes

  • Fixed Python 3 compatibility issues.

Download: aliyun-mns-python-sdk-1.1.6.zip

1.1.5 (2019-04-26)

  • Made the SDK compatible with Python 3.

Download: aliyun-mns-python-sdk-1.1.5.zip

1.1.4 (2017-03-23)

  • Added text message push support for the topic-based model.

  • Added Chinese character support for queue and topic messages.

  • Added mnsEndpoint, accessKeyId, and accessKeySecret as parameters for the mnscmd command.

  • Added Base64 encoding and decoding options for queue messages to the mnscmd command.

Download: aliyun-mns-python-sdk-1.1.4.zip

1.1.3 (2016-09-13)

  • Added support for passing RequestID through to SMQ.

  • Added QueueEndpoint and MailEndpoint for topic push.

  • Added JSON format support for topic message push.

  • Added the config_file parameter to the mnscmd command for specifying a configuration file.

Download: aliyun-mns-python-sdk-1.1.3.zip

1.1.2 (2016-05-23)

  • Added message filtering for topic push.

  • Added the sample directory with more detailed sample code.

Download: aliyun-mns-python-sdk-1.1.2.zip

1.1.1 (2016-03-28)

  • Added HTTPS support.

  • Added logging support.

Download: aliyun-mns-python-sdk-1.1.1.zip

1.1.0 (2016-01-05)

  • Added topic support.

  • Added Security Token Service (STS) token support.

Download: aliyun-mns-python-sdk-1.1.0.zip

1.0.2 (2015-06-09)

  • Added SDK installation support.

  • Added the mnscmd command.

  • Upgraded the API protocol to "x-mns-version"="2015-06-06".

  • Added BatchSendMessage, BatchReceiveMessage, BatchPeekMessage, and BatchDeleteMessage.

Download: aliyun-mns-python-sdk-1.0.2.zip

1.0.1 (2015-02-03)

  • Unified the type of non-string queue properties to int.

  • Corrected the return status of SetQueueAttribute to 204.

Download: aliyun-mns-python-sdk-1.0.1.zip

1.0.0 (2014-08-01)

Initial release.