Improve NestedIterators smell detector

- Only report deepest nested iterator in each method
- Remove code smells
- Improve specs
Merge pull request #164 from troessner/improve-nested-iterators

Improve NestedIterators smell detector