Use ? operator in tests.

src/fn_register.rs

@@ -11,6 +11,7 @@ use std::any::TypeId;
 /// # Example
 ///
 /// ```rust
+/// # fn main() -> Result<(), rhai::EvalAltResult> {
 /// use rhai::{Engine, RegisterFn};
 ///
 /// // Normal function
@@ -23,9 +24,11 @@ use std::any::TypeId;
 /// // You must use the trait rhai::RegisterFn to get this method.
 /// engine.register_fn("add", add);
 ///
-/// if let Ok(result) = engine.eval::<i64>("add(40, 2)") {
-///    println!("Answer: {}", result);  // prints 42
-/// }
+/// let result = engine.eval::<i64>("add(40, 2)")?;
+///
+/// println!("Answer: {}", result);  // prints 42
+/// # Ok(())
+/// # }
 /// ```
 pub trait RegisterFn<FN, ARGS, RET> {
     /// Register a custom function with the `Engine`.
@@ -37,7 +40,8 @@ pub trait RegisterFn<FN, ARGS, RET> {
 /// # Example
 ///
 /// ```rust
-/// use rhai::{Engine, RegisterDynamicFn, Dynamic};
+/// # fn main() -> Result<(), rhai::EvalAltResult> {
+/// use rhai::{Engine, Dynamic, RegisterDynamicFn};
 ///
 /// // Function that returns a Dynamic value
 /// fn get_an_any(x: i64) -> Dynamic {
@@ -49,9 +53,11 @@ pub trait RegisterFn<FN, ARGS, RET> {
 /// // You must use the trait rhai::RegisterDynamicFn to get this method.
 /// engine.register_dynamic_fn("get_an_any", get_an_any);
 ///
-/// if let Ok(result) = engine.eval::<i64>("get_an_any(42)") {
-///    println!("Answer: {}", result);  // prints 42
-/// }
+/// let result = engine.eval::<i64>("get_an_any(42)")?;
+///
+/// println!("Answer: {}", result);  // prints 42
+/// # Ok(())
+/// # }
 /// ```
 pub trait RegisterDynamicFn<FN, ARGS> {
     /// Register a custom function returning `Dynamic` values with the `Engine`.
@@ -63,6 +69,7 @@ pub trait RegisterDynamicFn<FN, ARGS> {
 /// # Example
 ///
 /// ```rust
+/// # fn main() -> Result<(), rhai::EvalAltResult> {
 /// use rhai::{Engine, RegisterFn};
 ///
 /// // Normal function
@@ -75,9 +82,11 @@ pub trait RegisterDynamicFn<FN, ARGS> {
 /// // You must use the trait rhai::RegisterFn to get this method.
 /// engine.register_fn("add", add);
 ///
-/// if let Ok(result) = engine.eval::<i64>("add(40, 2)") {
-///    println!("Answer: {}", result);  // prints 42
-/// }
+/// let result = engine.eval::<i64>("add(40, 2)")?;
+///
+/// println!("Answer: {}", result);  // prints 42
+/// # Ok(())
+/// # }
 /// ```
 pub trait RegisterResultFn<FN, ARGS, RET> {
     /// Register a custom function with the `Engine`.

src/lib.rs

@@ -17,15 +17,22 @@
 //! And the Rust part:
 //!
 //! ```rust,no_run
-//! use rhai::{Engine, RegisterFn};
+//! use rhai::{Engine, EvalAltResult, RegisterFn};
 //!
-//! fn compute_something(x: i64) -> bool {
-//!	    (x % 40) == 0
+//! fn main() -> Result<(), EvalAltResult>
+//! {
+//!     fn compute_something(x: i64) -> bool {
+//!	        (x % 40) == 0
+//!     }
+//!
+//!     let mut engine = Engine::new();
+//!
+//!     engine.register_fn("compute_something", compute_something);
+//!
+//!     assert_eq!(engine.eval_file::<bool>("my_script.rhai")?, true);
+//!
+//!     Ok(())
 //! }
-//!
-//! let mut engine = Engine::new();
-//! engine.register_fn("compute_something", compute_something);
-//! assert_eq!(engine.eval_file::<bool>("my_script.rhai").unwrap(), true);
 //! ```
 //!
 //! [Check out the README on GitHub for more information!](https://github.com/jonathandturner/rhai)
@@ -61,6 +68,7 @@ mod call;
 mod engine;
 mod error;
 mod fn_register;
+mod optimize;
 mod parser;
 mod result;
 mod scope;

src/scope.rs

@@ -9,13 +9,17 @@ use std::borrow::Cow;
 /// # Example
 ///
 /// ```rust
+/// # fn main() -> Result<(), rhai::EvalAltResult> {
 /// use rhai::{Engine, Scope};
 ///
 /// let mut engine = Engine::new();
 /// let mut my_scope = Scope::new();
 ///
-/// assert!(engine.eval_with_scope::<()>(&mut my_scope, "let x = 5;").is_ok());
-/// assert_eq!(engine.eval_with_scope::<i64>(&mut my_scope, "x + 1").unwrap(), 6);
+/// engine.eval_with_scope::<()>(&mut my_scope, "let x = 5;")?;
+///
+/// assert_eq!(engine.eval_with_scope::<i64>(&mut my_scope, "x + 1")?, 6);
+/// # Ok(())
+/// # }
 /// ```
 ///
 /// When searching for variables, newly-added variables are found before similarly-named but older variables,