add common.py
update iterators function signatures, add several tweaks