Yarn link что это
6 качеств, благодаря которым Yarn является лучшим менеджером пакетов для JavaScript
Russian (Pусский) translation by AlexBioJS (you can also view the original English article)
1. Скорость
Одним из достижений Yarn является его скорость работы по сравнению со стандартным клиентом npm. Но насколько он быстр? Недавно проведенное эталонное тестирование показало, что Yarn был в два-три раза быстрее npm. В этом тесте измерялось время установки React, Angular 2 и Ember. Это весьма надежная проверка менеджера пакетов, поскольку каждый из этих фреймворков нуждается во множестве зависимостей и содержит большую долю зависимостей реальных веб-приложений.
Давайте добавим еще одно значение и самостоятельно протестируем скорость путем установки модуля create-react-app при помощи yarn и npm. Ниже приведен результат установки с использованием yarn:
Вот результат установки с использованием npm:
Да. Этот результат бесспорно согласуется с другими сообщениями о значительном преимуществе yarn в скорости. Yarn установил модули за 2.59 секунд, тогда как npm потребовалось 9.422 секунд. Yarn был быстрее в 3.63 раза.
2. Надежность установок
Также yarn может похвастаться более надежными установками, чем npm. Когда установка считается ненадежной? Если при последующих установках происходит сбой или получается другой результат, то установка является ненадежной. Это может происходить по двум причинам:
Yarn справляется с обоими проблемами.
Офлайн кэш
Yarn использует глобальный офлайн кэш для сохранения пакетов, которые вы однажды установили, поэтому при установках новых версий используется кэшированная версия и достигается устойчивость к периодическим сбоям компьютерной сети. Вы можете узнать о расположении кэша yarn у вас при помощи команды:
Вот первые пять пакетов моего офлайн кэша:
Yarn способен на большее. У него может быть полное офлайн зеркало (* копия), которое будет использоваться обновлёнными версиями yarn.
Файл yarn.lock
Файл yarn.lock (* файл для блокировки ресурсов yarn) обновляется каждый раз, когда вы добавляете или обновляете версию пакета. В нем определяется, главным образом, точная версия каждого пакета, которая может быть указана в package.json при помощи частичного определения версии (например, указаны только главный и второстепенный номера версии), и его зависимостей.
Ниже приводится начало типичного файла yarn.lock. Вы можете увидеть версию такую, как она указана в package.json, например, «abbrev@1», и точно определенную версию «1.1.0».
Но почему?
Также yarn предоставляет вам команду yarn why для объяснения причины установки определенного пакета в вашем проекте:
3. Возможность проверки лицензий
4. Совместимость с npm и Bower
Yarn полностью совместим с npm, поскольку является просто другим клиентом, который работает с реестрами npm. В самом начале развития Yarn поддерживал Bower, однако немного спустя было принято решение прекратить поддержку Bower.
Основной причиной была не очень хорошая совместимость с Bower. При этом освобождалась папка bower_components или не доставлялся ни один пакет в новом проекте. Однако другой причиной является то, что команда Yarn не хотела поддерживать разделение в области управления пакетами и, наоборот, предпочитала переключение всех на npm.
Если вы заинтересованы в использовании Bower и не хотели бы переходить на другой менеджер пакетов прямо сейчас, вы по-прежнему можете использовать Yarn, однако, добавьте следующий фрагмент кода в ваш файл package.json.
5. Наличие нескольких реестров
Yarn может работать с несколькими типами реестров. Если вы просто добавляете пакет, то, по умолчанию, Yarn будет использовать свой реестр npm (который не является стандартным реестром npm). Однако, Yarn также может добавлять пакеты из файлов, удаленных tar-архивов с исходным кодом или удаленных репозиториев git (* система контроля версий).
Чтобы посмотреть текущий сконфигурированный реестр npm, выполните:
Для того чтобы установить другой тип реестра, используйте: yarn config set registry
Для добавления пакетов из разных источников используйте следующие команды для добавления:
6. Эмодзи «рулят»!
Одним людям нравятся эмодзи, другим нет. Изначально Yarn отображал эмодзи автоматически, однако только на операционной системе Mac OS X. В результате на Yarn посыпались камни с двух сторон: ненавистники эмодзи были огорчены тем, что их консоль пестрила эмодзи, в то время как любители эмодзи были расстроены отсутствием эмодзи на Windows и Linux.
How to `yarn link` a dist folder?
Is there a way to do a yarn link to a dist or lib folder?
Here is my code structure:
If I do cd dist && yarn link and do yarn link package-a to another project, it links the package-a root folder and not the dist, making the import looks like this:
Any way to make this work aside from manually doing a symlink?
3 Answers 3
yarn link will look for the folder where the package.json is in. So if you copy your package.json to your dist, it should work:
Not direct answer on that question, but with yarn you also can specify a package as a local dependency and it will work just like link, but it won’t require package.json to be in the dist folder.
Just specify in the project’s package.json where you would do yarn link foo :
Here I specified a relative path, yours could be whatever in local file system.
My solution for this was to conditionally alias the imports if there’s a symlink.
In my project I have dependency package-a that publishes on the root, while the local version (symlink) has the files to publish on package-a/dist
On my webpack config I have the following:
This way it will conditionally add an alias when the symlink path exists.
A more generic, less ES6 version:
With this you don’t have to change the imports and keep them as
Yarn 2 — Устанавливаем и разбираемся
Знакомство
Yarn 2 (Berry) — это новый выпуск революционного и хорошо зарекомендовавшего себя менеджера пакетов Yarn, включающий в себя такие особенности, как: Plug’n’Play, возможность расширения модульного API, оффлайн-кэш и улучшенную поддержку рабочих пространств.
Plug’n’Play
В новой документации Yarn подробно рассказывается о недостатках node_modules, как структуры папок, и объясняется, почему необходим новый взгляд на управление зависимостями.
Монорепозитории
Не зависимо от того, являетесь бы поклонником монорепозиториев или нет, чтобы обеспечить качественное управление большими проектами и сложными рабочими процессами, потребуется хороший набор инструментов.
Популярным рецептом настойки JavaScript монорепозитория является комбинация рабочих пространств Yarn и использование Lerna в качестве менеджера проектов.
Хорошая новость заключается в том, что теперь Yarn может одновременно выполнять функции как менеджера пакетов, так и менеджера проектов, пытаясь обеспечить положительный опыт работы в этом аспекте.
Модульная архитектура, плагины
Сделав важный шаг вперед, Yarn 2 был переработан в пользу нового модульного API, расширяемого при помощью плагинов. В настоящее время большинство функций уже реализовано с их помощью — даже yarn add и yarn install являются предустановленными плагинами!
Как начать работу?
Установка
Yarn придерживается стратегии глобальной установки первой версии, а уже затем переключения на вторую для конкретного проекта.
Сначала установим глобальный Yarn, который мы будем использовать для создания локальных экземпляров:
“Berry” — кодовое имя релизной ветки Yarn 2.
Изменим версию Yarn конкретно для каталога my-app :
После выполнения данной команды установка будет завершена, и можно переходить к установке зависимостей!
Добавление зависимостей
Общие команды управления остались теми же, что и в предыдущих версиях:
yarn init — инициализация проекта
[—dev] — добавление пакета
Также, вы можете увидеть некоторые изменения консольного интерфейса в новой версии Yarn:
каждый набор связанных задач, выполняемых в процессе установки, сгруппирован;
почти все сообщения имеют собственные коды ошибок, которые можно найти в документации;
цвета теперь используются только для обозначения важных частей каждого сообщения.
Установка React.js с Yarn-плагином TypeScript
Далеко не все пакеты поставляются с собственными определениями типов, но уже нет поводов для волнения, ведь там, где их нет, Yarn возьмёт работу на себя.
Перед выполнением операцией ниже, следует установить Yarn Berry для рабочей директории и убрать детей от экрана.
Инициализируем package.json и установим плагин TypeScript:
Проведем установку библиотеки React:
Зависимости @types/ были успешно установлены!
package.json
Что в итоге
Ветка Yarn 1.x (Classic) уже официально перешла в статус поддержки, предполагающей только исправление уязвимостей.
Для React Native всё таки придётся подключать node modules.
Если Yarn не подружится с вашей IDE, нужно будет кое-что установить. Не скучайте!
Yarn 2 — с Prolog’ом и плагнплеями
Yarn — менеджер пакетов для ноды — выпустили вторую версию. И, похоже, парни серьёзно вознамерились изменить статус-кво в экосистеме ноды, а то и вообще в пакетных менеджерах. Удаляйте все свои картинки про гигабайтные мамки node_modules, убирайте yarn install из скриптов CI, мы начинаем очередную великую JavaScript-смуту. Если вкратце:
Если вы не хотите обновлять все ваши проекты, просто запустите yarn policies set-version ^1 (смотри legacy.yarnpkg.com/en/docs/cli/policies) в репозиториях, которые должны остаться на Yarn 1 и закомитьте результат. Тогда Yarn будет использовать локальные бинарники Yarn 1 вместо глобальных так что все в команде будут использовать одну версию!
The JavaScript community has been surprisingly stable for the past few years. Really feels like the days of JavaScript Fatigue are behind us.
В целом, прослеживается два направления развития: а) максимальная воспроизводимость окружения и б) движение в сторону платформы для менеджмента пакетов.
По поводу первого пункта yarn загонялся всегда — собственно, это и было причиной по которой он когда-то появился, мигом потеснив npm (напомню, тогда запуск npm install мог давать разные результаты, потому что lock-файл в мире ноды — это заслуга yarn). Хотя лично я перешёл на него из-за бесящей строчки в логах npm.
Звучит интересно, амбициозно и слегка самоуверенно. Посмотрим, справятся ли они или заглохнут уже на этапе PnP-first.
Во всяком случае, я попробую перевести наш проект на yarn 2, если получится — это будет приятно. Вы как?
UPD: Про пролог в заголовке — это не шутка, на нём можно будет писать правила проверки воркспейсов, next.yarnpkg.com/features/constraints
Самое важное
А ещё.
Пакеты билдятся только если без этого совсем уж никак
Билды пакетов могут быть включены/выключены
Скрипты выполняются в универсальном шелле
Peer dependencies работают даже через yarn link
Локфайл стал обычным YAML
Весь код теперь на TypeScript
Поддержка плагинов
Breaking changes
Настройки стали единообразными
Пакеты должны соблюдать свои границы
Bundle dependencies больше не поддерживаются
Пакеты хранятся в read-only архивах
Детальный чейнджлог здесь, инструкции по обновлению — здесь.
Сложно будет переехать на Yarn 2?
Спасибо нашим бета-тестерам и общей поддержке экосистемы, мы облегчили кучу боли, связанной с таким массивным обновлением. Руководство по переезду расскажет детальней, но в целом пока вы используете последние версии инструментов (ESLint, Babel, TypeScript, Gatsby, и т.д.), всё должно быть норм.
Но есть один значимый косяк: Flow и React-Native сейчас нельзя использовать с Plug’n’Play (PnP). Мы ищем пути сотрудничества с их командами чтобы всё заработало. Сейчас же вы можете оставаться на Yarn 1 или использовать плагин node_modules, который предоставляет обратную совместимость для облегчения перехода (он всё ещё в работе, могут быть баги). Больше — здесь.
Что будет со старой версией?
Yarn 1.22 зарелизится на следующей неделе. После это ветка 1.x официально войдёт в режим доживания — то есть, не будет никаких релизов, кроме фиксов уязвимостей. Новые фичи будут делаться исключительно в Yarn 2. На практике это означает:
Как установить Yarn на Ubuntu 20.04
Yarn — это менеджер пакетов JavaScript, совместимый с npm, который помогает автоматизировать процесс установки, обновления, настройки и удаления пакетов npm. Он кэширует каждый загружаемый пакет и ускоряет процесс установки за счет распараллеливания операций.
В этом руководстве мы объясним, как установить Yarn на Ubuntu 20.04. Мы также рассмотрим основные команды и параметры Yarn.
Установка Yarn на Ubuntu
Установить Yarn на Ubuntu довольно просто. Мы включим официальный репозиторий Yarn, импортируем GPG-ключ репозитория и установим пакет. Репозиторий постоянно поддерживается и предоставляет самую последнюю версию.
Импортируйте GPG-ключ репозитория и добавьте репозиторий Yarn APT в вашу систему, выполнив следующие команды:
После включения репозитория обновите список пакетов и установите Yarn.
Приведенная выше команда также установит Node.js. Если вы установили Node через nvm, пропустите установку Node.js с помощью:
После завершения проверьте установку, распечатав версию Yarn:
Результат будет выглядеть примерно так:
Версия, установленная в вашей системе, может отличаться от указанной выше.
Это оно! Вы успешно установили Yarn на свой компьютер с Ubuntu и можете начать его использовать.
Использование пряжи
Теперь, когда Yarn установлен в вашей системе Ubuntu, давайте рассмотрим некоторые из наиболее распространенных команд Yarn.
Создание нового проекта
Начните с создания каталога для вашего приложения и перейдите в него:
Чтобы создать новый проект, запустите yarn init :
Команда задаст вам несколько вопросов. Введите информацию в соответствии с запросом или примите значения по умолчанию:
После завершения сценарий создает базовый файл package.json содержащий предоставленную информацию. Вы можете открыть и отредактировать этот файл в любое время.
Добавление зависимости
Чтобы добавить пакет npm в зависимости проекта, используйте команду yarn add за которой следует имя пакета:
По умолчанию, когда указано только имя пакета, Yarn устанавливает последнюю версию. Чтобы установить определенную версию или тег, используйте следующий синтаксис:
Обновление зависимости
Чтобы обновить пакеты, используйте одну из следующих команд:
Если имя пакета не указано, команда обновит зависимости проекта до последней версии в соответствии с диапазоном версий, указанным в файле package.json. В противном случае обновляются только указанные пакеты.
Удаление зависимости
Используйте команду yarn remove за которой следует имя пакета, чтобы удалить зависимость:
Установка всех зависимостей проекта
Выводы
Если у вас есть какие-либо вопросы или отзывы, не стесняйтесь оставлять комментарии ниже.