decorators now have their own module
move optional from utils but preserve compat
tests for the new decorators
style fixes in the decorators module
update the docs
adds a thread-safe storage for notario