utility functions for the python-microcopy environment