Maybe allow users to specify return types in docstrings and parse those? Like this:
Gives the current position of the ball.
That way, the difficulty of parsing a dynamically typed language is lessened, and users can still benefit from the added code completion feature. If they dont specify the @returns thing, then there will just be no code completion for it.