3 # Specify a configuration file.
6 # Python code to execute, usually for sys.path manipulation such as
10 # Add files or directories to the blacklist. They should be base names, not
12 ignore=.git,sphinxtogithub
14 # Pickle collected data for later comparisons.
17 # List of plugins (as comma separated values of python modules names) to load,
18 # usually to register additional checkers.
21 # Use multiple processes to speed up Pylint.
24 # Allow loading of arbitrary C extensions. Extensions are imported into the
25 # active Python interpreter and may run arbitrary code.
26 unsafe-load-any-extension=no
28 # A comma-separated list of package or module names from where C extensions may
29 # be loaded. Extensions are loading into the active Python interpreter and may
31 extension-pkg-whitelist=PyQt5,PyQt4,PySide,PySide2
33 # Allow optimization of some AST trees. This will activate a peephole AST
34 # optimizer, which will apply various small optimizations. For instance, it can
35 # be used to obtain the result of joining multiple strings with the addition
36 # operator. Joining a lot of strings can lead to a maximum recursion error in
37 # Pylint and this flag can prevent that. It has one side effect, the resulting
38 # AST will be different than the one from reality.
44 # Only show warnings with the listed confidence levels. Leave empty to show
45 # all. Valid levels: HIGH, INFERENCE, INFERENCE_FAILURE, UNDEFINED
48 # Enable the message, report, category or checker with the given id(s). You can
49 # either give multiple identifier separated by comma (,) or put this option
50 # multiple time. See also the "--disable" option for examples.
53 # Disable the message, report, category or checker with the given id(s). You
54 # can either give multiple identifiers separated by comma (,) or put this
55 # option multiple times (only on the command line, not in the configuration
56 # file where it should appear only once).You can also use "--disable=all" to
57 # disable everything first and then reenable specific checks. For example, if
58 # you want to run only the similarities checker, you can use "--disable=all
59 # --enable=similarities". If you want to run only the classes checker, but have
60 # no Warning level messages displayed, use"--disable=all --enable=classes
62 disable=fixme,wrong-import-position,invalid-name,missing-docstring,too-many-instance-attributes
66 # Set the output format. Available formats are text, parseable, colorized, msvs
67 # (visual studio) and html. You can also give a reporter class, eg
68 # mypackage.mymodule.MyReporterClass.
71 # Put messages in a separate file for each module / package specified on the
72 # command line instead of printing them on stdout. Reports (if any) will be
73 # written in a file name "pylint_global.[txt|html]".
76 # Tells whether to display a full report or only the messages
79 # Python expression which should return a note less than 10 (10 is the highest
80 # note). You have access to the variables errors warning, statement which
81 # respectively contain the number of errors / warnings messages and the total
82 # number of statements analyzed. This is used by the global evaluation report
84 evaluation=10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)
86 # Template used to display messages. This is a python new-style format string
87 # used to format the message information. See doc for all details
88 msg-template={path}:{line}:{column}: {msg} ({symbol})
93 # List of builtins function names that should not be used, separated by a comma
94 bad-functions=map,filter,input
96 # Good variable names which should always be accepted, separated by a comma
97 good-names=i,j,k,ex,Run,_
99 # Bad variable names which should always be refused, separated by a comma
100 bad-names=foo,bar,baz,toto,tutu,tata
102 # Colon-delimited sets of names that determine each other's naming style when
103 # the name regexes allow several styles.
106 # Include a hint for the correct naming format with invalid-name
107 include-naming-hint=yes
109 # Regular expression matching correct function names
110 function-rgx=[a-z_][a-z0-9_]{2,30}$
112 # Naming hint for function names
113 function-name-hint=[a-z_][a-z0-9_]{2,30}$
115 # Regular expression matching correct variable names
116 variable-rgx=[a-z_][a-z0-9_]{2,30}$
118 # Naming hint for variable names
119 variable-name-hint=[a-z_][a-z0-9_]{2,30}$
121 # Regular expression matching correct constant names
122 const-rgx=(([A-Z_][A-Z0-9_]*)|(__.*__))$
124 # Naming hint for constant names
125 const-name-hint=(([A-Z_][A-Z0-9_]*)|(__.*__))$
127 # Regular expression matching correct attribute names
128 attr-rgx=[a-z_][a-z0-9_]{2,30}$
130 # Naming hint for attribute names
131 attr-name-hint=[a-z_][a-z0-9_]{2,30}$
133 # Regular expression matching correct argument names
134 argument-rgx=[a-z_][a-z0-9_]{2,30}$
136 # Naming hint for argument names
137 argument-name-hint=[a-z_][a-z0-9_]{2,30}$
139 # Regular expression matching correct class attribute names
140 class-attribute-rgx=([A-Za-z_][A-Za-z0-9_]{2,30}|(__.*__))$
142 # Naming hint for class attribute names
143 class-attribute-name-hint=([A-Za-z_][A-Za-z0-9_]{2,30}|(__.*__))$
145 # Regular expression matching correct inline iteration names
146 inlinevar-rgx=[A-Za-z_][A-Za-z0-9_]*$
148 # Naming hint for inline iteration names
149 inlinevar-name-hint=[A-Za-z_][A-Za-z0-9_]*$
151 # Regular expression matching correct class names
152 class-rgx=[A-Z_][a-zA-Z0-9]+$
154 # Naming hint for class names
155 class-name-hint=[A-Z_][a-zA-Z0-9]+$
157 # Regular expression matching correct module names
158 module-rgx=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
160 # Naming hint for module names
161 module-name-hint=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
163 # Regular expression matching correct method names
164 method-rgx=[a-z_][a-z0-9_]{2,30}$
166 # Naming hint for method names
167 method-name-hint=[a-z_][a-z0-9_]{2,30}$
169 # Regular expression which should only match function or class names that do
170 # not require a docstring.
171 no-docstring-rgx=__.*__
173 # Minimum line length for functions/classes that require docstrings, shorter
175 docstring-min-length=-1
180 # List of note tags to take in consideration, separated by a comma.
186 # Maximum number of characters on a single line.
189 # Regexp for a line that is allowed to be longer than the limit.
190 ignore-long-lines=^\s*(# )?<?https?://\S+>?$
192 # Allow the body of an if to be on the same line as the test if there is no
194 single-line-if-stmt=no
196 # List of optional constructs for which whitespace checking is disabled
199 # Maximum number of lines in a module
200 max-module-lines=3000
202 # String used as indentation unit. This is usually " " (4 spaces) or "\t" (1
206 # Number of spaces of indent required inside a hanging or continued line.
209 # Expected format of line ending, e.g. empty (any line ending), LF or CRLF.
210 expected-line-ending-format=LF
215 # Tells whether missing members accessed in mixin class should be ignored. A
216 # mixin class is detected if its name ends with "mixin" (case insensitive).
217 ignore-mixin-members=yes
219 # List of module names for which member attributes should not be checked
220 # (useful for modules/projects where namespaces are manipulated during runtime
221 # and thus existing member attributes cannot be deduced by static analysis
224 # List of classes names for which member attributes should not be checked
225 # (useful for classes with attributes dynamically set).
228 # List of members which are set dynamically and missed by pylint inference
229 # system, and so shouldn't trigger E0201 when accessed. Python regular
230 # expressions are accepted.
236 # Minimum lines number of a similarity.
237 min-similarity-lines=4
239 # Ignore comments when computing similarities.
242 # Ignore docstrings when computing similarities.
243 ignore-docstrings=yes
245 # Ignore imports when computing similarities.
251 # Spelling dictionary name. Available dictionaries: none. To make it working
252 # install python-enchant package.
255 # List of comma separated words that should not be checked.
256 spelling-ignore-words=
258 # A path to a file that contains private dictionary; one word per line.
259 spelling-private-dict-file=
261 # Tells whether to store unknown words to indicated private dictionary in
262 # --spelling-private-dict-file option instead of raising a message.
263 spelling-store-unknown-words=no
268 # Logging modules to check that the string format arguments are in logging
269 # function parameter format
270 logging-modules=logging
275 # Tells whether we should check for unused import in __init__ files.
278 # A regular expression matching the name of dummy variables (i.e. expectedly
280 dummy-variables-rgx=_$|dummy
282 # List of additional names supposed to be defined in builtins. Remember that
283 # you should avoid to define new builtins when possible.
286 # List of strings which can identify a callback function by name. A callback
287 # name must start or end with one of those strings.
293 # List of method names used to declare (i.e. assign) instance attributes.
294 defining-attr-methods=__init__,__new__,setUp
296 # List of valid names for the first argument in a class method.
297 valid-classmethod-first-arg=cls
299 # List of valid names for the first argument in a metaclass class method.
300 valid-metaclass-classmethod-first-arg=mcs
302 # List of member names, which should be excluded from the protected access
304 exclude-protected=_asdict,_fields,_replace,_source,_make
309 # Maximum number of arguments for function / method
312 # Argument names that match this expression will be ignored. Default to name
313 # with leading underscore
314 ignored-argument-names=_.*
316 # Maximum number of locals for function / method body
319 # Maximum number of return / yield for function / method body
322 # Maximum number of branch for function / method body
325 # Maximum number of statements in function / method body
328 # Maximum number of parents for a class (see R0901).
331 # Maximum number of attributes for a class (see R0902).
334 # Minimum number of public methods for a class (see R0903).
337 # Maximum number of public methods for a class (see R0904).
338 max-public-methods=40
343 # Deprecated modules which should not be used, separated by a comma
346 # Create a graph of every (i.e. internal and external) dependencies in the
347 # given file (report RP0402 must not be disabled)
350 # Create a graph of external dependencies in the given file (report RP0402 must
354 # Create a graph of internal dependencies in the given file (report RP0402 must
361 # Exceptions that will emit a warning when being caught. Defaults to
363 overgeneral-exceptions=Exception