Added getter, read and is_allowed attribute decorators

Closes #338 (closed)

We already have setter and write decorators. I adeed getter, read and is_allowed.

Added unit test for decorators and added example to documentation