flake8 comprehensions

flake8-понимания

Плагин flake8, который поможет вам лучше писать списки/наборы/диктовки.

---

Линтинг проекта Django? Прочтите мою книгу Boost Your Django DX, в которой рассказывается о Flake8 и многих других инструментах качества кода.

---

Требования

Поддерживается Python 3.9–3.13.

Установка

Сначала установите с помощью pip :

python -m pip install flake8-comprehensions

Во-вторых, если вы определяете настройку select Flake8, добавьте к ней префикс C4 . В противном случае плагин должен быть активен по умолчанию.

Правила

C400-402: Ненужный генератор — перепишите как понимание <list/set/dict> .

Правила:

• C400 Ненужный генератор - переписать как понимание списка.
• C401 Ненужный генератор — перепишите как понимание множества.
• C402 Ненужный генератор - переписать как понимание диктата.

Нет необходимости использовать list , set или dict вокруг выражения генератора, поскольку для этих типов существуют эквивалентные понимания. Например:

• Перепишите list(f(x) for x in foo) как [f(x) for x in foo]
• Перепишите set(f(x) for x in foo) как {f(x) for x in foo}
• Перепишите dict((x, f(x)) for x in foo) как {x: f(x) for x in foo}

C403-404: Ненужное понимание списка — перепишите как понимание <set/dict> .

Правила:

• C403 Ненужное понимание списка — перепишите как понимание множества.
• C404 Ненужное понимание списка — перепишите как понимание dict.

Нет необходимости использовать понимание списка внутри вызова set или dict , поскольку для этих типов существуют эквивалентные понимания. Например:

• Перепишите set([f(x) for x in foo]) как {f(x) for x in foo}
• Перепишите dict([(x, f(x)) for x in foo]) как {x: f(x) for x in foo}

C405-406: Ненужный литерал <list/tuple> — перепишите как литерал <set/dict> .

• C405 Ненужный литерал <list/tuple> — перепишите как набор литералов.
• C406 Ненужный литерал <list/tuple> — перепишите как литерал dict.

Нет необходимости использовать литерал списка или кортежа внутри вызова set или dict . Например:

• Перепишите set([1, 2]) как {1, 2}
• Перепишите set((1, 2)) как {1, 2}
• Перепишите set([]) как set()
• Перепишите dict([(1, 2)]) как {1: 2}
• Перепишите dict(((1, 2),)) как {1: 2}
• Перепишите dict([]) как {}

C407: Ненужное понимание <dict/list> — <builtin> может использовать генератор

Это правило было исключено в версии 3.4.0, поскольку оно способствовало увеличению лени, что могло привести к ошибкам.

C408: Ненужный вызов <dict/list/tuple> — перепишите как литерал.

Вызов, например, dict() медленнее, чем использование пустого литерала, поскольку имя dict необходимо искать в глобальной области видимости в случае его повторного привязки. То же самое и с двумя другими основными типами. Например:

• Перепишите dict() как {}
• Перепишите dict(a=1, b=2) как {"a": 1, "b": 2}
• Перепишите list() как []
• Перепишите tuple() как ()

C409-410: Ненужный <list/tuple> передан в <list/tuple> () - <advice> .

Правила:

• C409 Ненужный <list/tuple> передан в tuple() — <advice> .
• C410 Ненужный список передан в list() — <advice> .

Где <advice> :

• удалить внешний вызов <list/tuple> ()
• переписать как литерал <list/tuple>

Нет необходимости использовать литерал списка или кортежа при вызове list или tuple , поскольку для этих типов существует литеральный синтаксис. Например:

• Перепишите tuple([1, 2]) как (1, 2)
• Перепишите tuple((1, 2)) как (1, 2)
• Перепишите tuple([]) как ()
• Перепишите list([1, 2]) как [1, 2]
• Перепишите list((1, 2)) как [1, 2]
• Перепишите list([]) как []

C411: Ненужный вызов списка — удалите внешний вызов list().

Нет необходимости использовать list для понимания списка, поскольку без него он эквивалентен. Например:

• Перепишите list([f(x) for x in foo]) как [f(x) for x in foo]

C412: Ненужное понимание <dict/list/set> — 'in' может использовать генератор.

Это правило было исключено в версии 3.4.0, поскольку оно способствовало увеличению лени, что могло привести к ошибкам.

C413: Ненужный вызов <list/reversed> для sorted().

Нет необходимости использовать list() вместо sorted() поскольку он уже возвращает список. Также нет необходимости использовать reversed() вместо sorted() поскольку последний имеет reverse аргумент. Например:

• Переписать list(sorted([2, 3, 1])) как sorted([2, 3, 1])
• Перепишите reversed(sorted([2, 3, 1])) как sorted([2, 3, 1], reverse=True)
• Перепишите reversed(sorted([2, 3, 1], reverse=True)) как sorted([2, 3, 1])

C414: Ненужный вызов <list/reversed/set/sorted/tuple> внутри <list/set/sorted/tuple> ().

Нет необходимости выполнять двойное приведение или двойную обработку итераций, заключая перечисленные функции в list / set / sorted / tuple . Например:

• Переписать list(list(iterable)) как list(iterable)
• Переписать list(tuple(iterable)) как list(iterable)
• Переписать tuple(list(iterable)) как tuple(iterable)
• Перепишите tuple(tuple(iterable)) как tuple(iterable)
• Перепишите set(set(iterable)) как set(iterable)
• Перепишите set(list(iterable)) как set(iterable)
• Перепишите set(tuple(iterable)) как set(iterable)
• Перепишите set(sorted(iterable)) как set(iterable)
• Перепишите set(reversed(iterable)) как set(iterable)
• Переписать sorted(list(iterable)) как sorted(iterable)
• Переписать sorted(tuple(iterable)) как sorted(iterable)
• Перепишите sorted(sorted(iterable)) как sorted(iterable)
• Переписать sorted(reversed(iterable)) как sorted(iterable)

C415: Ненужное изменение индекса итерации внутри <reversed/set/sorted> ().

Нет необходимости менять порядок итерации, поскольку передача ее в одну из перечисленных функций снова изменит порядок. Например:

• Перепишите set(iterable[::-1]) как set(iterable)
• Перепишите sorted(iterable)[::-1] как sorted(iterable, reverse=True)
• Перепишите reversed(iterable[::-1]) как iterable

C416: Ненужное понимание <dict/list/set> — перепишите с помощью <dict/list/set> ().

Нет необходимости использовать понимание dict/list/set для построения структуры данных, если элементы не изменились. Вместо этого оберните итерацию с помощью dict() , list() или set() . Например:

• Перепишите {a: b for a, b in iterable} как dict(iterable)
• Перепишите [x for x in iterable] как list(iterable)
• Перепишите {x for x in iterable} как set(iterable)

C417: Ненужное использование map — перепишите, используя выражение генератора/понимание <list/set/dict> .

map(func, iterable) имеет отличную производительность, когда func является встроенной функцией, и это имеет смысл, если у вашей функции уже есть имя. Но если ваша функция является lambda , быстрее использовать выражение-генератор или понимание, поскольку это позволяет избежать накладных расходов на вызов функции. Например:

• Перепишите map(lambda x: x + 1, iterable) на (x + 1 for x in iterable)
• Переписать map(lambda item: get_id(item), items) на (get_id(item) for item in items)
• Перезаписать list(map(lambda num: num * 2, nums)) на [num * 2 for num in nums]
• Перепишите set(map(lambda num: num % 2 == 0, nums)) на {num % 2 == 0 for num in nums}
• Перепишите dict(map(lambda v: (v, v ** 2), values)) на {v : v ** 2 for v in values}

C418: Ненужный <dict/dict comprehension> передан в dict() — удалите внешний вызов dict().

Нет необходимости использовать dict вокруг литерала dict или понимания dict, поскольку любой синтаксис уже создает dict. Например:

• Перепишите dict({}) как {}
• Перепишите dict({"a": 1}) как {"a": 1}

C419 Ненужное понимание списка в <any/all> () предотвращает короткое замыкание — перепишите как генератор.

Использование понимания списка внутри вызова any() / all() предотвращает короткое замыкание при обнаружении значения True / False . Весь список будет создан перед вызовом any() / all() , что может привести к потере работы. Перепишите, чтобы использовать выражение-генератор, которое может остановиться на полпути. Например:

• Перепишите all([condition(x) for x in iterable]) как all(condition(x) for x in iterable)
• Перепишите any([condition(x) for x in iterable]) как any(condition(x) for x in iterable)

C420: Ненужное понимание dict — перепишите, используя dict.fromkeys().

Нет необходимости использовать понимание dict для создания dict со всеми значениями, установленными в одну и ту же константу. Вместо этого используйте dict.fromkeys() , что быстрее. Например:

• Перепишите {x: 1 for x in iterable} как dict.fromkeys(iterable, 1)
• Перепишите {x: None for x in iterable} как dict.fromkeys(iterable)