form-data / form-data / 606 / 9

98%

master: 99%

Pull #454

travis-ci

Note how to defer file descriptor creation

When appending many files and creating readstreams for each one, you run the real risk of blowing you file descriptor limit.  Generally its better to defer the creation of readStreams until you need to read the file.  

Reading into the combined stream docs, it appeared that this would support the `(next) => next(fs.createReadStream('foo')` api, however its not quite that simple.  This module expects a `path` property on the value so I documented that expectation.  

There is probably room for improvement here, API wise, however this should help assist people from having to read too much code to achieve this outcome. 

Thank you for and open to any suggestions.

120 of 146 branches covered (82.19%)

192 of 219 relevant lines covered (87.67%)

35.48 hits per line