basic pyclient.flush() and some docs