@@ -125,15 +125,25 @@ disable=print-statement,
125
125
xreadlines-attribute,
126
126
deprecated-sys-function,
127
127
exception-escape,
128
- comprehension-escape
128
+ comprehension-escape,
129
+ missing-module-docstring
130
+
131
+ # missing-module-docstring^^:
132
+ # This wants to require a docstring at the top of every file. We don't
133
+ # always want that; particularly for __init__.py files. If there was a way
134
+ # to disable this for only __init__.py files, that would be better. Some of
135
+ # our __init__.py files are are auto-generated (e.g., for versioning). Until
136
+ # we find a way to do that without a comment in the file (which is roughly
137
+ # the same as a docstring), just disable this check.
129
138
130
139
# Enable the message, report, category or checker with the given id(s). You can
131
140
# either give multiple identifier separated by comma (,) or put this option
132
141
# multiple time (only on the command line, not in the configuration file where
133
142
# it should appear only once). See also the "--disable" option for examples.
134
143
enable =blacklisted-name,
135
144
invalid-name,
136
- missing-docstring,
145
+ missing-function-docstring,
146
+ missing-class-docstring,
137
147
empty-docstring,
138
148
unneeded-not,
139
149
singleton-comparison,
@@ -373,14 +383,6 @@ enable=blacklisted-name,
373
383
bad-thread-instantiation,
374
384
shallow-copy-environ
375
385
376
- # This wants to require a docstring at the top of every file. We don't always
377
- # want that; particularly for __init__.py files. If there was a way to disable
378
- # this for only __init__.py files, that would be better as some of ours are
379
- # auto-generated. Until we find a way to to that without a comment in the file
380
- # (which is roughly the same as a docstring), we'll do this:
381
- disable =missing-module-docstring
382
-
383
-
384
386
[REPORTS]
385
387
386
388
# Python expression which should return a note less than 10 (10 is the highest
0 commit comments