fix
add class methods
fix documentation
remove duplicate logic, add option to not covert json to hash
add example