Вклад в libvips

Благодарим вас за интерес к участию в развитии libvips! Есть много способов внести свой вклад, и мы ценим все вклады.

Стиль кода

В этом проекте используется clang-format для поддержания единого стиля кода во всей кодовой базе. Мы рекомендуем использовать версию 14 (доступную в Ubuntu 22.04), чтобы избежать несоответствия форматирования с нашей проверкой GitHub Actions lint.

clang-format можно использовать через скрипт git-clang-format. На некоторых системах он может быть уже установлен (или доступен для установки через менеджер пакетов). Если это так, вы можете просто запустить его — следующие команды отформатируют только код на подготовленных изменениях:

# Подготовить исходные изменения
$ git add .

# Запустить clang-format на подготовленных изменениях
$ git clang-format

# Подготовить изменения форматирования и зафиксировать
$ git add .
$ git commit -m "My commit message"

Или вы можете отформатировать только код, изменённый в последнем коммите:

$ git clang-format HEAD~1

Обратите внимание, что это изменяет файлы, но не фиксирует их — вам, вероятно, потребуется запустить:

$ git commit --amend -a

чтобы обновить последний коммит со всеми ожидающими изменениями.

В экстренных случаях переформатируйте весь проект с помощью чего-то вроде:

find . \
  \( -name "*.[hc]" -o -name "*.cc" -o -name "*.cpp" \) \
  -not \( -path "./libvips/foreign/libnsgif/*" -o \
    -name vips-operators.cpp -o \
    -name StandaloneFuzzTargetMain.c -o \
    -name profiles.c \) | \
  xargs clang-format -i