liquidhaskell v0.2.0.0 Release Notes
-
๐ Move to GHC-7.8.3 LiquidHaskell now requires ghc-7.8.3.
Termination ๐ LiquidHaskell will now attempt to prove all recursive functions terminating. It tries to prove that some parameter (or combination thereof) decreases at each recursive callsite. By default, this will be the first parameter with an associated size measure (see Size Measures), but can be overridden with the
Decreases
annotation or a termination expression (see Termination Expressions).
If proving termination is too big of burden, it can be disabled on a per-module basis with the
--no-termination
flag, or on a per-function basis with theLazy
annotation.Size Measures Data declarations now optionally take a size measure, which LiquidHaskell will use to prove termination of recursive functions. The syntax is:
{-@ data List a [len] = Nil | Cons a (List a) @-}
Termination Expressions Termination Expressions can be used to specify the decreasing metric of a recursive function. They can be any valid LiquidHaskell expression and must be placed after the function's LiquidHaskell type, e.g.
{-@ map :: (a -> b) -> xs:[a] -> [a] / [len xs] @-}
Type Holes To reduce the annotation burden, LiquidHaskell now accepts
_
as a placeholder for types and refinements. It can take the place of any base Haskell type and LiquidHaskell will query GHC to fill in the blanks, or it can take the place of a refinement predicate, in which case LiquidHaskell will infer an appropriate refinement. For example,{-@ add :: x:_ -> y:_ -> {v:_ | v = x + y} @-} add x y = x + y
becomes
{-@ add :: Num a => x:a -> y:a -> {v:a | v = x + y} @-} add x y = x + y
Assumed Specifications The
assume
annotation now works as you might expect it to, i.e. LiquidHaskell will not verify that the implementation is correct. Furthermore,assume
can be used to locally override the type of an imported function.Derived Measure Selectors Given a data definition
{-@ data Foo = Foo { bar :: Int, baz :: Bool } @-}
LiquidHaskell will automatically derive measures
{-@ measure bar :: Foo -> Int @-} {-@ measure baz :: Foo -> Bool @-}
Type-Class Specifications LiquidHaskell can now verify prove that type-class instances satisfy a specification. Simply use the new
class
annotation{-@ class Num a where (+) :: x:a -> y:a -> {v:a | v = x + y} (-) :: x:a -> y:a -> {v:a | v = x - y} ... @-}
and LiquidHaskell will attempt to prove at each instance declaration that the implementations satisfy the class specification.
๐ When defining type-class specifications you may find the need to use overloaded measures, to allow for type-specific definitions (see Type-Indexed Measures).
Type-Indexed Measures LiquidHaskell now accepts measures with type-specific definitions, e.g. a measure to describe the size of a value. Such measures are defined using the
class measure
syntax{-@ class measure size :: forall a. a -> Int @-}
and instances can be defined using the
instance measure
syntax, which mirrors the regular measure syntax{-@ instance measure size :: [a] -> Int size ([]) = 0 size (x:xs) = 1 + size xs @-} {-@ instance measure size :: Tree a -> Int size (Leaf) = 0 size (Node l x r) = 1 + size l + size r @-}
๐ Parsing ๐ We have greatly improved our parser to require fewer parentheses! Yay!
๐ Emacs/Vim Support LiquidHaskell now comes with syntax checkers for flycheck in Emacs and syntastic in Vim.
Incremental Checking LiquidHaskell has a new
--diffcheck
flag that will only check binders that have changed since the last run, which can drastically improve verification times.๐ Experimental Support for Z3's theory of real numbers with the
--real
flag.