update pragmas a bit
use module-level PY2/PY3 variables
params for post/put are no longer optional
remove obsolete paragraph