Felix Hildén

Thanks for the fast reply! That sounds like it could do the job, but it feels *very* hacky. I partly expected this to not be possible right away. I think...

Totally agree, and thanks for providing the bigger picture! Running the code is an important point. I think it's definitely possible to statically analyse the code to determine imports and...

Makes sense, thanks for clarifying 👍 I suspect it wouldn't be hard to read and concatenate code examples from RST to produce the running code either. And that might be...

Sure! Given that you execute the `.py` file and then make the RST file with its comment blocks, and the use case of much ordinary documentation which is RST interleaved...

That's a very good point, I hadn't considered capturing output. My point was simply that if the starting point for you *could* be RST, then a tool capable of generating...

I've recently implemented the functionality in a new Sphinx extension [sphinx-codeautolink](https://sphinx-codeautolink.readthedocs.io). As I said, the approach was different enough to warrant a new project in my opinion. Execution is fine...

Wow that'd be too kind of you 😅

Also, let me know if my [short thanks](https://sphinx-codeautolink.readthedocs.io/en/stable/#thanks) for you guys is alright! I'd be happy to add something more or change it around a bit if you'd like to...

This issue looks a lot like #44, for which I just posted at least a partial solution from Sphinx 3 (dataclasses). Though I've not tested it with variables defined in...

If I've understood the documentation machinery correctly this would be huge for dataclasses. Big plus.