fix load failure when reading cached data
update README and docs for v0.4
fix return type typo
provide docstrings