Cleaned up test_zmq_service.py a bit

Removed some unused code, put the actual test at the top and added some
comments and docstrings.