Базовый курс npm

Содержание

Скачивание и установка npm

Установка пакетов npm

Использование установленного пакета npm

Использование файла «package.json»

Зависимости от других пакетов

Идея версионирования: патчи, минорные и мажорные версии

Обновление зависимостей

Удаление зависимостей

Установка пакета npm глобально

Обновление глобальных пакетов npm

Удаление глобальных пакетов npm

Публикация пакета npm


 

Скачивание и установка npm

Для начала нам нужно установить Node.js, npm идёт вместе с ним. Затем нужно обновить версию npm, так как он обновляется несколько чаще, чем Node.js:

Проверить версию npm можно командой:

У меня вывело 4.5.0.

Установка пакетов npm

Существует два способа установки пакетов npm: локально и глобально.

Если вы хотите использовать пакет из своего модуля с помощью чего-нибудь вроде require от Node.js, то вам нужно установить пакет локально командой:

Эта команда создаст каталог «node_modules» в текущем рабочем каталоге и скачает туда указанный пакет.

Для проверки этой команды вы можете выполнить:

Затем проверьте, что у вас появился каталог «node_modules» с подкаталогом «lodash».

Если у вас не было файла «package.json» в текущем каталоге, то устанавливается последняя версия, если же файл «package.json» присутствует, то устанавливается последняя версия, удовлетворяющая правилам в этом файле.

Использование установленного пакета npm

После появления пакета в каталоге «node_modules» вы можете его использовать. Например, если вы создаёте модуль Node.js, то вы можете подключить и использовать его так:

Запуск:

Использование файла «package.json»

Лучший способ  управления локально установленными пакетами — это использование файла «package.json», который должен иметь как минимум name и version.

Поле name  должно состоять из строчных букв английского алфавита, подчёркиваний и тире. Оно определяет имя вашего модуля.

Поле version определяет версию в формате x.x.x.

Пример:

Создать «package.json» можно командой с консоли:

Эта команда проведёт вас через процесс создания «package.json» в стиле вопрос-ответ.

Зависимости от других пакетов

Для указания зависимости от других пакетов используются поля dependencies  и devDependencies в «package.json», которые указывают зависимости для production среды и development соответственно. Для добавления зависимостей проще использовать флаги --save и --save-dev у npm install, которые сохраняют зависимость в «package.json» для production и development среды.

Пример «package.json» с зависимостями:

Идея версионирования: патчи, минорные и мажорные версии

Идея использования трёх чисел, разделённых точками, в качестве версии состоит в следующем (например, если текущий пакет 1.0.0):

  • Патчи или исправления ошибок и незначительные изменения увеличивают последнее число (1.0.1).
  • Минорные версии. Новые возможности, которые не ломают старый код увеличивают второе число (1.1.0).
  • Мажорные версии. Изменения, ломающие совместимость со старым кодом увеличивают самое первое число (2.0.0).

При указании необходимой версии зависимости в «package.json» можно указывать диапазоны:

  • 1.0, 1.0.x или ~1.0.4 будет использовать последнюю версию патча с исправлениями ошибок (для третьего варианта начиная с версии 1.0.4).
  • 1, 1.x или ^1.0.4 будет использовать последнюю минорную версию.
  • * или x всегда будет использовать последнюю версию.

Обновление зависимостей

Для обновления зависимостей в соответствии с правилами в файле «package.json» используйте команду:

Удаление зависимостей

Для удаления зависимости из каталога «node_modules» используйте команду:

Для удаления зависимости из файла «package.json» используйте:

и

Установка пакета npm глобально

Устанавливайте пакет глобально, если вы хотите его использовать как самостоятельную утилиту с командной строки:

Если вы получите ошибку EACCESS, то это значит, что у вас нет прав на изменение каталога, который npm использует для глобальных пакетов.

В этом случае вам нужно сделать одно из следующих:
1. Изменить права доступа к каталогу, который npm использует по умолчанию.
2. Изменить каталог по умолчанию для npm.
3. Установить node c помощью пакетного менеджера.

Обновление глобальных пакетов npm

Для обновления пакетов npm, установленных глобально, используйте команду:

 

Удаление глобальных пакетов npm

Для удаления пакетов npm, установленных глобально, используйте команду:

 

Публикация пакета npm

Для начала вам нужно создать пользователя в репозитории npm:

Если же у вас уже есть пользователь, созданный на сайте, то можете сохранить его логин и пароль:

Для публикации пакета используйте команду:

Имейте в виду, что опубликовано будет всё, что не добавлено в игнорируемые в «.gitignore» или «.npmignore».

Перейдите на https://npmjs.com/package/<package>. Вы должны увидеть информацию о вашем пакете.

Для обновления версии используйте одну из команд:

или

или

А затем опубликуйте его снова:

 


Поделиться:

Добавить комментарий

Ваш e-mail не будет опубликован.

*