input for files, more factory methods
update readme examples