Extend example to include usage of arbitrary crate

Closes #17

Author: Adam Reichold

example/Cargo.toml

@@ -3,5 +3,13 @@ name = "example"
 version = "0.0.0"
 authors = ["Paul Grandperrin <[email protected]>"]
 
+[[bin]]
+name = "example"
+path = "src/main.rs"
+
+[[bin]]
+name = "arbitrary-example"
+path = "src/arbitrary_main.rs"
+
 [dependencies]
 honggfuzz = {path = ".."}

example/src/arbitrary_main.rs

@@ -0,0 +1,24 @@
+#[macro_use] extern crate honggfuzz;
+
+fn main() {
+    // Here you can parse `std::env::args and
+    // setup / initialize your project
+
+    // You have full control over the loop but
+    // you're supposed to call `fuzz` ad vitam aeternam
+    loop {
+        // The fuzz macro gives an arbitrary object (see `arbitrary crate`)
+        // to a closure-like block of code.
+        // For performance, it is recommended that you use the native type
+        // `&[u8]` when possible.
+        // Here, this tuple will contain three "random" values of different type.
+        fuzz!(|data: (bool, i32, f32)| {
+
+            if data.0 == false {return}
+            if data.1 < 0 {return}
+            if data.2 > 1.0 {return}
+            panic!("BOOM")
+
+        });
+    }
+}

example/test.sh

@@ -82,7 +82,7 @@ RUSTFLAGS="" cargo build
 
 # but when we run it, it should fail with a useful error message and status 17
 set +e
-RUSTFLAGS="" cargo run
+RUSTFLAGS="" cargo run --bin example
 status=$?
 set -e
 test $status -eq 17