blob: b752ee50e833a510f0ae7bfd8b4a4f23e48b1e41 [file] [log] [blame]
Claudiu Popa0d9e17a2018-10-02 09:52:23 +02001[MASTER]
2
3# Specify a configuration file.
4#rcfile=
5
6# Python code to execute, usually for sys.path manipulation such as
7
8# pygtk.require().
9#init-hook=
10
11# Profiled execution.
12profile=no
13
14# Add files or directories to the blacklist. They should be base names, not
15
16# paths.
17ignore=CVS
18
19# Pickle collected data for later comparisons.
20persistent=yes
21
22# List of plugins (as comma separated values of python modules names) to load,
23
24# usually to register additional checkers.
25load-plugins=
26
27# Use multiple processes to speed up Pylint.
28jobs=1
29
30# Allow loading of arbitrary C extensions. Extensions are imported into the
31
32# active Python interpreter and may run arbitrary code.
33unsafe-load-any-extension=no
34
35# A comma-separated list of package or module names from where C extensions may
36
37# be loaded. Extensions are loading into the active Python interpreter and may
38
39# run arbitrary code
40extension-pkg-whitelist=
41
42
43[REPORTS]
44
45# Set the output format. Available formats are text, parseable, colorized, msvs
46
47# (visual studio) and html. You can also give a reporter class, eg
48
49# mypackage.mymodule.MyReporterClass.
50output-format=text
51
52# Put messages in a separate file for each module / package specified on the
53
54# command line instead of printing them on stdout. Reports (if any) will be
55
56# written in a file name "pylint_global.[txt|html]".
57files-output=no
58
59# Tells whether to display a full report or only the messages
60reports=yes
61
62# Python expression which should return a note less than 10 (10 is the highest
63
64# note). You have access to the variables errors warning, statement which
65
66# respectively contain the number of errors / warnings messages and the total
67
68# number of statements analyzed. This is used by the global evaluation report
69
70# (RP0004).
71evaluation=10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)
72
73# Template used to display messages. This is a python new-style format string
74
75# used to format the message information. See doc for all details
76#msg-template=
77
78
79[MESSAGES CONTROL]
80
81# Only show warnings with the listed confidence levels. Leave empty to show
82
83# all. Valid levels: HIGH, INFERENCE, INFERENCE_FAILURE, UNDEFINED
84confidence=
85
Claudiu Popa0d9e17a2018-10-02 09:52:23 +020086
87# Disable the message, report, category or checker with the given id(s). You
88
89# can either give multiple identifiers separated by comma (,) or put this
90
91# option multiple times (only on the command line, not in the configuration
92
93# file where it should appear only once).You can also use "--disable=all" to
94
95# disable everything first and then reenable specific checks. For example, if
96
97# you want to run only the similarities checker, you can use "--disable=all
98
99# --enable=similarities". If you want to run only the classes checker, but have
100
101# no Warning level messages displayed, use"--disable=all --enable=classes
102
103# --disable=W"
104
105disable=fixme,invalid-name, missing-docstring, too-few-public-methods,
106 too-many-public-methods,
107 # We know about it and we're doing our best to remove it
108 # in 2.0
109 cyclic-import,
110 # The check is faulty in most cases and it doesn't take in
111 # account how the variable is being used. For instance,
112 # using a variable that is a list or a generator in an
113 # iteration context is fine.
114 redefined-variable-type,
115 # Requires major redesign for fixing this (and private
116 # access in the same project is fine)
117 protected-access,
118 # Most of them are conforming to an API. Putting staticmethod
119 # all over the place changes the aesthetics when these methods
120 # are following a local pattern (visit methods for instance).
121 no-self-use,
122 # API requirements in most of the occurrences
123 unused-argument,
124 # Not very useful when it warns about imports.
125 duplicate-code,
126 # Don't care about these two too much
127 wrong-import-order,
128 wrong-import-position,
129 # We'll have to disable this until we drop support for Python 2
Claudiu Popa3d58a622018-10-02 09:52:44 +0200130 stop-iteration-return,
131 # black handles these
Claudiu Popae2f3dbd2019-01-15 14:05:57 +0100132 format,
133 # temporary until we fix the problems with InferenceContexts
134 no-member
Claudiu Popa0d9e17a2018-10-02 09:52:23 +0200135
136
137[BASIC]
138
139# List of builtins function names that should not be used, separated by a comma
140bad-functions=
141
142# Good variable names which should always be accepted, separated by a comma
143good-names=i,j,k,ex,Run,_
144
145# Bad variable names which should always be refused, separated by a comma
146bad-names=foo,bar,baz,toto,tutu,tata
147
148# Colon-delimited sets of names that determine each other's naming style when
149
150# the name regexes allow several styles.
151name-group=
152
153# Include a hint for the correct naming format with invalid-name
154include-naming-hint=no
155
156# Regular expression matching correct attribute names
157attr-rgx=[a-z_][a-z0-9_]{2,30}$
158
159# Naming hint for attribute names
160attr-name-hint=[a-z_][a-z0-9_]{2,30}$
161
162# Regular expression matching correct constant names
163const-rgx=(([A-Z_][A-Z0-9_]*)|(__.*__))$
164
165# Naming hint for constant names
166const-name-hint=(([A-Z_][A-Z0-9_]*)|(__.*__))$
167
168# Regular expression matching correct method names
169method-rgx=[a-z_][a-z0-9_]{2,30}$
170
171# Naming hint for method names
172method-name-hint=[a-z_][a-z0-9_]{2,30}$
173
174# Regular expression matching correct inline iteration names
175inlinevar-rgx=[A-Za-z_][A-Za-z0-9_]*$
176
177# Naming hint for inline iteration names
178inlinevar-name-hint=[A-Za-z_][A-Za-z0-9_]*$
179
180# Regular expression matching correct class names
181class-rgx=[A-Z_][a-zA-Z0-9]+$
182
183# Naming hint for class names
184class-name-hint=[A-Z_][a-zA-Z0-9]+$
185
186# Regular expression matching correct argument names
187argument-rgx=[a-z_][a-z0-9_]{2,30}$
188
189# Naming hint for argument names
190argument-name-hint=[a-z_][a-z0-9_]{2,30}$
191
192# Regular expression matching correct module names
193module-rgx=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
194
195# Naming hint for module names
196module-name-hint=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
197
198# Regular expression matching correct function names
199function-rgx=[a-z_][a-z0-9_]{2,30}$
200
201# Naming hint for function names
202function-name-hint=[a-z_][a-z0-9_]{2,30}$
203
204# Regular expression matching correct variable names
205variable-rgx=[a-z_][a-z0-9_]{2,30}$
206
207# Naming hint for variable names
208variable-name-hint=[a-z_][a-z0-9_]{2,30}$
209
210# Regular expression matching correct class attribute names
211class-attribute-rgx=([A-Za-z_][A-Za-z0-9_]{2,30}|(__.*__))$
212
213# Naming hint for class attribute names
214class-attribute-name-hint=([A-Za-z_][A-Za-z0-9_]{2,30}|(__.*__))$
215
216# Regular expression which should only match function or class names that do
217
218# not require a docstring.
219no-docstring-rgx=__.*__
220
221# Minimum line length for functions/classes that require docstrings, shorter
222
223# ones are exempt.
224docstring-min-length=-1
225
226
227[FORMAT]
228
229# Maximum number of characters on a single line.
230max-line-length=100
231
232# Regexp for a line that is allowed to be longer than the limit.
233ignore-long-lines=^\s*(# )?<?https?://\S+>?$
234
235# Allow the body of an if to be on the same line as the test if there is no
236
237# else.
238single-line-if-stmt=no
239
240# List of optional constructs for which whitespace checking is disabled
241no-space-check=trailing-comma,dict-separator
242
243# Maximum number of lines in a module
244max-module-lines=3000
245
246# String used as indentation unit. This is usually " " (4 spaces) or "\t" (1
247
248# tab).
249indent-string=' '
250
251# Number of spaces of indent required inside a hanging or continued line.
252indent-after-paren=4
253
254# Expected format of line ending, e.g. empty (any line ending), LF or CRLF.
255expected-line-ending-format=
256
257
258[LOGGING]
259
260# Logging modules to check that the string format arguments are in logging
261
262# function parameter format
263logging-modules=logging
264
265
266[MISCELLANEOUS]
267
268# List of note tags to take in consideration, separated by a comma.
269notes=FIXME,XXX,TODO
270
271
272[SIMILARITIES]
273
274# Minimum lines number of a similarity.
275min-similarity-lines=4
276
277# Ignore comments when computing similarities.
278ignore-comments=yes
279
280# Ignore docstrings when computing similarities.
281ignore-docstrings=yes
282
283# Ignore imports when computing similarities.
284ignore-imports=no
285
286
287[SPELLING]
288
289# Spelling dictionary name. Available dictionaries: none. To make it working
290
291# install python-enchant package.
292spelling-dict=
293
294# List of comma separated words that should not be checked.
295spelling-ignore-words=
296
297# A path to a file that contains private dictionary; one word per line.
298spelling-private-dict-file=
299
300# Tells whether to store unknown words to indicated private dictionary in
301
302# --spelling-private-dict-file option instead of raising a message.
303spelling-store-unknown-words=no
304
305
306[TYPECHECK]
307
308ignore-on-opaque-inference=n
309# Tells whether missing members accessed in mixin class should be ignored. A
310
311# mixin class is detected if its name ends with "mixin" (case insensitive).
312ignore-mixin-members=yes
313
314# List of module names for which member attributes should not be checked
315
316# (useful for modules/projects where namespaces are manipulated during runtime
317
318# and thus existing member attributes cannot be deduced by static analysis
319ignored-modules=typed_ast.ast3
320
321# List of classes names for which member attributes should not be checked
322
323# (useful for classes with attributes dynamically set).
324ignored-classes=SQLObject
325
326# List of members which are set dynamically and missed by pylint inference
327
328# system, and so shouldn't trigger E0201 when accessed. Python regular
329
330# expressions are accepted.
331generated-members=REQUEST,acl_users,aq_parent
332
333
334[VARIABLES]
335
336# Tells whether we should check for unused import in __init__ files.
337init-import=no
338
339# A regular expression matching the name of dummy variables (i.e. expectedly
340
341# not used).
342dummy-variables-rgx=_$|dummy
343
344# List of additional names supposed to be defined in builtins. Remember that
345
346# you should avoid to define new builtins when possible.
347additional-builtins=
348
349# List of strings which can identify a callback function by name. A callback
350
351# name must start or end with one of those strings.
352callbacks=cb_,_cb
353
354
355[CLASSES]
356
357# List of method names used to declare (i.e. assign) instance attributes.
358defining-attr-methods=__init__,__new__,setUp
359
360# List of valid names for the first argument in a class method.
361valid-classmethod-first-arg=cls
362
363# List of valid names for the first argument in a metaclass class method.
364valid-metaclass-classmethod-first-arg=mcs
365
366# List of member names, which should be excluded from the protected access
367
368# warning.
369exclude-protected=_asdict,_fields,_replace,_source,_make
370
371
372[DESIGN]
373
374# Maximum number of arguments for function / method
375max-args=10
376
377# Argument names that match this expression will be ignored. Default to name
378
379# with leading underscore
380ignored-argument-names=_.*
381
382# Maximum number of locals for function / method body
383max-locals=25
384
385# Maximum number of return / yield for function / method body
386max-returns=10
387
388# Maximum number of branch for function / method body
389max-branches=25
390
391# Maximum number of statements in function / method body
392max-statements=60
393
394# Maximum number of parents for a class (see R0901).
395max-parents=10
396
397# Maximum number of attributes for a class (see R0902).
398max-attributes=15
399
400# Minimum number of public methods for a class (see R0903).
401min-public-methods=2
402
403# Maximum number of public methods for a class (see R0904).
404max-public-methods=20
405
406
407[IMPORTS]
408
409# Deprecated modules which should not be used, separated by a comma
410deprecated-modules=stringprep,optparse
411
412# Create a graph of every (i.e. internal and external) dependencies in the
413
414# given file (report RP0402 must not be disabled)
415import-graph=
416
417# Create a graph of external dependencies in the given file (report RP0402 must
418
419# not be disabled)
420ext-import-graph=
421
422# Create a graph of internal dependencies in the given file (report RP0402 must
423
424# not be disabled)
425int-import-graph=
426
427
428[EXCEPTIONS]
429
430# Exceptions that will emit a warning when being caught. Defaults to
431
432# "Exception"
433overgeneral-exceptions=Exception