added option for custom id generator
add test
cleanup
update README
Merge remote-tracking branch 'origin/custom-id-generator' into custom