wip
define default value for limit
document more
streamline and simplify
ignore .pyc files