ondivi

Ондиви (только нарушения различия)

Это простой сценарий Python, предназначенный для фильтрации нарушений кодирования (вероятно, идентифицированного статическим анализатором) только для линий, которые были изменены в репозитории GIT.

Этот инструмент работает с любым анализатором Linter или статического кода, включая, помимо прочего:

• Flake8
• Рюша
• Пинтинт
• Mypy
• Эслинт
• Рубокоп
• Стилит

Предварительные условия:

• Python 3.9 или выше
• Git

Установка

pip install ondivi

Использование

Убедитесь, что вы находитесь в корневом каталоге вашего репозитория GIT.

Запустите сценарий:

flake8 script.py | ondivi
# with ruff:
ruff check file.py --output-format=concise | ondivi

или:

flake8 script.py > violations.txt
ondivi --fromfile=violations.txt

 $ ondivi --help
Usage: ondivi [OPTIONS]

  Ondivi (Only diff violations).

  Python script filtering coding violations, identified by static analysis,
  only for changed lines in a Git repo. Usage example:

  flake8 script.py | ondivi

Options:
  --baseline TEXT    Commit or branch which will contain legacy code. Program
                     filter out violations on baseline (default: "master")
  --fromfile TEXT    Path to file with violations. Expected "utf-8" encoding
  --format TEXT      Template for parsing linter messages. The template should
                     include the following named parts:

                     {filename}   The name of the file with the error/warning
                     {line_num}   The line number with the error/warning
                     (integer)

                     Example usage:

                     --format "{filename}:{line_num:d}{other}"

                     In this example, the linter message

                     "src/app_types/listable.py:23:1: UP035 Import from
                     collections.abc instead: Sequence"

                     will be recognized and parsed into the following
                     components:

                      - filename: "src/app_types/listable.py"
                      - line_num: 23
                      - other: :1: "UP035 Import from collections.abc instead:
                      Sequence"

                     Ensure that the template matches the format of the
                     messages generated by your linter.
                     (default: "{filename}:{line_num:d}{other}")
  --only-violations  Show only violations
  --help             Show this message and exit.

Как это работает

Сценарий анализирует выход GIT DIFF, чтобы идентифицировать измененные строки в каждом файле.

Затем он фильтрует заданные нарушения кодирования, чтобы включить только те нарушения, которые соответствуют измененным линиям.

FlakeHeaven и FlakeHell не поддерживаются, потому что они полагаются на внутренний API Flake8, что может привести к проблемам совместимости по мере развития Flake8. Напротив, Ondivi использует только выходные данные о нарушениях и состояние репозитория GIT, что делает его более надежным и проще в обслуживании.

Flake8 в файле:

$ flake8 file.py
file.py:3:1: E302 expected 2 blank lines, found 1
file.py:9:1: E302 expected 2 blank lines, found 1
file.py:10:121: E501 line too long (123 > 120 characters)
file.py:14:1: E305 expected 2 blank lines after class or function definition, found 1

Пример изменений:

 from dataclasses import dataclass

 @dataclass
 class User(object):

     name: str
     age: int

 def greet(user: User):
     print('Long string in initial commit ################################################################################')
     print(f'Hello, {user.name}!')
+    print('Long string in new commit ################################################################################')

 if __name__ == '__main__':
     greet(User(345, 23))
+    greet(User('Bob', '23'))

По GIT Diff, мы видим, что были добавлены две новые линии (12 и 16):

Ondivi отфильтровывает нарушения и показывает только один для строки 12:

$ flake8 script.py | ondivi
file.py:12:80: E501 line too long (119 > 79 characters)

Лицензия

Этот проект лицензирован по лицензии MIT. Смотрите файл лицензии для получения подробной информации.