-
-
Notifications
You must be signed in to change notification settings - Fork 32.4k
Closed
Labels
docsDocumentation in the Doc dirDocumentation in the Doc dir
Description
While technically Python modules are mutable and every name can be overridden, some names are not intended to be changed. Sphinx has a special directive for this: :const:
. I think that it is better to use semantically more specific :const:
instead of general :data:
in these cases.
First of all it is all-uppercase names, but there are exceptions: curses.LINES
and curses.COLS
are changed after terminal changes size. But some lowercase names like os.sep
and string.ascii_letters
are also clearly constants.
Linked PRs
Metadata
Metadata
Assignees
Labels
docsDocumentation in the Doc dirDocumentation in the Doc dir