nameko wamp

Web Application Messaging Protocol (WAMP) for the nameko microservices framework

Nameko Wamp provides Extensions for WAMP PUB-SUB and RPC. Here is a (silly) example service implementing WAMP entrypoints.

from nameko_wamp.extensions.dependencies import Caller, Publisher
from nameko_wamp.extensions.entrypoints import consume, callee


class WeatherService:

    name = "weather_service"

    caller = Caller()
    publihser = Publisher()

    @callee
    def get_weather(self):
        # the weather is always sunny here!
        return "sunny"

    @consume
    def weather_updates(self, topic_data):
        # and do something with the new weather data here
        pass

One method is marked as a “callee”, which is a WAMP Role, and another is marked as a WAMP “caller” Role. The former is callable over RPC and is (almost) exactly the same as the nameko rpc Extension. The latter consumes from a WAMP Topic and appears exactly the same as the nameko event_handler Extension.

There is also the dependency injection caller. Yet another WAMP Role, this allows outgoing RPC calls from your service to other nameko services. Finally the WAMP Role publisher dependency which allows a service API to publish messages to WAMP Topics.

with Client(router=router) as client:
    result = client.rpc.get_weather()
    assert result == "sunny"

    # and publish to a Topic
    client.publish(topic="foobar", message={...})

$ pip install --editable .[dev]
$ py.test ./test -vs