updated docstring from out of date usage
updated contextual runner to provide neater api.
updated tests to demonstrate usage