refactor: remove dead code, add documentatino and doctests for utils
Some functions were no longer used because the code the used them was
refactored some time ago and now uses different ways to do that same thing
Add doctest joint documentation/unit testing to utils/__init__.py and a runner
for it in tests/.
