verl
SemVer 2.0 version and requirements parsing, matching, and comparisons.
All parsing of versions and requirements adhere to the SemVer 2.0 schema
Build
$ rebar3 compileTest
$ rebar3 testUsage
Add to you deps configuration in rebar.config for your project :
{deps, [{verl, "1.1.0"}]}.Comparisons
1> verl:compare(<<"1.0.0">>, <<"1.0.1">>).
lt
2> verl:compare(<<"1.0.0">>, <<"1.0.0">>).
eq
3> verl:compare(<<"2.0.0">>, <<"1.0.0">>).
gt
4> verl:compare(<<"1.0.0-pre">>, <<"1.0.0">>).
lt
5> verl:compare(<<"1.0.0">>, <<"1.0.0-pre">>).
gtVersion, Requirements, and Matching
Matching
1> verl:is_match(<<"1.0.0">>, <<"~> 1.0.0">>).
true
2> verl:is_match(<<"1.0.0">>, <<"~> 2.0.0">>).
false
3> verl:is_match(<<"3.2.0">>, <<"~> 3.0.0">>).
false
4> verl:is_match(<<"3.2.0">>, <<"~> 3.0">>).
trueCompiled requirements for ludicious speed matching
1> {ok, Req} = verl:parse_requirement(<<"~> 3.0">>).
{ok,#{compiled => false,
string => <<"~> 3.0">>,
matchspec => [{{'$1','$2','$3','$4','$5'}...}],
string => <<"~> 3.0">>}}
2> verl:is_match(<<"3.0.0-dev">>, Req).
false
3> verl:is_match(<<"1.2.3">>, Req).
false
4> verl:is_match(<<"3.1.0">>, Req).
trueVersion parsing
1> verl:parse(<<"1.2.3">>).
#{build => undefined,major => 1,minor => 2,patch => 3,
pre => []}
2> verl:parse(<<"1.2.3+build">>).
#{build => <<"build">>,major => 1,minor => 2,patch => 3,
pre => []}
3> verl:parse(<<"1.2.3-pre+build">>).
#{build => <<"build">>,major => 1,minor => 2,patch => 3,
pre => [<<"pre">>]}
4> verl:parse(<<"1">>).
{error, invalid_version}
5> verl:parse(<<"2">>).
{error, invalid_version}Don't want a map? Use the verl_parser module...
1> verl_parser:parse_version(<<"1.2.3">>).
{ok,{1,2,3,[],[]}}
2> verl_parser:parse_version(<<"1.2.3+build">>).
{ok,{1,2,3,[],[<<"build">>]}}
3> verl_parser:parse_version(<<"1.2.3-pre+build">>).
{ok,{1,2,3,[<<"pre">>],[<<"build">>]}}
4> verl_parser:parse_version(<<"1">>).
{error, invalid_version}Requirements parsing
1> verl:parse_requirement(<<"~> 2.1.0-dev">>).
{ok,#{compiled => false,
string => <<"~> 2.1.0-dev">>,
matchspec =>
[{{'$1','$2','$3','$4','$5'}...] }}
2> verl:parse_requirement(<<"~> 2.1.0-">>).
{error,invalid_requirement}Don't want a map? User the verl_parser module...
1> verl_parser:parse_requirement(<<"~> 2.1.0-dev">>).
{ok, [{{'$1','$2','$3','$4','$5'}...]}
2> verl:parse_requirement(<<"~> 2.1.0-">>).
{error,invalid_requirement}Credits
- All credit goes to the Elixir team and contributors to Version and Version.Parser in the Elixir standard lib for the algorithm and original implementation.