# Zeno

### From HaskellWiki

m |
(Added categories "How to" and "Tools") |
||

(20 intermediate revisions by one user not shown) | |||

Line 1: | Line 1: | ||

− | |||

− | |||

== Introduction == | == Introduction == | ||

− | Zeno is an automated proof system for Haskell program properties; developed at Imperial College London by William Sonnex, Sophia Drossopoulou and Susan Eisenbach. It aims to solve the general problem of equality between two Haskell terms, for any input value. | + | [http://hackage.haskell.org/package/zeno Zeno] is an automated proof system for Haskell program properties; developed at Imperial College London by William Sonnex, [http://www.doc.ic.ac.uk/~scd/ Sophia Drossopoulou] and [http://www.doc.ic.ac.uk/~susan/ Susan Eisenbach]. It aims to solve the general problem of equality between two Haskell terms, for any input value. |

Many program verification tools available today are of the model checking variety; able to traverse a very large but finite search space very quickly. These are well suited to problems with a large description, but no recursive datatypes. Zeno on the other hand is designed to [http://en.wikipedia.org/wiki/Structural_induction inductively] prove properties over an infinite search space, but only those with a small and simple specification. | Many program verification tools available today are of the model checking variety; able to traverse a very large but finite search space very quickly. These are well suited to problems with a large description, but no recursive datatypes. Zeno on the other hand is designed to [http://en.wikipedia.org/wiki/Structural_induction inductively] prove properties over an infinite search space, but only those with a small and simple specification. | ||

− | One can try Zeno online at [http://www.doc.ic.ac.uk/~ws506/tryzeno TryZeno], or <tt>cabal install zeno</tt> to use it from home. | + | One can try Zeno online at [http://www.doc.ic.ac.uk/~ws506/tryzeno TryZeno], or <tt>cabal install zeno</tt> to use it from home. You can find the latest paper on Zeno [http://pubs.doc.ic.ac.uk/zenoTwo/ here], though please note that Zeno no longer uses the described proof output syntax but instead outputs proofs as Isabelle theories. |

− | + | ||

=== Features === | === Features === | ||

− | * Outputs proofs and translated Haskell programs to an | + | * Outputs proofs and translated Haskell programs to an [http://www.cl.cam.ac.uk/research/hvg/Isabelle/ Isabelle/HOL] theory file and will automatically invoke Isabelle to check it (requires <tt>isabelle</tt> to be visible on the command line). |

* Works with full Haskell98 along with any GHC extensions not related to the type system. Unfortunately not all Haskell code is then convertable to Isabelle/HOL, see [[Zeno#Limitations]] for details. | * Works with full Haskell98 along with any GHC extensions not related to the type system. Unfortunately not all Haskell code is then convertable to Isabelle/HOL, see [[Zeno#Limitations]] for details. | ||

− | * | + | * Has a built-in counter-example finder, along the same lines as [http://www.cs.york.ac.uk/fp/smallcheck/ SmallCheck], but using symbolic evaluation to control search depth. |

+ | * Its property language is just a Haskell DSL. | ||

== Example Usage == | == Example Usage == | ||

− | The first thing you need is the <tt>Zeno.hs</tt> file | + | The first thing you need is the <tt>Zeno.hs</tt> file which contains the definitions for Zeno's property DSL. It should be in your Zeno installation directory but is also given below: |

+ | |||

+ | <haskell> | ||

+ | module Zeno ( | ||

+ | Bool (..), Equals (..), Prop, | ||

+ | prove, proveBool, given, givenBool, | ||

+ | ($), otherwise | ||

+ | ) where | ||

+ | |||

+ | import Prelude ( Bool (..) ) | ||

+ | |||

+ | infix 1 :=: | ||

+ | infixr 0 $ | ||

+ | |||

+ | ($) :: (a -> b) -> a -> b | ||

+ | f $ x = f x | ||

+ | |||

+ | otherwise :: Bool | ||

+ | otherwise = True | ||

+ | |||

+ | data Equals | ||

+ | = forall a . (:=:) a a | ||

+ | |||

+ | data Prop | ||

+ | = Given Equals Prop | ||

+ | | Prove Equals | ||

+ | |||

+ | prove :: Equals -> Prop | ||

+ | prove = Prove | ||

+ | |||

+ | given :: Equals -> Prop -> Prop | ||

+ | given = Given | ||

+ | |||

+ | proveBool :: Bool -> Prop | ||

+ | proveBool p = Prove (p :=: True) | ||

+ | |||

+ | givenBool :: Bool -> Prop -> Prop | ||

+ | givenBool p = Given (p :=: True) | ||

+ | </haskell> | ||

+ | |||

+ | |||

+ | Making sure this file is in the same directory we can now start coding: | ||

<haskell> | <haskell> | ||

Line 49: | Line 88: | ||

Notice we have stopped any <hask>Prelude</hask> functions from being imported, this is important as we have no source code available for them; Zeno can only work with functions for which it can see the definition. The only built-in Haskell types we have are lists and tuples, which are automatically available, and <hask>Bool</hask>, which <tt>Zeno.hs</tt> will import for you. | Notice we have stopped any <hask>Prelude</hask> functions from being imported, this is important as we have no source code available for them; Zeno can only work with functions for which it can see the definition. The only built-in Haskell types we have are lists and tuples, which are automatically available, and <hask>Bool</hask>, which <tt>Zeno.hs</tt> will import for you. | ||

− | Now that we have some code we can define a property about this code. | + | Now that we have some code we can define a property about this code. Equality is expressed using the <hask>(:=:)</hask> constructor defined in <tt>Zeno.hs</tt>. We then pass this to the <hask>prove</hask> function to turn an equality into a property (<hask>Prop</hask>). |

The following code will express that the length of two appended lists is the sum of their individual lengths: | The following code will express that the length of two appended lists is the sum of their individual lengths: | ||

Line 60: | Line 99: | ||

Add this to the above code and save it to <tt>Test.hs</tt>. We can now check <hask>prop_length</hask> by running <tt>zeno Test.hs</tt>. As a bug/feature this will also check <hask>Zeno.proveBool</hask>, a helper function in <tt>Zeno.hs</tt>, as this looks like a property. To restrict this to just <hask>prop_length</hask> we can run <tt>zeno -m prop Test.hs</tt>, which will only check properties whose name contains the text <tt>prop</tt>. | Add this to the above code and save it to <tt>Test.hs</tt>. We can now check <hask>prop_length</hask> by running <tt>zeno Test.hs</tt>. As a bug/feature this will also check <hask>Zeno.proveBool</hask>, a helper function in <tt>Zeno.hs</tt>, as this looks like a property. To restrict this to just <hask>prop_length</hask> we can run <tt>zeno -m prop Test.hs</tt>, which will only check properties whose name contains the text <tt>prop</tt>. | ||

− | Say we want to express arbitrary propositions, we can do an equality check with <hask>True</hask> | + | Say we want to express arbitrary propositions, we can do an equality check with <hask>True</hask>, as in the following code (appended to the code above): |

<haskell> | <haskell> | ||

Line 75: | Line 114: | ||

</haskell><br/> | </haskell><br/> | ||

− | We have | + | We have provided the helper function <hask>proveBool</hask> to make this more succinct; an equivalent definition of <hask>prop_eq_ref</hask> would be: |

<haskell> | <haskell> | ||

Line 96: | Line 135: | ||

</haskell><br/> | </haskell><br/> | ||

− | Here <hask>prop_elem</hask> expresses that if <hask>n</hask> is an element of <hask>ys</hask> then <hask>n</hask> is an element of <hask>xs ++ ys</hask>. Notice that we had to explicitly type everything to be <hask>Nat</hask> | + | Here <hask>prop_elem</hask> expresses that if <hask>n</hask> is an element of <hask>ys</hask> then <hask>n</hask> is an element of <hask>xs ++ ys</hask>. Notice that we had to explicitly type everything to be <hask>Nat</hask> so as to give Zeno an explicit definition for <hask>(==)</hask>. |

== Limitations == | == Limitations == | ||

Line 105: | Line 144: | ||

# No internal recursive definitions; don't put recursive functions inside your functions. | # No internal recursive definitions; don't put recursive functions inside your functions. | ||

− | # No non-terminating definitions. This also means you cannot use default type-class methods, as GHC transforms these internally to a co-recursive value. | + | # No non-terminating definitions. This also means you cannot use default type-class methods, as GHC transforms these internally to a co-recursive value. Isabelle will check for termination but Zeno will not, unfortunately this means that Zeno could be thrown into an infinite loop with such a definition. |

− | While the above restrictions are founded in Isabelle's input language | + | While the above restrictions are founded in Isabelle's input language there are a few which are just laziness on part of Zeno's developers, and on our to-do list: |

# No partial definitions; only use total pattern matches. | # No partial definitions; only use total pattern matches. | ||

Line 114: | Line 153: | ||

# No name clashes, even across modules. Zeno will automatically strip module names in its output for clarity, and we have not yet implemented a flag to control this. | # No name clashes, even across modules. Zeno will automatically strip module names in its output for clarity, and we have not yet implemented a flag to control this. | ||

− | If you are wondering why a certain bit of code cannot be converted to Isabelle try running Zeno with the <tt>--print-core</tt> flag, | + | If you are wondering why a certain bit of code cannot be converted to Isabelle try running Zeno with the <tt>--print-core</tt> flag, this will output Zeno's internal representation for your code. |

− | + | ||

=== Primitive Types === | === Primitive Types === | ||

− | Zeno can only reason about inductive datatypes, meaning the only built-in types it can use are lists, tuples and <hask>Bool</hask> | + | Zeno can only reason about inductive datatypes, meaning the only built-in types it can use are lists, tuples and <hask>Bool</hask>. Any values of type <hask>Integer</hask>, <hask>Int</hask>, <hask>Char</hask>, etc. Zeno will replace with <hask>undefined</hask>. |

− | + | ||

=== Infinite and undefined values === | === Infinite and undefined values === | ||

Line 126: | Line 163: | ||

When we said that Zeno proves properties of Haskell programs this wasn't entirely true, it only proves those for which every value is finite and well-defined. For example, Zeno can prove <hask>reverse (reverse xs) = xs</hask>, which is not true for infinite lists, as <hask>xs</hask> could still be pattern matched upon, whereas evaluating <hask>reverse (reverse xs)</hask> starts an infinite loop (<hask>undefined</hask>). | When we said that Zeno proves properties of Haskell programs this wasn't entirely true, it only proves those for which every value is finite and well-defined. For example, Zeno can prove <hask>reverse (reverse xs) = xs</hask>, which is not true for infinite lists, as <hask>xs</hask> could still be pattern matched upon, whereas evaluating <hask>reverse (reverse xs)</hask> starts an infinite loop (<hask>undefined</hask>). | ||

− | Another example (courtesy of Tillmann Rendel) is <hask>takeWhile p xs ++ dropWhile p xs = xs</hask>, which is not true when <hask>p = const undefined</hask> and <hask>xs /= []</hask>, as the left hand side of the equality would | + | Another example (courtesy of Tillmann Rendel) is <hask>takeWhile p xs ++ dropWhile p xs = xs</hask>, which Zeno will prove but in fact is not true when <hask>p = const undefined</hask> and <hask>xs /= []</hask>, as the left hand side of the equality would be <hask>undefined</hask>. |

You might ask why this is a Haskell theorem prover, rather than an ML one, if it cannot deal with infinite values, which would be a very valid question. As it stands Zeno is more a base-line for us to start more advanced research into lazy functional program verification, which will include attempting to tackle this issue. | You might ask why this is a Haskell theorem prover, rather than an ML one, if it cannot deal with infinite values, which would be a very valid question. As it stands Zeno is more a base-line for us to start more advanced research into lazy functional program verification, which will include attempting to tackle this issue. | ||

+ | |||

+ | [[Category:How to]] | ||

+ | [[Category:Tools]] |

## Latest revision as of 15:52, 22 February 2012

## Contents |

## [edit] 1 Introduction

Zeno is an automated proof system for Haskell program properties; developed at Imperial College London by William Sonnex, Sophia Drossopoulou and Susan Eisenbach. It aims to solve the general problem of equality between two Haskell terms, for any input value.

Many program verification tools available today are of the model checking variety; able to traverse a very large but finite search space very quickly. These are well suited to problems with a large description, but no recursive datatypes. Zeno on the other hand is designed to inductively prove properties over an infinite search space, but only those with a small and simple specification.

One can try Zeno online at TryZeno, or `cabal install zeno` to use it from home. You can find the latest paper on Zeno here, though please note that Zeno no longer uses the described proof output syntax but instead outputs proofs as Isabelle theories.

### [edit] 1.1 Features

- Outputs proofs and translated Haskell programs to an Isabelle/HOL theory file and will automatically invoke Isabelle to check it (requires
`isabelle`to be visible on the command line).

- Works with full Haskell98 along with any GHC extensions not related to the type system. Unfortunately not all Haskell code is then convertable to Isabelle/HOL, see Zeno#Limitations for details.

- Has a built-in counter-example finder, along the same lines as SmallCheck, but using symbolic evaluation to control search depth.

- Its property language is just a Haskell DSL.

## [edit] 2 Example Usage

The first thing you need is the `Zeno.hs` file which contains the definitions for Zeno's property DSL. It should be in your Zeno installation directory but is also given below:

module Zeno ( Bool (..), Equals (..), Prop, prove, proveBool, given, givenBool, ($), otherwise ) where import Prelude ( Bool (..) ) infix 1 :=: infixr 0 $ ($) :: (a -> b) -> a -> b f $ x = f x otherwise :: Bool otherwise = True data Equals = forall a . (:=:) a a data Prop = Given Equals Prop | Prove Equals prove :: Equals -> Prop prove = Prove given :: Equals -> Prop -> Prop given = Given proveBool :: Bool -> Prop proveBool p = Prove (p :=: True) givenBool :: Bool -> Prop -> Prop givenBool p = Given (p :=: True)

Making sure this file is in the same directory we can now start coding:

module Test where import Prelude () import Zeno data Nat = Zero | Succ Nat length :: [a] -> Nat length [] = Zero length (x:xs) = Succ (length xs) (++) :: [a] -> [a] -> [a] [] ++ ys = ys (x:xs) ++ ys = x : (xs ++ ys) class Num a where (+) :: a -> a -> a instance Num Nat where Zero + y = y Succ x + y = Succ (x + y)

Notice we have stopped any

`Zeno.hs`will import for you. Now that we have some code we can define a property about this code. Equality is expressed using the

`Zeno.hs`. We then pass this to the

The following code will express that the length of two appended lists is the sum of their individual lengths:

prop_length xs ys = prove (length (xs ++ ys) :=: length xs + length ys)

Add this to the above code and save it to

`Test.hs`. We can now check

`zeno Test.hs`. As a bug/feature this will also check

`Zeno.hs`, as this looks like a property. To restrict this to just

`zeno -m prop Test.hs`, which will only check properties whose name contains the text

`prop`. Say we want to express arbitrary propositions, we can do an equality check with

class Eq a where (==) :: a -> a -> Bool instance Eq Nat where Zero == Zero = True Succ x == Succ y = x == y _ == _ = False prop_eq_ref :: Nat -> Prop prop_eq_ref x = prove (x == x :=: True)

We have provided the helper function

prop_eq_ref x = proveBool (x == x)

We can also express implication in our properties, using the

elem :: Eq a => a -> [a] -> Bool elem _ [] = False elem n (x:xs) | n == x = True | otherwise = elem n xs prop_elem :: Nat -> [Nat] -> [Nat] -> Prop prop_elem n xs ys = givenBool (n `elem` ys) $ proveBool (n `elem` (xs ++ ys))

Here

## [edit] 3 Limitations

### [edit] 3.1 Isabelle/HOL output

While Zeno is able to reason about any valid Haskell definition, not all of these can be converted to Isabelle for checking. There are two main restrictions:

- No internal recursive definitions; don't put recursive functions inside your functions.
- No non-terminating definitions. This also means you cannot use default type-class methods, as GHC transforms these internally to a co-recursive value. Isabelle will check for termination but Zeno will not, unfortunately this means that Zeno could be thrown into an infinite loop with such a definition.

While the above restrictions are founded in Isabelle's input language there are a few which are just laziness on part of Zeno's developers, and on our to-do list:

- No partial definitions; only use total pattern matches.
- No mututally recursive datatypes.
- No tuple types beyond quadruples.
- No name clashes, even across modules. Zeno will automatically strip module names in its output for clarity, and we have not yet implemented a flag to control this.

If you are wondering why a certain bit of code cannot be converted to Isabelle try running Zeno with the `--print-core` flag, this will output Zeno's internal representation for your code.

### [edit] 3.2 Primitive Types

Zeno can only reason about inductive datatypes, meaning the only built-in types it can use are lists, tuples and### [edit] 3.3 Infinite and undefined values

When we said that Zeno proves properties of Haskell programs this wasn't entirely true, it only proves those for which every value is finite and well-defined. For example, Zeno can proveYou might ask why this is a Haskell theorem prover, rather than an ML one, if it cannot deal with infinite values, which would be a very valid question. As it stands Zeno is more a base-line for us to start more advanced research into lazy functional program verification, which will include attempting to tackle this issue.