kill utf-8 characters from the output
cosmetic changes (pylint fixes)
add more documentations