autoDocstring icon indicating copy to clipboard operation
autoDocstring copied to clipboard

Added class and module docstrings

Open tracetidwell opened this issue 4 years ago • 21 comments

class docstrings are created under the class definition. They read parameters from the init() method and scan the entire class for attributes. Both parameters and attributes are listed.

module docstrings are created at the first line of the script. They scan the entire file and list out all top-level classes and methods defined therein.

All tests are passing, and I added a few unit tests and integration tests. I am not an expert at TypeScript, so this might can be improved, but I've been using this on my code for a few months now with no problems.

tracetidwell avatar Jan 29 '21 18:01 tracetidwell

Hi this pr looks fantastic! I will review it this weekend.

NilsJPWerner avatar Feb 04 '21 04:02 NilsJPWerner

@NilsJPWerner any updates on your side?

bnonni avatar Feb 25 '21 17:02 bnonni

Nice work this would be awesome!

michaeloliverx avatar Mar 05 '21 11:03 michaeloliverx

@tracetidwell thank you for contributing to this project. This feature would help out so many of us that have expressed interest in issue #27. It would be really helpful if you addressed the comments that the repo owner @NilsJPWerner has requested, then he can followup and get this merged and published for us all to use :)

lieutdan13 avatar Oct 04 '21 19:10 lieutdan13

After way, WAY too long, I am going to finish this. I resolved a number of issues, left comments on a couple others, and need to work on the rest. If this is not being maintained or doesn't seem worth it, please let me know.

tracetidwell avatar Feb 04 '22 20:02 tracetidwell

I haven't touched this repo in years, but I think I still have the repo cloned locally. @tracetidwell let me know if you need something from me. would love to help get this completed and merged.

bnonni avatar Feb 04 '22 21:02 bnonni

Any news on this?

trycoast avatar Apr 25 '22 21:04 trycoast

Bumping this again? Would love to see this merged? If not, does anyone know any alternatives?

MaddyGuthridge avatar Jun 29 '22 09:06 MaddyGuthridge

If @tracetidwell or someone else wants to pick up the PR again or start fresh I would be happy to review and merge. Right now I am focused on adding the ability to update docstrings, and so work on module and class docstrings will have to come afterwards.

NilsJPWerner avatar Jun 29 '22 15:06 NilsJPWerner

WANT!

silopolis avatar Sep 13 '22 17:09 silopolis

This would be super nice, someone finalize this and add it

NathanNull avatar Oct 04 '22 02:10 NathanNull

Yes, please make this happen 🙏

trycoast avatar Oct 04 '22 08:10 trycoast

Really, sitting in this state for over two years? I don't think this is being maintained any longer.

FrankC01 avatar Feb 01 '23 09:02 FrankC01

Need this please, ASAP!

ishandandekar avatar Feb 04 '23 11:02 ishandandekar

Any updates on this?

mjspeck avatar May 08 '23 21:05 mjspeck

Did anyone perhaps forked and added this feature? I would love to use it! It appears the repo's owner forsaken this project, as there were no pushes made in over a year.

Yuval1337 avatar Jun 08 '23 13:06 Yuval1337