Should __main__.py really be considered a public module?

[CobaltCause]

Reading this, I wouldn't think so; it seems to imply that nothing should be defined in that file and then imported elsewhere. Yet, ruff will give me such errors as D100 Missing docstring in public module in __main__.py, which I found surprising. I'm not entirely certain which behavior is correct, though.

[JonathanPlasse]

According to pydocstyle implementation, __main__.py is public.

[CobaltCause]

Looking at git blame, that code hasn't been touched since 2020-09-05. Clicking through the version history on the page I linked in the issue description, __main__.py was added in Python 3.10 which was released on 2021-10-04. So I think pydocstyle simply doesn't account for this, since that code was written before this feature existed. Maybe I should open an issue over there as well?

[charliermarsh]

I think it's worth asking over there, even just to get an opinion (regardless of whether it's changed in pydocstyle).

[CobaltCause]

I've opened PyCQA/pydocstyle#644

[charliermarsh]

Thanks :)

[charliermarsh]

I'm gonna close for now to keep the issue tracker actionable.

[CobaltCause]

Looks like pydocstyle was deprecated in favor of ruff somewhat recently