حاسبة الإصدارات (SemVer)

طريقة الاستخدام

1. اكتب الإصدار، مثل 1.4.0، واختيارياً إصداراً في المقارنة مع لترتيبه مقابله.
2. اختر الرفع لترى الإصدار التالي. ولرفع ما قبل الإصدار سمِّ الإصدار التجريبي في اسم ما قبل الإصدار.
3. اكتب النطاق لتفحص هل يطابقه الإصدار، واقرأ كيف يُقرأ النطاق لترى معنى كل جزء منه.
4. اقرأ الإصدار بعد الرفع والترتيب وفحص النطاق للإجابة التي تحتاجها.

كيف تُرتَّب الإصدارات

يقارن SemVer 2.0.0 أرقام الرئيسي والثانوي والتصحيحي كأرقام. ويأتي الإصدار الذي له وسم ما قبل الإصدار قبل الإصدار نفسه دون وسم. وتُقارن معرّفات ما قبل الإصدار واحداً واحداً: الأرقام كأرقام، والنص بترتيب ASCII، والرقم قبل النص. ولا تُحسب بيانات البناء، وهي الجزء الذي يأتي بعد +.

• ترتيب أمثلة المواصفة: 1.0.0-alpha، و1.0.0-alpha.1، و1.0.0-alpha.beta، و1.0.0-beta، و1.0.0-beta.2، و1.0.0-beta.11، و1.0.0-rc.1، ثم 1.0.0.
• يُقبل الحرف v في البداية، كما في v1.4.0، ولا يُعد جزءاً من الإصدار.

كيف يعمل الرفع

يرفع الرفع الرئيسي الرقم الأول ويجعل الرقمين الآخرين 0. ويفعل الرفع الثانوي والتصحيحي الشيء نفسه لجزئهما. والإصدار الذي ما زال ما قبل إصدار يفقد وسمه حين يكون الرفع سيرفعه على أي حال: فـ1.0.0-alpha يصبح 1.0.0 بالرفع الرئيسي، كما يفعل node-semver. أما رفع ما قبل الإصدار فيبدأ التصحيح التالي بالاسم الذي تعطيه، مثل 1.4.1-beta.0، أو يرفع الرقم الأخير لما قبل إصدار موجود، مثل beta.1 إلى beta.2.

كيف تُقرأ النطاقات

تتبع صيغة النطاقات node-semver، وهي الحزمة التي يستخدمها npm، وفق قواعد README (باللغة الإنجليزية). فـ^1.3.0 تعني >=1.3.0 <2.0.0-0، و~1.2.3 تعني >=1.2.3 <1.3.0-0، و1.2.x تعني >=1.2.0 <1.3.0-0. ويجب أن تتحقق كل المقارنات داخل المجموعة الواحدة معاً. والمجموعات المفصولة بـ || بدائل، والمجموعة الفارغة تقبل أي إصدار، كما يفعل *.

ما قبل الإصدارات والنطاقات

لا يطابق إصدار ما قبل الإصدار، مثل 1.5.0-beta.1، نطاقاً إلا إذا كانت إحدى المقارنات في مجموعته تحمل الإصدار 1.5.0 نفسه مع وسم ما قبل الإصدار. لذلك تبقى الإصدارات غير المكتملة خارج النطاقات افتراضياً، كما يشرح README الخاص بـ node-semver (باللغة الإنجليزية). والفحص في هذه الصفحة يتبع هذه القاعدة.

الأسئلة الشائعة