Ieremies · 2022-04-02 16:26
I've been programming in python for a few years now and recently I started in my first job as a python backend programmer. Never liked using those big IDE but, since my whole team uses VS Code, I thought to give it a go and generate the least amount of friction on the first week. Yeah, didn't like.
BUT what I've loved was a VS Code extension named "auto doc string" which could automatically create a doc string and already place some information, like which arguments, what are the returns and, most important, type annotations were reflected in the doc string.
Sure, there must be a package in emacs that could do all that, right? I have yet to found it. The closest I got was [yasnippet-radical-snippets](https://github.com/Xaldew/yasnippet-radical-snippets), but it doesn't support types (yet).
Does anyone know a better tool for the job?
TheHentaiSama · 2022-04-02 17:30
There is sphinx doc : https://github.com/naiquevin/sphinx-doc.el
It really does a good job but only for the sphinx format. I personally prefer the google format but i have yet to find something for this.
But yeah, if you don’t have any problem with the sphinx format this one is great ! =D
stochastic_forests · 2022-04-02 18:47
If you’re using numpydoc styling, this has support for type hinting: https://github.com/douglasdavis/numpydoc.el
Extension_Try_6870 · 2022-04-03 16:39
There is https://github.com/jcs-elpa/docstr
I couldn't get it to work though.
NoisyFrequency · 2022-04-04 11:46
I like it very much, it's on point most of the time.
TheHentaiSama · 2022-04-04 19:21
Just wanted to say that I tried this one just now and it's amazing. I highly recommand using this one. Very powerful and customizable.