~ extract cache as decorator
+ properly stub clock
+ explain tags
+ readme