838ae8f47c
The zerorpc package is a light-weight, reliable and language-agnostic library for distributed communication between server-side processes. It builds on top of ZeroMQ and MessagePack. This package is required for sysinv ZeroMQ-based RPC backend [1]. TEST PLAN: PASS: Verify STX Debian builds properly PASS: Verify STX Debian deploys properly PASS: Verify zerorpc-python package was properly installed PASS: Verify syinv processes runs properly [1] https://review.opendev.org/c/starlingx/config/+/859571 Story: 2010087 Task: 46794 Signed-off-by: Alyson Deives Pereira <alyson.deivespereira@windriver.com> Change-Id: I62565e2ce39c0bed63506bfcabf909d5cf186ec1
427 lines
16 KiB
Diff
427 lines
16 KiB
Diff
From ec72e722a5628568fe7ba25385d31f8ebcbb8130 Mon Sep 17 00:00:00 2001
|
|
From: Alyson Deives Pereira <alyson.deivespereira@windriver.com>
|
|
Date: Fri, 29 Jul 2022 15:22:30 -0300
|
|
Subject: [PATCH] Allow usage of kwargs
|
|
|
|
Based on https://github.com/0rpc/zerorpc-python/commit/674678de3e4744f86fd186582bc4b31daa86e785
|
|
|
|
Signed-off-by: Alyson Deives Pereira <alyson.deivespereira@windriver.com>
|
|
---
|
|
tests/test_events.py | 14 ++++++------
|
|
tests/test_kwargs.py | 50 +++++++++++++++++++++++++++++++++++++++++
|
|
zerorpc/channel.py | 12 +++++-----
|
|
zerorpc/channel_base.py | 6 ++---
|
|
zerorpc/core.py | 34 ++++++++++++++--------------
|
|
zerorpc/events.py | 20 +++++++++++------
|
|
zerorpc/heartbeat.py | 4 ++--
|
|
zerorpc/patterns.py | 4 ++--
|
|
8 files changed, 100 insertions(+), 44 deletions(-)
|
|
create mode 100644 tests/test_kwargs.py
|
|
|
|
diff --git a/tests/test_events.py b/tests/test_events.py
|
|
index 7acf98e..c9e1c30 100644
|
|
--- a/tests/test_events.py
|
|
+++ b/tests/test_events.py
|
|
@@ -47,25 +47,25 @@ def test_context():
|
|
|
|
def test_event():
|
|
context = MokupContext()
|
|
- event = zerorpc.Event('mylittleevent', (None,), context=context)
|
|
+ event = zerorpc.Event('mylittleevent', (None,), {}, context=context)
|
|
print(event)
|
|
assert event.name == 'mylittleevent'
|
|
assert event.header['message_id'] == 0
|
|
assert event.args == (None,)
|
|
|
|
- event = zerorpc.Event('mylittleevent2', ('42',), context=context)
|
|
+ event = zerorpc.Event('mylittleevent2', ('42',), {}, context=context)
|
|
print(event)
|
|
assert event.name == 'mylittleevent2'
|
|
assert event.header['message_id'] == 1
|
|
assert event.args == ('42',)
|
|
|
|
- event = zerorpc.Event('mylittleevent3', ('a', 42), context=context)
|
|
+ event = zerorpc.Event('mylittleevent3', ('a', 42), {}, context=context)
|
|
print(event)
|
|
assert event.name == 'mylittleevent3'
|
|
assert event.header['message_id'] == 2
|
|
assert event.args == ('a', 42)
|
|
|
|
- event = zerorpc.Event('mylittleevent4', ('', 21), context=context)
|
|
+ event = zerorpc.Event('mylittleevent4', ('', 21), {}, context=context)
|
|
print(event)
|
|
assert event.name == 'mylittleevent4'
|
|
assert event.header['message_id'] == 3
|
|
@@ -79,14 +79,14 @@ def test_event():
|
|
assert unpacked.header['message_id'] == 3
|
|
assert list(unpacked.args) == ['', 21]
|
|
|
|
- event = zerorpc.Event('mylittleevent5', ('c', 24, True),
|
|
+ event = zerorpc.Event('mylittleevent5', ('c', 24, True), {},
|
|
header={'lol': 'rofl'}, context=None)
|
|
print(event)
|
|
assert event.name == 'mylittleevent5'
|
|
assert event.header['lol'] == 'rofl'
|
|
assert event.args == ('c', 24, True)
|
|
|
|
- event = zerorpc.Event('mod', (42,), context=context)
|
|
+ event = zerorpc.Event('mod', (42,), {}, context=context)
|
|
print(event)
|
|
assert event.name == 'mod'
|
|
assert event.header['message_id'] == 4
|
|
@@ -177,7 +177,7 @@ def test_events_push_pull():
|
|
|
|
def test_msgpack():
|
|
context = zerorpc.Context()
|
|
- event = zerorpc.Event(u'myevent', (u'a',), context=context)
|
|
+ event = zerorpc.Event(u'myevent', (u'a',), {}, context=context)
|
|
print(event)
|
|
# note here that str is an unicode string in all Python version (thanks to
|
|
# the builtin str import).
|
|
diff --git a/tests/test_kwargs.py b/tests/test_kwargs.py
|
|
new file mode 100644
|
|
index 0000000..e3d7009
|
|
--- /dev/null
|
|
+++ b/tests/test_kwargs.py
|
|
@@ -0,0 +1,50 @@
|
|
+from __future__ import absolute_import
|
|
+import eventlet
|
|
+
|
|
+import zerorpc
|
|
+from .testutils import teardown, random_ipc_endpoint
|
|
+
|
|
+def test_client_connect():
|
|
+ endpoint = random_ipc_endpoint()
|
|
+
|
|
+ class MySrv(zerorpc.Server):
|
|
+
|
|
+ def echo(self, *args, **kwargs):
|
|
+ return args, kwargs
|
|
+
|
|
+ srv = MySrv()
|
|
+ srv.bind(endpoint)
|
|
+ eventlet.spawn(srv.run)
|
|
+
|
|
+ client = zerorpc.Client()
|
|
+ client.connect(endpoint)
|
|
+
|
|
+ args = 1, 2, 3
|
|
+ kwargs = {'a': 7, 'b': 8}
|
|
+ res = client.echo(*args, **kwargs)
|
|
+ assert len(res) == 2
|
|
+ assert res[0] == args
|
|
+ assert len(res[1]) == 3
|
|
+ assert 'a' in res[1] and 'b' in res[1]
|
|
+
|
|
+def test_client_quick_connect():
|
|
+ endpoint = random_ipc_endpoint()
|
|
+
|
|
+ class MySrv(zerorpc.Server):
|
|
+
|
|
+ def echo(self, *args, **kwargs):
|
|
+ return args, kwargs
|
|
+
|
|
+ srv = MySrv()
|
|
+ srv.bind(endpoint)
|
|
+ eventlet.spawn(srv.run)
|
|
+
|
|
+ client = zerorpc.Client(endpoint)
|
|
+
|
|
+ args = 1, 2, 3
|
|
+ kwargs = {'a': 7, 'b': 8}
|
|
+ res = client.echo(*args, **kwargs)
|
|
+ assert len(res) == 2
|
|
+ assert res[0] == args
|
|
+ assert len(res[1]) == 3
|
|
+ assert 'a' in res[1] and 'b' in res[1]
|
|
diff --git a/zerorpc/channel.py b/zerorpc/channel.py
|
|
index bd376ec..df77bc0 100644
|
|
--- a/zerorpc/channel.py
|
|
+++ b/zerorpc/channel.py
|
|
@@ -55,8 +55,8 @@ class ChannelMultiplexer(ChannelBase):
|
|
if self._channel_dispatcher_task:
|
|
self._channel_dispatcher_task.kill()
|
|
|
|
- def new_event(self, name, args, xheader=None):
|
|
- return self._events.new_event(name, args, xheader)
|
|
+ def new_event(self, name, args, kwargs=None, xheader=None):
|
|
+ return self._events.new_event(name, args, kwargs, xheader)
|
|
|
|
def emit_event(self, event, timeout=None):
|
|
return self._events.emit_event(event, timeout)
|
|
@@ -135,8 +135,8 @@ class Channel(ChannelBase):
|
|
logger.debug('-x- closed channel %s', self._channel_id)
|
|
self._channel_id = None
|
|
|
|
- def new_event(self, name, args, xheader=None):
|
|
- event = self._multiplexer.new_event(name, args, xheader)
|
|
+ def new_event(self, name, args, kwargs=None, xheader=None):
|
|
+ event = self._multiplexer.new_event(name, args, kwargs, xheader)
|
|
if self._channel_id is None:
|
|
self._channel_id = event.header[u'message_id']
|
|
self._multiplexer._active_channels[self._channel_id] = self
|
|
@@ -218,8 +218,8 @@ class BufferedChannel(ChannelBase):
|
|
self.close()
|
|
return
|
|
|
|
- def new_event(self, name, args, xheader=None):
|
|
- return self._channel.new_event(name, args, xheader)
|
|
+ def new_event(self, name, args, kwargs=None, xheader=None):
|
|
+ return self._channel.new_event(name, args, kwargs, xheader)
|
|
|
|
def emit_event(self, event, timeout=None):
|
|
if self._remote_queue_open_slots == 0:
|
|
diff --git a/zerorpc/channel_base.py b/zerorpc/channel_base.py
|
|
index a391b08..35fc695 100644
|
|
--- a/zerorpc/channel_base.py
|
|
+++ b/zerorpc/channel_base.py
|
|
@@ -40,14 +40,14 @@ class ChannelBase(object):
|
|
def close(self):
|
|
raise NotImplementedError()
|
|
|
|
- def new_event(self, name, args, xheader=None):
|
|
+ def new_event(self, name, args, kwargs=None, xheader=None):
|
|
raise NotImplementedError()
|
|
|
|
def emit_event(self, event, timeout=None):
|
|
raise NotImplementedError()
|
|
|
|
- def emit(self, name, args, xheader=None, timeout=None):
|
|
- event = self.new_event(name, args, xheader)
|
|
+ def emit(self, name, args, kwargs=None, xheader=None, timeout=None):
|
|
+ event = self.new_event(name, args, kwargs, xheader)
|
|
return self.emit_event(event, timeout)
|
|
|
|
def recv(self, timeout=None):
|
|
diff --git a/zerorpc/core.py b/zerorpc/core.py
|
|
index 90b1aae..dc2b484 100644
|
|
--- a/zerorpc/core.py
|
|
+++ b/zerorpc/core.py
|
|
@@ -117,10 +117,10 @@ class ServerBase(object):
|
|
lambda m: self._methods[m]._zerorpc_args()
|
|
self._methods['_zerorpc_inspect'] = self._zerorpc_inspect
|
|
|
|
- def __call__(self, method, *args):
|
|
+ def __call__(self, method, *args, **kwargs):
|
|
if method not in self._methods:
|
|
raise NameError(method)
|
|
- return self._methods[method](*args)
|
|
+ return self._methods[method](*args, **kwargs)
|
|
|
|
def _print_traceback(self, protocol_v1, exc_infos):
|
|
logger.exception('')
|
|
@@ -233,7 +233,7 @@ class ClientBase(object):
|
|
return pattern.process_answer(self._context, bufchan, request_event,
|
|
reply_event, self._handle_remote_error)
|
|
|
|
- def __call__(self, method, *args, **kargs):
|
|
+ def __call__(self, method, *args, **kwargs):
|
|
# here `method` is either a string of bytes or an unicode string in
|
|
# Python2 and Python3. Python2: str aka a byte string containing ASCII
|
|
# (unless the user explicitly provide an unicode string). Python3: str
|
|
@@ -251,28 +251,28 @@ class ClientBase(object):
|
|
if isinstance(method, bytes):
|
|
method = method.decode('utf-8')
|
|
|
|
- timeout = kargs.get('timeout', self._timeout)
|
|
+ timeout = kwargs.pop('timeout_', self._timeout)
|
|
channel = self._multiplexer.channel()
|
|
hbchan = HeartBeatOnChannel(channel, freq=self._heartbeat_freq,
|
|
passive=self._passive_heartbeat)
|
|
- bufchan = BufferedChannel(hbchan, inqueue_size=kargs.get('slots', 100))
|
|
+ bufchan = BufferedChannel(hbchan, inqueue_size=kwargs.pop('slots_', 100))
|
|
|
|
xheader = self._context.hook_get_task_context()
|
|
- request_event = bufchan.new_event(method, args, xheader)
|
|
+ request_event = bufchan.new_event(method, args, kwargs, xheader)
|
|
self._context.hook_client_before_request(request_event)
|
|
bufchan.emit_event(request_event)
|
|
|
|
# In python 3.7, "async" is a reserved keyword, clients should now use
|
|
# "async_": support both for the time being
|
|
- if (kargs.get('async', False) is False and
|
|
- kargs.get('async_', False) is False):
|
|
+ async_ = kwargs.pop('async_', False)
|
|
+ if not async_:
|
|
return self._process_response(request_event, bufchan, timeout)
|
|
|
|
return eventlet.spawn(self._process_response, request_event, bufchan,
|
|
timeout)
|
|
|
|
def __getattr__(self, method):
|
|
- return lambda *args, **kargs: self(method, *args, **kargs)
|
|
+ return lambda *args, **kwargs: self(method, *args, **kwargs)
|
|
|
|
|
|
class Server(SocketBase, ServerBase):
|
|
@@ -313,12 +313,12 @@ class Pusher(SocketBase):
|
|
def __init__(self, context=None, zmq_socket=zmq.PUSH):
|
|
super(Pusher, self).__init__(zmq_socket, context=context)
|
|
|
|
- def __call__(self, method, *args):
|
|
- self._events.emit(method, args,
|
|
+ def __call__(self, method, *args, **kwargs):
|
|
+ self._events.emit(method, args, kwargs,
|
|
self._context.hook_get_task_context())
|
|
|
|
def __getattr__(self, method):
|
|
- return lambda *args: self(method, *args)
|
|
+ return lambda *args, **kwargs: self(method, *args, **kwargs)
|
|
|
|
|
|
class Puller(SocketBase):
|
|
@@ -336,10 +336,10 @@ class Puller(SocketBase):
|
|
self.stop()
|
|
super(Puller, self).close()
|
|
|
|
- def __call__(self, method, *args):
|
|
+ def __call__(self, method, *args, **kwargs):
|
|
if method not in self._methods:
|
|
raise NameError(method)
|
|
- return self._methods[method](*args)
|
|
+ return self._methods[method](*args, **kwargs)
|
|
|
|
def _receiver(self):
|
|
while True:
|
|
@@ -349,7 +349,7 @@ class Puller(SocketBase):
|
|
raise NameError(event.name)
|
|
self._context.hook_load_task_context(event.header)
|
|
self._context.hook_server_before_exec(event)
|
|
- self._methods[event.name](*event.args)
|
|
+ self._methods[event.name](*event.args, **event.kwargs)
|
|
# In Push/Pull their is no reply to send, hence None for the
|
|
# reply_event argument
|
|
self._context.hook_server_after_exec(event, None)
|
|
@@ -422,7 +422,7 @@ def fork_task_context(functor, context=None):
|
|
context = context or Context.get_instance()
|
|
xheader = context.hook_get_task_context()
|
|
|
|
- def wrapped(*args, **kargs):
|
|
+ def wrapped(*args, **kwargs):
|
|
context.hook_load_task_context(xheader)
|
|
- return functor(*args, **kargs)
|
|
+ return functor(*args, **kwargs)
|
|
return wrapped
|
|
diff --git a/zerorpc/events.py b/zerorpc/events.py
|
|
index 295220e..f24cc2f 100644
|
|
--- a/zerorpc/events.py
|
|
+++ b/zerorpc/events.py
|
|
@@ -162,15 +162,16 @@ class Receiver(SequentialReceiver):
|
|
|
|
class Event(object):
|
|
|
|
- __slots__ = ['_name', '_args', '_header', '_identity']
|
|
+ __slots__ = ['_name', '_args', '_kwargs', '_header', '_identity']
|
|
|
|
# protocol details:
|
|
# - `name` and `header` keys must be unicode strings.
|
|
# - `message_id` and 'response_to' values are opaque bytes string.
|
|
# - `v' value is an integer.
|
|
- def __init__(self, name, args, context, header=None):
|
|
+ def __init__(self, name, args, kwargs, context, header=None):
|
|
self._name = name
|
|
self._args = args
|
|
+ self._kwargs = kwargs or {}
|
|
if header is None:
|
|
self._header = {u'message_id': context.new_msgid(), u'v': 3}
|
|
else:
|
|
@@ -193,6 +194,10 @@ class Event(object):
|
|
def args(self):
|
|
return self._args
|
|
|
|
+ @property
|
|
+ def kwargs(self):
|
|
+ return self._kwargs
|
|
+
|
|
@property
|
|
def identity(self):
|
|
return self._identity
|
|
@@ -202,7 +207,7 @@ class Event(object):
|
|
self._identity = v
|
|
|
|
def pack(self, encoder=None):
|
|
- payload = (self._header, self._name, self._args)
|
|
+ payload = (self._header, self._name, self._args, self._kwargs)
|
|
r = msgpack.Packer(use_bin_type=True, default=encoder).pack(payload)
|
|
return r
|
|
|
|
@@ -213,7 +218,7 @@ class Event(object):
|
|
unpacked_msg = unpacker.unpack()
|
|
|
|
try:
|
|
- (header, name, args) = unpacked_msg
|
|
+ (header, name, args, kwargs) = unpacked_msg
|
|
except Exception as e:
|
|
raise Exception('invalid msg format "{0}": {1}'.format(
|
|
unpacked_msg, e))
|
|
@@ -222,7 +227,7 @@ class Event(object):
|
|
if not isinstance(header, dict):
|
|
header = {}
|
|
|
|
- return Event(name, args, None, header)
|
|
+ return Event(name, args, kwargs, None, header)
|
|
|
|
def __str__(self, ignore_args=False):
|
|
if ignore_args:
|
|
@@ -237,6 +242,7 @@ class Event(object):
|
|
identity = ', '.join(repr(x.bytes) for x in self._identity)
|
|
return '<{0}> {1} {2} {3}'.format(identity, self._name,
|
|
self._header, args)
|
|
+ # TODO include kwargs?
|
|
return '{0} {1} {2}'.format(self._name, self._header, args)
|
|
|
|
|
|
@@ -333,8 +339,8 @@ class Events(ChannelBase):
|
|
logger.debug('disconnected from %s (status=%s)', endpoint_, r[-1])
|
|
return r
|
|
|
|
- def new_event(self, name, args, xheader=None):
|
|
- event = Event(name, args, context=self._context)
|
|
+ def new_event(self, name, args, kwargs=None, xheader=None):
|
|
+ event = Event(name, args, kwargs, context=self._context)
|
|
if xheader:
|
|
event.header.update(xheader)
|
|
return event
|
|
diff --git a/zerorpc/heartbeat.py b/zerorpc/heartbeat.py
|
|
index daa7d50..7bd1166 100644
|
|
--- a/zerorpc/heartbeat.py
|
|
+++ b/zerorpc/heartbeat.py
|
|
@@ -101,10 +101,10 @@ class HeartBeatOnChannel(ChannelBase):
|
|
return LostRemote('Lost remote after {0}s heartbeat'.format(
|
|
self._heartbeat_freq * 2))
|
|
|
|
- def new_event(self, name, args, header=None):
|
|
+ def new_event(self, name, args, kwargs=None, header=None):
|
|
if self._compat_v2 and name == u'_zpc_more':
|
|
name = u'_zpc_hb'
|
|
- return self._channel.new_event(name, args, header)
|
|
+ return self._channel.new_event(name, args, kwargs, header)
|
|
|
|
def emit_event(self, event, timeout=None):
|
|
if self._lost_remote:
|
|
diff --git a/zerorpc/patterns.py b/zerorpc/patterns.py
|
|
index 3623e17..a6f44f1 100644
|
|
--- a/zerorpc/patterns.py
|
|
+++ b/zerorpc/patterns.py
|
|
@@ -27,7 +27,7 @@ class ReqRep(object):
|
|
|
|
def process_call(self, context, channel, req_event, functor):
|
|
context.hook_server_before_exec(req_event)
|
|
- result = functor(*req_event.args)
|
|
+ result = functor(*req_event.args, **req_event.kwargs)
|
|
rep_event = channel.new_event(u'OK', (result,),
|
|
context.hook_get_task_context())
|
|
context.hook_server_after_exec(req_event, rep_event)
|
|
@@ -54,7 +54,7 @@ class ReqStream(object):
|
|
def process_call(self, context, channel, req_event, functor):
|
|
context.hook_server_before_exec(req_event)
|
|
xheader = context.hook_get_task_context()
|
|
- for result in iter(functor(*req_event.args)):
|
|
+ for result in iter(functor(*req_event.args, **req_event.kwargs)):
|
|
channel.emit(u'STREAM', result, xheader)
|
|
done_event = channel.new_event(u'STREAM_DONE', None, xheader)
|
|
# NOTE: "We" made the choice to call the hook once the stream is done,
|
|
--
|
|
2.25.1
|
|
|