wip

Author: tangrufus

and.go

@@ -8,6 +8,9 @@ const (
 	ErrImpossibleInterval stringError = "impossible interval"
 )
 
+// And returns a [CeilingFloorConstrainter] instance representing the logical AND of
+// the given [Endless] instances; or return an error if the given [Endless] instances could never be
+// satisfied.
 func And(es ...Endless) (CeilingFloorConstrainter, error) {
 	if len(es) == 0 {
 		var c CeilingFloorConstrainter
@@ -60,8 +63,18 @@ func And(es ...Endless) (CeilingFloorConstrainter, error) {
 		return NewExactConstraint(*floor.Floor().version), nil
 	}
 
-	return Interval{
+	return interval{
 		ceiling: ceiling,
 		floor:   floor,
 	}, nil
 }
+
+// MustAnd is like [And] but panics if an error occurs.
+func MustAnd(es ...Endless) CeilingFloorConstrainter {
+	c, err := And(es...)
+	if err != nil {
+		panic(err)
+	}
+
+	return c
+}

and_test.go

@@ -282,7 +282,7 @@ func TestAnd(t *testing.T) {
 				NewLessThan(MustParse("4")),
 				NewGreaterThan(MustParse("1")),
 			},
-			want: Interval{
+			want: interval{
 				ceiling: NewLessThan(MustParse("4")),
 				floor:   NewGreaterThan(MustParse("1")),
 			},
@@ -297,7 +297,7 @@ func TestAnd(t *testing.T) {
 				NewLessThan(MustParse("3")),
 				NewGreaterThan(MustParse("1")),
 			},
-			want: Interval{
+			want: interval{
 				ceiling: NewLessThan(MustParse("3")),
 				floor:   NewGreaterThan(MustParse("1")),
 			},
@@ -311,7 +311,7 @@ func TestAnd(t *testing.T) {
 				NewLessThanOrEqualTo(MustParse("3")),
 				NewGreaterThan(MustParse("1")),
 			},
-			want: Interval{
+			want: interval{
 				ceiling: NewLessThanOrEqualTo(MustParse("3")),
 				floor:   NewGreaterThan(MustParse("1")),
 			},
@@ -326,7 +326,7 @@ func TestAnd(t *testing.T) {
 				NewGreaterThan(MustParse("1")),
 				NewGreaterThanOrEqualTo(MustParse("1")),
 			},
-			want: Interval{
+			want: interval{
 				ceiling: NewLessThan(MustParse("4")),
 				floor:   NewGreaterThan(MustParse("2")),
 			},
@@ -340,7 +340,7 @@ func TestAnd(t *testing.T) {
 				NewGreaterThan(MustParse("1")),
 				NewGreaterThanOrEqualTo(MustParse("1")),
 			},
-			want: Interval{
+			want: interval{
 				ceiling: NewLessThan(MustParse("4")),
 				floor:   NewGreaterThanOrEqualTo(MustParse("2")),
 			},
@@ -358,7 +358,7 @@ func TestAnd(t *testing.T) {
 				NewGreaterThan(MustParse("1")),
 				NewGreaterThanOrEqualTo(MustParse("1")),
 			},
-			want: Interval{
+			want: interval{
 				ceiling: NewLessThan(MustParse("3")),
 				floor:   NewGreaterThan(MustParse("2")),
 			},
@@ -377,7 +377,7 @@ func TestAnd(t *testing.T) {
 				NewGreaterThanOrEqualTo(MustParse("1")),
 				NewWildcard(),
 			},
-			want: Interval{
+			want: interval{
 				ceiling: NewLessThan(MustParse("3")),
 				floor:   NewGreaterThan(MustParse("2")),
 			},

interval.go

@@ -1,26 +1,26 @@
 package comver
 
-// Interval represents a constraint that is both floor bounded and ceiling bounded.
+// interval represents a constraint that is both floor bounded and ceiling bounded.
 // It must be initialized via [And].
-type Interval struct {
+type interval struct {
 	ceiling Endless
 	floor   Endless
 }
 
 // Check reports whether a [Version] satisfies the constraint.
-func (i Interval) Check(v Version) bool {
+func (i interval) Check(v Version) bool {
 	return i.ceiling.Check(v) && i.floor.Check(v)
 }
 
-func (i Interval) Ceiling() Endless {
+func (i interval) Ceiling() Endless {
 	return i.ceiling
 }
 
-func (i Interval) Floor() Endless {
+func (i interval) Floor() Endless {
 	return i.floor
 }
 
-func (i Interval) String() string {
+func (i interval) String() string {
 	if i.ceiling.wildcard() {
 		return i.floor.String()
 	}

or.go

@@ -40,7 +40,7 @@ func (o Or) Check(v Version) bool {
 //		cs = append(cs, tail)
 //	}
 //
-//	// TODO: Check whether Interval{head, tail} are wildcard.
+//	// TODO: Check whether interval{head, tail} are wildcard.
 //	// If yes, early return wildcard
 //
 //	// important!
@@ -88,7 +88,7 @@ func compactTwoSCs(a, b CeilingFloorConstrainter) (CeilingFloorConstrainter, boo
 		return a, true
 	}
 
-	return Interval{a.Floor(), b.Ceiling()}, true
+	return interval{a.Floor(), b.Ceiling()}, true
 }
 
 func compareSimpleConstrainters(a, b CeilingFloorConstrainter) int {