CaloRec: Python code fixes related to flake8 warnings

Fix warnings/errors flagged by flake8. Mostly unused variables/imports or stylistic code problems.

For this MR, rather than just concentrating on the new-style configuration, I fixed problems in all (and possibly obsolete) python files. While we won't be doing this for the entire repository, I am interested to see if something breaks elsewhere.