Google Git
Sign in
apache / rocketmq-client-python / 48f7cf9470e83ac142a360b4d96c5fd71e0a3013
commit48f7cf9470e83ac142a360b4d96c5fd71e0a3013[log] [tgz]
authorvon gosling <vongosling@apache.org>Mon Oct 19 09:27:27 2020 +0800
committerGitHub <noreply@github.com>Mon Oct 19 09:27:27 2020 +0800
treec18fc4e8a1caecc25cca7fad047cb580a93cc702
parent58397dc86d85d1b16a4d949c430e7499722050b5 [diff]
parent89ad6bde4351ecafa582770a3826ac9c660134b9 [diff]
Merge pull request #100 from tom0392/multi-threaded

[ISSUE #99]Add a function which shows how to use rocketmq in multi-threaded scen…
tree: c18fc4e8a1caecc25cca7fad047cb580a93cc702
  1. .github/
  2. ci/
  3. rocketmq/
  4. samples/
  5. tests/
  6. .bumpversion.cfg
  7. .coveragerc
  8. .gitignore
  9. .travis.yml
  10. CONTRIBUTING.md
  11. dev-requirements.txt
  12. LICENSE
  13. MANIFEST.in
  14. manylinux.sh
  15. NOTICE
  16. PULL_REQUEST_TEMPLATE.md
  17. pytest.ini
  18. README.md
  19. setup.cfg
  20. setup.py
README.md

rocketmq-client-python

License Build Status codecov PyPI GitHub release Average time to resolve an issue Percentage of issues still open Twitter Follow

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

Prerequisites

Install librocketmq

rocketmq-client-python is a lightweight wrapper around rocketmq-client-cpp, so you need install librocketmq first.

Download by binary release.

download specific release according you OS: rocketmq-client-cpp-2.0.0

  • centos

    take centos7 as example, you can install the library in centos6 by the same method.

        wget https://github.com/apache/rocketmq-client-cpp/releases/download/2.0.0/rocketmq-client-cpp-2.0.0-centos7.x86_64.rpm
    sudo rpm -ivh rocketmq-client-cpp-2.0.0-centos7.x86_64.rpm

  • debian

        wget https://github.com/apache/rocketmq-client-cpp/releases/download/2.0.0/rocketmq-client-cpp-2.0.0.amd64.deb
    sudo dpkg -i rocketmq-client-cpp-2.0.0.amd64.deb

  • macOS

        wget https://github.com/apache/rocketmq-client-cpp/releases/download/2.0.0/rocketmq-client-cpp-2.0.0-bin-release.darwin.tar.gz
    tar -xzf rocketmq-client-cpp-2.0.0-bin-release.darwin.tar.gz
    cd rocketmq-client-cpp
    mkdir /usr/local/include/rocketmq
    cp include/* /usr/local/include/rocketmq
    cp lib/* /usr/local/lib
    install_name_tool -id "@rpath/librocketmq.dylib" /usr/local/lib/librocketmq.dylib

Build from source

you can also build it manually from source according to Build and Install

Installation

pip install rocketmq-client-python

Usage

Producer

from rocketmq.client import Producer, Message

producer = Producer('PID-XXX')
producer.set_name_server_address('127.0.0.1:9876')
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, ConsumeStatus


def callback(msg):
    print(msg.id, msg.body)
    return ConsumeStatus.CONSUME_SUCCESS


consumer = PushConsumer('CID_XXX')
consumer.set_name_server_address('127.0.0.1:9876')
consumer.subscribe('YOUR-TOPIC', callback)
consumer.start()

while True:
    time.sleep(3600)

consumer.shutdown()

License

Apache License, Version 2.0 Copyright (C) Apache Software Foundation