Google Git
Sign in
apache / rocketmq-client-python / e0de2b6abaeb4d8c9ffd381172227e7abddf4784
commite0de2b6abaeb4d8c9ffd381172227e7abddf4784[log] [tgz]
authormessense <messense@icloud.com>Wed Aug 28 17:54:51 2019 +0800
committermessense <messense@icloud.com>Thu Oct 17 15:43:39 2019 +0800
tree2e211287f24bccaa1e70b6405b73df38d6779b1e
parent8d3ab1c33e1cd691cbb60d880a5e54d82caa1017 [diff]
Clarify Windows support
2 files changed
tree: 2e211287f24bccaa1e70b6405b73df38d6779b1e
  1. .github/
  2. rocketmq/
  3. tests/
  4. .bumpversion.cfg
  5. .coveragerc
  6. .gitignore
  7. .travis.yml
  8. changelog
  9. CONTRIBUTING.md
  10. dev-requirements.txt
  11. LICENSE
  12. MANIFEST.in
  13. manylinux.sh
  14. NOTICE
  15. PULL_REQUEST_TEMPLATE.md
  16. pytest.ini
  17. README.md
  18. setup.cfg
  19. setup.py
README.md

rocketmq-python

Build Status codecov PyPI

RocketMQ Python client, based on rocketmq-client-cpp, supports Linux and macOS

Installation

pip install rocketmq

Usage

Producer

from rocketmq.client import Producer, Message

producer = Producer('PID-XXX')
producer.set_namesrv_domain('http://onsaddr-internet.aliyun.com/rocketmq/nsaddr4client-internet')
# For ip and port name server address, use `set_namesrv_addr` method, for example:
# producer.set_namesrv_addr('127.0.0.1:9887')
producer.set_session_credentials('XXX', 'XXXX', 'ALIYUN') # No need to call this function if you don't use Aliyun.
producer.start()

msg = Message('YOUR-TOPIC')
msg.set_keys('XXX')
msg.set_tags('XXX')
msg.set_body('XXXX')
ret = producer.send_sync(msg)
print(ret.status, ret.msg_id, ret.offset)
producer.shutdown()

PushConsumer

import time

from rocketmq.client import PushConsumer


def callback(msg):
    print(msg.id, msg.body)


consumer = PushConsumer('CID_XXX')
consumer.set_namesrv_domain('http://onsaddr-internet.aliyun.com/rocketmq/nsaddr4client-internet')
# For ip and port name server address, use `set_namesrv_addr` method, for example:
# consumer.set_namesrv_addr('127.0.0.1:9887')
consumer.set_session_credentials('XXX', 'XXXX', 'ALIYUN') # No need to call this function if you don't use Aliyun.
consumer.subscribe('YOUR-TOPIC', callback)
consumer.start()

while True:
    time.sleep(3600)

consumer.shutdown()

PullConsumer

from rocketmq.client import PullConsumer


consumer = PullConsumer('CID_XXX')
consumer.set_namesrv_domain('http://onsaddr-internet.aliyun.com/rocketmq/nsaddr4client-internet')
# For ip and port name server address, use `set_namesrv_addr` method, for example:
# consumer.set_namesrv_addr('127.0.0.1:9887')
consumer.set_session_credentials('XXX', 'XXXX', 'ALIYUN') # No need to call this function if you don't use Aliyun.
consumer.start()

for msg in consumer.pull('YOUR-TOPIC'):
    print(msg.id, msg.body)

consumer.shutdown()

License

This work is released under the MIT license. A copy of the license is provided in the LICENSE file.