Custom entrypoints

I’m trying to automate some documentation on my services, and I’m struggling to get things to work. I’m new to nameko, only used it for testing and I’m feeling a little lost to get something more advanced like this to work.

Problem is that I have no idea where/how to collect class and method information to get the data I need: the closest thing I got was to write a class Documentation(Rpc) and rpc = Documentation.decorator and use that decorator instead to access the service class with self.container.service_cls, but it seems that it executes for every method, and I need to group the information up. Also I have no idea how I could access the Documentation instance inside the action later.

In resume, what I want to accomplish it:

• Write a normal service
• Do something really simple if needed to the service (like a dependency docs = Documentation())
• A new rpc method “documentation” will be added automatically (without writing additional code) and it should return the docstrings from the class and its methods
• Should be able to call n.rpc.myservice.documentation() and get the data I need

Example

How service is written

class Service:
    """a docstring"""
    name = "myservice"

    @rpc
    def test(self):
        """another docstring"""
        return True

How service will behave like

class Service:
    """a docstring"""
    name = "myservice"

    @rpc
    def test(self):
        """another docstring"""
        return True

    @rpc
    def documentation(self):
        return { 
            "service": "a doc string",
            "methods": {
                "test": "another docstring", 
            }
        }

Thoughts?

[davidszotten]

for future reference, the mailinglist is probably a better place for questions like this. thanks

[mattbennett]

This issue was moved to https://discourse.nameko.io/t/custom-entrypoints/300