OK, but in requests they are top-level functions, not methods. Is there anything... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

		Myrmornis on July 16, 2015 \| parent \| context \| favorite \| on: Ask HN: Good Python codebases to read? OK, but in requests they are top-level functions, not methods. Is there anything wrong with the below? I don't think I've seen it done. `__shared_docstring_content = """ bar baz """ def f(): "f docstring" pass f.__doc__ += __shared_docstring_content def g(): "g docstring" pass g.__doc__ += __shared_docstring_content`

andreasvc on July 16, 2015 [–]

I would do simply """f docstring\n%s""" % _shared_docstring, no need for a separate concatenation. However, I wonder whether sphinx would handle this.

shoyer on July 17, 2015 | [–]

This sort of thing works fine. We use it for pandas all the time.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact