SemVer کیلکولیٹر اور رینج چیکر کے بارے میں — تفصیلی رہنما
SemVer Calculator سیمنٹک ورژننگ (SemVer 2.0.0) کی سٹرنگز اور منحصر رینج کی حدود (dependency range constraints) کو پارس اور جانچتا ہے۔ یہ Major، Minor، Patch، Prerelease ٹیگز اور Build میٹا ڈیٹا کو منظم اجزاء میں تقسیم کرتا ہے۔
مطابقت کی جانچ کرنے، ورژن ایریز کو ترتیب دینے، اور اگلے مجوزہ ورژن بَمپس کا جائزہ لینے کے لیے npm package.json کی semver حدود (بشمول `^1.2.3`، `~1.2.3`، `>=1.0.0 <2.0.0`، `1.x`، وائلڈ کارڈ `*`، اور یونین `||` کے تاثرات) کو ٹیسٹ کریں۔
اہم خصوصیات اور صلاحیتیں
- SemVer 2.0.0 تصریحات کی مکمل پارسنگ (Major.Minor.Patch-prerelease+build)
- npm رینج ایکسپریشنز کی جانچ کرتا ہے: کیرٹ (^)، ٹلڈا (~)، تقابلی موازنہ اور یونین لاجک
- سخت ورژن موازنہ اور چھانٹی کی تشخیص (gt، lt، eq، satisfies)
- Major، Minor اور Patch ریلیز بَمپس کی پیش گوئی کے ساتھ اگلا ورژن خودکار حساب
استعمال کرنے کا طریقہ
- 1
بیس ورژن (مثلاً `2.4.1`) یا کوئی رینج ایکسپریشن (مثلاً `^2.3.0`) درج کریں۔
- 2
یہ جانچنے کے لیے مجوزہ ریلیز ورژن ٹائپ کریں کہ آیا یہ بتائی گئی رینج پر پورا اترتا ہے یا نہیں۔
- 3
شمولیت کے نتیجے، پارس شدہ ٹوکنز اور اگلے ورژن کے اضافے کی تجاویز کا جائزہ لیں۔
عام استعمال کی صورتیں
- ← package.json میں کیرٹ (`^`) رینجز کی وجہ سے پیدا ہونے والے غیر متوقع ڈیپینڈنسی ڈرفٹ کو ڈیبگ کرنا
- ← npm publish یا git tag چلانے سے پہلے اگلے درست ریلیز ورژن کا تعین کرنا
- ← مونو ریپو ورک اسپیسز اور مشترکہ CI/CD بلڈ اسکرپٹس میں رینج کی پابندیوں کی توثیق کرنا
متعلقہ ٹولز
HTML میٹا ٹیگز جنریٹر
SEO، Open Graph اور Twitter Cards کے لیے مکمل اور درست HTML میٹا ٹیگز تیار کریں۔
.gitignore فائل جنریٹر
Node.js, Python, Java, Go اور سینکڑوں فریم ورکس کے لیے حسب ضرورت .gitignore تیار کریں۔
اوپن سورس لائسنس جنریٹر
MIT, Apache 2.0, GPL اور BSD سمیت دیگر اوپن سورس لائسنسز کے متن کو حسب ضرورت بنائیں۔
README.md جنریٹر
اپنے اوپن سورس پروجیکٹس کے لیے بیجز اور سیکشنز کے ساتھ بہترین README بنائیں۔
Conventional Commits معاون
معیاری اصولوں کے مطابق پیشہ ورانہ اور منظم Git کمٹ پیغامات تیار کریں۔
OpenAPI / Swagger دستاویزات ویور
OpenAPI 3.0 اور Swagger 2.0 تفصیلات کو انٹرایکٹو API دستاویزات کے طور پر دیکھیں۔
اکثر پوچھے گئے سوالات اور رازداری
`^` (کیرٹ) اور `~` (ٹلڈا) کے درمیان بنیادی فرق کیا ہے؟
`~1.2.3` صرف PATCH ریلیزز کی اجازت دیتا ہے (`>=1.2.3 <1.3.0` سے مماثل)، جبکہ `^1.2.3` MINOR اور PATCH دونوں ریلیزز کی اجازت دیتا ہے (`>=1.2.3 <2.0.0` سے مماثل)۔
کیا بلڈ میٹا ڈیٹا (مثلاً `+build123`) ورژن کی ترجیح (precedence) کو متاثر کرتا ہے؟
نہیں، SemVer تصریح کے سیکشن 10 کے مطابق، بلڈ میٹا ڈیٹا خالصتاً معلوماتی ہے اور ورژن کی ترجیح کا تعین کرتے وقت اسے نظر انداز کیا جانا چاہیے۔