Skip to content

Latest commit

 

History

History
64 lines (45 loc) · 3.53 KB

style.md

File metadata and controls

64 lines (45 loc) · 3.53 KB

ya style

Команда ya style используется для исправления стиля кода на языках C++, Python и Go.

Файлы могут быть переданы непосредственно или обработаны рекурсивно в директориях.

Синтаксис

ya style [OPTION]... [FILE OR DIR]...

Опции style

  • --reindent — выровнять строки по минимальному отступу.
  • -h, --help — распечатать справку.

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

Эти ключи могут быть комбинированы для достижения более точных результатов.

Например, чтобы отфильтровать файлы на языках Python, C++ и Go, вы можете использовать следующие ключи:

  • --py для Python.
  • --cpp для C++.
  • --go для Go.
  • --yamake для файлов ya.make.
  • --cuda обрабатывать только файлы cuda.
  • --all запустить все проверки: py, cpp, go, yamake, cuda.

Линтеры по языкам

C++

Для форматирования C++-кода используется утилита clang-format.

Python

Команда поддерживает защиту блоков кода с помощью # fmt: on/off. Для форматирования используется линтер black. Если вы предпочитаете стиль форматирования Ruff, используйте опцию --ruff, которая позволяет использовать форматирование с помощью инструмента Ruff вместо стандартного black для Python-файлов.

Go

В качестве линтера для Go используется утилита yoimports, поэтому при запуске ya style обновятся только import-ы.

Для полноценного линтинга нужно использовать yolint.

Примеры использования ya style

ya style file.cpp  # обновить стиль файла file.cpp
ya style           # обновить стиль текста из <stdin>, перенаправить результат в <stdout>
ya style .         # обновить стиль всех файлов в данной директории рекурсивно
ya style folder/   # обновить стиль всех файлов во всех подпапках рекурсивно
ya style . --py    # обновить стиль всех python-файлов в данной директории рекурсивно

Java

Для java существует отдельная команда ya jstyle.

Отформатировать Java-код.

ya jstyle [OPTION]... [TARGET]...

Команда ya jstyle используется для форматирования Java-кода и использует те же опции, что и ya style. Базируется на форматтере JetBrains IntelliJ IDEA.

Пример

  ya jstyle path/to/dir  # обновить стиль всех поддерживаемых файлов в данной директории