String manipulation in Python docstrings

Question

I've been trying to do the following:

#[...]
    def __history_dependent_simulate(self, node, iterations=1,
                                     *args, **kwargs):
        """
        For history-dependent simulations only:
        """ + self.simulate.__doc___

What I tried to accomplish here is to have the same documentation for this private method as the documentation of the method simulate, except with a short introduction. This would allow me to avoid copy-pasting, keep a shorter file and not have to update the documentation for two functions every time.

But it doesn't work. Does anyone know of a reason why, or whether there is a solution?

Anthony Towns · Accepted Answer · 2009-10-05 09:41:11Z

9

A better solution is probably to use a decorator, eg:

def add_docs_for(other_func):  
    def dec(func):  
        func.__doc__ = other_func.__doc__ + "\n\n" + func.__doc__
        return func
    return dec

def foo():
    """documentation for foo"""
    pass

@add_docs_for(foo)
def bar():
    """additional notes for bar"""
    pass

help(bar) # --> "documentation for foo // additional notes for bar"

That way you can do arbitrary manipulations of docstrings.

answered Oct 5, 2009 at 9:41

Anthony Towns

2,9332 gold badges19 silver badges23 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

Anthony Towns Over a year ago

Arbitrary manipulation means you could do have "SEE DOCS FOR >foo<" in the docstring, and have the decorator use re to replace that with foo.__doc__, eg.

unwind · Accepted Answer · 2009-10-05 09:41:58Z

2

I think this section makes it pretty clear:

What is a Docstring?

A docstring is a string literal that occurs as the first statement in a module, function, class, or method definition. Such a docstring becomes the doc special attribute of that object.

So, it's not an expression that evaluates into a string, it's a string literal.

answered Oct 5, 2009 at 9:41

unwind

402k64 gold badges492 silver badges620 bronze badges

Collectives™ on Stack Overflow

String manipulation in Python docstrings

2 Answers 2

1 Comment

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

2 Answers 2

1 Comment

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related