Add within assertion helper

README.md

@@ -149,13 +149,15 @@ B = (1 + 1e-6)*A
 #### `less_than`/
 #### `less_than_or_equal`/
 #### `less_than_or_equal`/
-#### `greater_than_or_equal`
+#### `greater_than_or_equal`/
+#### `within`
 Test inequality relationships between numbers.
 ```julia
 @fact 1 --> less_than(2)
 @fact 1 --> less_than_or_equal(1)
 @fact 2 --> greater_than(1)
 @fact 2 --> greater_than_or_equal(2)
+@fact 2 --> within(1:3)
 ```
 
 #### `anyof`

src/FactCheck.jl

@@ -18,7 +18,8 @@ export @fact, @fact_throws, @pending,
        roughly,
        anyof,
        less_than, less_than_or_equal,
-       greater_than, greater_than_or_equal
+       greater_than, greater_than_or_equal,
+       within
 
 const INDENT = "  "
 
@@ -182,7 +183,8 @@ print_compact(s::Pending) = print_with_color(:yellow, "P")
 
 const SPECIAL_FACTCHECK_FUNCTIONS =
     Set([:not, :exactly, :roughly, :anyof,
-         :less_than, :less_than_or_equal, :greater_than, :greater_than_or_equal])
+         :less_than, :less_than_or_equal, :greater_than, :greater_than_or_equal,
+         :within])
 
 @compat const FACTCHECK_FUN_NAMES =
     Dict{Symbol,AbstractString}(

src/helpers.jl

@@ -48,3 +48,5 @@ greater_than(compared) = (compare) -> compare > compared
 
 # greater_than_or_equal: Comparing two numbers
 greater_than_or_equal(compared) = (compare) -> compare >= compared
+
+within(range::Range) = (compare) -> compare in range

test/runtests.jl

@@ -192,6 +192,10 @@ facts("FactCheck assertion helper functions") do
         @fact 2 --> greater_than_or_equal(1)
         @fact 2 --> greater_than_or_equal(2)
     end
+
+    context("within") do
+        @fact 2 --> within(1:3)
+    end
 end
 
 exitstatus()