Недопустимое имя пользователя Pylint

Я получаю ошибку Pylint относительно моей константы: MIN_SOIL_PARTICLE_DENS (недопустимое имя). Любые идеи, почему эта константа неверна? Здесь моя полная функция:

def bulk_density(clay, sand, organic_matter):
    MIN_SOIL_PARTICLE_DENS = 2.65
    x1 = (0.078 + 0.278 * sand + 0.034 * clay + 0.022 * organic_matter - 0.018
          * sand * organic_matter - 0.027 * clay * organic_matter - 0.584 * sand
          * clay)
    x2 = -0.107 + 1.636 * x1
    field_capacity = vol_water_content_33_j_kg(clay, sand, organic_matter)#m3/m3
    sat_water_content = 0.043 + field_capacity + x2 - 0.097 * sand
    return (1 - sat_water_content) * MIN_SOIL_PARTICLE_DENS

Ответ 1

При проверке имен Pylint различает константы, переменные, классы и т.д. Любое имя, не входящее в функцию/класс, будет считаться константой, а все остальное является переменной.

Смотрите http://docs.pylint.org/features.html#basic-checker

variable-rgx:
[a-z_][a-z0-9_]{2,30}$

const-rgx:
(([A-Z_][A-Z0-9_]*)|(__.*__))$

Поскольку вы находитесь в функции, MIN_SOIL_PARTICLE_DENS (в соответствии с pylint) считается переменной, однако pylint рассматривает ее как константу и поэтому жалуется.

Это означает, что вы не можете иметь заглавные имена внутри функций без жалобы.

Если вы спросите меня, использование заглавных букв внутри функций хорошо; не все константы обязательно определены глобально.

Ответ 2

Несколько простых правил:

Константы должны быть определены только буквами UPPER_CASE и должны быть определены на уровне модуля
Имена классов должны быть определены буквами CamelCase
Переменные должны быть определены в lower_case и должны быть определены внутри функции, классов и т.д.

Теперь давайте поговорим о вашем деле,

MIN_SOIL_PARTICLE_DENS определен внутри функции и должен иметь только строчные буквы. Таким образом, вместо того, чтобы рассматривать MIN_SOIL_PARTICLE_DENS как константу, Pylint рассматривает его как переменную здесь и, следовательно, ошибку PILINT.

Пилинт Учебник

Ответ 3

Я нахожу это поведение раздражающим, но есть способ настроить Pylint, чтобы избежать этого!

Добавьте следующее объявление ini-style в ваш файл .pylintrc:

[BASIC]
variable-rgx=((([a-z_][a-z0-9_]{2,})|(_[a-z0-9_]*)|(__[a-z][a-z0-9_]+__))$)|([A-Z_][A-Z0-9_]+$)

Я построил это регулярное выражение, взяв

регулярное выражение snake_case, взятое из источника pylint в этой строке,
регулярное выражение CONST_VAR по умолчанию, взятое из источника pylint в этой строке

и присоединение к ним с помощью | и некоторых скобок.

Теоретически, вы также можете просто взять .*, но это позволит использовать даже недопустимые имена, такие как mixed_CASE.