24
Are docstrings commonly used? (programming.dev)
submitted 2 weeks ago by 3rr4tt1c@programming.dev to c/python@programming.dev
15 comments fedilink hide all child comments

Was going through a Python tutorial, but it seems kinda dated. Wanted to know if people regularly use docstrings in the workforce. Or are they somewhat irrelevant because you can convey most of that info via comments and context? Do jobs make you use them?

you are viewing a single comment's thread
view the rest of the comments
[-] logging_strict@programming.dev 1 points 1 week ago* (last edited 1 week ago)

i use interrogate

Which has a fun bug. Uses ast to compile every module. If a module contains a compile error, get a traceback showing only the one line that contains the issue, but not the module path nor the line #

The only way to find the issue is to just test your code base and ignore interrogate until code base is more mature.

interrogate author and maintainers: UX ... what's that?

The most obvious bug in the history of bugs ... setuptools maintainers, oh that's a feature request

this post was submitted on 05 Apr 2025
24 points (92.9% liked)

Python

7021 readers
1 users here now

Welcome to the Python community on the programming.dev Lemmy instance!

📅 Events

PastNovember 2023

October 2023

July 2023

August 2023

September 2023

🐍 Python project:
💓 Python Community:
✨ Python Ecosystem:
🌌 Fediverse
Communities
Projects
Feeds

founded 2 years ago
MODERATORS
erlingur@programming.dev
jnovinger@programming.dev
norambna@programming.dev