Kontrola Semver
Kontrolujte, porovnávejte a řaďte sémantické verze a ověřujte je vůči rozsahům ve stylu npm, například ^1.2.0, ~2.4, >=1.0.0 <2.0.0, 1.x nebo 1.2.3 - 2.3.4. Kontrola dodržuje pravidla Semantic Versioning 2.0.0 pro předběžná vydání a metadata sestavení a stejná pravidla rozsahů jako balíček semver od npm, ukazuje rozvinutí rozsahu a hledá nejvyšší verzi, která mu vyhovuje.
Často kladené otázky
Co kontrola dělá?
Analyzuje každou zadanou verzi, uvádí, zda jde o platnou sémantickou verzi, seřadí platné verze, určí nejvyšší a při zadání rozsahu sdělí, které verze mu vyhovují a která z nich je nejvyšší. Pokud zadáte přesně dvě verze, také uvede, která je vyšší.
Co znamená ^1.2.3?
Znak caret povoluje změny, které nemění nejlevější nenulové číslo. ^1.2.3 znamená >=1.2.3 <2.0.0, ^0.2.3 znamená >=0.2.3 <0.3.0 a ^0.0.3 znamená pouze 0.0.3. Je to výchozí nastavení balíčku npm při jeho instalaci.
Co znamená ~1.2.3?
Znak tilde povoluje aktualizace oprav: ~1.2.3 znamená >=1.2.3 <1.3.0. Pouze s hlavní verzí znamená ~1 >=1.0.0 <2.0.0. Použijte ho, když chcete opravy chyb, ale žádné nové funkce v dílčích verzích.
Které syntaxe rozsahů jsou podporovány?
Porovnávací operátory (<, <=, >, >=, =), rozsahy caret a tilde, rozsahy X, například 1.x, 1.2.* a *, neúplné verze, například 1.2, rozsahy s pomlčkou, například 1.2.3 - 2.3.4, několik porovnávacích operátorů oddělených mezerami, které musí všechny platit, a alternativy oddělené pomocí ||.
Jak se porovnávají předběžné verze?
Předběžná verze, například 1.0.0-beta.2, je nižší než vydání 1.0.0. Identifikátory předběžné verze se porovnávají postupně: čísla číselně, text abecedně a číslo je vždy nižší než text, takže 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.
Proč 2.0.0-beta nevyhovuje ^1.2.0?
Podle npm předběžná verze vyhovuje rozsahu pouze tehdy, když některý z jeho porovnávacích operátorů uvádí předběžnou verzi se stejnou hlavní, dílčí a opravnou verzí. Rozsahy tak omylem nezahrnou nestabilní verze. Zapnutím možnosti Zahrnout předběžná vydání jim umožníte vyhovět jako běžným verzím; stejně jako v npm pak dolní meze neúplných rozsahů a rozsahů s pomlčkou zahrnují i předběžná vydání.
Co je rozvinutí rozsahu?
Kontrola zobrazuje rozsah jako jednotlivé porovnávací operátory, které zastupuje, například ^1.2.3 = >=1.2.3 <2.0.0-0. Přípona -0 znamená, že mez vylučuje také předběžná vydání verze 2.0.0, přesně jak ji zapisuje balíček semver od npm.
Porovnávají se metadata sestavení?
Ne. Semantic Versioning při porovnávání ignoruje metadata sestavení, tedy část za znaménkem plus, takže 1.0.0+build.1 a 1.0.0+build.2 jsou stejné. Kontrola metadata zobrazuje, ale při řazení ani vyhodnocování rozsahů je nepoužívá.
Přijímají se verze s počátečním v?
Ano. Počáteční v se ignoruje, takže v1.2.3 se čte jako 1.2.3, stejně jako v npm. Verze s méně než třemi čísly, například 1.2, nejsou platné verze, ale fungují v rozsazích, kde 1.2 znamená libovolnou verzi 1.2.x.
Kolik verzí mohu zkontrolovat?
Až 200 verzí na požadavek, jedna na řádek, a rozsah dlouhý až 1,000 znaků.