Thanks for putting quite some effort into this. However, I don't understand why you want to use TODO(<user>) to be set globally for everything? This would, for example, end up in:

def myMethod(self: MyClass, p1: Sequence[T]) -> Generator[int, float, str]:
    """
    TODO(<user>)

    :param self MyClass: TODO(<user>)
    :param p1 Sequence[T]: TODO(<user>)
    :rtype Generator[int, float, str]: TODO(<user>)
    """
    pass

I'm not seeing in why this would be useful. I can understand it if you want to add more context to what the TODO should contain.

For example, this would be logical in a scenario where the numpy doc for Python has two TODO items at the top but it's not super clear what it should be. NOTE: I am planning to build this soon, giving more context to TODO items.

Then this output would be more logical:

    def call(self, *args: str, **kwargs: str) -> str:
        """
        TODO(<summary>)
        
        TODO(<description>)
        
        Parameters
        ----------
        self : any
            TODO(<description>)
        args : str
            TODO(<description>)
        kwargs : str
            TODO(<description>)
        
        Returns
        -------
        str:
            TODO(<description>)
        """
        pass

but this is not what you've submitted, so please, explain why this would be useful.

Well, my case is that I have script for listing TODOs that matches only my TODO(<user>) because I work on large codebase with a lot of other people. I did this so that they could play along nicely, but I thought that someone else might have same inconvenience. Also, I don't have to keep my fork up to date.

As for the adding context to TODOs, it doesn't seem like that much extra work, I could add it if you want.

I will add the context feature for now by myself, however I don't think this is something DoGe needs. If you want to give your descriptions more context for certain users you work with then this is a content issue and up to the user to add.

I'll close the issue for now. Thanks for submitting your idea.

The TODO context support is released in v1.4.0.