blob: 3c2f96e4fa12617b897ea40aba63ad793f3070ff [file] [log] [blame]
Josip Sokcevica52cc052023-11-28 00:55:34 +00001[MAIN]
2
3# Analyse import fallback blocks. This can be used to support both Python 2 and
4# 3 compatible code, which means that the block might have code that exists
5# only in one or another interpreter, leading to false positives when analysed.
6analyse-fallback-blocks=no
7
8# Clear in-memory caches upon conclusion of linting. Useful if running pylint
9# in a server-like mode.
10clear-cache-post-run=no
11
12# Load and enable all available extensions. Use --list-extensions to see a list
13# all available extensions.
14#enable-all-extensions=
15
16# In error mode, messages with a category besides ERROR or FATAL are
17# suppressed, and no reports are done by default. Error mode is compatible with
18# disabling specific errors.
19#errors-only=
20
21# Always return a 0 (non-error) status code, even if lint errors are found.
22# This is primarily useful in continuous integration scripts.
23#exit-zero=
24
25# A comma-separated list of package or module names from where C extensions may
26# be loaded. Extensions are loading into the active Python interpreter and may
27# run arbitrary code.
28extension-pkg-allow-list=
29
30# A comma-separated list of package or module names from where C extensions may
31# be loaded. Extensions are loading into the active Python interpreter and may
32# run arbitrary code. (This is an alternative name to extension-pkg-allow-list
33# for backward compatibility.)
34extension-pkg-whitelist=
35
36# Return non-zero exit code if any of these messages/categories are detected,
37# even if score is above --fail-under value. Syntax same as enable. Messages
38# specified are enabled, while categories only check already-enabled messages.
39fail-on=
40
41# Specify a score threshold under which the program will exit with error.
42fail-under=10
43
44# Interpret the stdin as a python script, whose filename needs to be passed as
45# the module_or_package argument.
46#from-stdin=
47
48# Files or directories to be skipped. They should be base names, not paths.
49ignore=CVS
50
51# Add files or directories matching the regular expressions patterns to the
52# ignore-list. The regex matches against paths and can be in Posix or Windows
53# format. Because '\\' represents the directory delimiter on Windows systems,
54# it can't be used as an escape character.
55ignore-paths=
56
57# Files or directories matching the regular expression patterns are skipped.
58# The regex matches against base names, not paths. The default value ignores
59# Emacs file locks
60ignore-patterns=^\.#
61
62# List of module names for which member attributes should not be checked
63# (useful for modules/projects where namespaces are manipulated during runtime
64# and thus existing member attributes cannot be deduced by static analysis). It
65# supports qualified module names, as well as Unix pattern matching.
66ignored-modules=
67
68# Python code to execute, usually for sys.path manipulation such as
69# pygtk.require().
70#init-hook=
71
72# Use multiple processes to speed up Pylint. Specifying 0 will auto-detect the
73# number of processors available to use, and will cap the count on Windows to
74# avoid hangs.
75jobs=0
76
77# Control the amount of potential inferred values when inferring a single
78# object. This can help the performance when dealing with large functions or
79# complex, nested conditions.
80limit-inference-results=100
81
82# List of plugins (as comma separated values of python module names) to load,
83# usually to register additional checkers.
84load-plugins=pylint_quotes
85
86# Pickle collected data for later comparisons.
87persistent=yes
88
89# Minimum Python version to use for version dependent checks. Will default to
90# the version used to run pylint.
91py-version=3.11
92
93# Discover python modules and packages in the file system subtree.
94recursive=no
95
96# Add paths to the list of the source roots. Supports globbing patterns. The
97# source root is an absolute path or a path relative to the current working
98# directory used to determine a package namespace for modules located under the
99# source root.
100source-roots=
101
102# When enabled, pylint would attempt to guess common misconfiguration and emit
103# user-friendly hints instead of false-positive error messages.
104suggestion-mode=yes
105
106# Allow loading of arbitrary C extensions. Extensions are imported into the
107# active Python interpreter and may run arbitrary code.
108unsafe-load-any-extension=no
109
110# In verbose mode, extra non-checker-related info will be displayed.
111#verbose=
112
113
114[BASIC]
115
116# Naming style matching correct argument names.
117argument-naming-style=snake_case
118
119# Regular expression matching correct argument names. Overrides argument-
120# naming-style. If left empty, argument names will be checked with the set
121# naming style.
122argument-rgx=[a-z_][a-z0-9_]{2,30}$
123
124# Naming style matching correct attribute names.
125attr-naming-style=snake_case
126
127# Regular expression matching correct attribute names. Overrides attr-naming-
128# style. If left empty, attribute names will be checked with the set naming
129# style.
130attr-rgx=[a-z_][a-z0-9_]{2,30}$
131
132# Bad variable names which should always be refused, separated by a comma.
133bad-names=foo,
134 bar,
135 baz,
136 toto,
137 tutu,
138 tata
139
140# Bad variable names regexes, separated by a comma. If names match any regex,
141# they will always be refused
142bad-names-rgxs=
143
144# Naming style matching correct class attribute names.
145class-attribute-naming-style=any
146
147# Regular expression matching correct class attribute names. Overrides class-
148# attribute-naming-style. If left empty, class attribute names will be checked
149# with the set naming style.
150#class-attribute-rgx=
151
152# Naming style matching correct class constant names.
153class-const-naming-style=UPPER_CASE
154
155# Regular expression matching correct class constant names. Overrides class-
156# const-naming-style. If left empty, class constant names will be checked with
157# the set naming style.
158#class-const-rgx=
159
160# Naming style matching correct class names.
161class-naming-style=PascalCase
162
163# Regular expression matching correct class names. Overrides class-naming-
164# style. If left empty, class names will be checked with the set naming style.
165class-rgx=[A-Z_][a-zA-Z0-9]+$
166
167# Naming style matching correct constant names.
168const-naming-style=UPPER_CASE
169
170# Regular expression matching correct constant names. Overrides const-naming-
171# style. If left empty, constant names will be checked with the set naming
172# style.
173const-rgx=(([A-Z_][A-Z0-9_]*)|(__.*__))$
174
175# Minimum line length for functions/classes that require docstrings, shorter
176# ones are exempt.
177docstring-min-length=-1
178
179# Naming style matching correct function names.
180function-naming-style=snake_case
181
182# Regular expression matching correct function names. Overrides function-
183# naming-style. If left empty, function names will be checked with the set
184# naming style.
185function-rgx=[a-z_][a-z0-9_]{2,30}$
186
187# Good variable names which should always be accepted, separated by a comma.
188good-names=i,
189 j,
190 k,
191 ex,
192 Run,
193 _
194
195# Good variable names regexes, separated by a comma. If names match any regex,
196# they will always be accepted
197good-names-rgxs=
198
199# Include a hint for the correct naming format with invalid-name.
200include-naming-hint=no
201
202# Naming style matching correct inline iteration names.
203inlinevar-naming-style=any
204
205# Regular expression matching correct inline iteration names. Overrides
206# inlinevar-naming-style. If left empty, inline iteration names will be checked
207# with the set naming style.
208inlinevar-rgx=[A-Za-z_][A-Za-z0-9_]*$
209
210# Naming style matching correct method names.
211method-naming-style=snake_case
212
213# Regular expression matching correct method names. Overrides method-naming-
214# style. If left empty, method names will be checked with the set naming style.
215method-rgx=[a-z_][a-z0-9_]{2,30}$
216
217# Naming style matching correct module names.
218module-naming-style=snake_case
219
220# Regular expression matching correct module names. Overrides module-naming-
221# style. If left empty, module names will be checked with the set naming style.
222module-rgx=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
223
224# Colon-delimited sets of names that determine each other's naming style when
225# the name regexes allow several styles.
226name-group=
227
228# Regular expression which should only match function or class names that do
229# not require a docstring.
230no-docstring-rgx=__.*__
231
232# List of decorators that produce properties, such as abc.abstractproperty. Add
233# to this list to register other decorators that produce valid properties.
234# These decorators are taken in consideration only for invalid-name.
235property-classes=abc.abstractproperty
236
237# Regular expression matching correct type alias names. If left empty, type
238# alias names will be checked with the set naming style.
239#typealias-rgx=
240
241# Regular expression matching correct type variable names. If left empty, type
242# variable names will be checked with the set naming style.
243#typevar-rgx=
244
245# Naming style matching correct variable names.
246variable-naming-style=snake_case
247
248# Regular expression matching correct variable names. Overrides variable-
249# naming-style. If left empty, variable names will be checked with the set
250# naming style.
251variable-rgx=[a-z_][a-z0-9_]{2,30}$
252
253
254[CLASSES]
255
256# Warn about protected attribute access inside special methods
257check-protected-access-in-special-methods=no
258
259# List of method names used to declare (i.e. assign) instance attributes.
260defining-attr-methods=__init__,
261 __new__,
262 setUp
263
264# List of member names, which should be excluded from the protected access
265# warning.
266exclude-protected=_asdict,_fields,_replace,_source,_make,os._exit
267
268# List of valid names for the first argument in a class method.
269valid-classmethod-first-arg=cls
270
271# List of valid names for the first argument in a metaclass class method.
272valid-metaclass-classmethod-first-arg=mcs
273
274
275[DESIGN]
276
277# List of regular expressions of class ancestor names to ignore when counting
278# public methods (see R0903)
279exclude-too-few-public-methods=
280
281# List of qualified class names to ignore when counting class parents (see
282# R0901)
283ignored-parents=
284
285# Maximum number of arguments for function / method.
286max-args=5
287
288# Maximum number of attributes for a class (see R0902).
289max-attributes=7
290
291# Maximum number of boolean expressions in an if statement (see R0916).
292max-bool-expr=5
293
294# Maximum number of branch for function / method body.
295max-branches=12
296
297# Maximum number of locals for function / method body.
298max-locals=15
299
300# Maximum number of parents for a class (see R0901).
301max-parents=7
302
303# Maximum number of public methods for a class (see R0904).
304max-public-methods=20
305
306# Maximum number of return / yield for function / method body.
307max-returns=6
308
309# Maximum number of statements in function / method body.
310max-statements=50
311
312# Minimum number of public methods for a class (see R0903).
313min-public-methods=2
314
315
316[EXCEPTIONS]
317
318# Exceptions that will emit a warning when caught.
319overgeneral-exceptions=builtin.Exception
320
321
322[FORMAT]
323
324# Expected format of line ending, e.g. empty (any line ending), LF or CRLF.
325expected-line-ending-format=
326
327# Regexp for a line that is allowed to be longer than the limit.
328ignore-long-lines=^\s*(# )?<?https?://\S+>?$
329
330# Number of spaces of indent required inside a hanging or continued line.
331indent-after-paren=4
332
333# String used as indentation unit. This is usually " " (4 spaces) or "\t" (1
334# tab).
335indent-string=' '
336
337# Maximum number of characters on a single line.
338max-line-length=80
339
340# Maximum number of lines in a module.
341max-module-lines=1000
342
343# Allow the body of a class to be on the same line as the declaration if body
344# contains single statement.
345single-line-class-stmt=no
346
347# Allow the body of an if to be on the same line as the test if there is no
348# else.
349single-line-if-stmt=no
350
351
352[IMPORTS]
353
354# List of modules that can be imported at any level, not just the top level
355# one.
356allow-any-import-level=
357
358# Allow explicit reexports by alias from a package __init__.
359allow-reexport-from-package=no
360
361# Allow wildcard imports from modules that define __all__.
362allow-wildcard-with-all=no
363
364# Deprecated modules which should not be used, separated by a comma.
365deprecated-modules=regsub,
366 string,
367 TERMIOS,
368 Bastion,
369 rexec
370
371# Output a graph (.gv or any supported image format) of external dependencies
372# to the given file (report RP0402 must not be disabled).
373ext-import-graph=
374
375# Output a graph (.gv or any supported image format) of all (i.e. internal and
376# external) dependencies to the given file (report RP0402 must not be
377# disabled).
378import-graph=
379
380# Output a graph (.gv or any supported image format) of internal dependencies
381# to the given file (report RP0402 must not be disabled).
382int-import-graph=
383
384# Force import order to recognize a module as part of the standard
385# compatibility libraries.
386known-standard-library=
387
388# Force import order to recognize a module as part of a third party library.
389known-third-party=enchant
390
391# Couples of modules and preferred modules, separated by a comma.
392preferred-modules=
393
394
395[LOGGING]
396
397# The type of string formatting that logging methods do. `old` means using %
398# formatting, `new` is for `{}` formatting.
399logging-format-style=old
400
401# Logging modules to check that the string format arguments are in logging
402# function parameter format.
403logging-modules=logging
404
405
406[MESSAGES CONTROL]
407
408# Only show warnings with the listed confidence levels. Leave empty to show
409# all. Valid levels: HIGH, CONTROL_FLOW, INFERENCE, INFERENCE_FAILURE,
410# UNDEFINED.
411confidence=HIGH,
412 CONTROL_FLOW,
413 INFERENCE,
414 INFERENCE_FAILURE,
415 UNDEFINED
416
417# Disable the message, report, category or checker with the given id(s). You
418# can either give multiple identifiers separated by comma (,) or put this
419# option multiple times (only on the command line, not in the configuration
420# file where it should appear only once). You can also use "--disable=all" to
421# disable everything first and then re-enable specific checks. For example, if
422# you want to run only the similarities checker, you can use "--disable=all
423# --enable=similarities". If you want to run only the classes checker, but have
424# no Warning level messages displayed, use "--disable=all --enable=classes
425# --disable=W".
426disable=raw-checker-failed,
427 bad-inline-option,
428 locally-disabled,
429 file-ignored,
430 suppressed-message,
431 useless-suppression,
432 deprecated-pragma,
433 use-symbolic-message-instead,
434 invalid-name,
435 missing-module-docstring,
436 missing-class-docstring,
437 missing-function-docstring,
438 too-many-lines,
439 duplicate-code,
440 too-many-ancestors,
441 too-many-instance-attributes,
442 too-few-public-methods,
443 too-many-public-methods,
444 too-many-return-statements,
445 too-many-branches,
446 too-many-arguments,
447 too-many-locals,
448 too-many-statements,
449 exec-used,
450 deprecated-module,
451 reimported,
452 fixme,
453 global-statement,
454 broad-exception-caught,
455 logging-not-lazy,
456 anomalous-backslash-in-string,
457 assigning-non-slot,
458 unexpected-special-method-signature,
459 bad-indentation,
460 bad-str-strip-call,
461 bad-super-call,
462 cell-var-from-loop,
463 consider-using-enumerate,
464 deprecated-method,
465 eval-used,
466 function-redefined,
467 import-error,
468 invalid-docstring-quote,
469 invalid-string-quote,
470 invalid-triple-quote,
471 misplaced-bare-raise,
472 missing-final-newline,
473 multiple-imports,
474 no-name-in-module,
475 no-self-argument,
476 not-an-iterable,
477 not-callable,
478 protected-access,
479 simplifiable-if-statement,
480 singleton-comparison,
481 superfluous-parens,
482 too-many-boolean-expressions,
483 too-many-function-args,
484 too-many-nested-blocks,
485 trailing-whitespace,
486 undefined-variable,
487 ungrouped-imports,
488 unnecessary-semicolon,
489 unneeded-not,
490 unpacking-non-sequence,
491 unsubscriptable-object,
492 unsupported-membership-test,
493 unused-import,
494 useless-else-on-loop,
495 using-constant-test,
496 wrong-import-order,
497 wrong-import-position
498
499# Enable the message, report, category or checker with the given id(s). You can
500# either give multiple identifier separated by comma (,) or put this option
501# multiple time (only on the command line, not in the configuration file where
502# it should appear only once). See also the "--disable" option for examples.
503enable=c-extension-no-member
504
505
506[METHOD_ARGS]
507
508# List of qualified names (i.e., library.method) which require a timeout
509# parameter e.g. 'requests.api.get,requests.api.post'
510timeout-methods=requests.api.delete,requests.api.get,requests.api.head,requests.api.options,requests.api.patch,requests.api.post,requests.api.put,requests.api.request
511
512
513[MISCELLANEOUS]
514
515# List of note tags to take in consideration, separated by a comma.
516notes=FIXME,
517 XXX,
518 TODO
519
520# Regular expression of note tags to take in consideration.
521notes-rgx=
522
523
524[REFACTORING]
525
526# Maximum number of nested blocks for function / method body
527max-nested-blocks=5
528
529# Complete name of functions that never returns. When checking for
530# inconsistent-return-statements if a never returning function is called then
531# it will be considered as an explicit return statement and no message will be
532# printed.
533never-returning-functions=sys.exit,argparse.parse_error
534
535
536[REPORTS]
537
538# Python expression which should return a score less than or equal to 10. You
539# have access to the variables 'fatal', 'error', 'warning', 'refactor',
540# 'convention', and 'info' which contain the number of messages in each
541# category, as well as 'statement' which is the total number of statements
542# analyzed. This score is used by the global evaluation report (RP0004).
543evaluation=10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)
544
545# Template used to display messages. This is a python new-style format string
546# used to format the message information. See doc for all details.
547msg-template=
548
549# Set the output format. Available formats are text, parseable, colorized, json
550# and msvs (visual studio). You can also give a reporter class, e.g.
551# mypackage.mymodule.MyReporterClass.
552#output-format=
553
554# Tells whether to display a full report or only the messages.
555reports=no
556
557# Activate the evaluation score.
558score=no
559
560
561[SIMILARITIES]
562
563# Comments are removed from the similarity computation
564ignore-comments=yes
565
566# Docstrings are removed from the similarity computation
567ignore-docstrings=yes
568
569# Imports are removed from the similarity computation
570ignore-imports=yes
571
572# Signatures are removed from the similarity computation
573ignore-signatures=yes
574
575# Minimum lines number of a similarity.
576min-similarity-lines=4
577
578
579[SPELLING]
580
581# Limits count of emitted suggestions for spelling mistakes.
582max-spelling-suggestions=4
583
584# Spelling dictionary name. No available dictionaries : You need to install
585# both the python package and the system dependency for enchant to work..
586spelling-dict=
587
588# List of comma separated words that should be considered directives if they
589# appear at the beginning of a comment and should not be checked.
590spelling-ignore-comment-directives=fmt: on,fmt: off,noqa:,noqa,nosec,isort:skip,mypy:
591
592# List of comma separated words that should not be checked.
593spelling-ignore-words=
594
595# A path to a file that contains the private dictionary; one word per line.
596spelling-private-dict-file=
597
598# Tells whether to store unknown words to the private dictionary (see the
599# --spelling-private-dict-file option) instead of raising a message.
600spelling-store-unknown-words=no
601
602
603[STRING]
604
605# This flag controls whether inconsistent-quotes generates a warning when the
606# character used as a quote delimiter is used inconsistently within a module.
607check-quote-consistency=no
608
609# This flag controls whether the implicit-str-concat should generate a warning
610# on implicit string concatenation in sequences defined over several lines.
611check-str-concat-over-line-jumps=no
612
613
614[STRING_QUOTES]
615
616# The quote character for triple-quoted docstrings.
617docstring-quote=double
618
619# The quote character for string literals.
620string-quote=single-avoid-escape
621
622# The quote character for triple-quoted strings (non-docstring).
623triple-quote=double
624
625
626[TYPECHECK]
627
628# List of decorators that produce context managers, such as
629# contextlib.contextmanager. Add to this list to register other decorators that
630# produce valid context managers.
631contextmanager-decorators=contextlib.contextmanager
632
633# List of members which are set dynamically and missed by pylint inference
634# system, and so shouldn't trigger E1101 when accessed. Python regular
635# expressions are accepted.
636generated-members=REQUEST,acl_users,aq_parent,multiprocessing.managers.SyncManager
637
638# Tells whether to warn about missing members when the owner of the attribute
639# is inferred to be None.
640ignore-none=yes
641
642# This flag controls whether pylint should warn about no-member and similar
643# checks whenever an opaque object is returned when inferring. The inference
644# can return multiple potential results while evaluating a Python object, but
645# some branches might not be evaluated, which results in partial inference. In
646# that case, it might be useful to still emit no-member and other checks for
647# the rest of the inferred objects.
648ignore-on-opaque-inference=yes
649
650# List of symbolic message names to ignore for Mixin members.
651ignored-checks-for-mixins=no-member,
652 not-async-context-manager,
653 not-context-manager,
654 attribute-defined-outside-init
655
656# List of class names for which member attributes should not be checked (useful
657# for classes with dynamically set attributes). This supports the use of
658# qualified names.
659ignored-classes=SQLObject,twisted.internet.reactor,hashlib,google.appengine.api.memcache
660
661# Show a hint with possible names when a member name was not found. The aspect
662# of finding the hint is based on edit distance.
663missing-member-hint=yes
664
665# The minimum edit distance a name should have in order to be considered a
666# similar match for a missing member name.
667missing-member-hint-distance=1
668
669# The total number of similar names that should be taken in consideration when
670# showing a hint for a missing member.
671missing-member-max-choices=1
672
673# Regex pattern to define which classes are considered mixins.
674mixin-class-rgx=.*[Mm]ixin
675
676# List of decorators that change the signature of a decorated function.
677signature-mutators=
678
679
680[VARIABLES]
681
682# List of additional names supposed to be defined in builtins. Remember that
683# you should avoid defining new builtins when possible.
684additional-builtins=
685
686# Tells whether unused global variables should be treated as a violation.
687allow-global-unused-variables=yes
688
689# List of names allowed to shadow builtins
690allowed-redefined-builtins=
691
692# List of strings which can identify a callback function by name. A callback
693# name must start or end with one of those strings.
694callbacks=cb_,
695 _cb
696
697# A regular expression matching the name of dummy variables (i.e. expected to
698# not be used).
699dummy-variables-rgx=_|dummy
700
701# Argument names that match this expression will be ignored.
702ignored-argument-names=_.*
703
704# Tells whether we should check for unused import in __init__ files.
705init-import=no
706
707# List of qualified module names which can have objects that can redefine
708# builtins.
709redefining-builtins-modules=six.moves,past.builtins,future.builtins,builtins,io