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
Summary
npm-এ প্যাকেজ প্রকাশ করা Node.js সম্প্রদায়ের সাথে আপনার কোড শেয়ার করার একটি দুর্দান্ত উপায়।
আপনি যদি সর্বোত্তম অনুশীলনগুলি অনুসরণ করেন এবং আপনার প্যাকেজগুলি ভালভাবে বজায় রাখেন, আপনি মূল্যবান সরঞ্জামগুলিতে অবদান রাখতে পারেন যা অন্যরা তৈরি করতে পারে।
শেয়ারিং
বিশ্বের সাথে আপনার সমাধান শেয়ার করুন
সমাজ
Node.js
টুলস
অন্যরা ব্যবহার করতে পারে এমন সরঞ্জাম তৈরি করুন
শেখা
অন্য লোকেদের কোড থেকে শিখুন
মনে রাখবেন:
মহান ক্ষমতা মহান দায়িত্ব আসে. আপনি যখন একটি প্যাকেজ রিলিজ করেন, আপনি এটি বজায় রাখার বা ব্যবহারকারীদের কাছে স্পষ্টভাবে এর স্থিতি জানাতে একটি প্রতিশ্রুতি দেন।