hopefully this doesn't get used much, but currently am having a major
headache when running python 3.7 tests via tox. probably should just
drop support for that one ASAP..
this has 100% test coverage and i intend to keep it that way. api
docs have a good start but still need narrative. several more things
must be added before i can seriously consider incorporating into
rattail but this seemed a good save point