Базовый курс 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>. Вы должны увидеть информацию о вашем пакете.

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

или

или

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

 

Базовый курс npm: 3 комментария

  1. Приветствую Вас, Автор курса по NPM. Всё написано более чем доступно и понятно. Не раскрыт лишь 1 очень важный вопрос, за чем я и обратился к Вашему курсу — как удалить опубликованный пакет.

    1. Полагаю, что вот так:


      Но поосторожнее с этим. Я бы не удалял уже опубликованные версии и пакеты.

      1. После того, как один турок поудалял все свои пакеты, это уже никак не сделать.
        (Он тогда чуть ли не интернет обломал)

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

Ваш адрес email не будет опубликован. Обязательные поля помечены *