package semver import ( "fmt" "strings" "unicode" ) type comparator func(Version, Version) bool var ( compEQ comparator = func(v1 Version, v2 Version) bool { return v1.Compare(v2) == 0 } compNE = func(v1 Version, v2 Version) bool { return v1.Compare(v2) != 0 } compGT = func(v1 Version, v2 Version) bool { return v1.Compare(v2) == 1 } compGE = func(v1 Version, v2 Version) bool { return v1.Compare(v2) >= 0 } compLT = func(v1 Version, v2 Version) bool { return v1.Compare(v2) == -1 } compLE = func(v1 Version, v2 Version) bool { return v1.Compare(v2) <= 0 } ) type versionRange struct { v Version c comparator } // rangeFunc creates a Range from the given versionRange. func (vr *versionRange) rangeFunc() Range { return Range(func(v Version) bool { return vr.c(v, vr.v) }) } // Range represents a range of versions. // A Range can be used to check if a Version satisfies it: // // range, err := semver.ParseRange(">1.0.0 <2.0.0") // range(semver.MustParse("1.1.1") // returns true type Range func(Version) bool // OR combines the existing Range with another Range using logical OR. func (rf Range) OR(f Range) Range { return Range(func(v Version) bool { return rf(v) || f(v) }) } // AND combines the existing Range with another Range using logical AND. func (rf Range) AND(f Range) Range { return Range(func(v Version) bool { return rf(v) && f(v) }) } // ParseRange parses a range and returns a Range. // If the range could not be parsed an error is returned. // // Valid ranges are: // - "<1.0.0" // - "<=1.0.0" // - ">1.0.0" // - ">=1.0.0" // - "1.0.0", "=1.0.0", "==1.0.0" // - "!1.0.0", "!=1.0.0" // // A Range can consist of multiple ranges separated by space: // Ranges can be linked by logical AND: // - ">1.0.0 <2.0.0" would match between both ranges, so "1.1.1" and "1.8.7" but not "1.0.0" or "2.0.0" // - ">1.0.0 <3.0.0 !2.0.3-beta.2" would match every version between 1.0.0 and 3.0.0 except 2.0.3-beta.2 // // Ranges can also be linked by logical OR: // - "<2.0.0 || >=3.0.0" would match "1.x.x" and "3.x.x" but not "2.x.x" // // AND has a higher precedence than OR. It's not possible to use brackets. // // Ranges can be combined by both AND and OR // // - `>1.0.0 <2.0.0 || >3.0.0 !4.2.1` would match `1.2.3`, `1.9.9`, `3.1.1`, but not `4.2.1`, `2.1.1` func ParseRange(s string) (Range, error) { parts := splitAndTrim(s) orParts, err := splitORParts(parts) if err != nil { return nil, err } var orFn Range for _, p := range orParts { var andFn Range for _, ap := range p { opStr, vStr, err := splitComparatorVersion(ap) if err != nil { return nil, err } vr, err := buildVersionRange(opStr, vStr) if err != nil { return nil, fmt.Errorf("Could not parse Range %q: %s", ap, err) } rf := vr.rangeFunc() // Set function if andFn == nil { andFn = rf } else { // Combine with existing function andFn = andFn.AND(rf) } } if orFn == nil { orFn = andFn } else { orFn = orFn.OR(andFn) } } return orFn, nil } // splitORParts splits the already cleaned parts by '||'. // Checks for invalid positions of the operator and returns an // error if found. func splitORParts(parts []string) ([][]string, error) { var ORparts [][]string last := 0 for i, p := range parts { if p == "||" { if i == 0 { return nil, fmt.Errorf("First element in range is '||'") } ORparts = append(ORparts, parts[last:i]) last = i + 1 } } if last == len(parts) { return nil, fmt.Errorf("Last element in range is '||'") } ORparts = append(ORparts, parts[last:]) return ORparts, nil } // buildVersionRange takes a slice of 2: operator and version // and builds a versionRange, otherwise an error. func buildVersionRange(opStr, vStr string) (*versionRange, error) { c := parseComparator(opStr) if c == nil { return nil, fmt.Errorf("Could not parse comparator %q in %q", opStr, strings.Join([]string{opStr, vStr}, "")) } v, err := Parse(vStr) if err != nil { return nil, fmt.Errorf("Could not parse version %q in %q: %s", vStr, strings.Join([]string{opStr, vStr}, ""), err) } return &versionRange{ v: v, c: c, }, nil } // splitAndTrim splits a range string by spaces and cleans leading and trailing spaces func splitAndTrim(s string) (result []string) { last := 0 for i := 0; i < len(s); i++ { if s[i] == ' ' { if last < i-1 { result = append(result, s[last:i]) } last = i + 1 } } if last < len(s)-1 { result = append(result, s[last:]) } // parts := strings.Split(s, " ") // for _, x := range parts { // if s := strings.TrimSpace(x); len(s) != 0 { // result = append(result, s) // } // } return } // splitComparatorVersion splits the comparator from the version. // Spaces between the comparator and the version are not allowed. // Input must be free of leading or trailing spaces. func splitComparatorVersion(s string) (string, string, error) { i := strings.IndexFunc(s, unicode.IsDigit) if i == -1 { return "", "", fmt.Errorf("Could not get version from string: %q", s) } return strings.TrimSpace(s[0:i]), s[i:], nil } func parseComparator(s string) comparator { switch s { case "==": fallthrough case "": fallthrough case "=": return compEQ case ">": return compGT case ">=": return compGE case "<": return compLT case "<=": return compLE case "!": fallthrough case "!=": return compNE } return nil }