OK, but doesn't python already have something like this?

Anyway, if this is important and really needed, then documentation needs to be provided.  I can sort of guess what it does from the name, but would rather read a description of what it says, rather then deciphering the code.