session: docs, PEP8 and PEP257 improvements

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