Better document and extend Importer

Importers should get the input stream in a consistent way. This change also prepares for https://github.com/LibreCat/Catmandu/issues/58