Issue 406 adding each_with_hit feature

Created the 'each_with_hit' feature on the results collection.  Including unit and integration tests and updating the readme with an example.