Improve error handling, update default filename, create file for shared logic called `functions.py`

[willmhowes]