Перейти до вмісту
EngineerПлатформа
Меню
Дизайн
Українська

Engineer / Платформа / Портфоліо

Перевірила лінтером 10 242 рядки перевірки якості

Охопила форматувальником і лінтером 10 242 рядки JavaScript у перевірках якості, з'ясувавши, що це найбільший обсяг коду в репозиторії і єдиний, який ніщо не перевіряло, — виправила 13 зауважень і не вимкнула жодного.

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

Завдання. Скрипти перевірки треба було привести до того самого стандарту, дотримання якого вони мають забезпечувати, а форматувальник — підлаштувати під них, а не навпаки.

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

Результат. Найбільший і найвідповідальніший код у репозиторії тепер відформатовано й перевірено лінтером і засобом перевірки типів: тринадцять проблем виправлено, жодної не придушено. Чому це важливіше, ніж можна подумати з кількості рядків, пояснено в плані: дефект у таблиці стилів сайту проявляється як сторінка, що має неправильний вигляд, а дефект у скрипті перевірки — як перевірка, що проходить тоді, коли не мала б.

Контакти

Ще визначаєтесь, що саме вам потрібно?

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

Від 1 400 DKK за годину, без ПДВ — і дешевша година на довшому замовленні.

welcome@engineer.company +45 50 10 61 84 Копенгаген, Данія