test-cli-package

Простий тестовий npm пакет з CLI командою.

Встановлення

npm install -g test-cli-package

Використання

test-cli
test-cli hello
test-cli hello Іван
test-cli version

Як задеплоїти пакет на npm

1. Підготовка

Переконайтеся, що у вас є акаунт на npmjs.com. Якщо немає - зареєструйтеся.

2. Увімкнення двофакторної аутентифікації (2FA)

ОБОВ'ЯЗКОВО! npm вимагає 2FA для публікації пакетів.

1. Зайдіть на npmjs.com і увійдіть в акаунт
2. Перейдіть в налаштування профілю: https://www.npmjs.com/settings/[ваш-username]/profile
3. Увімкніть Two-Factor Authentication (2FA)
4. Виберіть метод (автентифікатор або SMS)
5. Скануйте QR-код або введіть код з SMS в додаток-автентифікатор

3. Вхід в npm через CLI

npm login

Введіть ваші credentials (username, password, email). Якщо 2FA увімкнено, вам потрібно буде ввести код з автентифікатора.

4. Перевірка назви пакету

Переконайтеся, що назва пакету в package.json унікальна. Можна перевірити на npmjs.com чи вільна назва.

5. Публікація

Перейдіть в папку пакету:

cd test-cli-package

Опублікуйте пакет:

npm publish

Якщо хочете опублікувати як публічний пакет (за замовчуванням):

npm publish --access public

6. Оновлення версії

Після змін в коді, оновіть версію в package.json і знову опублікуйте:

npm version patch  # для патчів (1.0.0 -> 1.0.1)
npm version minor  # для мінорних оновлень (1.0.0 -> 1.1.0)
npm version major  # для мажорних оновлень (1.0.0 -> 2.0.0)
npm publish

Або вручну змініть версію в package.json і виконайте npm publish.

7. Тестування локально

Перед публікацією можна протестувати локально:

npm link

Це створить символічне посилання, і ви зможете використовувати команду test-cli глобально для тестування.

8. Встановлення іншими користувачами

Після публікації інші користувачі зможуть встановити пакет:

npm install -g test-cli-package

Структура пакету

test-cli-package/
├── bin/
│   └── cli.js          # CLI скрипт
├── index.js            # Основний модуль
├── package.json        # Конфігурація пакету
└── README.md           # Документація

Важливо

• Файл cli.js повинен починатися з #!/usr/bin/env node для коректної роботи
• Поле bin в package.json вказує на CLI команду
• Поле files в package.json визначає які файли будуть включені в пакет