pub_semver 1.4.0

pub_semver: ^1.4.0 copied to clipboard

Add a Version.firstPreRelease getter that returns the first possible pre-release of a version.

Add a Version.isFirstPreRelease getter that returns whether a version is the first possible pre-release.

new VersionRange() with an exclusive maximum now replaces the maximum with its first pre-release version. This matches the existing semantics, where an exclusive maximum would exclude pre-release versions of that maximum.

Explicitly representing this by changing the maximum version ensures that all operations behave correctly with respect to the special pre-release semantics. In particular, it fixes bugs where, for example, (>=1.0.0 <2.0.0-dev).union(>=2.0.0-dev <2.0.0) and (>=1.0.0 <3.0.0).difference(^1.0.0) wouldn't include 2.0.0-dev.

Add an alwaysIncludeMaxPreRelease parameter to new VersionRange(), which disables the replacement described above and allows users to create ranges that do include the pre-release versions of an exclusive max version.

Make the VersionUnion class public. This was previously used internally to implement new VersionConstraint.unionOf() and VersionConstraint.union(). Now it's public so you can use it too.

Added VersionConstraint.difference(). This returns a constraint matching all versions matched by one constraint but not another.

Make VersionRange implement Comparable<VersionRange>. Ranges are ordered first by lower bound, then by upper bound.

Add a VersionConstraint.union() method and a new VersionConstraint.unionOf() constructor. These each return a constraint that matches multiple existing constraints.

Add a VersionConstraint.allowsAll() method, which returns whether one constraint is a superset of another.

Add a VersionConstraint.allowsAny() method, which returns whether one constraint overlaps another.

Version now implements VersionRange.

Add support for the ^ operator for compatible versions according to pub's notion of compatibility. ^1.2.3 is equivalent to >=1.2.3 <2.0.0; ^0.1.2 is equivalent to >=0.1.2 <0.2.0.

Add Version.nextBreaking, which returns the next version that introduces breaking changes after a given version.

Add new VersionConstraint.compatibleWith(), which returns a range covering all versions compatible with a given version.

Add a custom VersionRange.hashCode to make it properly hashable.