@@ -252,7 +252,11 @@ logging-modules=logging
252252[BASIC]
253253
254254# Good variable names which should always be accepted, separated by a comma
255- good-names=i,j,k,ex,Run,_
255+ # DEFAULT: good-names=i,j,k,ex,Run,_
256+ # RATIONALE: 'pb' and 'id' have well-understood meainings in the code.
257+ good-names = i, j, k, ex, Run, _,
258+ pb,
259+ id,
256260
257261# Bad variable names which should always be refused, separated by a comma
258262bad-names=foo,bar,baz,toto,tutu,tata
@@ -323,14 +327,18 @@ module-rgx=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
323327module-name-hint=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
324328
325329# Regular expression matching correct method names
326- method-rgx=[a-z_][a-z0-9_]{2,30}$
330+ # DEFAULT: method-rgx=[a-z_][a-z0-9_]{2,30}$
331+ # RATIONALE: mapping long API names onto connection methods
332+ method-rgx=[a-z_][a-z0-9_]{2,35}$
327333
328334# Naming hint for method names
329335method-name-hint=[a-z_][a-z0-9_]{2,30}$
330336
331337# Regular expression which should only match function or class names that do
332338# not require a docstring.
333- no-docstring-rgx=^_
339+ # DEFAULT: no-docstring-rgx=^_
340+ # RATIONALE: More documentation, even for non-public methods, is useful.
341+ no-docstring-rgx=__.*__
334342
335343# Minimum line length for functions/classes that require docstrings, shorter
336344# ones are exempt.
0 commit comments