مدقق إصدارات Semver
تحقق من الإصدارات الدلالية وقارنها ورتبها، واختبرها باستخدام نطاقات بنمط npm مثل ^1.2.0 و~2.4 و>=1.0.0 <2.0.0 و1.x أو 1.2.3 - 2.3.4. يتبع المدقق قواعد Semantic Versioning 2.0.0 للإصدارات التجريبية وبيانات البناء، وقواعد النطاقات نفسها التي تستخدمها حزمة semver لدى npm، كما يوضح الإصدارات التي يشملها النطاق ويجد أعلى إصدار يطابقه.
الأسئلة الشائعة
ما وظيفة المدقق؟
يحلل كل إصدار تدخله، ويبين ما إذا كان إصدارًا دلاليًا صالحًا، ويرتب الإصدارات الصالحة، ويحدد أعلاها. وعند إدخال نطاق، يخبرك بالإصدارات التي تطابقه وبأعلى إصدار منها. وإذا أدخلت إصدارين بالضبط، يوضح أيضًا أيهما أعلى.
ما معنى ^1.2.3؟
يسمح رمز caret بالتغييرات التي لا تعدّل الرقم غير الصفري الواقع في أقصى اليسار. يعني ^1.2.3 >=1.2.3 <2.0.0، ويعني ^0.2.3 >=0.2.3 <0.3.0، أما ^0.0.3 فيعني 0.0.3 فقط. وهذا هو الإعداد الافتراضي لدى npm عند تثبيت حزمة.
ما معنى ~1.2.3؟
يسمح رمز tilde بتحديثات التصحيح: يعني ~1.2.3 >=1.2.3 <1.3.0. وعند إدخال الإصدار الرئيسي وحده، يعني ~1 >=1.0.0 <2.0.0. استخدمه عندما تريد إصلاحات للأخطاء دون ميزات فرعية جديدة.
ما صيغ النطاقات المدعومة؟
عوامل المقارنة (<, <=, >, >=, =)، ونطاقات caret وtilde، ونطاقات X مثل 1.x، و1.2.* و*، والإصدارات الجزئية مثل 1.2، ونطاقات الواصلة مثل 1.2.3 - 2.3.4، وعدة عوامل مقارنة مفصولة بمسافات يجب أن تنطبق جميعها، والبدائل المفصولة بـ ||.
كيف تُقارن الإصدارات التجريبية؟
الإصدار التجريبي مثل 1.0.0-beta.2 أقل من الإصدار النهائي 1.0.0. تُقارن معرّفات الإصدار التجريبي واحدًا تلو الآخر: الأرقام عدديًا، والنصوص أبجديًا، ويكون الرقم دائمًا أقل من النص؛ لذا 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.
لماذا لا يطابق 2.0.0-beta النطاق ^1.2.0؟
وفقًا لـ npm، لا يطابق الإصدار التجريبي نطاقًا إلا إذا سمّى أحد عوامل المقارنة في النطاق إصدارًا تجريبيًا له الإصدار الرئيسي والفرعي وإصدار التصحيح نفسها، حتى لا تشمل النطاقات إصدارات غير مستقرة عن غير قصد. فعّل خيار تضمين الإصدارات التجريبية للسماح لها بالمطابقة كالإصدارات العادية؛ وكما في npm، ستشمل الحدود الدنيا للنطاقات الجزئية ونطاقات الواصلة الإصدارات التجريبية أيضًا.
ما المقصود بتوسيع النطاق؟
يعرض المدقق النطاق على هيئة عوامل المقارنة المباشرة التي يمثّلها؛ فمثلًا ^1.2.3 = >=1.2.3 <2.0.0-0. تعني اللاحقة -0 أن الحد يستبعد أيضًا الإصدارات التجريبية من 2.0.0، تمامًا كما تكتبها حزمة semver لدى npm.
هل تُقارن بيانات البناء؟
لا. تتجاهل Semantic Versioning بيانات البناء، وهي الجزء الذي يأتي بعد علامة الجمع، عند المقارنة؛ لذا فإن 1.0.0+build.1 و1.0.0+build.2 متساويان. يعرض المدقق بيانات البناء، لكنه لا يستخدمها في الترتيب أو النطاقات.
هل تُقبل الإصدارات التي تبدأ بحرف v؟
نعم. يُتجاهل حرف v في البداية، لذا يُقرأ v1.2.3 على أنه 1.2.3، كما يفعل npm. الإصدارات التي تحتوي على أقل من ثلاثة أرقام، مثل 1.2، ليست إصدارات صالحة، لكنها تعمل داخل النطاقات، حيث يعني 1.2 أي إصدار 1.2.x.
كم عدد الإصدارات التي يمكنني التحقق منها؟
حتى 200 إصدارًا في كل طلب، بواقع إصدار واحد في كل سطر، ونطاقًا يصل إلى 1,000 حرفًا.