cleanup specs
add limit param
add example unit tests