From ff69e50127ac993bd4df3ec3784351072fd98baf Mon Sep 17 00:00:00 2001 From: Dexoron Date: Fri, 13 Feb 2026 00:49:18 +0800 Subject: [PATCH] =?UTF-8?q?=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?= =?UTF-8?q?=D0=BD=D1=8B=20=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=D0=B0=20?= =?UTF-8?q?=D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=B8=D0=B1=D1=8C=D1=8E=D1=86?= =?UTF-8?q?=D0=B8=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CONTRIBUTING.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..2c74346 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,55 @@ +# Вклад в проект + +Спасибо за интерес к проекту. + +## Требования + +- Обязательно использовать форматирование `ruff`. +- Обязательно использовать аннотации типов и проверять их через `ty`. + +## Быстрый старт(GNU/Linux) + +Создайте линковку ./PATH_TO_PROJECT/dcr и ~/.local/bin/dcr +После этого, вы можете использовать команду dcr где угодно + +## Стиль кода + +- Форматируйте код через `ruff`. +- Держите функции небольшими и сфокусированными. +- Предпочитайте понятные имена вместо "хитрых". + +## Типизация + +- Добавляйте аннотации типов для нового и изменяемого кода. +- Запускайте `ty` для проверки корректности типов. + +## Проверки + +Для запуска всех проверок используйте скрипт проекта: + +```bash +./check.sh +``` + +> Скрипт можно запустить из любой папки, указав путь до него: `../check.sh` (или больше `../`, если нужно). + +## Запуск инструментов напрямую + +```bash +ruff check src +uvx ty check src +``` + +## Коммиты и PR + +- Делайте коммиты понятными. +- В PR указывайте краткое описание и мотивацию изменений. +- Обновляйте документацию при изменении поведения. + +## Вопросы + +Если что-то непонятно, откройте issue или задайте вопрос в PR. + +Также можно задать вопрос напрямую: +- TG: @dexoron +- DS: dexoron