Rename repeat to repeated and avoid shadowing methods from Base

Fixes #7
Make partition actually return tuples as its comment says

Also fix some issues with the examples provided
Add tests
Deprecate Iterators.repeat