Python SDK release notes
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
MessageGroupIdproperty 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.pyas 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_attributesmethod of the queue model incorrectly reset queue properties to their default values.Removed the dependency on
pycrypto-2.6.1to 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_bodyand 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_messagemethod, 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
ReceiptHandlein 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, andaccessKeySecretas parameters for themnscmdcommand.Added Base64 encoding and decoding options for queue messages to the
mnscmdcommand.
Download: aliyun-mns-python-sdk-1.1.4.zip
1.1.3 (2016-09-13)
Added support for passing RequestID through to SMQ.
Added
QueueEndpointandMailEndpointfor topic push.Added JSON format support for topic message push.
Added the
config_fileparameter to themnscmdcommand 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
mnscmdcommand.Upgraded the API protocol to
"x-mns-version"="2015-06-06".Added
BatchSendMessage,BatchReceiveMessage,BatchPeekMessage, andBatchDeleteMessage.
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
SetQueueAttributeto204.
Download: aliyun-mns-python-sdk-1.0.1.zip
1.0.0 (2014-08-01)
Initial release.