Середовище роботи
pnpm має вбудовану підтримку для монорепозиторіїв (відомих також як багатопакетні репозиторії, багатопроектних репозиторіїв або монолітні репозиторії). Ви можете створити робочий простір, щоб об’єднати кілька проєктів в одному репозиторії.
Робочий простір має мати pnpm-workspace.yaml
файл у своєму корені. Робоча область також може мати .npmrc
у своєму корені.
Якщо ви розглядаєте управління монорепозиторієм, ви також можете розглянути Bit. Bit використовує pnpm під капотом, але автоматизує багато речей, які зараз виконуються вручну в традиційному робочому просторі, керованому pnpm/npm/Yarn. Є стаття про bit install
, яка розповідає про це: Painless Monorepo Dependency Management with Bit.
Протокол робочого простору (workspace:)
By default, pnpm will link packages from the workspace if the available packages match the declared ranges. Наприклад, foo@1.0.0
повʼязано з bar
, якщо bar
має "foo": "^1.0.0"
у своїх залежностях і foo@1.0.0
знаходиться у робочому просторі. Однак, якщо bar
має "foo": "2.0.0"
у залежностях і foo@2.0.0
відсутній у робочому просторі, foo@2.0.0
буде встановлено з реєстру. Така поведінка вносить певну невизначеність.
На щастя, pnpm підтримує протокол workspace:
. При використанні цього протоколу pnpm відмовлятиметься виконувати перетворення на будь-що, окрім пакунків локального робочого простору. Отже, якщо ви задасте "foo": "workspace:2.0.0"
, цього разу встановлення не вдасться, оскільки "foo@2.0.0"
у робочому просторі відсутній.
Цей протокол особливо корисний, коли параметр link-workspace-packages має значення false
. У цьому випадку pnpm буде компонувати пакунки з робочого простору лише за умови використання протоколу workspace:
.
Посилання на пакунки робочого простору через псевдоніми
Припустимо, у робочому просторі у вас є пакунок з назвою foo
. Зазвичай, ви посилаєтесь на нього як "foo": "workspace:*"
.
Якщо ви хочете використовувати інший псевдонім, наступний синтаксис також буде працювати: "bar": "workspace:foo@*"
.
Перед публікацією псевдоніми перетворюються на звичайні залежності від псевдонімів. Вищенаведений приклад стане: "bar": "npm:foo@1.0.0"
.
Посилання на пакунки робочого простору через їхній відносний шлях
У робочому просторі з 2 пакунками:
+ packages
+ foo
+ bar
bar
може мати foo
у своїх залежностях, оголошених як "foo": "workspace:../foo"
. Перед публікацією ці специфікації перетворюються у звичайні специфікації версій, які підтримуються усіма менеджерами пакунків.