utils: datastructures docs and PEP257 improvements

Signed-off-by: Jiri Kuncar <jiri.kuncar@cern.ch>