Початковий код Weblate¶
Розробка Weblate ведеться на GitHub. Ми будемо раді, якщо ви створите відгалуження коду і надсилатимете запити щодо злиття. Будемо раді будь-яким латкам у будь-якій формі.
Дивись також
Ознайомтеся із розділом Нутрощі Weblate, щоб дізнатися про те, як Weblate виглядає з середини.
Настанови щодо програмного коду¶
Будь-який код для Weblate має бути написано із використанням Security by Design Principles (принципів безпеки за компонуванням).
Будь-який програмний код має супроводжуватися документацією, яка пояснює його роботу. Не забувайте документувати методи, складні блоки коду або видимі користувачам можливості.
У коді має бути використано підказки щодо типів з PEP 484. Ми ще не перевіряємо їх у системі неперервної інтеграції, оскільки у наявному коді їх ще немає.
Стандарт програмування та шліфування коду¶
У коді має бути виконано вимоги щодо коду PEP-8, його має бути форматовано засобом форматування ruff.
Для перевірки якості коду ви можете скористатися ruff — її налаштування зберігаються у pyproject.toml
.
The easiest approach to enforce all this is to install pre-commit. The
repository contains configuration for it to verify the committed files are sane.
After installing it (it is already included in the
pyproject.toml
) turn it on by running pre-commit install
in
Weblate checkout. This way all your changes will be automatically checked.
Ви також можете запустити перевірку вручну. Щоб перевірити усі файли:
pre-commit run --all