Перейти до вмісту

Побудувала механізм із 268 перевірок репозиторію

Побудувала механізм перевірок репозиторію — 268 зареєстрованих перевірок коміту, 277 правил лінтингу та 15 власних правил ESLint — а також 146 тестів самих перевірок, щоб стандарт тримала збірка, а не код‑рев'ю.

268 перевірок коміту і 146 тестів самих перевірок

Ситуація. Стандарти, записані в настановах для учасників проєкту, — лише побажання. З ними всі згодні, а потім настає п’ятниця, зміна маленька, і настанови програють. Планка нульових попереджень могла втриматися лише за умови, що її триматиме щось, окрім доброї волі, — а лінтери, що йдуть у комплекті з кожною мовою, далеко не охоплюють специфічних для проєкту правил, які насправді мають значення: тих, що описують, як має працювати саме ця кодова база.

Завдання. Важливі для проєкту правила мали стати виконуваними, щоб порушення будь‑якого з них зупиняло коміт, а не чекало на рецензента, якому вистачить часу й пам’яті це помітити.

Дія. З цього виріс цілий рушій захисних перевірок. Це 274 скрипти перевірок, із них 268 зареєстровано в хуках комітів, а поруч — 277 лінтерів на JavaScript, 96 валідаторів на shell і 17 на Python, які стежать за тим, до чого готовим інструментам байдуже: що міграцію можна відкотити, що ключ перекладу існує в обох локалях, що зареєстрований маршрут є в описі OpenAPI, що ніхто тихцем не придушив попередження прямо в коді. П’ятнадцять власних правил ESLint тримають у TypeScript патерни, прийняті в проєкті. Одне правило варто назвати окремо: будь‑який коміт із префіксом fix: мусить містити тест, який без цього виправлення падає, — це дає виконувану перевірку для цієї регресії. А оскільки зламана перевірка гірша, ніж її відсутність, — вона пропускає все, і ніхто про це не дізнається, — самі перевірки мають 146 власних тестів.

Результат. Рецензенти могли приділяти більше часу проєктуванню, бо ще до відправлення гілки автоматичні перевірки опрацьовували закладені в них формальні правила. Компроміс реальний, і про нього варто сказати прямо: комітити повільно, а погано написана перевірка, яку доводиться обходити, справді доводить до сказу. Ті 146 тестів існують саме тому, що так уже траплялося.

  • Оглядова вежа, сніг, зима
    Фото: schauhi / Pixabay
  • Поворот дороги, захисна огорожа, напрямні стовпчики
    Фото: Monsterkoi / Pixabay

Застосуйте цей досвід у своєму проєкті

Використайте «Побудувала механізм із 268 перевірок репозиторію» як відправну точку для схожого завдання у вашій організації. Послуги, що стоять за цією роботою, доступні й для вашого проєкту. Агент, під'єднаний до систем, якими ви вже користуєтеся, перевірений на прикладах, які складають ваші експерти, під наглядом ваших людей і не прив'язаний до однієї моделі.

Переглянути наші послуги Зв'язатися з нами

Дізнайтеся, що привело до результату

Прочитайте про ситуацію, рішення та результат цього прикладу. Ми можемо обговорити, що відповідає вашим умовам, а що потребує іншого підходу. Побудувала механізм із 268 перевірок репозиторію — 268 перевірок коміту і 146 тестів самих перевірок

Переглянути наші послуги Зв'язатися з нами

Одна частина довшого переліку — і він увесь на цьому сайті.

Кожен запис написано однаково: ситуація, завдання, що ми зробили і що змінилося.

Переглянути весь перелік

Визначте потрібне покращення

Опишіть робочий процес, наявні інтерфейси та користувачів, яким потрібна зміна. Ми можемо визначити перевірюваний результат і спосіб передачі, який дасть вашій команді змогу підтримувати його.

Дивитися, скільки це коштує Зв'язатися з нами

Хочете, щоб дотримання ваших стандартів перевірялося автоматично?

Запитайте про рішення в роботі «Побудувала механізм із 268 перевірок репозиторію». Ви говоритимете з людьми, які можуть пояснити роботу й оцінити ваш проєкт.

Переглянути наші послуги
welcome@engineer.company +45 50 10 61 84 Копенгаген, Данія
QR-код сторінки «Побудувала механізм перевірок репозиторію — 268 зареєстрованих перевірок коміту, 277 правил лінтингу та 15 власних правил ESLint — а також 146 тестів самих перевірок, щоб стандарт тримала збірка, а не код‑рев'ю.»
Візьміть цю сторінку із собоюhttps://software.engineer.company/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/