Англійська для робочих місць Bun

Вбудована підтримка робочого простору Bun зробила його серйозним варіантом для інструментів monorepo, конкуруючи безпосередньо з налаштуваннями pnpm і Turborepo. Розмова про робочі простори — знання різниці між « пов’ язаним пакунком » і « залежністю каталогу » — важливо, коли ви зневаджуєте, чому одна програма у монорепо має іншу версію спільної бібліотеки, ніж інша. Цей довідник містить основні слова.

Ключовий словник

Workspace — у монорепо, окремий пакунок (програма або спільна бібліотека), який оголошено як частина поля workspaces кореня package.json, що дозволяє Bun керувати своїми залежностями разом зі своїми братами. “Ми додали новий пакунок ui як робочий простір, щоб веб- програма і програма адміністратора могли імпортувати його безпосередньо.”

** Протокол робочого простору ( workspace:* ) ** — спеціальний спеціфікатор версії, який використовується у package.json пакунка для посилання на інший робочий простір у тому ж монорепо, а не на версію, опубліковану в реєстрі. “Використовувати workspace:* для внутрішнього пакунка ui замість прикріплення номера версії — Bun завжди розв’ язуватиме його до локальної копії.”

** Поєднаний пакунок ** — залежність робочого простору, яку Bun символічно посилається на node_modules замість звантаження, отже зміни до пакунка джерел будуть негайно видимі для всіх залежних від нього пакунків. “Оскільки ui є пов’язаним пакунком, вам не потрібно перекомпілювати і переопубліковувати його — зміни з’являються в програмі миттєво.”

** Залежність від каталогу ** — версія залежності, визначена центральним чином, оголошена один раз у кореневому каталогу робочого простору, на яку може посилатися декілька пакунків, щоб гарантувати, що всі вони використовують одну і ту ж версію. “Ми перенесли React в каталог залежностей, тому кожна програма в монорепо змушена використовувати одну і ту ж версію, замість того, щоб дрейфувати окремо.”

** Підняття ** — процес встановлення спільних залежностей один раз у корені node_modules замість дублювання їх у кожному робочому просторі, зменшуючи розмір встановлення і дублювання. “Більшість наших залежностей переносяться до кореня, тому вилучення теки node_modules одного пакунка насправді не вилучає багато.”

** Фільтр робочого простору ** — параметр командного рядка ( bun run --filter ), який визначає обсяг скрипту для виконання лише у певних робочих просторах, корисний для збирання або перевірки підмножини великого моно- сховища. “Використовувати фільтр робочого простору, щоб CI запускав тести тільки для пакунків, які дійсно змінилися, замість того, щоб запускати весь монорепо кожного разу.”

Звичайні фрази

• «Чи ця версія залежності надходить з каталогу, чи хтось прикріпив її локально в цьому одному пакунку?»
• «Перевірте, чи пакунок правильно пов’язаний — якщо ні, то ви, ймовірно, тестуєте проти застарілої опублікованої версії»
• «Запустити збірку з фільтром робочого простору, щоб ми не перебудовували кожну програму для зміни однієї лінії»
• «Це невідповідність версії є саме тією причиною, чому ми перенесли спільні залежності в каталог.»
• Не забувайте декларувати новий пакунок як робочий простір, або Bun не підніме свої залежності

Приклади висловлювань

Пояснення налаштування монорепо для нового наймача: “Все під packages/ і apps/ є робочим простором, тому коли ви встановлюєте залежності в корені, Bun автоматично пов’язує внутрішні пакунки разом — вам ніколи не потрібно npm link щось вручну.”

Зневадження невідповідності версій:

• “Вада відтворюється лише у програмі адміністрування, оскільки вона все ще прив’ язана до старої версії бібліотеки спільних даних, а всі інші дані витягуються з каталогу. Давайте перенесем його в каталог, щоб це не могло повторитися»

Опис покращень швидкодії CI: “Ми значно скоротили час CI, використовуючи фільтри робочого простору — запити на завантаження, які торкаються тільки пакунку ui більше не викликають повного перебудови і тестового запуску в кожній програмі в монорепо.”

Професійні поради

• Використовуйте « linked », особливо, коли пакунок робочого простору розв’ язує локальну версію коду, а не опубліковану версію — ця відмінність є ключовою під час зневадження проблем « це працює у пакунку, але не у програмі ».
• Рекомендуємо активне використання ** каталогу залежностей ** під час перегляду коду, якщо ви бачите, що одна і та ж залежність прив’ язана до різних версій у різних робочих просторах — це поширене і легко запобіжне джерело незначних помилок.
• Використовуйте ** workspace filters ** при описі CI або оптимізації збирання; надання назви механізму допомагає колегам по команді відтворити підхід у інших місцях.
• Розрізняйте hoisting (оптимізація встановлення) від linking (механізм розв’ язання для внутрішніх пакунків) — об’ єднання їх призводить до заплутаного розв’ язання проблем.

Практичні вправи

1. Поясніть, у двох реченнях, чому використання workspace:* краще, ніж прикріплення номера версії для внутрішнього пакунка.
2. Написати опис PR у одному реченні, у якому буде запропоновано пересунути залежність до спільного каталогу.
3. Опишете, як використовувати фільтр робочого простору для прискорення CI для моно- сховища з двадцятьма пакунками.

Національний склад населення: Перепис населення та проживання

Будьмо чесними - навіть рідні носії англійської мови іноді борються з точкою мови, необхідної для ефективного спілкування в професійному середовищі розвитку. Коли ви працюєте з монорепо з використанням робочих просторів Bun — особливо, коли ви надсилаєте зворотній зв’ язок або координуєте зміни — важливо не тільки те, що ви кажете, але і як ви це кажете. Добре сформульоване повідомлення може розсіяти напругу, прояснити очікування і, врешті-решт, призвести до гладшої співпраці. Однією з найбільших проблем для носіїв мови, яка не є рідною, є розуміння тонких відмінностей у фразуваннях, які сигналізують про невідкладність, вимагають пояснення або просто визнають зміну.

Розглянемо такий сценарій: Ви щойно отримали коментар перегляду коду щодо PR, у якому описано зміни у модулі обробки даних вашої програми. Рецензент пише: «Це потребує подальшого дослідження — вплив на продуктивність не ясний.» Хоча здавалося б, це просте, це можна інтерпретувати декількома способами. Рецензент пропонує повне переписування? Они просят больше данных для профилирования? Чи вони просто підкреслюють область, яка потребує уваги? Більш нюансована відповідь може бути: «Дякую за підняття цього питання! Чи можете ви розглянути які конкретні аспекти впливу на продуктивність ви хотіли б, щоб я дослідив далі? Можливо, запуск деяких тестів навантаження з різними вхідними даними допоможе нам отримати яснішу картину. » Зауважте використання фраз на зразок « Чи могли б ви розібратися » — безпосередньо запитуєте про пояснення і описуєте вашу відповідь як спільну спробу. Аналогічно, при описі змін в описі PR, уникайте нечітких тверджень. Замість « Оновлено код », спробуйте « Впроваджено новий алгоритм для оптимізованого отримання даних за допомогою API fetch, скоротивши час запиту на 15% за оцінками, отриманими під час початкового тестування »

Інша поширена ситуація, коли вам слід координувати роботу у декількох робочих просторах у межах вашого моно- сховища Bun. Вам може знадобитися запитати оновлення залежностей у іншої команди. Прямий підхід, на зразок « Оновити цю бібліотеку », може призвести до плутанини. Професійнішою формулюванням буде: «Привіт Команда Альфа, ми в даний час оновлюємо наш модуль перевірки даних і вимагаємо останню версію validator. Чи можете ви переконатися, що будь- які оновлення до validator сумісні з нашими поточним налаштуваннями? Ми прагнемо до безшумної інтеграції і цінуємо вашу підтримку. “Це демонструє обізнаність про потенційні конфлікти і підкреслює співпрацю.

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

bun install --scripts --path ./packages/my-module

Ця команда, яку використовують для встановлення залежностей у структурі пов’ язаних пакунків робочого простору Bun, демонструє практичне застосування розуміння термінології керування залежностями — ще одну область, де точне формулювання є ключовим для ефективного спілкування. Використання bun install --scripts підкреслює намір виконати скрипти, визначені в package.json пакунку.