Documentation

[vkvam]

Explain intent and alternatives (input and output file types) of each generator and the difference between iter flush() and flush_iter().

Before documenting, ensure there is only on filetype. File and FileStream can be differentiated by wether an optional stream is present on a file or not.

FileMeta could be changed to FileData, and the stream could be one of these, for performance reasons set this as an instance variable as well as in the FileData map. File is turned into a pure container, and FileData can be accessed through get_item()

For each Generator specify acceptable FileData combinations.

[vkvam]

FileStream was removed, functionality moved to File.