[FEATURE] be less pedantic about enumeration
[FEATURE] add basic rspec test cases
[WIP] examples
[FIX] regression ; defaultto required
[WIP] more examples