Node.js Publish a Package

কীভাবে আপনার Node.js প্যাকেজটি npm রেজিস্ট্রিতে প্রকাশ করবেন তা জানুন

What Does it Mean to Publish a Package?

একটি প্যাকেজ প্রকাশ করার অর্থ হল আপনার Node.js মডিউল বা প্রকল্প অন্যদের জন্য একটি npm রেজিস্ট্রির মাধ্যমে ইনস্টল এবং ব্যবহার করার জন্য উপলব্ধ করা।

ওপেন সোর্স লাইব্রেরি এবং টুল এইভাবে Node.js সম্প্রদায়ের সাথে শেয়ার করা হয়।

আপনি যখন একটি সংগ্রহ প্রকাশ করেন, এটিnpm install your-package-nameএটি যে কেউ ব্যবহার করে ইনস্টলযোগ্য হয়ে ওঠে

⚠️দ্রষ্টব্য:

নিশ্চিত করুন যে আপনার প্যাকেজ মান প্রদান করে এবং NPM-এ বিদ্যমান প্যাকেজের সদৃশ নয়।

ব্যক্তিগত ব্যবহার

অভ্যন্তরীণ প্রকল্পের জন্য প্যাকেজ

পাবলিক রিলিজ

সার্বজনীন ব্যবহারের জন্য প্যাকেজ

সিস্টেম রিলিজ

সিস্টেমের ভিতরে ব্যবহারের জন্য প্যাকেজ

Preparing Your Package

1. প্যাকেজ শুরু করুন

একটি নতুন ডিরেক্টরি তৈরি করুন এবং আপনার সংগ্রহ শুরু করুন:

mkdir my-package
cd my-package
npm init -y

2. প্রয়োজনীয় ফাইল

একটি প্যাকেজে এই প্রধান ফাইলগুলি থাকা উচিত:

package.json

আপনার সংগ্রহ সম্পর্কে মেটাডেটা

README.md

নথি (মার্কডাউন সমর্থন করে)

index.js

প্রধান এন্ট্রি পয়েন্ট (বা package.json-এ উল্লেখ করুন)

LICENSE

ব্যবহারের শর্তাবলী (MIT, ISC, ইত্যাদি)

.gitignore

নোড_মডিউল, লগ, ইত্যাদি বাদ দিন

.npmignore

প্রকাশিত প্যাকেজ থেকে ফাইলগুলি বাদ দিন (ঐচ্ছিক)

3. Package.json Essentials

নিশ্চিত করুন যে আপনার package.json-এ এই ন্যূনতম ক্ষেত্রগুলি রয়েছে:

{
  "name": "your-package-name",
  "version": "1.0.0",
  "description": "A brief description of your package",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": ["keyword1", "keyword2"],
  "author": "Your Name ",
  "license": "MIT"
}

💡পরামর্শ:

আপনার প্যাকেজের নাম অনন্য এবং বর্ণনামূলক হওয়া উচিত। কীওয়ার্ড অন্যদের আপনার সংগ্রহ খুঁজে পেতে সাহায্য করে.

Creating an npm Account

1. নিবন্ধন করুন

আপনার যদি না থাকে তাহলে npmjs.com/signup-এ একটি অ্যাকাউন্ট তৈরি করুন৷

2. আপনার ইমেল চেক করুন

অনুগ্রহ করে আপনার ইমেল চেক করুন এবং প্রকাশ করার আগে আপনার অ্যাকাউন্ট যাচাই করুন৷

3. CLI এর মাধ্যমে লগইন করুন

আপনার টার্মিনাল খুলুন এবং চালান:

npm login

আপনাকে জিজ্ঞাসা করা হবে:

  • ব্যবহারকারীর নাম
  • পাসওয়ার্ড
  • ইমেল (আপনার npm অ্যাকাউন্টের সাথে অবশ্যই মিলবে)
  • এক-কালীন পাসওয়ার্ড (যদি 2FA সক্রিয় থাকে)

4. লগইন অবস্থা চেক করুন

npm whoami

Publishing Your Package

1. নাম উপলব্ধতা চেক করুন

npm view <package-name>

যদি সেই নামের একটি প্যাকেজ ইতিমধ্যেই বিদ্যমান না থাকে তবে আপনি সেই নামটি ব্যবহার করতে পারেন।

যদি তা হয়, তাহলে আপনার package.json-এ একটি ভিন্ন নাম বেছে নেওয়া উচিত।

2. স্থানীয়ভাবে প্যাকেজ পরীক্ষা করুন

প্রকাশ করার আগে, স্থানীয়ভাবে আপনার প্যাকেজ পরীক্ষা করুন:

# In your package directory
npm link

# In another project directory
npm link <package-name>

3. npm রেজিস্ট্রিতে প্রকাশ করুন

# First, make sure you're in the right directory
cd path/to/your/package

# Publish to the public npm registry
npm publish

4. নির্দিষ্ট ট্যাগ দিয়ে প্রকাশ করুন

npm publish --tag beta

5. পাবলিক প্যাকেজ প্রকাশ করুন

npm publish --access public

🚀একটি সফল লঞ্চের জন্য টিপস:

  • প্রকাশ করার আগে আপনার প্যাকেজটি পুঙ্খানুপুঙ্খভাবে পরীক্ষা করুন
  • একটি পরিষ্কার README.md ফাইল যোগ করুন
  • নিশ্চিত করুন যে আপনার প্যাকেজের নাম অনন্য
  • নিশ্চিত করুন যে আপনি আপনার npm অ্যাকাউন্টে লগ ইন করেছেন

Updating Your Package

1. সংস্করণ নম্বর আপডেট করুন

আপনার প্যাকেজ সংস্করণ আপডেট করতে শব্দার্থিক সংস্করণ ব্যবস্থাপনা (SemVer) ব্যবহার করুন:

প্যাচ রিলিজের জন্য (বাগ সংশোধন)

npm version patch

ছোট রিলিজের জন্য (পিছন দিকে সামঞ্জস্যপূর্ণ বৈশিষ্ট্য)

npm version minor

প্রধান প্রকাশের জন্য (ব্রেকিং পরিবর্তন)

npm version major

2. পরিবর্তন লগ আপডেট করুন

এই সংস্করণে পরিবর্তনগুলি নথিভুক্ত করতে দয়া করে আপনার CHANGELOG.md আপডেট করুন৷

3. আপডেট প্রকাশ করুন

npm publish

4. আউটপুট চিহ্নিত করুন (ঐচ্ছিক)

আপনি যদি গিট ব্যবহার করেন তবে রিলিজের জন্য একটি ট্যাগ তৈরি করুন:

git tag -a v1.0.0 -m "Initial release"
git push origin v1.0.0

Managing Published Packages

একটি প্যাকেজ প্রকাশ না করা হচ্ছে

npm রেজিস্ট্রি থেকে একটি প্যাকেজ সরাতে:

# Unpublish a specific version
npm unpublish <package-name>@<version>

# Unpublish the entire package (only works within 72 hours of publishing)
npm unpublish <package-name> --force

দ্রষ্টব্য:

রিলিজ না করা দৃঢ়ভাবে নিরুৎসাহিত করা হয় কারণ এটি আপনার প্যাকেজের উপর নির্ভর করে এমন অন্যান্য প্রোগ্রামগুলিকে ভেঙে দেবে। তার বদলেnpm deprecateব্যবহার বিবেচনা করুন

প্যাকেজ পরিত্যাগ

আপনি যদি ব্যবহারকারীদের একটি সংস্করণ ইনস্টল করা থেকে আটকাতে চান তবে এটি বিদ্যমান ব্যবহারকারীদের জন্য উপলব্ধ করতে চান:

# Deprecate a specific version
npm deprecate <package-name>@<version> "message"

# Example
npx deprecate my-package@1.0.0 "This version is no longer maintained. Please upgrade to v2.0.0"

মালিকানা হস্তান্তর

অন্য ব্যবহারকারী বা সিস্টেমে একটি প্যাকেজ স্থানান্তর করতে:

npm owner add <username> <package-name>

🚫গুরুত্বপূর্ণ:

প্যাকেজ প্রকাশ না করা এনপিএম সম্প্রদায়ে খারাপ অভ্যাস হিসাবে বিবেচিত হয়। আপনি যদি আপনার সংগ্রহ বজায় রাখতে না পারেন তবে এটি পরিত্যাগ করাই ভাল।

Best Practices

শব্দার্থিক সংস্করণ ব্যবস্থাপনা অনুসরণ করুন - উপযুক্ত হিসাবে MAJOR.MINOR.PATCH সংস্করণ নম্বর ব্যবহার করুন
ভাল ডকুমেন্টেশন লিখুন - আপনার README-এ স্পষ্ট ব্যবহারের উদাহরণগুলি অন্তর্ভুক্ত করুন
পরীক্ষা যোগ করুন - ইউনিট পরীক্ষা যোগ করুন এবং কীভাবে সেগুলি চালাতে হয় তা নথিভুক্ত করুন
.npmignore ব্যবহার করুন - শুধুমাত্র প্রয়োজনীয় ফাইল প্রকাশ করুন
কীওয়ার্ড যোগ করুন - অন্যদের আপনার সংগ্রহ খুঁজে পেতে সাহায্য করুন
সঠিক লাইসেন্স চয়ন করুন - ব্যবহারকারীদের কাছে আপনার শর্তাবলী পরিষ্কার করুন
পরিবর্তন লগ বজায় রাখুন - সংস্করণগুলির মধ্যে নথির পরিবর্তন
ক্রমাগত ইন্টিগ্রেশন ব্যবহার করুন - স্বয়ংক্রিয় পরীক্ষা এবং প্রকাশ

Summary

npm-এ প্যাকেজ প্রকাশ করা Node.js সম্প্রদায়ের সাথে আপনার কোড শেয়ার করার একটি দুর্দান্ত উপায়।

আপনি যদি সর্বোত্তম অনুশীলনগুলি অনুসরণ করেন এবং আপনার প্যাকেজগুলি ভালভাবে বজায় রাখেন, আপনি মূল্যবান সরঞ্জামগুলিতে অবদান রাখতে পারেন যা অন্যরা তৈরি করতে পারে।

শেয়ারিং

বিশ্বের সাথে আপনার সমাধান শেয়ার করুন

সমাজ

Node.js

টুলস

অন্যরা ব্যবহার করতে পারে এমন সরঞ্জাম তৈরি করুন

শেখা

অন্য লোকেদের কোড থেকে শিখুন

💎মনে রাখবেন:

মহান ক্ষমতা মহান দায়িত্ব আসে. আপনি যখন একটি প্যাকেজ রিলিজ করেন, আপনি এটি বজায় রাখার বা ব্যবহারকারীদের কাছে স্পষ্টভাবে এর স্থিতি জানাতে একটি প্রতিশ্রুতি দেন।

Exercise

প্যাকেজটি npm-এ প্রকাশ করতে সঠিক কমান্ডটি নির্বাচন করুন।

npm deploy
✗ ভুল! "npm deploy" npm-এ একটি বৈধ কমান্ড নয়
npm release
✗ ভুল! "npm প্রকাশ" npm-এ একটি বৈধ কমান্ড নয়
npm publish
✓ ঠিক আছে! "npm publish" হল সঠিক কমান্ড যা npm রেজিস্ট্রিতে একটি প্যাকেজ প্রকাশ করতে ব্যবহৃত হয়
npm push
✗ ভুল! "npm push" npm-এ একটি বৈধ কমান্ড নয়

নিচের কোন কমান্ড প্যাকেজের প্যাচ সংস্করণ আপডেট করবে?

npm update patch
✗ ভুল! "npm আপডেট প্যাচ" একটি বৈধ কমান্ড নয়
npm version patch
✓ ঠিক আছে! "npm সংস্করণ প্যাচ" একটি প্যাকেজের প্যাচ সংস্করণ আপডেট করার জন্য সঠিক কমান্ড
npm patch
✗ ভুল! "npm প্যাচ" npm-এ একটি বৈধ কমান্ড নয়
npm bump patch
✗ ভুল! "npm বাম্প প্যাচ" npm-এ একটি বৈধ কমান্ড নয়