setup.cfg

# WeMakePythonStyleGuide:
# https://wemake-python-stylegui.de/en/latest/index.html
# https://wemake-python-stylegui.de/en/latest/pages/usage/configuration.html
# https://wemake-python-stylegui.de/en/latest/pages/usage/violations/index.html
# http://pycodestyle.pycqa.org/en/latest/intro.html
# http://flake8.pycqa.org/en/latest/user/configuration.html
# http://flake8.pycqa.org/en/latest/user/options.html
# http://flake8.pycqa.org/en/latest/user/error-codes.html
# http://flake8.pycqa.org/en/latest/user/violations.html
# https://wemake-python-stylegui.de/en/latest/pages/usage/formatter.html
# https://wemake-python-stylegui.de/en/latest/pages/usage/integrations/plugins.html
# http://flake8.pycqa.org/en/latest/user/options.html?highlight=per-file-ignores#cmdoption-flake8-per-file-ignores


[flake8]
# Wemake Python Style Guide Configuration

jobs = 4

min-name-length = 1
# We don't control ones who use our code
i-control-code = False
nested-classes-whitelist =
    Meta,
    NewDate,
# Max of noqa in a module
max-noqa-comments = 10
max-annotation-complexity = 4
max-returns = 5
max-awaits = 5
max-local-variables = 20
max-name-length = 60
# Max of expressions in a function
max-expressions = 15
# Max args in a function
max-arguments = 15
# Max classes and functions in a single module
max-module-members = 35
max-methods = 25
# Max line complexity measured in AST nodes
max-line-complexity = 24
# Max Jones Score for a module: the median of all lines complexity sum
max-jones-score = 15
# Max amount of cognitive complexity per function
max-cognitive-score = 20
# Max amount of cognitive complexity per module
max-cognitive-average = 25
max-imports = 25
max-imported-names = 50
# Max of expression usages in a module
max-module-expressions = 15
# Max of expression usages in a function
max-function-expressions = 15
max-base-classes = 5
max-decorators = 6
# Max of repeated string constants in your modules
max-string-usages = 15
max-try-body-length = 15
max-asserts = 15
# Max number of access level in an expression
max-access-level = 6
# maximum number of public instance attributes
max-attributes = 20

max-line-length = 120
max-doc-length = 120

# https://pypi.org/project/flake8-quotes/
inline-quotes = double
multiline-quotes = double
docstring-quotes = double

# https://wemake-python-stylegui.de/en/latest/pages/usage/formatter.html
show-source = True
# Print total number of errors
count = True
statistics = True
# benchmark = True

exclude =
    .tox,
    migrations,
    dist,
    build,
    hadoop_archive_plugin,
    virtualenv,
    venv,
    venv36,
    ve,
    .venv,
    tox.ini,
    docker,
    Jenkinsfile,
    dags,
    setup.py,
    docs,

# https://github.com/peterjc/flake8-rst-docstrings/pull/16
rst-directives =
    # These are sorted alphabetically - but that does not matter
    autosummary,data,currentmodule,deprecated,
    glossary,moduleauthor,plot,testcode,
    versionadded,versionchanged,

rst-roles =
    attr,class,func,meth,mod,obj,ref,term,
    # Python programming language:
    py:func,py:mod,

# https://wemake-python-stylegui.de/en/latest/pages/usage/violations/index.html
# http://pycodestyle.pycqa.org/en/latest/intro.html
ignore =
# Import at the wrong position
# [buggy with trailing commas and "as <alias>" imports]
# [too much hassle]
# [sometimes flask imports cannot be placed alphabetically]
#FIXME: change where can be done, later switch on
    I,
    ANN,
# Found name reserved for first argument: cls [opinionated]
    WPS117,
# __future__ import "division" missing
    FI10,
# __future__ import "absolute_import" missing
    FI11,
# __future__ import "with_statement" missing
    FI12,
# __future__ import "print_function" missing
    FI13,
# __future__ import "unicode_literals" missing
    FI14,
# __future__ import "generator_stop" missing
    FI15,
# __future__ import "nested_scopes" missing
    FI16,
# __future__ import "generators" missing
    FI17,
# __future__ import "annotations" present
    FI58,
# Found `f` string [opinionated]
    WPS305,
# Found explicit string concat [opinionated]
    WPS336,
# Found using `@staticmethod` [opinionated]
    WPS602,
# Found wrong variable name ("data", "handler", "params") [opinionated]
    WPS110,
# Found upper-case . constant in a class (flask config requires uppercase consts) [opinionated]
    WPS115,
# WPS223: Found too many `elif` branches
    WPS223,
# Found class without a base class (goes against PEP8) [opinionated]
    WPS306,
# Found line break before binary operator [goes against PEP8] [opinionated]
    W503,
# Found multiline conditions [opinionated]
    WPS337,
# Found mutable module constant [opinionated]
    WPS407,
# WPS411 Found empty module:
    WPS411,
# Found nested import [opinionated]
    WPS433,
# Found negated condition [opinionated]
    WPS504,
# WPS529:Found implicit `.get()` dict usage
    WPS529,
# FIXME: handle with docstring later
# Docstrings [opinionated]
    D,
# P101 and P103 string does contain unindexed parameters'
    P101,
    P103,
# WPS237:Found a too complex `f` string
    WPS237,
# WPS316 Found context manager with too many assignments
    WPS316,
# WPS326 Found implicit string concatenation [optional]
    WPS326,
# WPS347 Found vague import that may cause confusion
    WPS347,
# WPS421 Found wrong function call: locals'
    WPS421,
# WPS348 Found a line that starts with a dot
    WPS348,
# WPS440 Found block variables overlap
    WPS440,
# WPS459 Found comparison with float or complex number [buggy]
    WPS459,
# S108 Probable insecure usage of temp file/directory.
    S108,
# S404  Consider possible security implications associated with check_call module
    S404,
# S603  subprocess call - check for execution of untrusted input
    S603,
# S607  Starting a process with a partial executable path
    S607,
# S608  Possible SQL injection vector through string-based query construction.
    S608,
# E402  module level import not at top of file
    E402,
# RST399: Document or section may not begin with a transition.
    RST399,
# WPS432 Found magic number
    WPS432,
# WPS615 Found unpythonic getter or setter
    WPS615,
# RST213: Inline emphasis start-string without end-string.
    RST213,
# RST307: Error in "code" directive
    RST307,
# WPS428 Found statement that has no effect
    WPS428,
# WPS462 Wrong multiline string usage
    WPS462,
# WPS303 Found underscored number:
    WPS303,
# WPS431 Found nested class
    WPS431,
# WPS317 Invalid multiline string usage
    WPS317,
# WPS226 Found string literal over-use: | [bug]
    WPS226,
# WPS323 Found `%` string formatting
    WPS323,
# RST305 Undefined substitution referenced: support_hooks
    RST305,
# RST303 Unknown directive type tabs
    RST303,
# WPS402 Found `noqa` comments overuse
    WPS402,
# WPS214 Found too many methods
    WPS214,
# WPS605 Found method without arguments
    WPS605,
#  N805 first argument of a method should be named 'self'
    N805,
# WPS238 Found too many raises in a function
    WPS238,
# W505: doc line too long
    W505,
# E501: line too long
    E501,
# WPS114 Found underscored number name pattern: package_spark_2_3
    WPS114,
# WPS420 Found wrong keyword pass
    WPS420
# WPS600 Found subclassing a builtin: str
    WPS600,
# WPS601 Found shadowed class attribute
    WPS601,
# WPS604 Found incorrect node inside `class` body: pass
    WPS604,
# WPS410 Found wrong metadata variable: __all__
    WPS410,
# WPS412 Found `__init__.py` module with logic
    WPS412


# http://flake8.pycqa.org/en/latest/user/options.html?highlight=per-file-ignores#cmdoption-flake8-per-file-ignores
per-file-ignores =
    __init__.py:
# * imports are valid for __init__.py scripts
        F403,
# F401 imported but unused
        F401,
    core.py:
# WPS430 Found nested function
        WPS430,
    test*:
# S101 Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.
        S101,
# WPS122:Found all unused variables definition
        WPS122,
# WPS125 Found builtin shadowing: globals [test setup]
        WPS125,
# WPS204:Found overused expression [ok, for test purpose]
        WPS204,
# WPS218 Found too many `assert` statements
        WPS218,
# WPS219 Found too deep access level [test usage]
        WPS219,
# WPS442 Found outer scope names shadowing [ok for test usage]
        WPS442,
# WPS118 Found too long name [test usage]
        WPS118,
# WPS213 Found too many expressions
        WPS213,
# WPS430 Found nested function: main
        WPS430,

[darglint]
docstring_style = sphinx

[codespell]
ignore-words-list = INOUT, inout