changed: handle null conditions
changed: buckets create test case
added: README manual