Swarm.Version

Query current and upstream Swarm version.

PVP version

isSwarmReleaseTag :: String -> Bool

Check that the tag follows the PVP versioning policy.

Note that this filters out VS Code plugin releases.

version :: String

Upstream release

tagToVersion :: String -> Version

Read Swarm tag as Version.

Swarm tags follow the PVP versioning scheme, so comparing them makes sense.

>>> map (first versionBranch) $ readP_to_S parseVersion "0.1.0.0"
[([0],".1.0.0"),([0,1],".0.0"),([0,1,0],".0"),([0,1,0,0],"")]
>>> Version [0,0,0,1] [] < tagToVersion "0.1.0.0"
True

upstreamReleaseVersion :: IO (Either NewReleaseFailure String)

Get the current upstream release version if any.

getNewerReleaseVersion :: Maybe GitInfo -> IO (Either NewReleaseFailure String)

Get a newer upstream release version.

This function can fail if the current branch is not main, if there is no Internet connection or no newer release.

data NewReleaseFailure where

Constructors

FailedReleaseQuery :: String -> NewReleaseFailure

NoMainUpstreamRelease :: [String] -> NewReleaseFailure

OnDevelopmentBranch :: String -> NewReleaseFailure

OldUpstreamRelease :: Version -> Version -> NewReleaseFailure

Instances

Show NewReleaseFailure

Defined in Swarm.Version

Methods

showsPrec :: Int -> NewReleaseFailure -> ShowS

show :: NewReleaseFailure -> String

showList :: [NewReleaseFailure] -> ShowS