unit tests for these 3 functions are really needed in  tests/unit/test_req.py,  and a doc string for the 2nd one.